配置自动化表单转换服务

本帮助描述AEM管理员如何配置Automated forms conversion服务,以自动将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 开发人员(用户)授予权限并连接到该服务。

前提条件

您需要以下各项才能使用Automated forms conversion服务:

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

设置环境

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

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

下载并安装AEM 6.4或AEM 6.5

automated forms conversion服务在AEM作者实例上运行。 您需要AEM 6.4或AEM 6.5来设置AEM作者实例。 如果您没有AEM并且正在运行,请从以下位置下载它:

下载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包中下载连接器包。share](https://www.adobeaemcloud.com/content/marketplace/marketplaceProxy.html?packagePath=/content/companies/public/adobe/packages/cq650/featurepack/AFCS-Connector-2020.03.1)。[

创建自定义主题和模板

如果您在生产模式(nosamplecontent运行模式)中开始AEM,则不会安装引用包。 引用包包含示例主题和模板。 automated forms conversion服务需要至少一个主题和一个模板来将PDF forms转换为自适应表单。 创建您自己的自定义主题和模板,并指向服务配置以在使用服务之前使用自定义模板和主题。

配置服务

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

  • 管理员:管理员负责管理组织的Adobe软件和服务。管理员授予组织中的开发人员访问权限,以连接到在Automated forms conversion云上运行的Adobe服务。 为组织设置管理员后,管理员将收到一封标题为​’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服务。

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

(仅限管理员)授予组织的开发人员访问权限

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

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

  1. 登录Admin Console。 使用配置为使用Automated forms conversion服务登录的管理员的​Adobe ID。 不要使用任何其他ID或Federated ID登录。

  2. 单击​Automated Forms Conversion​选项。

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

  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服务

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

配置电子邮件通知

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

  1. 转到位于http://localhost:4502/system/console/configMgr的AEM configuration manager

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

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

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

将用户添加到表单用户组

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

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

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

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

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

获取公共证书

公共证书允许您在Adobe I/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

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

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

  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。 将出现“Create a new Service Account(JWT)(创建新服务帐户(JWT))”凭据选项。 点按 Next.

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

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

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

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

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

    注意

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

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

    注意

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

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

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



配置云服务

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

  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

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

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

在此页面上

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free