Workflowmodellen maken

LET OP

Voor gebruik van de klassieke interface raadpleegt u de AEM 6.3 documentatie ter referentie.

U maakt een workflowmodel om de reeks stappen te definiëren die worden uitgevoerd wanneer een gebruiker de workflow start. U kunt ook modeleigenschappen definiëren, zoals of de workflow van voorbijgaande aard is of meerdere bronnen gebruikt.

Wanneer een gebruiker een workflow start, wordt een instantie gestart; Dit is het corresponderende runtimemodel dat wordt gemaakt wanneer u uw wijzigingen Sync wijzigt.

Een nieuwe workflow maken

Wanneer u voor het eerst een nieuw workflowmodel maakt, bevat dit model:

  • De stappen Flow Start en Flow End.

    Deze vertegenwoordigen het begin en einde van de workflow. Deze stappen zijn vereist en kunnen niet worden bewerkt of verwijderd.

  • Een voorbeeld Deelnemer stap genoemd Stap 1.

    Deze stap wordt gevormd om een het werkpunt aan de werkschemainitiatiefnemer toe te wijzen. Bewerk of verwijder deze stap en voeg desgewenst stappen toe.

Een nieuwe workflow maken met de editor:

  1. Open de Workflow Models console; door middel van Tools, Workflow, Models of, bijvoorbeeld:

    http://localhost:4502/aem/workflow

  2. Selecteer Create en Create Model.

  3. Het dialoogvenster Add Workflow Model wordt weergegeven. Voer Title en Name (optioneel) in voordat u Done selecteert.

  4. Het nieuwe model wordt vermeld in de Workflow Models console.

  5. Selecteer uw nieuwe werkschema, dan gebruik Edit​om het voor configuratie te openen:

    wf-01

OPMERKING

Als u met programmacode modellen maakt (met behulp van een crx-pakket), kunt u ook een submap maken binnen:

/var/workflow/models

Bijvoorbeeld, /var/workflow/models/prototypes

Deze map kan vervolgens worden gebruikt voor het beheren van de toegang tot de modellen in die map.

Een workflow bewerken

U kunt elk bestaand workflowmodel bewerken in:

Het uitgeven van Standaard of Verouderd (uit-van-de-doos) werkschema heeft een extra stap, om ervoor te zorgen dat een veilige exemplaar wordt genomen alvorens uw veranderingen wordt aangebracht.

Wanneer updates van uw workflow zijn voltooid, moet u Sync tot Generate a Runtime Model gebruiken. Zie Uw workflow synchroniseren voor meer informatie.

Synchroniseer uw Workflow - Genereer een Runtime Model

Met Sync (rechts op de editor-werkbalk) wordt een runtimemodel gegenereerd. Het runtimemodel is het model dat daadwerkelijk wordt gebruikt wanneer een gebruiker een workflow start. Als u uw wijzigingen niet Sync, dan zijn de wijzigingen niet beschikbaar bij uitvoering.

Wanneer u (of een andere gebruiker) wijzigingen aanbrengt in de workflow, moet u Sync gebruiken om een runtimemodel te genereren, zelfs wanneer afzonderlijke dialoogvensters (bijvoorbeeld voor stappen) hun eigen opslagopties hebben.

Wanneer de wijzigingen worden gesynchroniseerd met het (opgeslagen) runtimemodel, wordt in plaats daarvan Synched weergegeven.

Sommige stappen hebben verplichte velden en/of ingebouwde validatie. Wanneer niet aan deze voorwaarden wordt voldaan, wordt een fout weergegeven wanneer u Sync het model probeert te vervangen. Wanneer bijvoorbeeld geen deelnemer is gedefinieerd voor een stap Participant:

wf-21

Een standaard- of verouderde workflow voor het eerst bewerken

Wanneer u een Standaard en/of Verouderd model voor het uitgeven opent:

  • De browser Steps is niet beschikbaar (linkerkant).

  • Er is een Edit actie beschikbaar in de toolbar (rechterkant).

  • In eerste instantie worden het model en de eigenschappen ervan in de modus Alleen-lezen weergegeven als:

    • Standaardworkflows bevinden zich in /libs
    • Verouderde workflows bevinden zich in /etc

Als u Edit selecteert, wordt:

  • een kopie van de workflow opnemen in /conf
  • de Steps-browser beschikbaar stellen
  • laten u toe om veranderingen aan te brengen
OPMERKING

Zie Locaties van workflowmodellen voor meer informatie.

wf-22

Een stap toevoegen aan een model

U moet stappen aan uw model toevoegen om de uit te voeren activiteit te vertegenwoordigen - elke stap voert een specifieke activiteit uit. Een selectie van stapcomponenten is beschikbaar in een standaard AEM instantie.

Wanneer u een model bewerkt, worden de beschikbare stappen weergegeven in de verschillende groepen van de browser Steps. Bijvoorbeeld:

wf-10

OPMERKING

Voor informatie over de primaire stapcomponenten die met AEM worden geïnstalleerd, zie Referentie van de Stappen van het Werkschema.

Een stap toevoegen aan een model:

  1. Open een bestaand workflowmodel voor bewerking. Selecteer in de Workflows Model-console het vereiste model en Edit.

  2. Open de browser Steps; met Toggle Side Panel, helemaal links van de bovenste werkbalk. Hier kunt u:

    • Filter voor specifieke stappen.
    • Gebruik de keuzelijst om de selectie te beperken tot een specifieke groep stappen.
    • Selecteer het pictogram Beschrijving tonen wf-stepinfo-icon om meer details over de aangewezen stap te tonen.

    wf-02

  3. Sleep de desbetreffende stap(en) naar de gewenste locatie in het model.

    Bijvoorbeeld een Participant Step.

    Nadat het aan de stroom wordt toegevoegd kunt u de stap vormen.

    wf-03

  4. Voeg zo veel stappen, of andere updates toe, zoals vereist.

    Tijdens de uitvoering worden de stappen uitgevoerd in de volgorde waarin ze in het model worden weergegeven. Nadat u de onderdelen met stappen hebt toegevoegd, kunt u deze naar een andere locatie in het model slepen.

    U kunt ook bestaande stappen kopiëren, knippen, plakken, groeperen of verwijderen. zoals met de paginaredacteur.

    Gesplitste stappen kunnen ook worden samengevouwen/uitgevouwen met de werkbalkoptie: wf-collapse-toolbar-icon

  5. Bevestig de wijzigingen met Sync (editorwerkbalk) om het runtimemodel te genereren.

    Zie Uw workflow synchroniseren voor meer informatie.

Een workflowstap configureren

U kunt Configureren en het gedrag van een workflowstap aanpassen met de dialoogvensters Step Properties.

  1. U opent als volgt het dialoogvenster Step Properties voor een stap:

    • Tik op de stap in het workflowmodel en selecteer Configure in de werkbalk van de component.
    • Dubbelklik op de stap.
    OPMERKING

    Voor informatie over de primaire stapcomponenten die met AEM worden geïnstalleerd, zie Referentie van de Stappen van het Werkschema.

  2. Configureer Step Properties naar wens; Welke eigenschappen beschikbaar zijn, is afhankelijk van het type stap. Er kunnen ook verschillende tabbladen beschikbaar zijn. Bijvoorbeeld de standaard Participant Step, aanwezig in een nieuwe werkstroom als Step 1:

    wf-11

  3. Bevestig uw updates met de tik.

  4. Bevestig de wijzigingen met Sync (editorwerkbalk) om het runtimemodel te genereren.

    Zie Uw workflow synchroniseren voor meer informatie.

Een tijdelijk werkschema maken

U kunt een transient werkschemamodel tot stand brengen wanneer het creëren van een nieuw model, of door bestaande uit te geven:

  1. Open het workflowmodel voor bewerken.

  2. Selecteer Workflow Model Properties van de toolbar.

  3. Activeer Transient Workflow in het dialoogvenster (of deactiveer desgewenst):

    wf-07

  4. Bevestig de wijziging met Save & Close; gevolgd door Sync (editor-werkbalk) om het runtimemodel te genereren.

    Zie Uw workflow synchroniseren voor meer informatie.

OPMERKING

Wanneer u een werkschema in transient wijze in werking stelt AEM slaat geen werkschemageschiedenis op. Daarom geeft Timeline geen informatie weer met betrekking tot die workflow. 🔗

Workflowmodellen beschikbaar maken in Touch UI

Als een workflowmodel aanwezig is in de klassieke gebruikersinterface, maar ontbreekt in het pop-upmenu voor selectie in de Timeline-rail van de aanraakinterface, volgt u de configuratie om het beschikbaar te maken. De volgende stappen illustreren het gebruiken van het werkschemamodel genoemd Request for Activation.

  1. Bevestig dat het model niet beschikbaar is in een interface met aanraakbediening. Benader een element via het pad /assets.html/content/dam. Selecteer een element. Open Timeline in linkerspoor. Klik Start Workflow en bevestig dat het model Request for Activation niet aanwezig in popup lijst is.

  2. Navigeer door Tools > General > Tagging. Selecteer Workflow.

  3. Selecteer Create > Create Tag. Stel Title in als DAM en Name als dam. Selecteer Submit.
    Tag maken in workflowmodel

  4. Ga naar Tools > Workflow > Models. Selecteer Request for Activation en selecteer Edit.

  5. Selecteer Edit en open Workflow Model Properties. Ga naar het tabblad Basic.

  6. Voeg Workflow : DAM aan Tags gebied toe. Bevestig de selectie met de controle (kruis).

  7. Bevestig de toevoeging van de tag met Save & Close.
    Pagina-eigenschappen van model bewerken

  8. Voltooi het proces met Sync. De workflow is nu beschikbaar in de interface voor aanraakbediening.

Een workflow configureren voor ondersteuning van meerdere bronnen

U kunt een workflowmodel configureren voor Ondersteuning voor meerdere bronnen bij het maken van een nieuw model of door een bestaand model te bewerken:

  1. Open het workflowmodel voor bewerken.

  2. Selecteer Workflow Model Properties van de toolbar.

  3. Activeer Multi Resource Support in het dialoogvenster (of deactiveer desgewenst):

    wf-08

  4. Bevestig de wijziging met Save & Close; gevolgd door Sync (editor-werkbalk) om het runtimemodel te genereren.

    Zie Uw workflow synchroniseren voor meer informatie.

Werkstroomfasen configureren (die de voortgang van het werkschema weergeven)

Workflowwerkstroomoverzicht visualiseert de voortgang van een workflow bij het uitvoeren van taken.

LET OP

Als werkstroomfasen worden gedefinieerd in Page Properties maar niet worden gebruikt voor een van de werkstroomstappen, wordt op de voortgangsbalk geen voortgang weergegeven (ongeacht de huidige werkstroomstap).

De stadia die beschikbaar moeten zijn, worden gedefinieerd in de workflowmodellen; bestaande workflowmodellen kunnen worden bijgewerkt met werkgebieddefinities. U kunt een willekeurig aantal fasen voor het workflowmodel definiëren.

Stages definiëren voor uw workflow:

  1. Open uw workflowmodel voor bewerking.

  2. Selecteer Workflow Model Properties van de toolbar. Open vervolgens het tabblad Stages.

  3. Voeg (en plaats) uw vereiste Stages toe. U kunt een willekeurig aantal fasen voor het workflowmodel definiëren.

    Bijvoorbeeld:

    wf-08-1

  4. Klik Save & Close om de eigenschappen op te slaan.

  5. Wijs een werkgebied aan elk van de stappen in het werkschemamodel toe. Bijvoorbeeld:

    wf-09

    Een werkgebied kan aan meerdere stappen worden toegewezen. Bijvoorbeeld:

    Stap Werkgebied
    Stap 1 Maken
    Stap 2 Maken
    Stap 3 Controleren
    Stap 4 Goedkeuren
    Stap 5 Goedkeuren
    Stap 6 Voltooid
  6. Bevestig de wijzigingen met Sync (editorwerkbalk) om het runtimemodel te genereren.

    Zie Uw workflow synchroniseren voor meer informatie.

Een workflowmodel exporteren in een pakket

  1. Maak een nieuw pakket met de Package Manager:

    1. Navigeer naar Pakketbeheer met Tools, Deployment, Packages.
    2. Klik op Create Package.
    3. Geef Package Name op en geef desgewenst andere gegevens op.
    4. Klik op OK.
  2. Klik op Edit op de werkbalk van het nieuwe pakket.

  3. Open het tabblad Filters.

  4. Selecteer Add Filter en geef het pad van uw workflowmodel op design:

    /conf/global/settings/workflow/models/<*your-model-name*>

    Klik op Done.

  5. Selecteer Add Filter en geef het pad op van uw runtime-workflowmodel:

    /var/workflow/models/<*your-model-name*>

    Klik op Done.

  6. Voeg extra filters toe voor om het even welke douanescripts die door uw model worden gebruikt.

  7. Klik Save om uw filterdefinities te bevestigen.

  8. Selecteer Build van de toolbar van uw pakketdefinitie.

  9. Selecteer Download van de pakkettoolbar.

Workflows gebruiken om formulierverzendingen te verwerken

U kunt een formulier configureren voor verwerking door de geselecteerde workflow. Wanneer gebruikers het formulier verzenden, wordt een nieuwe werkstroominstantie gemaakt met de gegevens van het verzenden van het formulier als lading.

U configureert als volgt de workflow die met het formulier moet worden gebruikt:

  1. Maak een nieuwe pagina en open deze voor bewerking.

  2. Voeg een Form component aan de pagina toe.

  3. Configureer de Form Start-component die op de pagina werd weergegeven.

  4. Gebruik Start Workflow om de gewenste workflow te selecteren uit de beschikbare workflows:

    wf-12

  5. Bevestig de nieuwe formulierconfiguratie met de tik.

Workflows testen

Het is een goede praktijk wanneer het testen van een werkschema om een verscheidenheid van ladingstypes te gebruiken; met inbegrip van typen die verschillen van de soorten waarvoor zij is ontwikkeld. Als u bijvoorbeeld van plan bent om in uw workflow te werken met Elementen, test u deze door een Pagina in te stellen als een payload en controleer of er geen fouten optreden.

Test bijvoorbeeld de nieuwe workflow als volgt:

  1. Start uw workflowmodel vanuit de console.

  2. Bepaal Payload en bevestig.

  3. Voer de vereiste handelingen uit zodat de workflow doorgaat.

  4. Controleer de logbestanden terwijl de workflow wordt uitgevoerd.

U kunt ook AEM configureren om DEBUG-berichten weer te geven in de logbestanden. Zie Logging voor meer informatie en wanneer de ontwikkeling wordt gebeëindigd, plaats Log Level terug aan Info.

Voorbeelden

Voorbeeld: Een (eenvoudige) workflow maken om een verzoek om publicatie te accepteren of af te wijzen

Om enkele mogelijkheden te illustreren om een werkschema tot stand te brengen, leidt het volgende voorbeeld tot een variatie van de Publish Example werkschema.

  1. Maak een nieuw workflowmodel.

    De nieuwe workflow bevat:

    • Flow Start
    • Step 1
    • Flow End
  2. Step 1 verwijderen (omdat dit het verkeerde staptype is voor dit voorbeeld):

    • Klik op de stap en selecteer Delete in de werkbalk van de component. Bevestig de handeling.
  3. Sleep een Participant Step naar de werkstroom en plaats deze tussen Flow Start en Flow End vanuit de selectie van de stappen-browser.Workflow

  4. U opent als volgt het dialoogvenster Eigenschappen:

    • Klik op de deelnemersstap en selecteer Configure van de componententoolbar.
    • Dubbelklik op de stap voor deelnemers.
  5. Typ op het tabblad Common Validate Content voor zowel Title als Description.

  6. Open het tabblad User/Group:

    • Activeer Notify user via email.
    • Selecteer Administrator ( admin) voor het User/Group gebied.
    OPMERKING
  7. Bevestig de updates met de tik.

    U wordt teruggestuurd naar het overzicht van het workflowmodel, waar de naam van de deelnemer is gewijzigd in Validate Content.

  8. Sleep een Or Split op het werkschema en plaats het tussen Validate Content en Flow End.

  9. Open Or Split voor configuratie.

  10. Configureren:

    • Common: select 2 Branches
    • Branch 1: select Default Route.
    • Branch 2: ervoor zorgen dat Default Route deze niet is geselecteerd.
  11. Bevestig uw updates aan OR Split.

  12. Sleep een Participant Step naar de linkervertakking, open de eigenschappen, specificeer de volgende waarden, dan bevestig de veranderingen:

    • Title: Reject Publish Request
    • User/Group: bijvoorbeeld: projects-administrators
    • Notify user via email: Activeer deze functie om de gebruiker per e-mail op de hoogte te stellen.
  13. Sleep een Process Step naar de rechtervertakking, open de eigenschappen, geef de volgende waarden op en bevestig de wijzigingen:

    • Title: Publish Page as Requested
    • Process: select Activate Page. Dit proces publiceert de geselecteerde pagina naar de uitgeversinstanties.
  14. Klik Sync (redacteurstoolbar) om het runtime model te produceren.

    Zie Uw workflow synchroniseren voor meer informatie.

    Uw nieuwe workflowmodel ziet er als volgt uit:

    wf-13

  15. Pas deze workflow toe op de pagina, zodat de gebruiker Complete de stap Validate Content kan plaatsen en kan kiezen of hij of zij Publish Page as Requested of Reject Publish Request wenst.

    chlimage_1-182

Voorbeeld: Een regel definiëren voor een OF-splitsing

OR Split Met de stappen kunt u voorwaardelijke verwerkingspaden in uw workflow opnemen.

Een OR-regel definiëren:

  1. Maak twee scripts en sla deze op in de repository, bijvoorbeeld onder:

    /apps/myapp/workflow/scripts

    OPMERKING

    De scripts moeten een functie check() hebben die een booleaanse waarde retourneert.

  2. Bewerk de workflow en voeg de OR Split toe aan het model.

  3. Bewerk de eigenschappen van Branch 1 van OR Split:

    • Definieer dit als Default Route door Value aan true te plaatsen.

    • Als Rule, plaats de weg aan het manuscript. Bijvoorbeeld:

      /apps/myapp/workflow/scripts/myscript1.ecma

    OPMERKING

    U kunt de vertakkingsvolgorde desgewenst wijzigen.

  4. Bewerk de eigenschappen van Branch 2 van OR Split.

    • Als Rule, plaats de weg aan het andere manuscript. Bijvoorbeeld:

      /apps/myapp/workflow/scripts/myscript2.ecma

  5. Stel de eigenschappen van de afzonderlijke stappen in elke vertakking in. Zorg ervoor User/Group wordt geplaatst.

  6. Klik Sync (redacteurstoolbar) om uw veranderingen in het runtime model voort te zetten.

    Zie Uw workflow synchroniseren voor meer informatie.

Functiecontrole()

OPMERKING

Zie ECMAScript gebruiken.

Het volgende voorbeeldscript retourneert true als het knooppunt een JCR_PATH onder /content/we-retail/us/en is:

function check() {
    if (workflowData.getPayloadType() == "JCR_PATH") {
      var path = workflowData.getPayload().toString();
      var node = jcrSession.getItem(path);

      if (node.getPath().indexOf("/content/we-retail/us/en") >= 0) {
       return true;
      } else {
       return false;
      }
     } else {
      return false;
     }
}

Voorbeeld: Aangepast verzoek om activering

U kunt om het even welke uit-van-de-doos workflows aanpassen. Voor aangepast gedrag bedekt u de details van de juiste workflow.

Bijvoorbeeld, Request for Activation. Deze workflow wordt gebruikt voor het publiceren van pagina's binnen Sites en wordt automatisch geactiveerd wanneer een auteur van inhoud niet de juiste replicatierechten heeft. Zie Paginaontwerp aanpassen - Het verzoek om activeringsworkflow aanpassen voor meer informatie.

Op deze pagina