Forms-centric AEM workflows enable you to automate real-world Forms-centric business processes. Workflows consist of a series of steps that execute in an order specified in the associated workflow model. Each step performs a specific action such as assigning a task to a user or sending an email message. Workflows can interact with assets in the repository, user accounts, and services. Therefore, workflows can coordinate complicated activities that involve any aspect of Experience Manager.
A forms-centric workflow can be triggered or launched through any of the following methods:
- Submitting an application from AEM Inbox
- Submitting an application from AEM Forms App
- Submitting an adaptive form
- Using a watched folder
- Submitting an interactive communication or a letter
For more information about Forms-centric AEM workflows and capabilities, see Forms-centric workflow on OSGi.
When a workflow is triggered, a payload is auto-generated for the workflow instance. Each workflow instance is assigned a unique instance ID and an associated payload ID. The payload contains the repository locations for user and form data associated with a workflow instance. In addition, drafts and historical data for a workflow instance are also stored in the AEM repository.
The default repository locations where payload, drafts, and history of a workflow instance reside are as follows:
You can configure different locations to store payload, draft, and history data when creating a workflow or application. To identify the locations where a workflow or application stored data, review the workflow.
|AEM 6.4 Forms||AEM 6.3 Forms|
You can access and delete user data from a workflow instance in the repository. To achieve this, you must know the instance ID of the workflow instance associated with the user. You can find instance ID of a workflow instance by using the user name of the user who initiated the workflow instance or who is the current assignee of the workflow instance.
However, you cannot identify or the results may be ambiguous when identifying workflows associated with an initiator in the following scenarios:
- Workflow triggered through a watched folder: A workflow instance cannot be identified using its initiator if the workflow is triggered by a watched folder. In this case, the user information is encoded in the stored data.
- Workflow initiated from publish AEM instance: All workflow instances are created using a service user when adaptive forms, interactive communications, or letters are submitted from AEM publish instance. In these cases, the user name of the logged-in user is not captured in the workflow instance data.
Depending on the available information, execute one of the following queries:
- Execute the following if the workflow initiator is known:
SELECT * FROM [cq:Workflow] AS s WHERE ISDESCENDANTNODE([path-to-workflow-instances]) and s.[initiator]='initiator-ID'
- Execute the following if the user whose data you are finding is the current workflow assignee:
SELECT * FROM [cq:WorkItem] AS s WHERE ISDESCENDANTNODE([path-to-workflow-instances]) and s.[assignee]='assignee-id'
The query returns the location of all workflow instances for the specified workflow initiator or the current workflow assignee.
For example, the following query returns two workflow instances path from the /var/workflow/instances node whose workflow initiator is srose.
Navigate to the locations for drafts and history for the workflow instance.
AEM Forms app also stores data in offline mode. It is possible that data for a workflow instance is locally stored on individual devices and gets submitted to the Forms server when the app synchronizes with the server.
You must be an AEM administrator to delete user data from workflow instances by performing the following steps:
Follow the instructions in Access user data and take note of the following:
- Paths to workflow instances associated with the user
- Status of the workflow instances
- Paths to payloads for the workflow instances
- Paths to drafts and history for the workflow instances
Perform this step for workflow instances in RUNNING, SUSPENDED, or STALE status:
- Go to http://[server]:[port]/aem/start.html and log in with administrator credentials.
- Navigate to Tools > Workflow> Instances.
- Select relevant workflow instances for the user and tap Terminate to terminate running instances.
For more information about working with workflow instances, see Administering Workflow Instances.