Show Menu
主题×

配置自动化表单转换服务

此帮助描述AEM管理员如何配置自动表单转换服务以自动将其PDF表单转换为自适应表单。 此帮助适用于您组织的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 开发人员(用户)授予权限并连接到该服务。

前提条件

您需要以下各项才能使用自动表单转换服务:
  • 您的组织启用了自动表单转换服务
  • 具有转换服务管理员权限的Adobe ID帐户
  • 包含最新AEM Service Pack的正在运行的AEM 6.4或AEM 6.5作者实例
  • AEM用户(在AEM实例上),它是表单用户组的成员

Set up the environment

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

下载并安装AEM 6.4或AEM 6.5

自动表单转换服务在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包共享下载连接器包

创建自定义主题和模板

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

配置服务

在您继续配置服务并将本地实例与Adobe Cloud上运行的服务连接之前,请了解连接到服务所需的角色和权限。 该服务使用两种不同类型的角色,管理员和开发人员:
  • 管理员 : 管理员负责管理组织的Adobe软件和服务。 管理员授予组织内的开发人员访问权限,以便连接到Adobe Cloud上运行的自动表单转换服务。 为组织设置管理员后,管理员会收到一封带有标题的电子邮件 'You now have administrator rights to manage Adobe software and services for your organization' 。 如果您是管理员,请检查邮箱中是否有上述标题的电子邮件,然后继 续向组织的开发人员授予访问权限
  • 开发人员 : 开发人员将本地AEM Forms作者实例连接到在Adobe Cloud上运行的自动表单转换服务。 当管理员授予开发人员连接自动表单转换服务的权限时,将向开发人员发送一封电子邮件,其标题为您现在拥有开发人员访问权限以管理您组织的Adobe API集成。 如果您是开发人员,请检查邮箱中是否有前述标题的电子邮件,然后 继续将您的本地AEM实例连接到Adobe Cloud上的自动表单转换服务。

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

在Adobe为您的组织启用访问权限并向管理员提供所需权限后,管理员可登录Admin Console(详细说明如下)、创建用户档案并向用户档案添加开发人员。 开发人员可以将AEM Forms的本地实例连接到Adobe Cloud上的自动表单转换服务。
开发人员是您组织中指定用于运行转换服务的成员。 只有添加到Adobe自动表单转换服务用户档案的开发人员才有权使用自动表单转换服务。 执行以下步骤以创建用户档案并向其添加开发人员:
  1. 登录到 Admin Console 。 使用 为使用 Automated Forms Conversion服务提供的管理员的Adobe ID。 请勿使用任何其他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 .
为所有用户重复上述步骤。 有关添加开发人员的更多详细信息,请参 阅管理开发人员
管理员将开发人员添加到Adobe I/O用户档案后,开发人员会通过电子邮件收到通知。 收到电子邮件后,开发人员可以继 续在Adobe Cloud上连接本地AEM Forms实例和自动表单转换服务

(仅适用于开发人员)将您的本地AEM Forms实例连接到Adobe Cloud上的自动表单转换服务

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

配置电子邮件通知

自动表单转换服务使用Day CQ邮件服务发送电子邮件通知。 这些电子邮件通知包含有关转换成功或失败的信息。 如果选择不接收通知,请跳过这些步骤。 执行以下步骤配置Day CQ邮件服务:
  1. 转到AEM配置管理器,网址为 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. 在“选择用户组”选项卡中,键入并 选择表单用户组 。 点按 保存并关闭 。 用户现在是表单用户组的成员。

获取公共证书

公共证书允许您在Adobe I/O上验证用户档案。
  1. 登录到AEM Forms作者实例。 导航至 Tools > Security > Adobe IMS Configurations . 点按 Create . 将显 Adobe IMS Technical Account Configuration 示页面。
  2. 在云解 Automated Forms Conversion Service 决方案中选择。
  3. 选中复 Create new certificate 选框并指定别名。 别名将用作对话框的名称。点按 Create certificate . 将显示一个对话框。单击 OK . 将创建证书。
  4. Download Public Key 击并在 您的计算机上保存AEM-Adobe-IMS .crt证书文件。 证书文件用于在Adobe Devloper Console上配置服务API 。 点按 Next .
  5. 指定以下内容:
    现在将其他字段留空(稍后提供)。 保持页面打开。

在Adobe Devloper Console上配置服务API

要使用自动表单转换服务,请在Adobe开发人员控制台上创建一个项目并将自动表单配置服务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实例连接到自动表单转换服务所需的其他信息。 页面上的信息用于在本地机器上创建IMS配置。
  8. 打开本地实例上的“IMS配置”页。 保持打开该页面 获取公共证书 的结尾部分。
  9. 在Adobe IMS技术页上,指定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 ​按。 此时将显示用于创建自动表单转换配置的页面。 配置在全局文件夹中创建。 您还可以在已存在的其他文件夹中创建配置,或为配置创建新文件夹。
  3. 在页面 Create Automated Forms Conversion Configuration 上,指定以下字段的值并点按 Next
    字段
    描述
    标题
    配置的唯一标题。 标题显示在用于开始转换的UI中。
    名称
    配置的唯一名称。 配置将以指定的名称保存在CRX-Repository中。 名称可以与标题相同。
    缩略图位置
    配置的缩略图位置。
    服务 URL
    Adobe Cloud上的自动表单转换服务的URL。 使用 https://aemformsconversion.adobe.io/ URL。
    模板
    要应用于转换表单的默认模板。 在开始转换之前,您始终可以指定不同的模板。 模板包含自适应表单的基本结构和初始内容。 您可以从现成的模板中选择模板。 您还可以创建自定义模板。
    主题
    要应用于转换表单的默认主题。 在开始转换之前,您始终可以指定不同的主题。 您可以单击该图标以选择现成的主题。 您还可以创建自定义主题。
    现有片段
    现有片段的位置(如果有)。
    自定义元模型
    自定义元模型的。模式.json文件的路径。
  4. 在页面 Advanced 的选项卡 Create Automated Forms Conversion Configuration 中,指定以下字段的值:
    字段 描述
    生成记录文档 选择选项,为转换的表单自动生成记录文档。 此选项仅适用于基于XFA的表单(XDP和PDF表单)。 启用此选项后,在提交表单后,您可以允许客户以打印或文档格式记录他们在表单中填写的信息,以供将来参考。 这称为记录文档。
    启用 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实例可以开始将旧版表单转换为自适应表单。