ÃÛ¶¹ÊÓƵ

Administering Workflows administering-workflows

CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our . Find the supported versions here.

Workflows enable you to automate ÃÛ¶¹ÊÓƵ Experience Manager (AEM) activities. Workflows:

  • Consist of a series of steps that are executed in a specific order.

    • Each step performs a distinct activity; such as waiting for user input, activating a page or sending an email message.
  • Can interact with assets in the repository, user accounts, and AEM services.

  • Can coordinate complicated activities that involve any aspect of AEM.

The business processes that your organization has established can be represented as workflows. For example, the process of publishing website content typically includes steps such as approval and sign-off by various stakeholders. These processes can be implemented as AEM workflows and applied to content pages and assets.

NOTE
For further information see:

Workflow Models and Instances workflow-models-and-instances

Workflow models in AEM are the representation and implementation of business processes:

  • Typically they act on pages or assets to achieve a specific result.
  • These pages and/or assets are called the workflow payload.
  • Workflow models consist of a series of steps that perform a specific task.
  • The payload is passed from step to step as the workflow progresses.

When a workflow model is started (executed), a workflow instance is created. A workflow model can be started multiple times, each time generating a distinct workflow instance. For each instance, the steps that the workflow model defines are executed.

CAUTION
The steps performed are those defined by the workflow model at the time the instance is generated. See Developing Workflows for further details.

Workflow instances progress through the following lifecycle:

  1. The workflow model is started and a workflow instance is created and running.

    1. The payload of the workflow instance is identified when the model is started.
    2. The instance is effectively a copy of the model (as at the time of creation).
    3. AEM authors, administrators, or services can start workflow models.
  2. The first step of the workflow model is executed.

  3. The step is completed and the workflow engine uses the model to determine the next step to execute.

  4. The subsequent steps in the workflow model are executed and completed.

  5. When the final step is completed, the workflow instance is completed and therefore archived.

Many useful workflow models are provided with AEM. In addition, the developers in your organization can create custom workflow models, tailored to the specific needs of your business processes.

Workflow Steps workflow-steps

When workflow steps are executed, they are associated with a workflow instance. The history of a workflow instance includes information about each step that has executed for the instance. This information is useful for investigating problems that occur during execution.

Either a user or a service performs workflow steps, depending on the type of step:

  • When a user performs a step, they are assigned a work item that is placed in their Inbox. The user is responsible for manually completing the step so that the workflow instance progresses.
  • When a service performs a step, upon completion the workflow instance progresses automatically to the next step.
NOTE
If an error occurs, the service/step implementation should handle behavior for an error scenario. The workflow engine itself will retry the job, then log an error and stop the instance.

Workflow Status and Actions workflow-status-and-actions

A workflow can have one of the following status:

  • RUNNING: The workflow instance is running.

  • COMPLETED: The workflow instance has been successfully ended.

  • SUSPENDED: The workflow instance has been suspended.

  • ABORTED: The workflow instance has been terminated.

  • STALE: Progression of the workflow instance requires that a background job executes, however the job cannot be found in the system. This situation can occur when an error occurs when executing the workflow.

NOTE
When the execution of a Process Step results in errors, the step appears in the administrator’s Inbox and the workflow status is RUNNING.

Depending on the current status, you can perform actions on running workflow instances when you need to intervene in the normal progression of a workflow instance:

  • Suspend: Temporarily stops the execution of the workflow. Suspending is useful in exceptional cases when you do not want the workflow to proceed, for example for maintenance. Suspending changes the workflow state to Suspended.
  • Resume: Restarts a suspended workflow at the same point of execution where it was suspended, using the same configuration.
  • Terminate: Ends the workflow execution and changes the state to ABORTED. An aborted workflow instance cannot be restarted.
recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8