文档AEM 6.5用户指南

OSGi上以Forms为中心的工作流 — 步骤参考 forms-centric-workflow-on-osgi-step-reference

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • 用户
  • 开发人员
版本
文章链接
AEM as a Cloud Service
单击此处
AEM 6.5
本文

您可以使用工作流模型将业务逻辑转换为自动重复流程。 模型可帮助您定义和执行一系列步骤。 您还可以定义模型属性，例如工作流是临时工作流还是使用多个资源。 您可以在模型中包括各种AEM Workflow步骤以实现业务逻辑。

Forms Workflow步骤 forms-workflow-steps

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

以Forms为中心的工作流步骤在AEM Workflow中执行特定于AEM Forms的操作。 这些步骤让您能够在OSGi上快速构建基于Adaptive Forms的以Forms为中心的工作流。 这些工作流可用于开发基本的审核和批准工作流、内部和跨防火墙业务流程。

NOTE
如果为外部存储标记了工作流模型，则对于所有Forms Workflow步骤，您只能选择“变量”选项来存储或检索数据文件和附件。

分配任务步骤 assign-task-step

分配任务步骤将创建一个任务并将其分配给用户或组。 在分配任务的同时，组件还会为任务指定自适应表单或非交互式PDF。 自适应表单需要接受用户和非交互式PDF的输入，或者只读自适应表单用于仅审阅工作流。

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

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

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

  • 缩略图路径： ​任务缩略图路径。 如果未指定路径，则会为自适应表单显示默认缩略图，为记录文档显示默认图标。

  • 工作流暂存： ​一个工作流可以有多个暂存。 这些阶段显示在AEM收件箱中。 您可以在模型的属性(“Sidekick”>“页面”>“页面属性”>“阶段”)中定义这些阶段。

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

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

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

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

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

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

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

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

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

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

NOTE
您必须具有cm-agent-users和workflow-users组分配才能访问AEM收件箱中的交互式通信代理UI。

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

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

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

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

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

    • 使用以下方式选择输入附件： ​该位置可用的附件已附加到与任务关联的表单。 路径可以是相对于有效负荷的，也可以检索存储在文档的数组列表类型变量中的附件。 示例路径为[Payload_Directory]/attachments/。 您可以指定相对于有效负荷放置的附件，也可以使用文档类型（数组列表>文档）变量来指定自适应表单的输入附件。

      • 选择输入JSON： ​使用相对于有效负荷或存储在Document、JSON或表单数据模型数据类型的变量中的路径选择输入JSON文件。 如果从“类型”下拉列表中选择“交互式通信代理UI”或“交互式通信Web渠道文档”，则此选项可用。
      • 选择自定义预填充服务： ​选择预填充服务以检索数据并预填充交互式通信Web渠道文档或代理UI。
      • 使用上面选择的交互式通信的预填充服务： ​使用此选项可使用使用交互式通信下拉列表中定义的交互式通信的预填充服务。
      • 请求属性映射： ​使用“请求属性映射”部分定义请求属性🔗的名称和值。 根据请求中指定的属性名称和值从数据源检索详细信息。 您可以使用文本值或String数据类型的变量来定义请求属性值。
        仅当从“类型”下拉列表中选择“交互式通信代理UI”或“交互式通信Web渠道文档”时，预填充服务和请求属性映射选项才可用。

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

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

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

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

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

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

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

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

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

  • 参与者： ​在​ 参与者选择器 ​字段中选择​ com.adobe.granite.workflow.core.process.RandomParticipantChooser ​选项时，该字段可用。 利用字段，可为RandomParticipantChooser选项选择用户或组。

  • 代理人： ​在​ 参与者选择器 ​字段中选择​ com.adobe.fd.workspace.step.service.VariableParticipantChooser ​时，该字段可用。 利用字段，可选择String数据类型的变量来定义被分派人。

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

  • 用户或组： ​任务已分配给选定的用户或组。 在​ 分配选项 ​字段中选择​ 到特定用户或组选项 ​时，该选项可用。 字段列出了工作流用户组的所有用户和组。
    用户或组 ​下拉菜单列出了登录用户有权访问的用户和组。 用户名显示取决于您是否对该特定用户在crx存储库中的​ 用户 ​节点具有访问权限。

  • 发送通知电子邮件：选择此选项可向被分派人发送电子邮件通知。 将任务分配给用户或组时会发送这些通知。 您可以使用​ 收件人电子邮件地址 ​选项指定检索电子邮件地址的机制。

  • 收件人电子邮件地址：可以将电子邮件地址存储在变量中，使用文本指定永久电子邮件地址，或使用在受让人的配置文件中指定的受让人的默认电子邮件地址。 您可以使用文本或变量指定组的电子邮件地址。 变量选项有助于动态检索和使用电子邮件地址。 使用被分派人的默认电子邮件地址 ​选项仅适用于单个被分派人。 在这种情况下，将使用存储在被分派人用户配置文件中的电子邮件地址。

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

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

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

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

  • 操作>默认操作： ​现成可用的提交、保存和重置操作。 默认启用所有默认操作。

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

  • 路由： ​任务可以分支到不同的路由。 在AEM收件箱中选择后，该路由将返回一个值，并根据所选路由选择工作流分支。 您可以将路由存储在String数据类型的数组中，也可以选择​ 文本 ​来手动添加路由。

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

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

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

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

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

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

NOTE
在运行时使用代理UI中的附件选项卡，将附件与交互式通信关联。 以“完成”状态打开工作项后，关联的附件在Sidekick中显示为任务附件。
  • 使用自定义元数据： ​选择此选项可启用自定义元数据字段。 电子邮件模板中使用自定义元数据。
  • 自定义元数据： ​为电子邮件模板选择自定义元数据。 自定义元数据位于crx-repository中的apps/fd/dashboard/scripts/metadataScripts。 crx-repository中不存在指定的路径。 管理员在使用该路径之前先创建该路径。 您还可以将服务用于自定义元数据。 您还可以扩展WorkitemUserMetadataService界面以提供自定义元数据。
  • 显示先前步骤的数据：选择此选项可让被分派人查看之前的被分派人、已对任务执行的操作、添加到任务的注释以及已完成任务的记录文档（如果可用）。
  • 显示后续步骤的数据： ​选择此选项可允许当前被分派人查看后续被分派人执行的操作和添加到任务的注释。 它还允许当前被分派人查看已完成任务的记录文档（如果可用）。
  • 数据类型的可见性： ​默认情况下，被分派人可以查看记录文档、被分派人、采取的操作以及之前和后续被分派人添加的注释。 使用“数据类型的可见性”选项限制被分派人可见的数据类型。
NOTE
为外部数据存储配置Adobe Experience Manager工作流模型时，将分配任务步骤另存为草稿和检索分配任务步骤历史记录的选项被禁用。 此外，在收件箱中，将禁用保存选项。

发送电子邮件步骤 send-email-step

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

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

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

描述： ​当您在共享开发环境中工作时，说明对其他进程开发人员很有用。

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

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

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

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

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

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

  • 资产URL： ​使用选项将交互式通信的Web链接嵌入电子邮件。 选择选项后，浏览并选择要嵌入的交互式通信。 资产可以位于创作服务器或发布服务器上。

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

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

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

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

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

生成记录文档步骤 generate-document-of-record-step

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

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

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

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

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

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

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

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

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

调用表单数据模型服务步骤 invoke-form-data-model-service-step

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

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

示例CustomerDetails表

属性
值
名字
Sarah
姓氏
玫瑰
客户ID
1
电子邮件地址
srose@we.info

示例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"
    }
   }
  }

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

  • 标题： ​步骤的标题。 它有助于标识工作流编辑器中的步骤。

  • 描述： ​说明对于在共享开发环境中工作的其他进程开发人员很有用。

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

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

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

    • 文本： ​当您知道要指定的确切值时，请使用选项。 例如，srose@we.info。

    • 变量： ​使用选项检索存储在变量中的值。

    • 从工作流元数据中检索： ​当要使用的值保存在工作流元数据属性中时，请使用选项。 例如，emailAddress。

    • 相对于有效负载：使用选项检索在有效负载的相对路径中保存的文件附件。 选择选项并指定包含文件附件的文件夹名称，或在文本框中指定文件附件名称。

      例如，如果CRX存储库中的“相对于有效负荷”文件夹在attachment\attachment-folder位置包含文件附件，则在选择​ 相对于有效负荷 ​选项后，在文本框中指定attachment\attachment-folder。

    • JSON点表示法： ​当要使用的值位于JSON文件中时，请使用选项。 例如，insurance.customerDetails.emailAddress。 “JSON点表示法”选项仅在选择了“映射来自输入JSON的输入字段”选项时可用。

    • 映射来自输入JSON的输入字段： ​指定JSON文件的路径，以从JSON文件中获取某些服务参数的输入值。 JSON文件的路径可以是相对于有效负载的相对路径，也可以是绝对路径，您也可以使用JSON或表单数据模型类型的变量选择输入JSON文档。

  • Input for services >使用变量或JSON文件提供输入数据： ​选择相应选项，以从在绝对路径、有效负荷的相对路径或变量中保存的JSON文件中获取所有参数的值。

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

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

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

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

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

签名文档步骤 sign-document-step

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

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

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

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

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

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

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

  • 截止日期​ 天： ​在截止日期​ 天截止日期 ​字段中指定的天数内，任务中没有活动，文档被标记为到期（已超过截止日期）。 在将文档分配给用户进行签名后，计算天数。

  • 提醒电子邮件频率： ​您可以按每日或每周间隔发送提醒电子邮件。 从将文档分配给用户签名之日起计算周数。

  • 签名流程： ​您可以选择按顺序或并行顺序对文档进行签名。 按照顺序依次接收文档，每个收件人一次进行签名。 当第一个收件人完成签名文档后，该文档将发送给第二个收件人，依此类推。 多个收件人可同时以并行顺序签署文档。

  • 重定向URL： ​请指定重定向URL。 在签署文档后，您可以将受分派人重定向到URL。 通常，此URL包含感谢消息或进一步说明。

  • 工作流暂存： ​一个工作流可以有多个暂存。 这些阶段显示在AEM收件箱中。 您可以在模型的属性(“Sidekick”>“页面”>“页面属性”>“阶段”)中定义这些阶段。

  • 选择收件人： ​指定选择文档收件人的方法。 您可以动态地将工作流分配给用户或组，或手动添加收件人的详细信息。 在下拉列表中选择手动后，您会添加收件人详细信息，例如电子邮件、角色和身份验证方法。

    note note
    NOTE
    • 在“角色”部分，您可以将收件人角色指定为签名者、批准者、接受者、已认证收件人、表单填写者和委托人。
    • 如果在“角色”选项中选择委托人，则委托人可以将该签名任务分配给其他收件人。
    • 如果已为Adobe Sign配置了身份验证方法，则根据您的配置，请选择身份验证方法，例如基于电话的身份验证、基于社交身份的身份验证、基于知识的身份验证、基于政府身份的身份验证。

  • 用于选择收件人的脚本或服务： ​仅当您在“选择收件人”字段中选择“动态”选项时，该选项才可用。 您可以指定ECMAScript或服务来选择文档的接收者和验证选项。

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

  • 状态变量： ​启用Adobe Sign的文档将文档的签名状态存储在String数据类型的变量中。 指定状态变量的名称(adobeSignStatus)。 实例的状态变量可在CRXDE中的/etc/workflow/instances/<server>/<date-time>/<工作流模型的实例>/workItems/<node>/metaData中包含变量的状态。

  • 已签署文档：您可以将已签署文档的状态保存到变量。 要为已签署文档添加电子签名审核跟踪，以提高安全性和合法性，您可以包括审核报表。 您可以使用变量或有效负荷文件夹保存签名文档。

    note note
    NOTE
    审计报告将附加到已签署文档的最后一页。

文档服务步骤 document-services-steps

AEM Document Services是一组用于创建、组合和保护PDF文档的服务。 AEM Forms为每个文档服务提供了单独的AEM Workflow步骤。

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

应用文档时间戳步骤 apply-document-time-stamp-step

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

转换为图像步骤 convert-to-image-step

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

  • 生成多页TIFF文件。
  • 某些注释未包含在TIFF图像中。 需要Acrobat生成其外观的注释不包括在内。

转换为PDF/A步骤 convert-to-pdf-a-step

使用提供的选项将PDF文档转换为PDF/A格式。 Portable Document Format(PDF)的PDF/A版本专门用于归档和长期保存文档。

转换为PS步骤 convert-to-ps-step

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

从指定类型步骤创建PDF create-pdf-from-specified-type-step

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

从URL/HTML/ZIP步骤创建PDF create-pdf-from-url-html-zip-step

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

导出数据步骤 export-data-step

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

指定类型步骤的Export PDF export-pdf-to-specified-type-step

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

生成非交互式PDF步骤 generatenoninteractive

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

NOTE
可使用变量为输入文档指定模板文件。 将模板文件的路径存储在String数据类型的变量中。

导入数据步骤 import-data-step

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

调用DDX步骤 invokeddx

在指定的输入文档映射上执行DDX文件并返回操作的PDF文档。

NOTE
您可以使用变量为输入文档指定DDX文件。 将DDX文件存储在Document或XML数据类型的变量中。

Optimize PDF步骤 optimize-pdf-step

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

优化设置指定文件的优化方式。 以下是示例设置：

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

渲染PDF表单步骤 renderpdf

将在Designer (XDP)表单中创建的表单渲染到PDF表单。

NOTE
可使用变量为输入文档指定模板文件。 将模板文件的路径存储在String数据类型的变量中。

安全文档步骤 secure-document-step

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

发送到打印机步骤 send-to-printer-step

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

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

生成打印的输出步骤 generatePrintedOutput

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

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

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

输入属性

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

  • 使用以下方式选择数据文档：指定输入数据文件的路径。 您可以使用相对于有效负荷的路径（以绝对路径保存）或使用Document数据类型的变量来选择输入数据文件。 例如，[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/ （当authority为null时）。 以这种方式指定内容根URI时，表单中所有引用资源的路径都将针对此URI解析。

  • 使用 ​选择XCI文件： XCI文件用于描述用于窗体设计元素的字体和其他属性。 您可以将XCI文件相对于有效负荷保留在绝对路径上，或者使用Document数据类型的变量。

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

    • 要使用服务器默认值：
      （默认）使用AEM Forms服务器上配置的区域设置。 “区域设置”设置是使用“管理控制台”配置的。 (请参阅Designer帮助。)

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

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

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

    • 双面长Edge：使用双面打印并使用长边分页进行打印。
    • 双面短Edge：使用双面打印并使用短边分页进行打印。
    • 单面：使用单面打印。
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2