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

動的テーブルの作成

動的テーブルを作成して、構造化されたデータをレポート データ オブジェクトからフォームに取り込むことができます。

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

1. 動的テーブルへの入力に使用するレポート データ オブジェクトまたは API プラグインを作成または編集します。
2. レポート データ オブジェクトまたは API プラグインの変数によって返されるデータは、テーブルの列に要求されているフォーマットと一致する必要があることに注意してください。 そうなっていない場合は、リクエストでフォームを開くときデータはユーザに表示されません。 これについては後の手順で、さらに詳しく説明します。
3. テーブルの追加に使用するフォームを編集または作成します。 フォームを展開します。
4. 以下の手順に従って、フォームにテーブル要素を追加します。
   1. （オプション）テーブルを含むフィールド セットを作成します。
   2. ［システム］フォルダを展開して、テーブル要素をドラッグし、フォームにドロップします。 必要に応じて、前の手順で作成したフィールド セット上にテーブルをドロップします。
   3. テーブルの _id 値を指定し、フォームを保存します。
5. 以下の手順に従って、テーブルにレポート データ オブジェクトまたは API プラグインを追加します。
   1. ［テーブル］要素を選択します。

      テーブル要素の属性が表示されます。

   2. API プラグインを使用している場合は、以下の属性の値を指定します。
      • レポート/プラグイン ID： 使用する API プラグインの ID を入力します。 ［管理］-［ツール］-［プラグイン］ページで、これらの属性の値を検索できます。 そのページから使用するプラグインの ID をコピーし、レポート/プラグイン ID の属性値にそれを貼り付けます。
      • レポート/プラグイン変数： 適用可能な場合、変数を含めて、その詳細を表示するために選択した API プラグインを開きます。 ［詳細］ページの［入力］セクションに、プラグインの ID 値と入力変数の説明が一覧表示されます。 そのページから使用する変数の ID をコピーし、レポート/プラグイン変数の属性値に貼り付けます。
   3. レポート データ オブジェクトを使用している場合は、以下の属性の値を指定します。
      • レポート/プラグイン ID： 使用するレポート データ オブジェクトの ID を入力します。 ［管理］-［レポート ビルダ］-［データ オブジェクト］ページでこれらの属性の値を検索できます。 そのプロパティを表示するレポート データ オブジェクトの［編集］アイコンをクリックします。 そのページからレポート データ オブジェクトの ID をコピーし、レポート/プラグイン ID の属性値にそれを貼り付けます。
      • レポート/プラグイン変数： 適用可能な場合、選択したレポート データ オブジェクトの［編集］アイコンをクリックして、変数を含むそのプロパティを表示します。 ［プロパティ］ページで、レポート データ オブジェクトの入力変数は以下のように表示されます。

        クエリの場合： 入力変数は %expression% ステートメントとして表示されます。

        プラグインの場合： 入力変数は［引数］フィールドに表示されます。

        CSV の場合： 入力変数は適用されません。

        そのページから使用する変数をコピーし、レポート/プラグイン変数の属性値に貼り付けます。

      両方の属性については、たとえば、JSON 式として以下のように変数を入力します。

      	$({'<variable name>' : '<variable value>', ...})
      

      	$({'userid':_.user.id,'rm_orgunit':ca_fdGetSelectedOptionValues(ca_fd.formId,'orgunit_id')})
      

      重要： 変数の指定には注意が必要です。 変数を指定しない場合には、予測できない結果を生じることがあります。

   4. フォームを保存します。

   ユーザがサービスのリクエストでこのフォームに入力した場合、レポート データ オブジェクトまたは API プラグインによって、指定したデータが実行し返されます。

動的テーブルが作成されました。 次に、それを設定します。