OSGi上以Forms为中心的工作流——步骤参考

Forms Workflow步骤

Forms工作流步骤在AEM工作流中执行特定于AEM Forms的操作。 这些步骤允许您在OSGi上快速构建基于以Forms为中心的自适应表单工作流。 这些工作流可用于开发基本的审阅和批准工作流、内部和跨防火墙的业务流程。 您还可以使用Forms Workflow步骤开始文档服务、与Adobe Sign签名工作流集成并执行其他AEM Forms操作。 您需要AEM Forms加载项才能在工作流中使用这些步骤。

指定任务步骤

分配任务步骤创建任务并将其分配给用户或用户组。 除了指定任务，该组件还为任务指定自适应表单或非交互式PDF。 自适应表单必须接受用户的输入，非交互式PDF或只读自适应表单仅用于审阅工作流。

您还可以使用组件控制任务的行为。 例如，创建记录的自动文档，将任务分配给特定用户或组，指定提交数据的路径，指定要预填充的数据路径，以及指定默认操作。 分配任务步骤具有以下属性：

• 标题： 任务的标题。标题显示在AEM收件箱中。

• 说明： 对任务中正在执行的操作的说明。当您在共享开发环境中工作时，此信息对于其他流程开发人员很有用。

• 缩略图路 径：任务缩略图的路径。如果未指定路径，则显示自适应表单默认缩略图，并且对于“记录文档”，显示默认图标。

• 工作流阶 段：工作流可以具有多个阶段。这些阶段显示在AEM收件箱中。 您可以在模型的属性（Sidekick >页面>页面属性>阶段）中定义这些阶段。

• 优先级： 选定的优先级显示在AEM收件箱中。可用选项有“高”、“中”和“低”。 默认值为“中”。

• 到期日 期：指定任务被标记为逾期的天数或小时数。如果选择​关闭，则任务从不标记为过期。 您还可以指定超时处理程序，以在任务过期后执行特定任务。

• 天： 任务完成前的天数。在将任务分配给用户后计数天数。 如果任务未完成，并且超出“天数”字段中指定的天数，则如果选择此选项，将在到期日后触发超时处理程序。

• 小时 数：完成任务之前的小时数。在将任务分配给用户后计算小时数。 如果任务未完成，并且超出“小时”字段中指定的小时数，则如果选中，将在到期小时数后触发超时处理程序。

• 到期日后超时：选 择此选项可启用“超时处理程序”选择字段。

• 超时处理 程序：选择指定任务步骤跨过到期日期时要执行的脚本。放置在CRX-repository中[apps]/fd/仪表板/scripts/timeoutHandler的脚本可供选择。 crx-repository中不存在指定的路径。 管理员在使用路径之前创建该路径。

• 在“任务详细信息”中突出显示上一个任务中的操作和注 释：选择此选项可显示在任务的“任务详细信息”部分上执行的最后一个操作和收到的注释。

• 类型： 选择启动工作流时要填写的文档类型。您可以选择自适应表单、只读自适应表单、非交互式PDF文档、交互式通信代理UI或交互式通信Web渠道文档。

• 使用自适应表 单：指定定位输入自适应表单的方法。如果从“类型”(Type)下拉列表中选择自适应表单或只读自适应表单，则此选项可用。 您可以使用提交到工作流的自适应表单、绝对路径或变量路径。 可以使用“字符串”类型的变量指定路径。
  您可以将多个自适应表单与工作流关联。 因此，您可以使用可用的输入方法在运行时指定自适应表单。

• 使用交互式通 信：指定定位输入交互式通信的方法。您可以使用提交到工作流的交互式通信、绝对路径或变量中的路径。 可以使用“字符串”类型的变量指定路径。 如果从“类型”下拉渠道中选择“交互式通信代理UI”或“交互式通信Web文档”，则此选项可用。

• 自适应表单或交互式通信路径:指定自适应表单或交互式通信的路径。您可以使用提交到工作流的自适应表单或交互式通信（在绝对路径中可用），或从字符串数据类型变量中存储的路径检索自适应表单。

• 使用：指定 非交互式PDF文档的路径。当您在“类型”字段中选择非交互式PDF文档时，该字段可用。 您可以使用相对于有效负荷的路径选择输入PDF，将其保存在绝对路径中，或使用文档数据类型的变量。 例如，[Payload_Directory]/Workflow/PDF/credit-card.pdf。 crx-repository中不存在该路径。 管理员在使用路径之前创建该路径。 您需要启用“记录文档”选项或基于表单模板的自适应表单才能使用“PDF路径”选项。

• 对于完成的任务，将自适应表单渲染为:将任务标记为完成后，您可以将自适应表单渲染为只读自适应表单或PDF文档。您需要启用“记录文档”选项或基于表单模板的自适应表单才能将自适应表单渲染为“记录文档”。

• 预填充：以 下列字段用作任务的输入：

  • 使用：输入数据文 件的路径(.json,.xml、.doc或表单数据模型)。 您可以使用相对于有效负荷的路径检索输入数据文件，或检索存储在文档、XML或JSON数据类型变量中的文件。 例如，该文件包含通过AEM Inbox应用程序为表单提交的数据。 示例路径为[Payload_Directory]/workflow/data。

  • 使用以下方法选 择输入附件：与任务关联的表单中附加了位置可用的附件。路径始终相对于有效负荷。 示例路径为[Payload_Directory]/attachments/

  • 选择输入JSON: 使用相对于有效负荷的路径或存储在文档、JSON或表单数据模型数据类型变量中的路径选择输入JSON文件。如果从“类型”下拉渠道中选择“交互式通信代理UI”或“交互式通信Web文档”，则此选项可用。

  • 选择自定义预填服务： 选择预填服务以检索数据并预填交互通信Web渠道文档或代理UI。

  • 使用上面选择的交互式通信的预 填服务：使用此选项可使用在“使用交互式通信”下拉列表中定义的交互式通信的预填服务。

  • 请求属性映 射：使用“请求属性映射”部分可 定义请求属性的名称和值。根据请求中指定的属性名称和值从数据源检索详细信息。 您可以使用字面值或字符串数据类型的变量定义请求属性值。\

    只有在从“类型”下拉渠道中选择“交互通信代理UI”或“交互通信Web文档”时，预填服务和请求属性映射选项才可用。

• 已提交信 息：下面列出的以下字段用作任务的输出位置：

  • 使用：保存数 据文件(.json,.xml、.doc或表单数据模型)。 数据文件包含通过关联表单提交的信息。 您可以使用相对于有效负荷的路径保存输出数据文件，或将其存储在文档、XML或JSON数据类型的变量中。 例如，[Payload_Directory]/Workflow/data，其中数据是文件。

  • 使用以下方式保 存附件：保存任务中提供的表单附件。您可以使用相对于有效负荷的路径保存附件，也可以将其存储在文档数据类型数组变量中。

  • 使用：Path保存记录文档 以保存记录文件文档。例如，[Payload_Directory]/DocumentofRecord/credit-card.pdf。 您可以使用相对于有效负荷的路径保存记录文档，也可以将其存储在文档数据类型的变量中。 如果选择​相对于有效负荷​选项，则如果路径字段留空，则不生成记录文档。 仅当从“类型”下拉列表中选择“自适应表单”时，此选项才可用。

  • 使用以下方式保存Web 渠道数据：使用相对于有效负荷的路径保存Web渠道数据文件，或将其存储在文档、JSON或表单数据模型数据类型的变量中。仅当从“类型”下拉列表中选择“交互式通信代理UI”时，此选项才可用。

  • 使用以下方法保 存PDF文档：使用相对于有效负荷的路径保存PDF文档，或将其存储在文档数据类型的变量中。仅当从“类型”下拉列表中选择“交互式通信代理UI”时，此选项才可用。

  • 使用：保存布 局模板：使用相对于有效负荷的路径保存布局模板，或将其存储在文档数据类型的变量中。布局模板引用您使用Forms设计器创建的XDP文件。 仅当从“类型”下拉列表中选择“交互式通信代理UI”时，此选项才可用。

• “被分派人”>“分 配选项”：指定将任务分配给用户的方法。您可以使用参加者选择器脚本将任务动态分配给用户或用户组，或将任务分配给特定AEM用户或用户组。

• 参加者选 择器：当在“分配选项”字 段中选择“动态 分配给用户”或“分组”选项时，此选项可用。您可以使用ECMAScript或服务动态选择用户或用户组。 有关详细信息，请参阅将工作流动态分配给用户和创建自定义Adobe Experience Manager动态参与者步骤。

• 参加者： 当在“参加者选 择者”字段中选择com.adobe.granite.workflow.core.process. RandomParticipantChooser选项时，该 字段 可用。该字段允许您为RandomParticipantChooser选项选择用户或用户组。

• 被分派 人：当在“参与者 选择者”字 段中选择com.adobe.fd.workspace.step.service. VariableParticipantChooser时，该 字段可用。该字段允许您选择字符串数据类型的变量来定义被分派人。

• 参数： 当在“参加者选择器”字段中选择了RandomParticipantChoose脚本以外的脚本时，该字段可用。该字段允许您为在“参加者选择器”字段中选择的脚本提供以逗号分隔的参数列表。

• 用户或用户组： 任务被分配给选定的用户或用户组。当在​分配选项​字段中选择​特定用户或组选项​时，此选项可用。 该字段将列表工作流用户组的所有用户和用户组。
  用户或组​下拉菜单列表登录用户有权访问的用户和组。 用户名显示取决于您是否对crx-repository中该特定用户的​users​节点具有访问权限。

• 通过电子邮件通知被分派 人：选择此选项可向被分派人发送电子邮件通知。这些通知在向用户分配任务时发送。 在使用此选项之前，请启用AEM Web Console的通知。 有关分步说明，请参阅为分配任务步骤配置电子邮件通知

• HTML电子邮件模板:为通知电子邮件选择电子邮件模板。要编辑模板，请修改crx-repository中位于/libs/fd/dashboard/templates/email/htmlEmailTemplate.txt的文件。

• 允许委派到：AEM收 件箱为已登录的用户提供一个选项，以将分配的工作流委派给其他用户。您可以委派到同一组内，或委派到另一个组的工作流用户。 如果任务被分配给单个用户，并且选择了​允许委托给被分派人组成员的选项，则无法将任务委派给其他用户或组。

• 共享设置： AEM收件箱提供选项，用于与其他用户共享收件箱中的单个或所有任务:

  • 选择​允许被分派人显式共享收件箱​选项后，用户可以单击该任务并与另一个AEM用户共享。
  • 当选择​允许被分派人通过收件箱共享​选项并且用户共享其收件箱项目或允许其他用户访问其收件箱项目时，只有启用上述选项的任务才会与其他用户共享。

• “操作”>“默认操 作”：现成、“提交”、“保存”和“重置”操作均可用。默认情况下，所有默认操作都处于启用状态。

• 路由变 量：路由变量的名称。路由变量捕获用户在AEM收件箱中选择的自定义操作。

• 路由： 任务可以分支到不同的路由。在AEM收件箱中选择时，该路由将返回一个值，并基于所选路由返回工作流分支。 可以将路由存储在字符串数据类型数组的变量中，也可以选择​Literal​手动添加路由。

• 标题:指定路由的标题。它显示在AEM收件箱中。

• 珊瑚图标:指定珊瑚图标的HTML属性。AdobeCorelUI库提供大量触屏优先图标。 您可以选择并使用路由的图标。 它与标题一起显示在AEM收件箱中。 如果将路由存储在变量中，则路由使用默认的“标记”珊瑚图标。

• 允许被分派人添加评论:选择此选项可为任务启用注释。受分派人可以在提交任务时从AEM收件箱中添加注释。

• 在变量中保存注 释：在字符串数据类型的变量中保存注释。仅当您选中​允许被分派人添加注释​复选框时，才会显示此选项。

• 允许被分派人向任务添加附件:选择此选项可为任务启用附件。受分派人可以在提交任务时从AEM收件箱中添加附件。

• 使用以下方式保存输出任务附件:指定附件文件夹的位置。您可以使用相对于有效负荷的路径或任务数据类型数组变量来保存输出文档附件。 仅当您选中​允许被分派人向任务​添加附件复选框并选择​自适应表单、只读自适应表单​或​非交互式PDF文档​时，才会显示此选项​表单/文档​选项卡中的下拉列表。​

• 使用自定义元数 据：选择此选项可启用自定义元数据字段。自定义元数据用于电子邮件模板。
• 自定义元数 据：为电子邮件模板选择自定义元数据。自定义元数据可在crx-repository中找到，网址为apps/fd/仪表板/scripts/metadataScripts。 crx-repository中不存在指定的路径。 管理员在使用路径之前创建该路径。 您还可以对自定义元数据使用服务。 还可以扩展WorkitemUserMetadataService界面以提供自定义元数据。
• 显示前一步骤的数据:选择此选项可启用受分配者以视图以前的受分配者、已对任务执行的操作、添加到任务的注释以及已完成任务的记录文档（如果可用）。
• 显示后续步骤中的数据：选 择此选项可使当前被分派人能够视图后续被分派人所采取的操作和添加到任务的注释。它还允许当前被分派人视图已完成任务的记录文档（如果可用）。
• 数据类型的可见性： 默认情况下，被分派人可以视图记录、被分派人、所采取的操作以及先前和后续被分派人已添加的注释的文档。使用数据类型选项的可见性来限制受分配者可见的数据类型。

发送电子邮件步骤

使用电子邮件步骤发送电子邮件，例如，具有记录文档、自适应表单链接、交互式通信链接或附加的PDF文档的电子邮件。 “发送电子邮件”步骤支持HTML电子邮件。 HTML电子邮件具有响应性，可适应收件人的电子邮件客户端和屏幕大小。 您可以使用HTML电子邮件模板来定义电子邮件的外观、颜色方案和行为。

电子邮件步骤使用Day CQ邮件服务发送电子邮件。 在使用电子邮件步骤之前，请确保已配置电子邮件服务。 电子邮件步骤具有以下属性：

标题： 该步骤的标题有助于在工作流编辑器中识别该步骤。

说明： 在共享开发环境下工作时，说明对其他流程开发人员很有用。

电子邮件主 题：主题可以从工作流元数据中检索、手动指定或从变量中存储的值检索。从以下选项中进行选择：

• 文字- 手动指定主题。
• 从工作流元数据中检索 -从元数据属性中检索主题。
• 变量 -从字符串数据类型变量中存储的值检索主题。

HTML电子邮件模板:电子邮件的HTML模板。您可以在电子邮件模板中指定变量。 电子邮件步骤提取并显示模板中包含的所有变量作为输入。

电子邮件模板元 数据：电子邮件模板变量的值可以是用户指定的值、作者或发布服务器上资产的路径、图像或工作流元数据属性。

• 文本： 当您知道要指定的确切值时，请使用此选项。例如，example@example.com。

• 工作流元 数据：在将要使用的值保存到工作流元数据属性中时，使用此选项。选择该选项后，在“工作流元数据”选项下的空文本框中输入元数据属性名称。 例如，emailAddress。

• 资产URL: 使用此选项可嵌入交互式通信的Web链接至电子邮件。选择选项后，浏览并选择要嵌入的交互式通信。 资产可以驻留在作者服务器或发布服务器上。

• 图像： 使用此选项将图像嵌入到电子邮件中。选择选项后，浏览并选择图像。 图像选项仅对电子邮件模板中提供的图像标记(<img src="*"/>)可用。

发件人/收件人的电子邮件地 址：选 ​​择“文本”选项以手动指定电子邮件地址，或选择“从工作 流检索”元数 据选项以从元数据属性检索电子邮件地址。您还可以为​从工作流中检索元数据​选项指定元数据属性数组的列表。 选择​变量​选项，从字符串数据类型变量中存储的值检索电子邮件地址。

文件附 件：指定位置的可用资产会附加到电子邮件。资产的路径可以是相对有效负荷路径或绝对路径。 示例路径为[Payload_Directory]/attachments/。

选择​变量​选项以检索存储在文档、XML或JSON数据类型变量中的文件附件。

文件名：电 子邮件附件文件的名称。电子邮件步骤会将附件的原始文件名更改为指定的文件名。 可以手动指定名称，也可以从工作流元数据属性或变量中检索该名称。 如果您知道要指定的确切值，请使用​Literal​选项。 使用​变量​选项从字符串数据类型变量中存储的值检索文件名。 将要使用的值保存在工作流元数据属性中时，请使用​从工作流元数据​中检索选项。

生成记录步骤的文档

填写或提交表单后，您可以以打印或文档格式保留表单的记录。 这称为记录文档(DoR)。 您可以使用“生成记录文档”步骤创建自适应表单的只读或交互式PDF版本。 PDF版本包含已填写到表单的信息以及自适应表单的布局。

记录步骤的文档具有以下属性：

使用自适应表单:指定用于定位输入自适应表单的方法。您可以使用提交到工作流的自适应表单、绝对路径或变量路径。 可以使用字符串数据类型的变量在​选择变量以解析​字段中指定路径。
您可以将多个自适应表单与工作流关联。 因此，您可以使用可用的输入方法在运行时指定自适应表单。

自适应表单路径:指定自适应表单的路径。从​使用自适应表单​字段中选择​绝对路径​选项时，该字段可用。

选择使用：自适 应表单输入数据的路径输入数据。您可以将数据保留在相对于有效负荷的位置，指定数据的绝对路径，或检索存储在文档、JSON或XML数据类型变量中的数据。 输入数据与自适应表单合并以创建记录文档。

选择“使用：附件 的路径输入附件路径”。这些附件包含在记录文档中。 您可以将附件保留在相对于有效负荷的位置，指定附件的绝对路径，或检索存储在文档数据类型数组变量中的附件。

如果指定文件夹的路径（例如附件），则文件夹中直接可用的所有文件都将附加到“记录”文档。 如果指定的附件路径中直接可用的文件夹中有任何文件，则这些文件将包含在“记录为附件”文档中。 如果直接可用的文件夹中存在任何文件夹，则会跳过这些文件夹。

使用以下选项保存生成的记录文档: 指定保留记录文件文档的位置。您可以选择覆盖有效负荷文件夹，将记录文档放在有效负荷目录中的某个位置，或将记录文档存储在文档数据类型的变量中。

区域设置:指定记录文档的语言。选择​Literal​从下拉列表中选择区域设置，或选择​变量​从字符串数据类型变量中存储的值检索区域设置。 在变量中存储区域设置值时，必须定义区域设置代码。 例如，为英语指定​en_US，为法语指定​fr_FR。

调用表单数据模型服务步骤

可以使用AEM Forms数据集成配置和连接到不同的数据源。 这些数据源可以是数据库、Web服务、REST服务、OData服务和CRM解决方案。 AEM Forms数据集成允许您创建包含各种服务的表单数据模型，以对配置的数据库执行数据检索、添加和更新操作。 您可以使用​调用数据模型服务步骤​选择表单数据模型(FDM)，并使用FDM的服务检索、更新数据或将数据添加到不同的数据源。

要说明该步骤的字段的输入，以下数据库表和JSON文件将作为示例：

示例CustomerDetails表

示例JSON文件

  { 
    customer: { 
     firstName: "Sarah", 
     lastName:"Rose", 
     customerId: "1", 
     emailAddress:"srose@we.info" 
   }, 
    insurance: {
     customerId: "1", 
    policyType: "Premium,
    policyNumber: "Premium-521499",
    customerDetails: { 
     firstName: "Sarah",
     lastName: "Rose",
     customerId: "1",
     emailAddress: "srose@we.info" 
    }
   }
  }

调用表单数据模型服务步骤包含以下列字段，以便于表单数据模型操作：

• 标题： 步骤的标题。它有助于在工作流编辑器中确定步骤。

• 说明： 在共享开发环境下工作时，对其他流程开发人员有用的说明。

• 表单数据模型路径:浏览并选择服务器上存在的表单数据模型。

• 服务:所选表单数据模型提供的服务列表。

• 服务输入>使用文字、变量或工作流元数据以及JSON文件提供输入数据:服务可以有多个参数。选择选项，以从工作流元数据属性、JSON对象、变量获取服务参数的值，或直接在提供的文本框中输入值：

  • 文本： 当您知道要指定的确切值时，请使用此选项。例如，srose@we.info。
  • 变量： 使用该选项检索变量中存储的值。
  • 从工作流元数据中 检索：当要使用的值保存在工作流元数据属性中时，请使用此选项。例如，emailAddress。
  • JSON点表示法： 当要使用的值在JSON文件中时，请使用此选项。例如，insurance.customerDetails.emailAddress。 仅当选择“映射输入JSON中的输入字段”选项时，“JSON点表示法”选项才可用。
  • 映射输入JSON的输入字段： 指定JSON文件的路径，以从JSON文件获取某些服务参数的输入值。JSON文件的路径可以是有效负荷的相对路径、绝对路径，也可以使用JSON或表单文档模型类型的变量选择输入JSON。

• 服务输入>使用变量或JSON文件提供输入数据：选 择此选项，可从保存在绝对路径、相对于有效负荷的路径或变量中的JSON文件获取所有参数的值。

• 使用以下方式选择输入JSON文档:包含所有服务参数值的JSON文件。JSON文件的路径可以是相对于有效负荷​的​或​绝对路径。 您还可以使用JSON或表单数据模型文档类型的变量检索输入JSON数据。

• JSON点表示法： 将字段留空，以使用指定JSON文件的所有对象作为服务参数的输入。要从指定的JSON文件中读取特定JSON对象作为服务参数的输入，请为JSON对象指定点符号，例如，如果您的JSON与该部分开始中列出的JSON类似，请指定insure.customerDetails以提供客户的所有详细信息作为服务的输入。

• 服务输出>将输出值映射并写入变量或元数据： 选择选项可将输出值另存为crx-repository中工作流实例元数据节点的属性。指定元数据属性的名称并选择要用元数据属性映射的相应服务输出属性，例如，将输出服务返回的phone_number与工作流元数据的phone_number属性进行映射。 同样，可以将输出存储在长数据类型的变量中。当为要映射的​服务输出属性选择属性​选项时，只会为​将输出保存到​选项填充能够存储所选属性数据的变量。

• 服务输出>将输出保存到变量或JSON 文件：选择此选项可将输出值保存到JSON文件的绝对路径、相对于有效负荷的路径或变量中。

• 使用以下选项保存输出JSON文档: 保存输出JSON文件。输出JSON文件的路径可以是有效负荷的相对路径或绝对路径。 您还可以使用JSON或表单数据模型数据类型的变量保存输出JSON文件。

签名文档步骤

签名文档步骤允许您使用Adobe Sign签署文档。 签名文档步骤具有以下属性：

• 协议名 称：指定协议的标题。协议名称将成为发送给签署方的电子邮件的主题和正文文本的一部分。 可以将名称存储在字符串数据类型的变量中，也可以选择​Literal​手动添加该名称。

• 区域设置： 指定电子邮件和验证选项的语言。您可以将区域设置存储在字符串数据类型的变量中，或选择​Literal​从可用选项列表中选择区域设置。 在变量中存储区域设置值时，必须定义区域设置代码。 例如，为英语指定​en_US，为法语指定​fr_FR。

• Adobe Sign云配置:选择“Adobe Sign云配置”。如果尚未为AEM Forms配置Adobe Sign，请参阅将Adobe Sign与AEM Forms集成。

• 使用以下方式选择要签名的文档: 您可以从相对于有效负荷的位置选择文档，使用有效负荷作为文档，指定文档的绝对路径，或检索存储在文档数据类型变量中的文档。

• 截止日期： 文档在“截止日期”字段中指定的天数没有活动后，将其标记为“截止日期”(已过 期日 期)。在将记录的天数分配给用户进行签名后计数。

• 提醒电子邮件频 率：您可以在每日或每周间隔发送提醒电子邮件。该周从被指定给用户进行签名的那天算起。

• 签名过 程：您可以选择按顺序或并行顺序对文档进行签名。按顺序，一个签署方每次接收文档进行签名。 第一个签署方完成文档后，文档将发送给第二个签署方，依此类推。 按平行顺序，多个签名者一次可以签署文档。

• 重定向URL: 指定重定向URL。签署文档后，您可以将被分派人重定向到URL。 通常，此URL包含感谢信或进一步说明。

• 工作流阶 段：工作流可以具有多个阶段。这些阶段显示在AEM收件箱中。 您可以在模型的属性（Sidekick >页面>页面属性>阶段）中定义这些阶段。

• 选择签名者： 指定选择文档签名者的方法。您可以动态地将工作流分配给用户或用户组，或手动添加签署方的详细信息。

• 用于选择签名者的脚本或服 务：仅当在“选择签名者”字段中选择了“动态”选项时，此选项才可用。可以指定ECMAScript或服务来为文档选择签名者和验证选项。

• 签署方详细信 息：仅当在“选择签署方”字段中选择“手动”选项时，此选项才可用。指定电子邮件地址并选择可选的验证机制。 在选择两步验证机制之前，请确保为已配置的Adobe Sign帐户启用相应的验证选项。 可以使用字符串数据类型的变量来定义​电子邮件、国家／地区代码​和​电话号码​字段的值。 仅当从​2步验证​下拉列表中选择​电话验证​时，国家代码​和​电话号码​字段才显示。

• 状态变量：启 用Adobe Sign的文档将文档的签名状态存储在字符串数据类型的变量中。指定状态变量的名称(adobeSignStatus)。 在CRXDE中，实例的状态变量位于/etc/workflow/instances/<server>/<date-time>/<workflow model的实例>/workItems/<node>/metaData包含变量的状态。

• 使用以下选项保存已签名 文档：指定保留已签名文档的位置。您可以选择覆盖有效负荷文件，将已签名文档放在有效负荷目录中的某个位置，或将已签名文档存储在文档类型的变量中。

文档服务步骤

AEM文档服务是一套用于创建、组合和保护PDF文档的服务。 AEM Forms为每个文档服务提供单独的AEM工作流步骤。

与其他AEM Forms工作流步骤(如分配任务、发送电子邮件和签名文档)类似，您可以在所有AEM文档服务步骤中使用变量。 有关创建和管理变量的详细信息，请参阅AEM工作流🔗中的变量。

应用文档时间戳步骤

为文档添加时间戳。 您提供文档详细信息，如输入文档路径、输入文档名称、存储导出数据的位置。 您可以选择覆盖现有的有效负荷文件，选择其他文件名以在有效负荷文件夹下的其他文件中存储数据，提供数据的绝对路径，或将数据存储在文档数据类型的变量中。

转换为图像步骤

将PDF文档转换为图像列表。 支持的图像格式为JPEG、JPEG2000、PNG和TIFF。 以下信息适用于TIFF图像的转换：

• 将生成多页TIFF文件。
• TIFF图像中不包含某些注释。 不包括要求Acrobat生成外观的注释。

转换为PDF/A步骤

使用提供的选项将PDF文档转换为PDF/A格式。 PDF/A版本的可移植文档格式(PDF)专门用于存档和长期保留文档。

转换为PS步骤

将PDF文档转换为PostScript。 转换为PostScript时，可以使用转换操作指定源文档以及是转换为PostScript级别2还是3。 转换为PostScript文件的PDF文档必须是非交互式的。

从指定类型步骤创建PDF

从输入文件生成PDF文档。 输入文档可以是相对于有效负荷的，具有绝对路径，可以是有效负荷本身，或存储在文档数据类型的变量中。

通过URL/HTML/ZIP步骤创建PDF

从提供的URL、HTML和ZIP文件生成PDF文档。

导出数据步骤

从PDF forms或XDP文件导出数据。 它要求您输入输入文档的文件路径和导出数据格式。 “导出数据格式”选项为“自动”、“XDP”和“XmlData”。

Export PDF到指定类型步骤

将PDF文档转换为选定格式。

生成非交互式PDF步骤

生成非交互式PDF。 它提供各种自定义选项。

导入数据步骤

将表单数据合并到PDF表单中。 您可以将表单数据导入PDF表单。

调用DDX步骤

在指定的输入文档映射上执行DDX文件，并返回经过处理的PDF文档。

Optimize PDF步骤

通过减小PDF文件的大小优化PDF文件。 此转换的结果是可能比原始版本小的PDF文件。 此操作还会将PDF文档转换为优化参数中指定的PDF版本。

优化设置指定如何优化文件。 以下是示例设置：

• 目标PDF版本
• 放弃JavaScript动作和嵌入的页面缩略图等对象
• 放弃用户数据，如注释和文件附件
• 放弃无效或未使用的设置
• 压缩未压缩数据或使用更高效的压缩算法
• 删除嵌入字体
• 设置透明度值

渲染PDF表单步骤

将在表单设计器(XDP)中创建的表单渲染为PDF表单。

安全文档步骤

加密、签署和验证文档。 AEM Forms支持基于密码和证书库加密。 您还可以选择对文档签名的各种算法。 例如，SHA-256和SH-512。 您还可以使用工作流步骤来阅读器扩展PDF文档。 工作流步骤提供了启用条形码解码、数字签名、PDF数据导入和导出等选项的选项。

发送到打印机步骤

将文档直接发送到打印机。 它支持以下打印访问机制：

• 可直接访问的打印机:安装在同一计算机上的打印机称为直接可访问的打印机，该计算机名为打印机主机。此类型的打印机可以是直接连接到计算机的本地打印机。
• 间接可访问的打印机:打印服务器上安装的打印机可从其他计算机进行访问。通用的UNIX®打印系统(CUPS)和线路打印机守护程序(LPD)协议等技术可用于连接到网络打印机。 要访问间接可访问的打印机，请指定打印服务器的IP或主机名。 使用此机制，当网络运行LPD时，可以向LPD URI发送文档。 该机制允许您将文档路由到任何连接到正在运行LPD的网络的打印机。

生成打印输出步骤

该步骤生成PCL、PostScript、ZPL、IPL、TPCL或DPL输出，给定表单设计和数据文件。 数据文件与表单设计合并并格式化以供打印。 通过此步骤生成的输出可以直接发送到打印机或另存为文件。 建议您在要使用应用程序中的表单设计或数据时使用此步骤。 如果您的表单设计或表单设计位于网络、本地文件系统或HTTP位置，请使用generatePrintedOutput操作。

例如，您的应用程序要求您将表单设计与数据文件合并。 数据包含数百条记录。 此外，它要求将输出发送到支持ZPL的打印机。 表单设计和输入数据位于应用程序中。 使用generatePrintedOutput操作将每个记录与表单设计合并，并将输出发送到支持ZPL的打印机。

“生成打印输出”步骤具有以下属性：

输入属性

• 使用以下方式选择模板文件:指定模板文件的路径。您可以使用相对于有效负荷的路径、以绝对路径保存的路径或使用文档数据类型的变量来选择模板文件。 例如，[Payload_Directory]/Workflow/data.xml。 如果crx-repository中不存在该路径，则管理员可以在使用该路径之前创建该路径。 此外，您还可以接受有效负荷作为输入数据文件。

• 使用以下方式选择文档:指定输入数据文件的路径。您可以使用相对于有效负荷的路径选择输入数据文件，以绝对路径保存，或使用文档数据类型的变量。 例如，[Payload_Directory]/Workflow/data.xml。 如果crx-repository中不存在该路径，则管理员可以在使用该路径之前创建该路径。

• 打印机格式:一个“打印格式”值，它指定在未提供XDC文件时用于生成输出流的页面描述语言。如果您提供一个字面值，请选择以下值之一：

  • 自定义PCL:使用该选项为PCL指定自定义XDC文件。
  • 自定义PostScript:使用此选项可为PostScript指定自定义XDC文件。
  • 自定义ZPL:使用此选项可指定用于ZPL的自定义XDC文件。
  • 通用颜色PCL(5c):使用通用颜色PCL(5c)。
  • 通用PostScript级别3:使用通用PostScript级别3。
  • ZPL 300 DPI:使用ZPL 300 DPI。使用zpl300.xdc。
  • ZPL 600 DPI:使用ZPL 600 DPI。使用zpl600.xdc文件。
  • 自定义IPL:使用此选项可指定用于IPL的自定义XDC文件。
  • IPL 300 DPI:使用IPL 300 DPI。使用ipl300.xdc。
  • IPL 400 DPI:使用IPL 400 DPI。使用ipl400.xdc文件。
  • 自定义TPCL:使用此选项可为TPCL指定自定义XDC文件。
  • TPCL 305 DPI:使用TPCL 300 DPI。使用tpcl305.xdc文件。
  • PCL 600 DPI:使用TPCL 600 DPI。使用tpcl600.xdc文件。
  • 自定义DPL:使用此选项指定自定义XDC文件DPL。
  • DPL300DPI:使用DPL 300 DPI。使用dpl300.xdc文件。
  • DPL406DPI:使用DPL 400 DPI。使用dpl406.xdc。
  • DPL600DPI:使用DPL 600 DPI。使用dpl600.xdc。

输出属性

• 保存输出文档:指定保存输出文件的位置。可以将输出文件保存在与有效负荷相关的位置、变量中，或指定一个绝对位置以保存输出文件。 如果crx-repository中不存在该路径，则管理员可以在使用该路径之前创建该路径。

高级属性

• 使用以下方式选择内容根位置:内容根是一个字符串值，它指定URI、绝对引用或存储库中的位置，以检索表单设计使用的相对资产。例如，如果表单设计相对引用图像，如…/myImage.gif，则myImage.gif必须位于repository://。 默认值为repository://，它指向存储库的根级别。

  从应用程序选取资产时，内容根URI路径必须具有正确的结构。 例如，如果从名为SampleApp的应用程序中选取表单，并将其放在SampleApp/1.0/forms/Test.xdp，则必须将内容根URI指定为repository://administrator@password/Applications/SampleApp/1.0/forms/，或将存储库：/Applications/SampleApp/1.0/forms/（当权限为null）。 以这种方式指定内容根URI时，将针对此URI解析表单中所有引用资产的路径。

• 使用以下方式选择XCI​文件：XCI文件用于描述用于表单设计元素的字体和其他属性。您可以将XCI文件保留为相对于有效负荷、绝对路径或使用文档数据类型的变量。

• 区域设置:指定用于生成PDF文档的语言。如果您提供了文字值，请从列表中选择一种语言，或选择以下值之一：

  • 要使用服务器默认值:（默认）使用在AEM Forms服务器上配置的区域设置。区域设置是使用管理控制台配置的。 （请参阅设计器帮助。）

  • 要使用自定义值:在文字框中键入区域设置代码，或选择包含区域设置代码的字符串变量。有关支持的区域设置代码的完整列表，请参阅http://java.sun.com/j2se/1.5.0/docs/guide/intl/locale.doc.html。

• 副本:一个整数值，它指定要为输出生成的副本数。默认值为 1。

• 双面打印:分页值，指定是使用双面打印还是单面打印。支持PostScript和PCL的打印机使用此值。如果您提供文本值，请选择以下值之一：

  • 双工长边:使用长边分页功能进行双面打印和打印。
  • 双工短边:使用短边分页功能进行双面打印和打印。
  • 单纯形:使用单面打印。