工作流最佳实践 workflow-best-practices

通过工作流，您可以自动化Adobe Experience Manager (AEM)活动。

它们通常代表AEM环境中发生的大量处理，因此，当自定义工作流步骤未根据最佳实践编写时，或者未将现成工作流配置为尽可能高效地运行时，系统可能会受损。

因此，强烈建议仔细规划工作流实施。

配置 configuration

在配置工作流进程（自定义和/或现成）时，有一些事项需要牢记。

瞬态工作流 transient-workflows

要优化高摄取负载，您可以将工作流定义为临时。

当工作流是瞬态时，与中间工作步骤相关的运行时数据在运行时不会保留在JCR中（保留输出演绎版）。

其优势可以包括：

调整DAM工作流 tuning-dam-workflows

有关DAM工作流的性能优化准则，请参阅AEM Assets性能优化指南。

配置最大并发工作流数 configure-the-maximum-number-of-concurrent-workflows

AEM允许同时运行多个工作流线程。 默认情况下，线程数配置为系统处理器内核数的一半。

如果正在执行的工作流需要系统资源，这可能意味着AEM几乎无法将其用于其他任务，例如渲染创作UI。 因此，系统在批量图像上传等活动期间可能会变得缓慢。

要解决此问题，Adobe建议将​ 最大并行作业数 ​配置为系统处理器内核数的一半到四分之三之间。 这应该允许系统在处理这些工作流时保持响应性的足够容量。

要配置​ 最大并行作业数，您可以：

此外，Granite工作流外部进程作业队列 ​有单独的配置。 用于启动外部二进制文件的工作流进程，如​ InDesign Server ​或​ 图像Magick。

配置单个作业队列 configure-individual-job-queues

在某些情况下，配置单个作业队列来控制并发线程或基于单个作业的其他队列选项会很有用。 您可以通过​ Apache Sling作业队列配置 ​工厂从Web控制台添加和配置单个队列。 要查找要列出的相应主题，请执行工作流的模型并在​ Sling作业 ​控制台中查找它；例如，位于http://localhost:4502/system/console/slingevent。

也可以为临时工作流添加单个作业队列。

配置工作流清除 configure-workflow-purging

在标准安装中，AEM提供了一个维护控制台，可以在其中计划和配置每日和每周维护活动；例如，在：

http://localhost:4502/libs/granite/operations/content/maintenance.html

默认情况下，每周维护时段 ​具有​ 工作流清除 ​任务，但需要先配置该任务才能运行。 要配置工作流清除，必须在Web控制台中添加新的​ AdobeGranite工作流清除配置。

有关AEM中维护任务的更多详细信息，请参阅操作功能板。

自定义 customization

在编写自定义工作流进程时，有一些事项应牢记。

位置 locations

工作流模型、启动器、脚本和通知的定义根据类型保存在存储库中；即，开箱即用、自定义等。

位置 — 工作流模型 locations-workflow-models

工作流模型根据类型存储在存储库中：

位置 — 工作流启动器 locations-workflow-launchers

工作流启动器定义还根据类型存储在存储库中：

位置 — 工作流脚本 locations-workflow-scripts

工作流脚本还根据类型存储在存储库中：

位置 — 工作流通知 locations-workflow-notifications

工作流通知还根据类型存储在存储库中：

进程会话 process-sessions

与任何自定义开发一样，始终建议尽可能使用用户会话：

实施工作流进程时：

public void execute(WorkItem item, WorkflowSession workflowSession, MetaDataMap args) throws WorkflowException {
        // to obtain a jcr session:
        javax.jcr.Session jcrSession = workflowSession.adaptTo(javax.jcr.Session.class);

        // to obtain a sling resource resolver:
        org.apache.sling.api.resource.ResourceResolver slingResourceResolver = workflowSession.adaptTo(org.apache.sling.api.resource.ResourceResolver.class);

保存会话：

最大程度地减少启动器的数量/范围 minimize-the-number-scope-of-launchers

有一个侦听器负责已注册的所有工作流启动器：

创建过多启动器将导致评估过程运行速度变慢。

在单个启动器的存储库根目录中创建通配路径会导致工作流引擎侦听并评估存储库中每个节点的创建/修改事件。 因此，建议仅创建所需的启动器，并尽可能具体化全局连接路径。

由于这些启动器对工作流行为的影响，禁用任何未使用的现成启动器也会很有用。

启动器的配置增强功能 configuration-enhancements-for-launchers

自定义启动器配置已得到增强，可支持以下内容：

不要从其他工作流启动工作流 do-not-start-workflows-from-other-workflows

工作流可能会产生大量开销，无论是在内存中创建的对象还是在存储库中跟踪的节点。 因此，最好让工作流在自身中进行处理，而不是启动其他工作流。

例如，某个工作流在一组内容上实施业务流程，然后激活该内容。 最好创建一个自定义工作流进程来激活其中的每个节点，而不是为每个需要发布的内容节点启动​ 激活内容 ​模型。 此方法将需要额外的开发工作，但在执行时比为每个激活启动单独的工作流实例更有效。

另一个示例是处理多个节点、创建工作流包，然后激活所述包的工作流。 您无需创建资源包，然后启动一个将资源包作为有效负载的单独工作流，您可以在创建资源包的步骤中更改工作流的有效负载，然后调用该步骤以激活同一工作流模型中的资源包。

处理程序前进 handler-advance

设计工作流模型时，您可以选择启用工作流步骤上的处理程序前进。 或者，您也可以将代码添加到工作流步骤中，以确定下一步应该运行哪个步骤，然后执行它。

建议使用处理程序前进，因为它可提供更好的性能。

工作流暂存 workflow-stages

您可以定义工作流阶段，然后将任务/步骤分配给特定的工作流阶段。

当您从​ 收件箱 ​🔗​单击工作项的​ 工作流信息 ​选项卡时，此信息用于显示工作流的进度。 可以编辑现有工作流模型以添加暂存。

激活页面流程步骤 activate-page-process-step

激活页面进程 ​步骤将为您激活页面，但不会自动查找任何引用的DAM资产并将其激活。

如果您计划将此步骤用作工作流模型的一部分，请牢记这一点。

升级注意事项 upgrade-considerations

升级实例时：

系统工具 system-tools

有许多系统工具可以帮助监控、维护和排除工作流故障。 以下所有示例URL都使用localhost:4502，但应在任何作者实例(<hostname>:<port>)上可用。

Sling作业处理控制台 sling-job-handling-console

http://localhost:4502/system/console/slingevent

Sling作业处理控制台将显示：

工作流报告工具 workflow-report-tool

将在6.3中删除工作流报告工具，以防止性能下降。

工作流维护操作MBean workflow-maintenance-operations-mbean

http://localhost:4502/system/console/jmx/com.adobe.granite.workflow:type=Maintenance

工作流维护MBean公开了几个有用的维护例程，例如清除已完成的工作流和检索工作流统计信息。

更多信息 further-information

有关更多信息，请参阅：