使用表单设计器 › 如何创建、自定义和使用表单 › 表单的元素 › 如何创建动态表 › 创建动态表

创建动态表

您可以创建动态表，以便将来自报告数据对象的结构化数据输入到表单。

遵循这些步骤:

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 插件会运行并返回您指定的数据。

至此，您就完成了动态表的创建。 下一步，您需要配置该表。