配置自动化表单转换服务

此帮助描述AEM管理员如何配置自动化Forms转换服务，以自动将PDF forms转换为自适应表单。 此帮助适用于您所在组织的IT和AEM管理员。 提供的信息基于以下假设：阅读本帮助的任何人都熟悉以下技术：

  • 安装、配置和管理Adobe Experience Manager和AEM包，

  • 使用Linux和Microsoft Windows操作系统，

  • 配置SMTP邮件服务器

入门

AEM 6.4 Forms 和 AEM 6.5 Forms 本地部署客户和 Adobe Managed Service 企业客户可免费使用此服务。欲访问服务，请联系 Adobe 销售团队或 Adobe 代表。

Adobe 可为贵企业开启访问通道，并为您指定的管理员提供各种所需权限。 管理员可以向贵企业的 AEM Forms 开发人员（用户）授予权限并连接到该服务。

前提条件

您需要以下各项才能使用自动化Forms转化服务：

  • 您的组织启用了自动化Forms转化服务
  • 具有转换服务管理员权限的Adobe ID帐户
  • 使用最新的AEM Service Pack启动并运行AEM 6.4或AEM 6.5作者实例
  • AEM用户(在AEM实例上)，它是表单用户组的成员

Set up the environment

在使用服务之前，请准备AEM作者实例以连接到在Adobe云上运行的服务。 在列出的序列中执行以下步骤，为服务准备实例：

  1. 下载并安装AEM 6.4或AEM 6.5
  2. 下载并安装最新的AEM Service Pack
  3. 下载并安装最新的AEM Forms加载项包
  4. （可选）下 载和安装最新的连接器包
  5. 创建自定义主题和模板

下载并安装AEM 6.4或AEM 6.5

自动化Forms转换服务在AEM作者实例上运行。 您需要AEM 6.4或AEM 6.5来设置AEM作者实例。 如果您没有AEM并且正在运行，请从以下位置下载它：

  • 如果您是现有的AEM客户，请从Adobe许可网站下载AEM 6.4或AEM 6.5。

  • 如果您是Adobe合作伙伴，请使 用Adobe合作伙伴培 训项目，请求AEM 6.4或AEM 6.5。

下载AEM后，有关设置AEM作者实例的说明，请参阅部署 和维护。

下载并安装AEM最新Service Pack

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

下载并安装AEM Forms加载项包

AEM实例包含基本表单功能。 转换服务需要AEM Forms的完整功能。 下载并安装AEM Forms加载项包以利用AEM Forms的所有功能。 设置和运行转换服务时需要包。 有关详细说明，请参 阅安装和配置数据捕获功能。

注意

确保在安装加载项包后执行强制安装后配置。

（可选）下载和安装连接器包

连接器包提供对AFC-2020. 03.1版中提供的自动检测逻辑部分功能和改进的早期访问 。如果您不需要AFC-2020.03.1中提供的功能和改进，请不要安装包。您可以从AEM包 共享下载连接器包。

创建自定义主题和模板

如果您在生产模 式(nosamplecontent runmode)中开始AEM，则不会安装引用包。 引用包包含示例主题和模板。 自动化Forms转换服务至少需要一个主题和一个模板，以便将PDF forms转换为自适应表单。 在使用服务之前，创建您自己的和点服务配 置的自定 义主题和模板，以使用自定义模板和主题。

配置服务

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

  • 管理员:管理员负责管理组织的Adobe软件和服务。 管理员授予组织中的开发人员访问权限，以连接到在Adobe云上运行的自动Forms转换服务。 为组织设置管理员后，管理员会收到一封带有标题的电子邮件 ‘You now have administrator rights to manage Adobe software and services for your organization’。 如果您是管理员，请检查邮箱中是否有上述标题的电子邮件，然后继 续向组织的开发人员授予访问权限。

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

  • 开发人员:开发人员将本地AEM Forms作者实例连接到运行在Adobe云上的自动Forms转换服务。 当管理员授予开发人员连接自动化Forms转换服务的权限时，将向开发人员发送一封电子邮件，其标题为您现在拥有开发人员访问权限以管理组织的AdobeAPI集成。 如果您是开发人员，请检查邮箱中是否有上述标题的电子邮件，然 后继续将您的本地AEM实例连接到Adobe云上的自动化Forms转换服务。

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

（仅适用于管理员）向组织的开发人员授予访问权限

在Adobe为您的组织启用访问权限并向管理员提供所需权限后，管理员可以登录Admin Console（下面的详细说明）、创建用户档案并将开发人员添加到用户档案。 开发人员可以将AEM Forms的本地实例连接到Adobe云上的自动化Forms转换服务。

开发人员是您组织中指定用于运行转换服务的成员。 只有添加到Adobe自动化Forms转换服务用户档案的开发人员才有权使用自动化Forms转换服务。 请执行以下步骤来创建用户档案并向其添加开发人员。 至少需要一个用户档案才能授予组织开发人员所需的访问权限：

  1. 登录 Admin Console。 使用 Adobe ID (为使用自动Forms转换服务而提供)管理员登录。 不要使用任何其他ID或Federated ID登录。

  2. 单击选 Automated Forms Conversion 项。

  3. 单击 New Profile 选项卡 Products 中的。

  4. 指 Name​定 Display Name、和 Description 用户档案。 单击 Done. 将创建用户档案。

    指定新用户档案的详细信息。

  5. 将开发人员添加到用户档案。 要添加开发人员，请执行以下操作：

    1. 在Admin Console 中，导航到概述选项卡。
    2. 单击 Assign Developers 所需的产品卡。
    3. 输入开发人员的电子邮件地址以及（可选）名字和姓氏。
    4. 选择产品用户档案。 点按 Save.

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

管理员将开发人员添加到AdobeI/O用户档案后，将通过电子邮件通知开发人员。 在收到电子邮件后，开发人员可以继 续将本地AEM Forms实例与Adobe云上的自动Forms转换服务连接。

（仅适用于开发人员）将您的本地AEM Forms实例连接到Adobe云上的自动Forms转换服务

管理员为您提供开发人员访问权限后，您可以将您的本地AEM Forms实例连接到在Adobe云上运行的自动Forms转换服务。 在列出的序列中执行以下步骤，将您的AEM Forms实例连接到服务：

配置电子邮件通知

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

  1. 转至AEM configuration manager，网址为 http://localhost:4502/system/console/configMgr

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

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

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

将用户添加到表单用户组

在指定用于运行服务的AEM用户的用户档案中指定电子邮件地址。 确保用户是表单用户组 的成员 。 电子邮件会发送到运行转换的用户的电子邮件地址。 要为用户指定电子邮件地址并将用户添加到表单用户组：

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

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

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

  4. Tap the Groups tab. 在“选择用户组”选项卡中，键入并 选择表单用户组 。 点按 保存并关闭。 用户现在是表单用户组的成员。

获取公共证书

公共证书允许您在AdobeI/O上验证用户档案。

  1. 登录您的AEM Forms作者实例。 导航至 Tools> Security > Adobe IMS Configurations. 点按 Create. 将显 Adobe IMS Technical Account Configuration 示页面。

    “AdobeIMS技术帐户配置”页

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

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

  4. 点 Download Public Key 击并在 您的计算机上保存AEM- Adobe-IMS.crt证书文件。 证书文件用于在Adobe 开发者控制台上配置服务API。 点按 Next.

  5. 指定以下内容：

    现在将其他字段留空（稍后提供）。 保持页面打开。

在Adobe开发者控制台上配置服务API

要使用自动Forms转换服务，请创建一个项目，并在Adobe开发者控制台上将自动Forms配置服务API添加到该项目。 集成会生成API密钥、客户端机密、有效负荷(JWT)。

  1. 登录 https://console.adobe.io/。 使用您的Adobe ID（您的管理员已设置的开发者帐户）登录AdobeI/O控制台以登录。

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

  3. 点按 Create new project. 此时会显示一个开始处理新项目的屏幕。 点按 Add API. 此时会出现一个屏幕，其中列表了您的帐户启用的所有API。

  4. 选择 Automated Forms Conversion service 并点按 Next。 此时会出现一个用于配置API的屏幕。

  5. 选择选 Upload your public key 项，上传下载到“Obtain Public Certificates（获取公共证书）”部分的AEM- Adobe-IMS .crt文件并点 Next​击。 将出现“Create a new Service Account(JWT)(创建新服务帐户(JWT))”凭据选项。 点按 Next.

  6. 选择产品用户档案并点按 Save configured API。 选择在授予组织的 开发人员访问权限时创建的用户档案。 如果您不知道要选择的用户档案，请与管理员联系。

  7. 点 Service Account (JWT) 击以视图API密钥、客户端机密和将您的本地AEM实例连接到自动化Forms转换服务所需的其他信息。 页面上的信息用于在本地机器上创建IMS配置。

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

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

  9. 在“AdobeIMS技术”页上，指定API密钥和客户端机密。 使用在Adobe开发者控制台页面的服务帐户(JWT)上指定的值。

    注意

    对于有效负荷，请使用Adobe开发者控制台的服务帐户(JWT)页面的“生成JWT”选项卡中提供的代码。

  10. 点按 Save. 将创建IMS配置。

    注意

    仅创建一个IMS配置。 请勿创建多个IMS配置。

  11. 选择IMS配置并点按 Check Health。 将显示一个对话框。点按 Check. 成功连接时，将显示​已成功检索令牌​消息。

    成功连接时，将显示标记检索成功的消息。



Configure the cloud service

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

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

  2. 点按文 Global 件夹并点 Create​按。 将显示用于创建自动化Forms转换配置的页面。 配置在全局文件夹中创建。 您还可以在已存在的其他文件夹中创建配置，或为配置创建新文件夹。

  3. 在页面 Create Automated Forms Conversion Configuration 上，指定以下字段的值并点按 Next。

    字段 描述
    标题 配置的唯一标题。 标题显示在用于开始转换的UI中。
    名称 配置的唯一名称。 配置将使用指定的名称保存在CRX-Repository中。 名称可以与标题相同。
    缩略图位置 配置的缩略图位置。
    服务 URL Adobe云上的自动Forms转换服务URL。 使用 https://aemformsconversion.adobe.io/ URL。
    模板 要应用于转换表单的默认模板。 在开始转换之前，您始终可以指定不同的模板。 模板包含自适应表单的基本结构和初始内容。 您可以从现成的模板中选择模板。 您还可以创建自定义模板。
    主题 要应用于转换表单的默认主题。 在开始转换之前，您始终可以指定不同的主题。 您可以单击该图标以选择现成的主题。 您还可以创建自定义主题。
    现有片段 现有片段的位置（如果有）。
    自定义元模型 自定义元模型的。模式.json文件的路径。

  4. 在页面 Advanced 的选项卡 Create Automated Forms Conversion Configuration 中，指定以下字段的值：

    字段 描述
    生成记录文档 选择选项，为转换的表单自动生成记录文档。 此选项仅适用于基于XFA的表单(XDP和PDF forms)。 启用此选项后，在提交表单后，您可以允许客户以打印或文档格式记录他们在表单中填写的信息，以供将来参考。 这称为记录文档。
    启用 Analytics 选择该选项，在所有转换的表单上启用Adobe Analytics。 在使用该选项之前，请确保为您的AEM Forms实例启用Adobe Analytics。
    • 当源是扩展名为。XDP的基于XFA的表单时，输出DOR将保留XFA布局，否则转换服务将使用现成的模板为其他基于XFA的表单生成DOR。
    • 提交XFA表单时，表单的提交数据将保存为XML元素或属性。 For example, <Amount currency="USD"> 10.00 </Amount>. 货币将保存为属性和货币金额，10.00将保存为元素。 自适应表单的提交数据没有属性，它只有元素。 因此，当基于XFA的表单转换为自适应表单时，自适应表单提交数据包含每个此类属性的元素。 例如，
       {
      "Type": "Principal",

      "Amount": "10.00",

      "currency": "USD"
   }

  5. 点按 Create. 将创建云配置。您的AEM Forms实例已准备好开始将旧表单转换为自适应表单。

在此页面上