フォーム デザイナの使用 › フォームを作成、カスタマイズ、使用する方法 › フォームの要素 › 動的テーブルを作成する方法 › 動的テーブルの設定

動的テーブルの設定

動的テーブルを作成した後、次にそれを設定し、データを入力し、必要な形式を使えるようにします。

次の手順に従ってください：

1. テーブルに要素を追加するための以下の要件を確認します。 追加する各要素はテーブルの列になります。
   • 前の手順でレポート/プラグイン変数の属性に指定した変数ごとに、1 つの要素を追加します。
   • （API プラグイン）テーブル内の各要素（列）の _id 属性値は、プラグインの出力 ID の値に一致する必要があります。
   • （レポート データ オブジェクト）テーブル内の各要素（列）の _id 属性値は、データ オブジェクトのフィールド値に一致する必要があります。
2. 前の手順の要件に従って、テーブルに要素を追加するには、以下の手順を行います。
   1. テーブルを展開して、［行］フィールドを表示します。
   2. ［システム］フォルダから必要な要素をドラッグし、［行］フィールドにドロップします。 以下の要素をドラッグ アンド ドロップできます。
      • 日付/時刻フィールド
      • ラベル
      • スピナー
      • テキスト
      • ［複数選択］属性が false に設定されるフィールドを選択します。 この設定では単一の選択しかできません。
   3. この手順は必要に応じて実行し、必要でない場合はスキップします。

      ［複数選択］の属性が false に設定されている選択フィールドを使用している場合、選択フィールドには value 属性が含まれません。 その場合、静的なリストまたはレポート データ オブジェクトのいずれかを使用して、［選択］フィールドに入力できます。

      静的なリストを使用して、［選択］フィールドに入力するには、以下の手順に従います。

      • 1 行目には、［選択］フィールドの［選択されたインデックス］属性の値を入力します。 たとえば、最初のオプションを指定するには、0 を入力します。 2 番目のオプションを指定するには、1 などを指定します。
      • ほかの行には、［選択］フィールドの選択オプション から value 属性の値をコピーします。 この値をその行の列の属性に貼り付けます。

      ドラッグ アンド ドロップする要素の名前が、最初の列名になります。 たとえば、日付要素をドラッグ アンド ドロップした場合、最初の列名は「日付」になります。

      注： 行の移動、コピー、切り取り、貼り付けはできません。

   4. 列の _id 値を指定し、フォームを保存します。

      重要： 列の _id 値は、前の手順の要件を満たす必要があります。 また、データ タイプおよびデータ フォーマットは同じである必要があります。 そうなっていない場合は、列にはデータが入力されません。

      たとえば、API プラグインを使用し、イベントの開始日を指定するテーブルの列を考えます。 「日付時刻」要素をテーブルにドラッグ アンド ドロップし、開始日（start_date）の Id（_id value）を指定します。 この要素はテーブル内の列になります。 したがって、API プラグインの変数の出力 ID も start_date である必要があります。 シーケンスは必要ありません。 さらに、この変数は、「日付時刻」要素に一致するフォーマットで日時を返す必要があります。

      注： フォームを保存した後は、ドラッグ アンド ドロップした要素の名前を任意で変更できます。 要素の名前を変更すると、それに応じて列名が変わります。 たとえば、要素の名前を「開始日」に変更した場合、列名も「開始日」に変わります。

3. テーブルなしでフォームに要素を追加する場合と同じように、テーブルに追加する各要素を設定します。

   各要素は、日付時刻フィールドおよび選択フィールド以外は基本要素です。 列に入力するデータはその要素に一致する必要があります。 たとえば、「日付」列には、日付以外は入力できません。

4. 追加する要素ごとに、上記の手順を繰り返します。

   重要： 前の手順で記した要件はすべて適用されます。

   前の手順で説明したように、追加する 2 番目の要素によって 2 番目の列の名前およびデータ タイプが決まります。 たとえば、2 番目の列に「テキスト」要素を追加します。 その場合、2 番目の列のタイトルは「テキスト」となり、テキスト データが含まれます。 前の手順で説明したように、ユーザはオプションで要素の名前を変更でき、その場合、自動的に列の名前が変更されます。

5. （オプション）テーブルのページ付けをするカスタム値を指定するには、以下の手順に従います。
   1. テーブル要素の［ページ サイズ］属性の値を指定します。
   2. 必要に応じて以下のいずれかを行います。
      • API プラグインの場合、並べ替えおよびページ付けのパラメータを設定します。
      • レポート データ オブジェクトの場合、追加の手順は必要ありません。
6. （API プラグインの場合のみ）以下の手順を実行して、ユーザがテーブルに返される結果を並べ替えられるようにします。
   1. テーブル要素の［並べ替え可能］属性に True の値を指定します。
   2. 並べ替えおよびページ付けのパラメータを設定します。

   注： 並べ替えはレポート データ オブジェクトに適用されません。

7. 以下の属性のいずれかまたはすべてを追加指定します。
   • HTML 属性
   • テーブル用のみの属性
   • テーブル専用の JavaScript 関数

動的テーブルが設定されました。