DocumentatieAEM 6.5Handboek

Workflowmodellen maken creating-workflow-models

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Ontwikkelaar
CAUTION
Voor gebruik van klassieke UI, zie AEM 6.3 documentatievoor verwijzing.

U creeert het model van het a werkschemaom de reeks uitgevoerde stappen te bepalen wanneer een gebruiker het werkschema begint. U kunt ook modeleigenschappen definiëren, zoals of de workflow van voorbijgaande aard is of meerdere bronnen gebruikt.

Wanneer een gebruiker een werkschema begint, is een instantie begonnen; dit is het overeenkomstige runtime model, dat wordt gecreeerd wanneer u synchroniseertuw veranderingen.

Een nieuwe workflow maken creating-a-new-workflow

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

  • De stappen, Begin van de Stroom en Eind van de Stroom.
    Deze vertegenwoordigen het begin en einde van de workflow. Deze stappen zijn vereist en kunnen niet worden bewerkt/verwijderd.
  • Een voorbeeld genoemde stap van de Deelnemer 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 workflow maken met de editor:

  1. Open de Modellen van het Werkschema console; via Hulpmiddelen, Werkschema, Modellen of, bijvoorbeeld: https://localhost:4502/aem/workflow
  2. Selecteer creeer, dan creeer Model.
  3. Het voegt de dialoog van het Model van het Werkschema toe verschijnt. Ga de Titel en Naam (facultatief) in alvorens te selecteren Gedaan.
  4. Het nieuwe model wordt vermeld in de Modellen van het Werkschema console.
  5. Selecteer uw nieuw werkschema, dan gebruik geeft uit om het voor configuratiete openen:
    wf-01
NOTE
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 omslag kan dan voor het leiden toegang tot de modellen in die omslagworden gebruikt.

Een workflow bewerken editing-a-workflow

U kunt elk bestaand workflowmodel bewerken in:

Het uitgeven a Gebrek en/of Verouderd (uit-van-de-doos) werkschemaheeft een extra stap, om ervoor te zorgen dat a veilige exemplaarvoorafgaand aan uw veranderingen wordt genomen die worden aangebracht.

Wanneer de updates aan uw werkschema volledig zijn moet u Synchronisatie gebruiken een Model van Runtime produceren. Zie Synchroniseer uw Werkschemavoor details.

Uw workflow synchroniseren - Een runtimemodel genereren sync-your-workflow-generate-a-runtime-model

Synchronisatie (recht in de redacteurstoolbar) produceert a runtime model. Het runtimemodel is het model dat daadwerkelijk wordt gebruikt wanneer een gebruiker een workflow start. Als u niet synchroniseert uw veranderingen, dan zullen de veranderingen niet beschikbaar bij runtime zijn.

Wanneer u (of een andere gebruiker) om het even welke veranderingen in het werkschema aanbrengt moet u Synchronisatie gebruiken om een runtime model te produceren - zelfs wanneer de individuele dialogen (bijvoorbeeld, voor stappen) hun eigen sparen opties hebben gehad.

Wanneer de veranderingen met runtime (bewaard) model worden gesynchroniseerd, Gesynchroniseerd wordt in plaats daarvan getoond.

Sommige stappen hebben verplichte velden en/of ingebouwde validatie. Wanneer deze voorwaarden niet worden voldaan aan een fout wordt getoond wanneer u aan synchronisatie probeert het model. Bijvoorbeeld, wanneer geen deelnemer voor de stap van a Deelnemer is bepaald:

wf-21

Een standaardworkflow of oudere workflow voor het eerst bewerken editing-a-default-or-legacy-workflow-for-the-first-time

Wanneer u a Gebrek en/of Verouderd modelvoor het uitgeven opent:

  • De browser Stappen is niet beschikbaar (links).

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

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

    • Standaardworkflows staan in /libs
    • Oudere workflows staan in /etc
      Het selecteren geeft uit zal:

  • neem een kopie van de workflow naar /conf

  • stelt browser Stappen ter beschikking

  • laten u veranderingen aanbrengen

NOTE
Zie Plaatsen van de Modellen van het Werkschemavoor verdere informatie.

wf-22

Een stap toevoegen aan een model adding-a-step-to-a-model

Voeg stappen aan uw model toe 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 uitgeeft, verschijnen de beschikbare stappen in de diverse groepen van browser van Stappen. Bijvoorbeeld:

wf-10

NOTE
Voor informatie over de primaire stapcomponenten die met AEM geïnstalleerd zijn, zie {de Verwijzing van de Stappen van het 0} Werkschema 🔗.

Stappen toevoegen aan uw workflowmodel:

  1. Open een bestaand workflowmodel voor bewerking. Van de console van het Model van de Werkschema's, selecteer het vereiste model, dan geef uit.

  2. Open browser van Stappen; het gebruiken van Knevel Zijpaneel, uiterst links van de hoogste toolbar. Hier kunt u:

    • Filter voor specifieke stappen.
    • Gebruik de keuzelijst om de selectie te beperken tot een specifieke groep stappen.
    • Selecteer het pictogram van de Beschrijving van de Show 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, de Stap van de a Deelnemer.

    Zodra toegevoegd aan de stroom kunt u de stapvormen.

    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, bestaande stappen kopiëren knippen, kleven, groeperen of schrappen; zoals met de paginaredacteur.

    De gespleten stappen kunnen ook worden doen ineenstorten/worden uitgebreid gebruikend de toolbaroptie: wf-doen ineenstorten-toolbar-pictogram

  5. Bevestig de veranderingen met Synchronisatie (redacteurstoolbar) om het runtime model te produceren.

    Zie Synchroniseer uw Werkschemavoor details.

Een workflowstap configureren configuring-a-workflow-step

U kunt vormen en het gedrag van een werkschemastap aanpassen gebruikend de 3} dialoogvensters van de Eigenschappen van de Stap {.

  1. Om de dialoog van de Eigenschappen van de Stap voor een stap te openen of:

    • Klik* *step in het werkschemamodel en selecteer vormen van de componententoolbar.

    • Dubbelklik op de stap.

    note note
    NOTE
    Voor informatie over de primaire stapcomponenten die met AEM geïnstalleerd zijn, zie {de Verwijzing van de Stappen van het 0} Werkschema 🔗.

  2. Vorm de Eigenschappen van de Stap zoals vereist; de beschikbare eigenschappen hangen van het stappentype af, kunnen er verscheidene beschikbare lusjes ook zijn. Bijvoorbeeld, de standaard Stap van de Deelnemer, in een nieuw werkschema als Step 1 aanwezig:

    wf-11

  3. Bevestig uw updates met de tik.

  4. Bevestig de veranderingen met Synchronisatie (redacteurstoolbar) om het runtime model te produceren.

    Zie Synchroniseer uw Werkschemavoor details.

Een tijdelijke workflow maken creating-a-transient-workflow

U kunt het model van het a Voorbijgaandewerkschema tot stand brengen wanneer het creëren van een model, of door bestaande te uitgeven:

  1. Open het werkschemamodel voor het uitgeven.

  2. Selecteer ModelEigenschappen van het Werkschema van de toolbar.

  3. In de dialoog activeer het Voorbijgaande Werkschema (of deactiveer indien nodig):

    wf-07

  4. Bevestig de verandering met sparen & sluit; gevolgd door Synchronisatie (redacteurstoolbar) om het runtime model te produceren.

    Zie Synchroniseer uw Werkschemavoor details.

NOTE
Wanneer u een werkschema in werking stelt op transientwijze AEM slaat geen werkschemageschiedenis op. Daarom toont de Chronologiegeen informatie met betrekking tot dat werkschema.

Workflowmodellen beschikbaar stellen in Touch UI classic2touchui

Als een workflowmodel aanwezig is in de klassieke gebruikersinterface, maar ontbreekt in het pop-upmenu Selectie in de Timeline -rail van de Touch-gebruikersinterface, volgt u de configuratie om het beschikbaar te maken. De volgende stappen illustreren het gebruik van het workflowmodel Request for Activation .

  1. Bevestig dat het model niet beschikbaar is in een interface met aanraakbediening. Gebruik een /assets.html/content/dam -pad om een element te openen. Selecteer een element. Open Timeline in linkerraster. Klik op Start Workflow en bevestig dat het Request for Activation -model niet aanwezig is in de pop-uplijst.

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

  3. Selecteer Create > Create Tag. Stel Title in op DAM en Name op dam . Selecteer Submit .
    creeer markering in werkschemamodel

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

  5. Selecteer Edit , open het menu Page Information en selecteer vervolgens Open Properties en ga naar de tab Basic (als deze nog niet is geopend).

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

  7. Bevestig de toevoeging van de tag met Save & Close .
    geef de Eigenschappen van de Pagina van Model uit

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

Een workflow configureren voor ondersteuning van meerdere bronnen configuring-a-workflow-for-multi-resource-support

U kunt een werkschemamodel voor de Multi Steun van het Middelvormen wanneer het creëren van een model, of door bestaande uit te geven:

  1. Open het werkschemamodel voor het uitgeven.

  2. Selecteer ModelEigenschappen van het Werkschema van de toolbar.

  3. In de dialoog activeer (of deactiveer indien nodig) de Steun van het Meervoudige Middel:

    wf-08

  4. Bevestig de verandering met sparen & sluit; gevolgd door Synchronisatie (redacteurstoolbar) om het runtime model te produceren.

    Zie Synchroniseer uw Werkschemavoor details.

Werkstroomfasen configureren (die de voortgang van de workflow weergeven) configuring-workflow-stages-that-show-workflow-progress

de Stages van het Werkschemahulp visualiseert de vooruitgang van een werkschema wanneer het behandelen van taken.

CAUTION
Als de werkschemastadia in Eigenschappen van de Pagina worden bepaald, maar niet voor om het even welke werkschemastappen worden gebruikt, dan zal de vooruitgangsbar geen vooruitgang tonen (ongeacht de huidige werkschemastap).

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.

Om Stages voor uw werkschema te bepalen:

  1. Open uw workflowmodel voor bewerking.

  2. Selecteer ModelEigenschappen van het Werkschema van de toolbar. Dan open de Stages tabel.

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

    Bijvoorbeeld:

    wf-08-1

  4. Klik sparen & Sluiten om de eigenschappen te bewaren.

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

    wf-09

    Een werkgebied kan aan meerdere stappen worden toegewezen. Bijvoorbeeld:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
    Stap Stadium
    Stap 1 Maken
    Stap 2 Maken
    Stap 3 Controleren
    Stap 4 Goedkeuren
    Stap 5 Goedkeuren
    Stap 6 Voltooid

  6. Bevestig de veranderingen met Synchronisatie (redacteurstoolbar) om het runtime model te produceren.

    Zie Synchroniseer uw Werkschemavoor details.

Een workflowmodel exporteren in een pakket exporting-a-workflow-model-in-a-package

Een workflowmodel exporteren in een pakket:

  1. Creeer een pakket gebruikend de Manager van het Pakket:

    1. Navigeer aan de Manager van het Pakket via Hulpmiddelen, Plaatsing, Pakketten.

    2. Klik Create Pakket.

    3. Specificeer de Naam van het Pakket, en om het even welke andere details zoals vereist.

    4. Klik OK.

  2. Klik uitgeven op de toolbar van uw nieuw pakket.

  3. Open de Filters tabel.

  4. Selecteer filter toevoegen en de weg van uw werkschemamodel ontwerp specificeren:

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

    Klik Gedaan.

  5. Selecteer toevoegen Filter en specificeer de weg van uw runtime werkschemamodel:

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

    Klik Gedaan.

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

  7. Klik sparen om uw filterdefinities te bevestigen.

  8. Selecteer Bouwstijl van de toolbar van uw pakketdefinitie.

  9. Selecteer Download van de pakkettoolbar.

Workflows gebruiken om formulierverzendingen te verwerken using-workflows-to-process-form-submissions

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 pagina en open deze voor bewerking.

  2. Voeg de component van de a Vorm aan de pagina toe.

  3. vormt de 3} component van het Begin van de Vorm {die in de pagina verscheen.

  4. Het Werkschema van het Begin van het gebruik om het gewenste werkschema van die beschikbare te selecteren:

    wf-12

  5. Bevestig de nieuwe formulierconfiguratie met de tik.

Testworkflows testing-workflows

Het is een goede praktijk wanneer het testen van een werkschema om een verscheidenheid van ladingstypes te gebruiken; met inbegrip van types die verschillend zijn aan die waarvoor het is ontwikkeld. Als u bijvoorbeeld van plan bent om met Assets om te gaan, 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. Begin uw werkschemamodelvan de console.

  2. Bepaal Payload en bevestig.

  3. Voer de vereiste handelingen uit om de workflow te laten doorgaan.

  4. Controleer de logbestanden terwijl de workflow wordt uitgevoerd.

U kunt AEM ook vormen om te tonen DEBUG berichten in de logboekdossiers. Zie het Registrerenvoor verdere informatie en wanneer de ontwikkeling wordt gebeëindigd, plaats het Niveau van het Logboek terug naar Info.

Voorbeelden examples

Voorbeeld: een (eenvoudige) workflow maken om een aanvraag voor publicatie te accepteren of af te wijzen example-creating-a-simple-workflow-to-accept-or-reject-a-request-for-publication

In het volgende voorbeeld wordt een variatie van de Publish Example -workflow gemaakt om enkele mogelijkheden voor het maken van een workflow te illustreren.

  1. creeer een werkschemamodel.

    De nieuwe workflow bevat:

    • Begin van de Stroom
    • Step 1
    • Eind van de Stroom

  2. Verwijderen Step 1 (omdat dit het verkeerde staptype is voor dit voorbeeld):

    • Klik op de stap en selecteer Schrapping van de componententoolbar. Bevestig de handeling.

  3. Van de selectie van het Werkschema van de stappen browser, sleep de Stap van de a Deelnemer op het werkschema en plaats het tussen Begin van de Stroom en Eind van de Stroom.

  4. U opent als volgt het dialoogvenster Eigenschappen:

    • Klik op de deelnemersstap en selecteer vormen van de componententoolbar.
    • Dubbelklik op de stap Deelnemer.

  5. In het Gemeenschappelijke lusje gaat Validate Content voor zowel de Titel als Beschrijving in.

  6. Open het Gebruiker/Groep lusje:

    • Activeer bericht gebruiker via e-mail.
    • Selecteer Administrator ( admin) voor het Gebruiker/Groep gebied.
    note note
    NOTE
    Voor te verzenden e-mail, de postdienst en de details van de gebruikersrekening moeten worden gevormd.

  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 of Gesplitste op het werkschema en plaats het tussen Validate Content en Eind van de Stroom.

  9. Open of Gesplitst voor configuratie.

  10. Configureren:

    • Gemeenschappelijk: specificeer de gespleten naam.

    • Tak 1: uitgezochte StandaardRoute.

    • Tak 2: zorg ervoor StandaardRoute niet wordt geselecteerd.

  11. Bevestig uw updates aan OF Splitst.

  12. Sleep de Stap van de a Deelnemer aan de linkertak, open de eigenschappen, specificeer de volgende waarden, dan bevestig de veranderingen:

    • Titel: Reject Publish Request

    • Gebruiker/Groep: bijvoorbeeld, projects-administrators

    • deelt gebruiker via e-mail mee: Activeer om de gebruiker te hebben die door e-mail op de hoogte wordt gebracht.

  13. Sleep de Stap van het a Proces aan de rechtertak, open de eigenschappen, specificeer de volgende waarden, dan bevestig de veranderingen:

    • Titel: Publish Page as Requested

    • Proces: uitgezochte Activate Page. Dit proces publiceert de geselecteerde pagina naar de uitgeversinstanties.

  14. Klik Synchronisatie (redacteurstoolbar) om het runtime model te produceren.

    Zie Synchroniseer uw Werkschemavoor details.

    Uw nieuwe workflowmodel ziet er als volgt uit:

    wf-13

  15. Pas dit werkschema op uw pagina toe, zodat wanneer de gebruiker zich aan voltooit de Bevestigt Inhoud stap, zij kunnen selecteren of zij Publish Pagina zoals Gevraagd willen, of het Verzoek van Publish van de Weigering.

    chlimage_1-72

Voorbeeld: Een regel definiëren voor een OR-splitsing met behulp van ECMA-script defineruleecmascript

OF Splitste stappen laat u voorwaardelijke verwerkingswegen in uw werkschema introduceren.

Ga als volgt te werk om een OR-regel te definiëren:

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

    /apps/myapp/workflow/scripts

    note note
    NOTE
    De manuscripten moeten a functie check() hebben die een booleaanse winst.

  2. Bewerk het werkschema en voeg OF Gesplitst aan het model toe.

  3. Bewerk de eigenschappen van Tak 1 van OF Gesplitst:

    • Bepaal dit als StandaardRoute door de Waarde aan true te plaatsen.

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

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

    note note
    NOTE
    U kunt de vertakkingsvolgorde desgewenst wijzigen.

  4. Bewerk de eigenschappen van Tak 2 van OF Splitst.

    • Als Regel, 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 de Gebruiker/Groep wordt geplaatst.

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

    Zie Synchroniseer uw Werkschemavoor details.

Functie check() function-check

NOTE
Zie Gebruikend ECMAScript.

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 example-customized-request-for-activation

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

Bijvoorbeeld, Verzoek om Activering. Dit werkschema wordt gebruikt voor het publiceren van pagina's binnen Plaatsen en wordt automatisch teweeggebracht wanneer een inhoudsauteur niet de aangewezen replicatierechten heeft. Zie het Aanpassen van de Authoring van de Pagina - het Verzoek om het Werkschema van de Activeringvoor verdere details aanpassen.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2