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 开发人员(用户)授予权限并连接到该服务。

前提条件

您需要满足以下条件才能使用Automated Forms Conversion Service:
  • 您的组织启用了自动表单转换服务
  • 具有转换服务管理员权限的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的所有功能。 设置和运行转换服务需要包。 有关详细说明,请参 阅安装和配置数据捕获功能。
确保在安装加载项包后执行强制安装后配置。

(可选)下载和安装连接器包

安装连接器软件包1.1.38或更高版本,以使用AFC-2020.03.1版中提供的 Auto-detect逻辑部分功能 和改进。您可以从 AEM包共享下载连接器包
如果您已安装并运行Automated Forms Conversion服务环境,则要使用转换服务的最新功能,请按上述顺序安装最新的服务包、最新的AEM Forms Add-on包和最新的连接器包。

创建自定义主题和模板

如果您在生产模 (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上的“自动表单转换”服务。 (仅限开发人员)将您的本地AEM Forms实例连接到Adobe Cloud上的自动表单转换服务

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

在Adobe为您的组织启用访问权限并向管理员提供所需权限后,管理员可以登录Admin Console(下面的详细说明),创建用户档案,并将开发人员添加到用户档案。 开发人员可以将AEM Forms的本地实例连接到Adobe Cloud上的自动表单转换服务。
开发人员是指定用于运行转换服务的组织成员。 只有添加到Adobe自动表单转换服务用户档案的开发人员才有权使用自动表单转换服务。 执行以下步骤以创建用户档案并向其添加开发人员:
  1. 登录到 Admin Console 。 使用 Adobe ID (提供管理员ID),以便使用自动表单转换服务登录。 请勿使用任何其他ID或Federated ID进行登录。
  2. 单击选 Automated Forms Conversion 项。
  3. 单击 New Profile 选项卡 Products 中的。
  4. Name ​用户档案 Display Name ​指定 Description 、和。 单击 Done . 将创建用户档案。
  5. 将开发人员添加到用户档案。 要添加开发人员,请执行以下操作:
    1. 在管理控 制台中 ,导航到概述选项卡。
    2. 单击 Assign Developers 所需的产品卡。
    3. 输入开发人员的电子邮件地址以及(可选)名和姓。
    4. 选择产品用户档案。 点按 Save .
为所有用户重复上述步骤。 有关添加开发人员的更多详细信息,请参阅 管理开发人员
管理员将开发人员添加到Adobe I/O用户档案后,开发人员会通过电子邮件收到通知。 在收到电子邮件后,开发人员可以继续将 本地AEM Forms实例与Adobe Cloud上的“自动表单转换”服务连接起来

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

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

配置电子邮件通知

自动表单转换服务使用Day CQ邮件服务发送电子邮件通知。 这些电子邮件通知包含有关成功或失败转换的信息。 如果选择不接收通知,请跳过这些步骤。 执行以下步骤以配置Day CQ Mail服务:
  1. 转到AEM配置管理器,网址为 http://localhost:4502/system/console/configMgr
  2. 打开Day CQ Mail服务配置。 指定、和字 SMTP server host name ​段 SMTP server port ​的 From address 值。 单击 Save .
    有关SMTP服务器的主机名和端口的信息,可以与电子邮件服务提供商或IT管理员联系。 您可以在发件人字段中使用任何有效的电子邮件地址。 例如,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 I/O控制台上创建集成 。 点按 Next .
  5. 指定以下内容:
    现在将其他字段留空(稍后提供)。 保持页面打开。

创建Adobe I/O集成

要使用自动表单转换服务,请在Adobe I/O中创建集成。该集成生成API密钥、客户端机密、有效负荷(JWT)。
  1. 登录 https://console.adobe.io/ 。 使用您的Adobe ID,即管理员为登录Adobe I/O控制台而提供的开发人员帐户。
  2. 点按 View Integrations . 将显示一个屏幕,其中包含所有可用的集成功能。
  3. 从下拉菜单中选择您的组织 Integrations 。 点 New Integration ​按、选 Access an API ​择和点按 Continue
  4. 选择 Experience Cloud > Automated Forms Conversion 并点按 Continue 。 如果为您禁用了“自动表单转换”选项,请确保您从选项上方的下拉框中选择了正确的组 Adobe Services 织。 如果您不了解您的组织,请与管理员联系。
  5. 指定集成的名称和说明。 点 Select a File from your computer 按并上传在“获取公共证书”部分下载的AEM-Adobe-IMS.crt 文件
  6. 选择在授予组织的开发 人员访问权限时创建的用户档案 ,然后点按 Create Integration 。 将创建集成。
  7. 点按 Continue to integration details 以视图集成信息。 该页面包含API密钥、客户端机密以及将本地AEM实例连接到自动表单转换服务所需的其他信息。 页面上的信息用于在本地计算机上创建IMS配置。
  8. 打开本地实例上的“IMS配置”页。 您在“获取公共证书”部分的结尾处保持 该页面打开
  9. 在“Adobe IMS技术”页上,指定API密钥和客户端机密。 使用在集成页面上指定的值。
    对于有效负荷,请使用集成页面的JWT选项卡中提供的代码。 点按 Save . 将创建IMS配置。 关闭集成页面。
    仅创建一个IMS配置。 请勿创建多个IMS配置。
  10. 选择IMS配置并点按 Check Health 。 将显示一个对话框。 点按 Check . 成功连接时,将显示 已成功检索的令牌 消息。

配置云服务

创建云服务配置以将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。
    • 当源是基于XFA的表单,扩展名为。XDP时,输出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实例可以开始将旧版表单转换为自适应表单。