Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

workflow-development

/workflow-development

Implementuje własne komponenty Java dla AEM Workflow w AEM 6.5 LTS (beta): kroki WorkflowProcess, ParticipantStepChooser, usługi Felix SCR lub OSGi DS R6, MetaDataMap i ładunek JCR przez WorkflowSession.

Repozytorium
skills ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
24.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
10
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 24.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Implementuje własne komponenty Java dla AEM Workflow w AEM 6.5 LTS (beta): kroki WorkflowProcess, ParticipantStepChooser, usługi Felix SCR lub OSGi DS R6, MetaDataMap i ładunek JCR przez WorkflowSession.

Oryginalny opis (EN)

[BETA] Implement custom AEM Workflow Java components on AEM 6.5 LTS. This skill is in beta. Verify all outputs before applying them to production projects. Use when writing WorkflowProcess steps, ParticipantStepChooser implementations, registering services via Felix SCR or DS R6 OSGi annotations, reading step arguments from MetaDataMap, accessing JCR payload via WorkflowSession adapter, reading and writing workflow metadata and variables, and handling errors with WorkflowException for retry behavior.

Jak działa

  1. Variant Scope
  2. Workflow
  3. WorkflowProcess Template — DS R6 (Preferred)
  4. WorkflowProcess Template — Felix SCR (Still Valid)
  5. ParticipantStepChooser Template
  6. Guardrails
  7. References
Sekcje z nagłówków SKILL.md, w oryginale · 108 linii, 439 słów
Podgląd SKILL.md
---
name: workflow-development
description: "[BETA] Implement custom AEM Workflow Java components on AEM 6.5 LTS. This skill is in beta. Verify all outputs before applying them to production projects. Use when writing WorkflowProcess steps, ParticipantStepChooser implementations, registering services via Felix SCR or DS R6 OSGi annotations, reading step arguments from MetaDataMap, accessing JCR payload via WorkflowSession adapter, reading and writing workflow metadata and variables, and handling errors with WorkflowException for retry behavior."
license: Apache-2.0
metadata:
  status: beta
---

# Workflow Development (AEM 6.5 LTS)

> **Beta Skill**: This skill is in beta and under active development.
> Results should be reviewed carefully before use in production.
> Report issues at https://github.com/adobe/skills/issues

Implement custom workflow components for AEM 6.5 LTS: `WorkflowProcess`, `ParticipantStepChooser`, OSGi registration, metadata handling, and error patterns.

## Variant Scope

- AEM 6.5 LTS only.
- Both Felix SCR and DS R6 annotations are supported. DS R6 preferred for new code.
- Bundle deployed via Maven (`autoInstallBundle`) or Package Manager.

## Workflow

```text
Development Progress
- [ ] 1) Identify what the step does: process (auto) or participant (human) or dynamic participant
- [ ] 2) Create Java class implementing WorkflowProcess or ParticipantStepChooser
- [ ] 3) Register with @Component/@Service (Felix SCR) or @Component (DS R6) with service property
- [ ] 4) Read step arguments from MetaDataMap args
- [ ] 5) Access payload via item.getWorkflowData().getPayload().toString()
- [ ] 6) Read/write workflow instance metadata via item.getWorkflowData().getMetaDataMap()
- [ ] 7) Return normally to advance; throw WorkflowException to trigger retry
- [ ] 8) Deploy; verify process.label appears in Workflow Model Editor step picker
```

## WorkflowProcess Template — DS R6 (Preferred)

```java
@Component(
    service = WorkflowProcess.class,
    property = {
        "process.label=My Custom Process Step",
        "service.description=Short description"
    }
)
public class MyCustomProcess implements WorkflowProcess {

    @Reference
    private ResourceResolverFactory resolverFactory;

    @Override
    public void execute(WorkItem item, WorkflowSession session, MetaDataMap args)
            throws WorkflowException {
        String payloadPath = item.getWorkflowData().getPayload().toString();
        String myArg = args.get("myArgKey", "defaultValue");
        item.getWorkflowData().getMetaDataMap().put("processedBy", "my-step");
        // ... do work ...
    }
}
```

## WorkflowProcess Template — Felix SCR (Still Valid)

```java
@Component(metatype = false)
@Service(value = WorkflowProcess.class)
@Property(name = "process.label", value = "My Custom Process Step")
public class MyCustomProcess implements WorkflowProcess {

    @Reference
    private SlingRepository repository;

    @Override
    public void execute(WorkItem item, WorkflowSession session, MetaDataMap args)
            throws WorkflowException {
        // same body as DS R6 example
    }
}
```

## ParticipantStepChooser Template

```java
@Component(
    service = ParticipantStepChooser.class,
    property = {"chooser.label=Department Head Chooser"}
)
public class DepartmentHeadChooser implements ParticipantStepChooser {

    @Override
    public String getParticipant(WorkItem workItem, WorkflowSession session,
                                 MetaDataMap args) throws WorkflowException {
        String department = workItem.getWorkflowData()
                                    .getMetaDataMap().get("department", "marketing");
        return department + "-managers";
    }
}
```

## Guardrails

- Never use `loginAdministrative()`. Always use a service user mapped via `ServiceUserMapper`.
- Felix SCR: keep `metatype=false` unless exposing configuration to the OSGi console.
- Do not mix Felix SCR and DS R6 annotations in the same class.
- Throw `WorkflowException` for retryable errors; log and rethrow for unexpected errors.

## References

- [process-step-patterns.md](./references/workflow-development/process-step-patterns.md) — WorkflowProcess patterns with Felix SCR and DS R6 examples
- [participant-step-patterns.md](./references/workflow-development/participant-step-patterns.md) — ParticipantStepChooser patterns and completing steps
- [variables-and-metadata.md](./references/workflow-development/variables-and-metadata.md) — MetaDataMap, workflow variables, inter-step data
- [api-reference.md](./references/workflow-foundation/api-reference.md)
- [65-lts-guardrails.md](./references/workflow-foundation/65-lts-guardrails.md)
Pliki w paczce (10)
  • SKILL.md 5 KB
  • references/workflow-development/participant-step-patterns.md 5 KB
  • references/workflow-development/process-step-patterns.md 5 KB
  • references/workflow-development/variables-and-metadata.md 3 KB
  • references/workflow-foundation/65-lts-guardrails.md 3 KB
  • references/workflow-foundation/README.md 1 KB
  • references/workflow-foundation/api-reference.md 3 KB
  • references/workflow-foundation/architecture-overview.md 2 KB
  • references/workflow-foundation/jcr-paths-reference.md 2 KB
  • references/workflow-foundation/quick-start-guide.md 2 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · adobe/skills100Apache-2.0
adobe/skills100Apache-2.0

Migawka bazy z 13.11.2026 · wersja paczki 6e7b3e59f450 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100workflow-triggering
    Uruchamia AEM Workflows w AEM 6.5 LTS wszystkimi dostępnymi sposobami: ręcznie z Timeline UI, programowo przez WorkflowSession.startWorkflow(), przez HTTP Workflow API, Manage Publication i wyzwalacze replikacji.
  • 100workflow-triggering
    Uruchamia AEM Workflows w AEM as a Cloud Service wszystkimi dostępnymi sposobami: ręcznie z Timeline UI, programowo przez WorkflowSession.startWorkflow(), przez HTTP Workflow API i Manage Publication.
  • 100aem-doctor
    Sprawdza stan infrastruktury projektu AEM: definicje komponentów, konfiguracje OSGi, reguły dispatchera i strukturę treści, na przykład po zmianach w infrastrukturze.
  • 100aem-fe-verify
    Weryfikuje wizualnie renderowanie komponentu na lokalnym AEM względem projektu w Figmie lub wymagań i w pętli poprawia znalezione rozbieżności.
  • 90Code Review
    Przegląda kod projektów AEM Edge Delivery Services przed commitem lub w pull requestach, z sugestiami zmian w GitHub.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.