Skip to Content

フォーム

すべての情報がセンサーや自動化システムから来るわけではありません。時には人の手が必要です — そこでフォームウィジェットの出番です。IronFlock 内のデジタルクリップボードと考えてください。手動でデータを記録したい場面で使用します。例えば:

  • 生産ラインでのスクラップ数の記録
  • 旧式の pH センサーからの読み取り値の入力
  • 工場巡回時の点検メモの記録
Forms widget demo

フォームの仕組み

フォームが送信されると、データはアプリのデータベース内の指定されたテーブルに保存されます。フォームの各フィールドはそのテーブルのカラムに対応し、フォーム送信時にすべてのフィールドが新しい行としてまとめて保存されます。

フォームウィジェットで設定する項目:

  • フォームのタイトル
  • 1 つ以上のフィールド(各フィールドにラベル、入力タイプ、書き込み先のテーブルカラムを設定)
  • フィールドごとのオプションのバリデーションルールとデフォルト値
  • ボタンの任意のテキスト(Button Labels、たとえば Submit の代わりに 保存)と、保存後に開くページ(Post-Submit Navigation)

利用可能なフィールドタイプ: ドロップダウン(リストから選択)、テキスト、数値、チェックボックス、日時ピッカー。

フィールドの配置

デフォルトでは、各フィールドは 1 行全体を使い、上から順に並びます。関連するフィールドを横に並べ、見出しの下にまとめると、長いフォームでも入力しやすくなります。

  • Width: 各フィールドは、1 行全体、または行の 4 分の 3、3 分の 2、半分、3 分の 1、4 分の 1 の幅を使えます。フィールドは各行を左から右へ埋めていき、収まらなくなったフィールドは次の行から始まります。Field Layout で Default Field Width を設定するとすべてのフィールドが同じ幅になり、必要に応じて個々のフィールドの幅を変更できます。
  • Start a New Row: 前のフィールドの横にまだ収まる場合でも、そのフィールドから新しい行が始まります。
  • セクション: タイプが section のフィールドは、見出しと、その下に任意のヒントを追加します。続くフィールドを、次のセクションまでひとつのグループにまとめます。セクションの Field Width in Group でこれらのフィールドの幅をまとめて設定でき、Conditional Display でグループ全体の表示・非表示を切り替えられます。たとえば、特定の種類のマシンにだけ関係する設定に使えます。
  • Density: 新しいフォームは Compact で始まり、マウスで操作するデスクトップ向けのボードに合った小さめのフィールドになります。タッチスクリーンに適した大きめのフィールドにするには Comfortable を選択します。

フォームは使える領域に合わせて調整されます。小さなタイルやスマートフォンでは、フィールドが段階的に広がり、最終的に 1 列に並ぶため、どのフィールドも読みやすいままです。Minimum Field Width では、そうなる前にフィールドをどこまで狭くできるかを設定します。

データはどこに保存されるか

フォーム送信のたびにテーブルに新しい行が追加されます。これにより、すべてのエントリの完全な履歴が保存されます。上書きや消失はありません。

各行が完全で一貫性のあるものになるよう、すべての必須フィールドを設定してください。

最新状態の追跡

フォームを使用してマシンや資産の現在の状態を追跡する場合(例:マシンごとの最新の点検結果など)、IronFlock は各項目の最新エントリだけを表示できます。アプリ開発者がテーブルに対して、どのカラムがエンティティを識別するか(例:マシン名)を指定することで、この機能が有効になります。

設定が完了したら、ウィジェットのフィルタ設定で latest トグルをオンにすると、そのウィジェットにはマシンや資産ごとの現在の行だけが表示されます。IronFlock はウィジェットがテーブルを読み取るたびにどの行が現在のものかを判断し、新しい送信が届くたびにボード上のその項目の行を置き換えるため、送信が遅れたり修正されたりしても、ボードに古い値が表示されたままになることはありません。送信履歴全体は確認したい場合にいつでもアクセスできます。

このようなテーブルでは、フォームにはエンティティを識別するカラムのフィールドと、編集するカラムのフィールドだけがあれば十分です。送信のたびに、フォームが書き込まないカラムはすべて現在の値が保持されます。フォーム上のフィールドは常に書き込まれます。空にした数値フィールドはそのカラムをクリアし、空にしたテキストフィールドは空のテキストを保存し、表示条件によって非表示になったフィールドはそのカラムをクリアします。デフォルト値を持つフィールドは、カラムを空にする代わりにデフォルト値を書き込みます。

テーブルからレコードを編集する

既存のレコードを開いて変更できるようにするには、同じページでテーブルとフォームを組み合わせます。

  1. テーブルに Edit button タイプのカラムを追加し、レコードを識別するカラム(たとえばマシン名)にバインドして、その URL Parameter Key を設定します(例:edit)。各行にペンのアイコンが表示されます。クリックすると、フィルターウィジェットがパラメーターを設定するのと同じように、その行のキーがページの URL に書き込まれます(?edit=press-1)。
  2. 同じページにフォームを追加し、Form Open Button をオンにして、Open on URL parameter に同じ名前を設定します。ボード上ではフォーム自身のボタンは表示されません。URL にパラメーターが含まれるとすぐにダイアログとして開き、ユーザーが保存またはキャンセルすると閉じて、パラメーターが URL から削除されます。
  3. 各フィールドの Pre-filled Value をレコードのカラムにバインドします。識別カラムに対するフィルターの値は フィルターパラメーター edit から取り、Latest スイッチをオンにします。識別カラムに書き込むフィールドは、同じバインディングを持つ Hidden Field にして、保存が同じレコードに対して行われるようにします。前のセクションと同様に、フォームが書き込まないカラムは値を保持します。

ダイアログには、レコードの値が届くまでプログレスバーが表示されます。latest トグルをオンにしておくと、保存した変更は格納された瞬間にテーブルに反映されます。パラメーター付きの URL をブックマークしておくとダイアログがすぐに開き、ブラウザーの戻るボタンで閉じます。

独自の開くボタンを持つ別のフォームは、これまでどおり新しいレコードを作成します。ボードの外、つまりウィジェットエディターのプレビューでは、フォームは試せるようにボタンを保持します。

データの削除

IronFlock は削除にも追記型のアプローチを採用しています。行を削除する代わりに、フォームはテーブルの deleted カラムでレコードを削除済みとしてマークする新しいエントリを送信します。deleted はアプリ開発者がテーブルに追加するブーリアンのカラムです。そのための特別な削除ボタンはありません。削除フォームとは、送信ボタンに 削除 と表示されるフォームのことです。

ユーザーが確認を経てテーブルからレコードを削除できるようにするには、次のようにします。

  1. テーブルに Edit button タイプの 2 つ目のカラムを追加し、レコードを識別するカラムにバインドして、URL Parameter Key を delete、Icon を delete に設定します。
  2. 同じページにフォームを追加し、Form Open Button をオンにして、Open on URL parameter を delete に設定し、「このレコードを削除しますか?」のようなタイトルを付けます。Button Labels で Submit Label を 削除、Cancel Label を 残す に設定し、赤い Highlight Color を選びます。
  3. フォームには、どちらも Hidden Field をオンにしたフィールドをちょうど 2 つ設けます。1 つは識別カラムを書き込むフィールドで、その Pre-filled Value は上の編集フォームと同じようにバインドしますが、delete パラメーターでフィルターします。もう 1 つは deleted カラムを書き込むチェックボックスで、Default Value をオンにします。

行の削除アイコンをクリックするとダイアログが開き、削除 でレコードのキーが deleted を true にして保存されます。代わりにレコード自身の詳細ページで削除するには、同じフォームをそのページに置き、Post-Submit Navigation を一覧ページ(たとえば /machines)に設定します。

レコードを一覧表示するウィジェットは、latest トグルと deleted カラムのフィルター(deleted が空または false)を組み合わせます。削除されたレコードはエントリが届いた瞬間にボードから消え、履歴と監査のためにデータベースに残ります。このためのビューや変換は不要です。レコードの論理削除を参照してください。編集フォームで削除済みレコードを復元できるようにするには、deleted カラムに Default Value をオフにした非表示のチェックボックスを追加します。

フォームウィジェットのバージョン 2.0 より前で作成されたフォームには、Show Delete Button と Delete-Flag Column の設定があります。バージョン 2.0 にはこれらの設定はありません。そのようなフォームをバージョン 2.0 以降に移行する場合は、ここで説明したとおりに削除の仕組みを作り直してください。

まとめ

フォームウィジェットで得られるもの:

  • ボードからの簡単な手動データ入力
  • すべての送信に対する自動的な履歴追跡
  • 現在の状態の表示と削除済みレコードの非表示のクリーンなパターン
  • テーブルから既存レコードを同じページのダイアログで編集

IronFlock のボードを離れることなく、すべて実現できます。

Last updated on