创建表单数据模型 create-form-data-model

版本
文章链接
AEM 6.5
单击此处
AEM as a Cloud Service
本文

数据集成

Experience Manager Forms 数据集成提供了一个直观的用户界面,用于创建和使用表单数据模型。 表单数据模型依赖于数据源进行数据交换;但是,您可以创建具有或不具有数据源的表单数据模型。 根据您是否配置了数据源,可使用两种方法从数据模型创建:

  • 使用预配置的数据源:如果您已按照中的说明配置数据源 配置数据源,您可以在创建表单数据模型时选择它们。 它提供选定数据源中的所有数据模型对象、属性和服务,可用于表单数据模型。

  • 无数据源:如果尚未为表单数据模型配置数据源,则仍可以创建它而不使用数据源。 您可以使用表单数据模型创作自适应Forms 并使用样本数据进行测试。 当数据源可用时,您可以将表单数据模型与数据源绑定,数据源会自动反映在关联的自适应Forms中.

NOTE
您必须同时是这两个角色的成员 fdm-authorforms-user 组才能创建和使用表单数据模型。 联系 Experience Manager 管理员以成为组的成员。

创建表单数据模型 data-sources

请确保已配置要在表单数据模型中使用的数据源,如中所述 配置数据源. 执行以下操作以基于配置的数据源创建表单数据模型:

  1. 在 Experience Manager 创作实例,导航到 Forms >数据集成.

  2. 选择 创建>表单数据模型.

  3. 在创建表单数据模型对话框中:

    • 指定表单数据模型的名称。
    • (可选)指定表单数据模型的标题、描述和标记。
    • (可选,并且仅在配置了数据源时适用)选择旁边的勾号图标 数据源配置 字段并选择您要使用的数据源的云服务所在的配置节点。 它将在下一页上可供选择的数据源列表限制为所选配置节点中的可用数据源列表。 但是,任何 Experience Manager 默认情况下,会列出用户配置文件数据源。 如果不选择配置节点,则会列出所有配置节点的数据源。
  4. 选择​ 下一步

  5. (仅在配置了数据源时适用) 选择数据源 屏幕列出了可用的数据源(如果有)。 选择要在表单数据模型中使用的数据源。

  6. 选择 创建 在确认对话框中,选择 打开 以打开表单数据模型编辑器。

    让我们查看表单数据模型编辑器UI的不同组件。

    具有三个数据源的表单数据模型 — RESTful服务, Experience Manager 用户配置文件和RDBMS

    答: 数据源 列出表单数据模型中的数据源。 展开数据源以查看其数据模型对象和服务。

    B. 刷新数据源定义 从配置的数据源中获取数据源定义中的任何更改,并在表单数据模型编辑器的“数据源”选项卡中更新它们。

    C. 模型 显示添加的数据模型对象的内容区域。

    D. 服务 显示添加的数据源操作或服务的内容区域。

    E. 工具栏 用于处理表单数据模型的工具。 工具栏根据表单数据模型中选定的对象显示更多选项。

    F. 添加选定项 将选定的数据模型对象和服务添加到表单数据模型。

有关表单数据模型编辑器以及如何使用它来编辑和配置表单数据模型的更多信息,请参阅 使用表单数据模型.

更新数据源 update

执行以下操作以将数据源添加或更新到现有表单数据模型。

  1. 转到 Forms >数据集成,选择要添加或更新数据源的表单数据模型,然后选择 属性.

  2. 在表单数据模型属性中,转到 更新源 选项卡。

    更新源 选项卡:

    • 选择中的浏览图标 上下文感知配置 字段并选择配置节点,您要添加的数据源的云配置驻留在该配置节点上。 如果不选择节点,则仅驻留在 global 选择时列出节点 添加源.

    • 要添加新数据源,请选择 添加源 并选择要添加到表单数据模型的数据源。 在中配置的所有数据源 global 并显示选定的配置节点(如果有)。

    • 要使用相同类型的另一个数据源替换现有数据源,请选择 编辑 图标并从可用数据源列表中选择。

    • 要删除现有数据源,请选择 删除 图标来访问。 如果将数据源中的数据模型对象添加到表单数据模型中,则“删除”图标将被禁用。

      fdm-properties

  3. 选择 保存并关闭 以保存更新。

NOTE
在表单数据模型中添加新数据源或更新现有数据源后,请确保在自适应Forms中相应地更新绑定引用 使用更新后的表单数据模型的用户。

特定运行模式的上下文感知配置 runmode-specific-context-aware-config

表单数据模型 利用 Sling上下文感知配置 支持不同的数据源参数以连接不同的数据源 Experience Manager 运行模式。

时间 表单数据模型 使用云配置来存储参数,当通过源代码管理(Cloud-Manager GIT存储库)签入和部署这些参数时,将使用所有运行模式(开发、暂存和生产)的相同参数创建云配置。 但是,对于测试和生产环境需要拥有不同数据集的用例,我们使用数据源参数(例如,数据源URL)作为不同的 Experience Manager 运行模式。

要实现此目的,您需要创建包含数据源参数 — 值对的OSGi配置。 这将覆盖来自的相同对 表单数据模型 运行时云配置。 由于OSGi配置默认支持这些运行模式,因此您可以根据运行模式将数据源参数覆盖为不同的值。

在中启用特定于部署的云配置 表单数据模型:

  1. 在本地开发实例上创建云配置。 有关详细步骤,请参阅 如何配置数据源.

  2. 将云配置存储到文件系统。

    1. 使用过滤器创建包 /conf/{foldername}/settings/cloudconfigs/fdm. 使用相同的 {foldername} 与步骤1中一样。 和替换 fdm 替换为 azurestorage 用于Azure存储配置。
    2. 生成并下载包。 有关详细信息,请参阅 包操作.
  3. 在中集成云配置 Experience Manager 原型项目。

    1. 解压缩下载的包。
    2. 复制 jcr_root 文件夹并将其放在 ui.content > src > main > content.
    3. 更新 ui.content > src > main > content > META-INF > vault > filter.xml 以包含过滤器 /conf/{foldername}/settings/cloudconfigs/fdm. 有关详细信息,请参阅 AEM项目原型的ui.content模块. 当通过CM管道部署此原型项目时,将在所有环境(或运行模式)上安装相同的云配置。 要根据环境更改云配置的字段(如URL)值,请使用以下步骤中讨论的OSGi配置。
  4. 创建Apache Sling上下文感知配置。 要创建OSGi配置,请执行以下操作:

    1. 在中设置OSGi配置文件 Experience Manager 原型项目。
      创建具有PID的OSGi工厂配置文件 org.apache.sling.caconfig.impl.override.OsgiConfigurationOverrideProvider. 在每个运行模式文件夹下创建同名文件,其中每个运行模式需要更改值。 有关详细信息,请参阅 为配置OSGi Adobe Experience Manager.

    2. 设置OSGI配置json。 要使用Apache Sling上下文感知配置覆盖提供程序,请执行以下操作:

      1. 在本地开发实例上 /system/console/configMgr,选择名为的工厂OSGi配置 Apache Sling上下文感知配置覆盖提供程序: OSGi配置.
      2. 提供描述。
      3. 选择 已启用.
      4. 在覆盖下,根据sling覆盖语法中的环境,提供需要更改的字段。 有关详细信息,请参阅 Apache Sling上下文感知配置 — 覆盖. 例如, cloudconfigs/fdm/{configName}/url="newURL".
        通过选择可添加多个覆盖 +.
      5. 选择​ 保存
      6. 要获取OSGi配置JSON,请执行以下步骤 使用AEM SDK快速入门生成OSGi配置.
      7. 将JSON放置在上一步中创建的OSGi工厂配置文件中。
      8. 更改的值 newURL 基于环境(或运行模式)。
      9. 要根据运行模式更改密码值,可以使用创建密码变量 cloud manager API 稍后可在 OSGi配置.
        当通过CM管道部署此原型项目时,覆盖将在不同的环境(或运行模式)中提供不同的值。
      note note
      NOTE
      Adobe Managed Service 用户可以使用加密支持对密码值进行加密(有关详细信息,请参阅 对配置属性的加密支持 并将加密的文本放在值之后 上下文感知配置在Service Pack 6.5.13.0中可用.
  5. 使用选项刷新数据源定义,以刷新 表单数据模型编辑器 以通过FDM UI刷新FDM缓存并获取最新配置。

后续步骤 next-steps

现在,您拥有一个添加了数据源的表单数据模型。 接下来,可以编辑表单数据模型以添加和配置数据模型对象和服务,添加数据模型对象之间的关联,编辑属性,添加自定义数据模型对象和属性,生成示例数据,等等。

有关更多信息,请参阅 使用表单数据模型.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab