配置自动化表单转换服务 about-this-help

此帮助介绍AEM管理员如何配置Automated forms conversion服务以自动将其PDF forms转换为自适应表单。 此帮助适用于贵组织的IT和AEM管理员。 所提供的信息基于这样一种假设,即任何阅读本“帮助”的人都熟悉以下技术:

  • 安装、配置和管理Adobe Experience Manager和AEM软件包,

  • 使用Linux®和Microsoft® Windows®操作系统,

  • 配置SMTP邮件服务器

入门培训 onboarding

AEM 6.4 Forms和AEM 6.5 Forms内部部署定期客户和Adobe托管服务企业客户可免费使用该服务。 欲访问服务,请联系 Adobe 销售团队或 Adobe 代表。AEM Formsas a Cloud Service客户也可以免费获取并预启用该服务。

Adobe 可为您的组织开启访问渠道,并为您指定为组织中管理员的人员提供所需的权限。管理员可以向贵企业的 AEM Forms 开发人员(用户)授予权限并连接到该服务。

前提条件 prerequisites

要使用Automated forms conversion服务,您需要满足以下条件:

  • 已为贵组织启用Automated forms conversion服务
  • 具有转换服务管理员权限的Adobe ID帐户
  • 已启动且正在运行的AEM 6.4、AEM 6.5或AEM Formsas a Cloud Service创作实例,其中包含最新的AEM Service Pack或最新更新。
  • 作为forms-user组成员的AEM用户(在您的AEM实例上)

设置环境 setuptheservice

在使用服务之前,请准备AEM创作实例以连接到Adobe云上运行的服务。 按照列出的顺序执行以下步骤,为服务准备实例:

下载并安装AEM 6.4、AEM 6.5或板载AEM Formsas a Cloud Service aemquickstart

automated forms conversion服务在AEM创作实例上运行。 您需要AEM 6.4、AEM 6.5或AEM Formsas a Cloud Service才能设置AEM创作实例。

(仅适用于AEM 6.4和AEM 6.5)下载并安装AEM最新版Service Pack servicepack

下载并安装最新的AEM Service Pack。 有关详细说明,请参阅或 AEM 6.4 Service Pack发行说明AEM 6.5 Service Pack发行说明.

(仅适用于AEM 6.4和AEM 6.5)下载并安装AEM Forms附加组件包 downloadaemformsaddon

AEM实例包含基本表单功能。 转换服务需要AEM Forms的全部功能。 下载并安装AEM Forms附加组件包以使用AEM Forms的所有功能。 设置和运行转换服务需要该包。 有关详细说明,请参阅 安装和配置数据捕获功能。

NOTE
请确保在安装附加组件包后执行强制安装后配置。

创建自定义主题和模板 referencepackage

如果您在启动AEM 6.4或AEM 6.5 生产模式 (nosamplecontent运行模式),未安装引用包。 参考包包含示例主题和模板。 automated forms conversion服务需要至少一个主题和一个模板,才能将PDF表单转换为自适应表单。 创建自己的自定义主题和模板及点 服务配置 以在使用服务之前使用自定义模板和主题。

您还可以下载并安装 AEM Forms参考资源 包。 它创建了一些参考主题和模板。

配置服务 configure-the-service

在继续配置服务并将本地实例与Adobe云上运行的服务连接之前,请了解连接到服务所需的角色和权限。 该服务使用两种不同类型的角色:管理员和开发人员:

  • 管理员:管理员负责为其组织管理Adobe软件和服务。 管理员向组织中的开发人员授予访问权限,以连接到在Adobe云上运行的Automated forms conversion服务。 为组织配置管理员后,管理员会收到一封包含标题的电子邮件 ‘You now have administrator rights to manage Adobe software and services for your organization’. 如果您是管理员,请检查您的邮箱中是否有包含前面提到的标题的电子邮件,然后继续 向组织的开发人员授予访问权限.

管理员访问权限授予电子邮件

  • 开发人员:开发人员将本地AEM Forms创作实例连接到Adobe云上运行的Automated forms conversion服务。 当管理员向开发人员授予连接到Automated forms conversion服务的权限时,会向开发人员发送一封电子邮件,其标题为“您现在拥有开发人员访问权限以管理组织的AdobeAPI集成”。 如果您是开发人员,请检查您的邮箱中是否有包含前面提到的标题的电子邮件,然后继续 将本地AEM实例连接到Adobe云上的Automated forms conversion服务。

开发人员访问权限授予电子邮件

(仅适用于AEM 6.4和AEM 6.5的管理员)向组织的开发人员授予访问权限 adduseranddevs

在Adobe启用对贵组织的访问并向管理员提供所需权限后,管理员可以登录Admin Console(详细说明如下)、创建配置文件并向配置文件添加开发人员。 开发人员可以将AEM Forms的本地实例连接到Adobe云上的Automated forms conversion服务。

开发人员是您指定运行转换服务的组织的成员。 只有添加到AdobeAutomated forms conversion服务配置文件的开发人员才有权使用Automated forms conversion服务。 执行以下步骤以创建配置文件并向其添加开发人员。 至少需要一个配置文件来向组织的开发人员授予所需的访问权限:

  1. 登录 Admin Console. 使用 Adobe ID 设置为使用Automated forms conversion服务登录的管理员的帐户。 请勿登录任何其他ID或Federated ID。

  2. 单击 Automated Forms Conversion 选项。

  3. 单击 New ProfileProducts 选项卡。

  4. 指定 NameDisplay Name、和 Description 用于配置文件。 单击 Done. 将创建一个配置文件。

    指定新配置文件的详细信息。

  5. 将开发人员添加到配置文件。 要添加开发人员,请执行以下操作:

    1. Admin Console,导航到概述选项卡。
    2. 单击 Assign Developers 在所需的产品卡上。
    3. 输入开发人员的电子邮件地址,以及(可选)名字和姓氏。
    4. 选择产品配置文件。 点击​ Save

对所有用户重复上述步骤。 有关添加开发人员的更多详细信息,请参阅 管理开发人员.

管理员将开发人员添加到Adobe I/O配置文件后,开发人员会通过电子邮件获得通知。 在收到电子邮件后,开发人员可以继续 将本地AEM Forms实例与Adobe云上的Automated forms conversion服务连接.

(仅适用于开发人员)将本地AEM Forms实例连接到Adobe云上的Automated forms conversion服务 connectafcadobeio

管理员为您提供开发人员访问权限后,您可以将本地AEM Forms实例连接到Adobe云上运行的Automated forms conversion服务。 按照列出的顺序执行以下步骤,将AEM Forms实例连接到服务:

配置电子邮件通知 configureemailnotification

automated forms conversion服务使用Day CQ邮件服务发送电子邮件通知。 这些电子邮件通知包含有关成功或失败的转换的信息。 如果选择不接收通知,请跳过这些步骤。 执行以下步骤来配置Day CQ邮件服务:

  • 对于AEM 6.4 Forms或AEM 6.5 Forms:

    1. 转到AEM配置管理器,网址为 http://localhost:4502/system/console/configMgr

    2. 打开Day CQ邮件服务配置。 指定值 SMTP server host nameSMTP server port、和 From address 字段。 单击 Save.

      有关SMTP服务器的主机名和端口的信息,您可以联系电子邮件服务提供商或IT管理员。 您可以在“发件人”字段中使用任何有效的电子邮件地址。 例如,notification@example.com或donotreply@example.com。

    3. 打开 Day CQ Link Externalizer 配置。 在 Domains 字段,为本地、创作和发布实例指定实际的主机名或IP地址和端口号。 单击 Save.

  • 对于AEM Formsas a Cloud Service, 记录支持票证以启用电子邮件服务.

将用户添加到forms-users组 adduserstousergroup

在指定用于运行服务的AEM用户的配置文件中指定电子邮件地址。 确保用户是 表单用户 组。 电子邮件会发送到运行转换的用户的电子邮件地址。 要为用户指定电子邮件地址并将用户添加到表单用户组,请执行以下操作:

  1. 以AEM管理员身份登录到您的AEM Forms创作实例。 使用本地AEM凭据登录。 请勿使用Adobe ID登录。 点按 Adobe Experience Manager > Tools > Security > Users.

  2. 选择指定用于运行转换服务的用户并点按 Properties. 此时将打开“编辑用户设置”页。

  3. 在中指定电子邮件地址 Email 字段并点按 Save. 成功完成转换或转换失败时,会将电子邮件发送到指定的电子邮件地址。

  4. 点按 选项卡。 在选择组选项卡中,键入并选择 forms-users 组。 点按 保存并关闭. 该用户现在是forms-users组的成员。

(仅适用于AEM 6.4和AEM 6.5)获取公共证书 obtainpubliccertificates

公共证书允许您在Adobe I/O时验证配置文件。

  1. 登录到您的AEM Forms创作实例。 导航至 Tools> Security > Adobe IMS Configurations. 点击​ Create。此 Adobe IMS Technical Account Configuration 页面。

    Adobe IMS技术帐户配置页面

  2. 选择 Automated Forms Conversion Service 在云解决方案中。

  3. 选择 Create new certificate 复选框,并指定别名。 别名将用作对话框的名称。点击​ Create certificate。将显示一个对话框。单击 OK. 已创建证书。

  4. 点按 Download Public Key 并保存 AEM-Adobe-IMS.crt 证书文件。 证书文件用于 在Adobe Developer控制台上配置服务API. 点击​ Next

  5. 指定以下内容:

    其他字段暂时留空(稍后提供)。 保持页面打开。

(仅适用于AEM 6.4和AEM 6.5)在Adobe Developer控制台上配置服务API createintegration

要使用Automated forms conversion服务,请创建一个项目,并将自动Forms配置服务API添加到Adobe Developer控制台上的项目中。 集成会生成API密钥、客户端密钥和有效负荷(JWT)。

  1. 登录 https://console.adobe.io/. 使用您的管理员配置用于登录到Adobe I/O控制台的Adobe ID开发人员帐户登录。

  2. 从右上角选择您的组织。 如果您不了解您的组织,请与管理员联系。

  3. 点击​ Create new project。此时将显示一个新项目开始使用的屏幕。 点击​ Add API。此时将显示一个屏幕,其中包含为您的帐户启用的所有API的列表。

  4. 选择 Automated Forms Conversion service 并点按 Next. 出现配置API的屏幕。

  5. 选择 Upload your public key 选项,上传在中下载的AEM-Adobe-IMS.crt文件 获取公共证书 分区并点按 Next. 此时会显示新建服务帐户(JWT)凭据选项。 点击​ Next

  6. 选择产品配置文件并点按 Save configured API. 选择在此时间创建的配置文件 向组织的开发人员授予访问权限. 如果您不知道要选择的配置文件,请联系您的管理员。

  7. 点按 Service Account (JWT) 查看API密钥、客户端密钥以及将本地AEM实例连接到Automated forms conversion服务所需的其他信息。 页面上的信息用于在本地计算机上创建IMS配置。

  8. 在本地实例上打开“IMS配置”页面。 保持打开该页面获取公共证书的结尾部分。

    指定标题、API密钥、客户端密钥和有效负载

  9. 在“Adobe IMS技术”页面上,指定API密钥和客户端密钥。 使用Adobe Developer控制台页面的服务帐户(JWT)上指定的值。

    note note
    NOTE
    对于有效负载,请使用Adobe Developer控制台的“服务帐户(JWT)”页面的“生成JWT”选项卡中提供的代码。
  10. 点击​ Save。已创建IMS配置。

    note caution
    CAUTION
    仅创建一个IMS配置。 请勿创建多个IMS配置。
  11. 选择IMS配置并点按 Check Health. 将显示一个对话框。点击​ Check。成功连接时,将显示​ 已成功检索令牌 ​消息。

    成功连接时,将显示已成功检索令牌消息。

配置Cloud Service configure-the-cloud-service

创建Cloud Service配置以将AEM实例连接到转换服务。 它还允许您为转换指定模板、主题和表单片段。 您可以为每组表单分别创建多个云服务配置。 例如,您可以为销售部门表单设置一个单独的配置,为客户支持表单设置一个单独的配置。 执行以下步骤可创建Cloud Service配置:

  1. 在您的AEM Forms实例上,点按 Adobe Experience Manager > Tools> Cloud Services > Automate Forms Conversion Configuration.

  2. 点按 Global 文件夹并点按 Create. 此时会显示创建Automated forms conversion配置的页面。 该配置在全局文件夹中创建。 您还可以在现有的不同文件夹中创建配置,或者为您的配置创建一个文件夹。

  3. Create Automated Forms Conversion Configuration 页面,为以下字段指定值并点按 Next.

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2
    字段 描述
    标题 配置的唯一标题。 标题显示在用于开始转换的UI中。
    名称 配置的唯一名称。 使用指定的名称将配置保存在CRX存储库中。 名称可以与标题相同。
    缩略图位置 配置的缩略图位置。
    服务 URL Adobe云上Automated forms conversion服务的URL。 使用 https://aemformsconversion.adobe.io/ URL。
    模板 应用于已转换表单的默认模板。 在开始转换之前,您始终可以指定其他模板。 模板包含自适应表单的基本结构和初始内容。 您可以从提供的现成模板中选择模板。 您还可以创建自定义模板。
    主题 应用于已转换表单的默认主题。 在开始转换之前,您始终可以指定不同的主题。 您可以单击图标以选择提供的现成主题。 您还可以创建自定义主题。
    现有片段 现有片段的位置(如果有)。
    自定义元模型 自定义元模型的.schema.json文件的路径。 您可以为英语、法语、德语、西班牙语、意大利语和葡萄牙语创建单独的元模型。
  4. Advanced 的选项卡 Create Automated Forms Conversion Configuration 页中,为以下字段指定值:

    table 0-row-2 1-row-2 2-row-2
    字段 描述
    生成记录文档 选择选项以自动生成已转换表单的记录文档。 该选项仅适用于基于XFA的表单(XDP和PDF forms)。 启用该选项后,在提交表单后,您可以允许客户以打印或文档格式记录他们在表单中填写的信息,以供将来参考。 这称为记录文档。
    启用 Analytics (仅适用于AEM 6.4和AEM 6.5)选择选项,以在所有已转换的表单上启用Adobe Analytics。 在使用选项之前,请确保为您的AEM Forms实例启用了Adobe Analytics。
    • 如果源是扩展名为.XDP的基于XFA的表单,则输出DOR将保留XFA布局,否则转换服务将使用现成的模板为其他XFA表单生成DOR。
    • 在提交XFA表单时,表单的提交数据将另存为XML元素或属性。 例如:<Amount currency="USD"> 10.00 </Amount>。货币另存为属性和货币金额,10.00另存为元素。 自适应表单的提交数据没有属性,只有元素。 因此,当基于XFA的表单转换为自适应表单时,自适应表单提交数据将包含每个此类属性的元素。 例如,
    code language-css
       {
          "Type": "Principal",
    
          "Amount": "10.00",
    
          "currency": "USD"
       }
    
  5. 点击​ Create。将创建云配置。您的AEM Forms实例已准备好开始将旧版表单转换为自适应表单。

recommendation-more-help
c40c2ccf-3d1b-4b47-b158-c4646051b46c