workflow-development

Develop custom AEM Workflow Java components with OSGi DS annotations.

1|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/adobe/aem-auth-demo --skill workflow-development-adobe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow-development
Source: https://github.com/adobe/aem-auth-demo/tree/main/.agents/skills/workflow-development
Command: npx skills add https://github.com/adobe/aem-auth-demo --skill workflow-development-adobe

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Implement custom AEM Workflow Java components for Cloud Service to orchestrate automated, reliable content workflows, including WorkflowProcess steps, ParticipantStepChooser logic, and robust error handling.

Core Features & Use Cases

  • Create and register WorkflowProcess steps and ParticipantStepChooser implementations using OSGi DS annotations.
  • Read and write workflow metadata via MetaDataMap, and access payload through WorkflowSession.
  • Handle retries and failures with WorkflowException to support deterministic retry behavior in Cloud Service deployments.
  • Deploy and manage models and service configurations via Cloud Manager for AEM Cloud Service workflows.

Quick Start

Create a minimal Cloud Service workflow with a custom WorkflowProcess and ParticipantStepChooser, then deploy via Cloud Manager and verify the model appears in the editor.

Frequently Asked Questions about workflow-development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create custom AEM Cloud Service workflow steps using OSGi DS annotations?

To create AEM Cloud Service workflow steps, implement the WorkflowProcess interface and register it using OSGi DS R6 annotations. This deploys your custom Java component to execute automated logic within AEM workflow models.

How do I implement a dynamic participant step chooser in AEM workflows?

Implement a ParticipantStepChooser interface using OSGi DS annotations and access workflow data via MetaDataMap to dynamically route AEM workflows to specific users or groups.

How does WorkflowException handle retries in AEM Cloud Service workflows?

Throwing a WorkflowException in your WorkflowProcess step enables robust retry logic for AEM Cloud Service workflows. This signals the workflow engine to re-execute the failed step, ensuring deterministic retry behavior.

How do I read and write workflow metadata in AEM using MetaDataMap?

Read and write AEM workflow metadata using the MetaDataMap object within your WorkflowProcess or ParticipantStepChooser implementation to pass arguments and state between workflow steps.

What are the deployment guardrails for AEM Cloud Service workflow models?

AEM Cloud Service deployment guardrails restrict workflow models to mutable paths like /var/workflow and configurations to /conf/global. Custom OSGi components must respect immutable paths and utilize proper service users.