创建表单数据模型

数据集成

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

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

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

注意

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

创建表单数据模型

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

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

  2. 点按 创建>表单数据模型.

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

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

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

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

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

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

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

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

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

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

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

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

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

更新数据源

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

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

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

    更新源 选项卡:

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

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

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

    • 要删除现有数据源,请点按 删除 图标。 如果在表单数据模型中添加了数据源中的数据模型对象,则“删除”图标将被禁用。

      fdm-properties

  3. 点按 保存并关闭 以保存更新。

注意

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

特定运行模式的上下文感知配置

表单数据模型 利用 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. 要根据runmode更改密码值,可以使用创建密码变量 cloud manager API 之后可在以下位置引用: OSGi配置.
        当通过CM管道部署此原型项目时,覆盖将在不同的环境(或运行模式)中提供不同的值。
      注意

      Adobe Managed Service 用户可以使用加密支持对密码值进行加密(有关详细信息,请参阅 对配置属性的加密支持 并将加密的文本放在值之后 上下文感知配置在service pack 6.5.13.0中可用.

  5. 使用选项刷新数据源定义,以刷新 表单数据模型编辑器 以通过FDM UI刷新FDM缓存并获取最新配置。

后续步骤

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

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

在此页面上