Best practices voor workflow workflow-best-practices

Met workflows kunt u Adobe Experience Manager-activiteiten (AEM) automatiseren.

Ze vertegenwoordigen vaak een groot deel van de verwerking die plaatsvindt in een AEM omgeving. Wanneer aangepaste workflowstappen niet volgens de beste praktijken worden geschreven, of workflows buiten de doos niet zodanig worden geconfigureerd dat ze zo efficiënt mogelijk worden uitgevoerd, kan het systeem hiervan de gevolgen ondervinden.

Daarom wordt u ten zeerste aangeraden de implementaties van uw workflows zorgvuldig te plannen.

Configuratie configuration

Bij het configureren van workflowprocessen (aangepast en/of out-of-the-box) zijn er een aantal zaken die in gedachten moeten worden gehouden.

Tijdelijke workflows transient-workflows

Voor het optimaliseren van hoge inname kunt u een workflow als tijdelijk.

Wanneer een werkstroom van voorbijgaande aard is, worden de runtime gegevens met betrekking tot de tussenliggende werkstappen niet voortgeduurd in JCR wanneer zij lopen (de uitvoeruitvoeruitvoeruitvoeringen blijven natuurlijk voortbestaan).

De voordelen kunnen zijn:

DAM-workflows afstemmen tuning-dam-workflows

Voor richtlijnen voor het afstemmen van prestaties voor DAM-workflows raadpleegt u de AEM Assets Performance Tuning Guide.

Het maximumaantal gelijktijdige workflows configureren configure-the-maximum-number-of-concurrent-workflows

AEM kunnen meerdere workflowthreads tegelijk uitvoeren. Door gebrek wordt het aantal draden gevormd om de helft van het aantal bewerkerkernen op het systeem te zijn.

In gevallen waarin de workflows die worden uitgevoerd veeleisend zijn aan systeembronnen, kan dit betekenen dat er weinig over AEM is om te gebruiken voor andere taken, zoals het renderen van de ontwerpgebruikersinterface. Hierdoor kan het systeem traag zijn tijdens activiteiten zoals het uploaden van grote hoeveelheden afbeeldingen.

Adobe raadt u aan het aantal Maximale parallelle taken tussen de helft en driekwart van het aantal processorkernen op het systeem. Dit moet voldoende capaciteit voor het systeem om ontvankelijk te blijven wanneer het verwerken van deze werkschema's.

Om te vormen Maximale parallelle taken kunt u:

Bovendien is er een afzonderlijke configuratie voor Graniet Workflow External Process Job Queue. Dit wordt gebruikt voor workflowprocessen waarmee externe binaire bestanden worden gestart, zoals InDesign Server of Afbeeldingsgrootte.

Afzonderlijke taakwachtrij configureren configure-individual-job-queues

In sommige gevallen is het nuttig om individuele baanrijen te vormen om gezamenlijke draden, of andere rijopties, op een individuele baanbasis te controleren. U kunt een individuele rij van de console van het Web via toevoegen en vormen Configuratie Apache Sling-taakwachtrij fabriek. Om het aangewezen onderwerp te vinden om een lijst te maken, voer het model van uw werkschema uit en zoek het in Verkooptaken console; bijvoorbeeld bij http://localhost:4502/system/console/slingevent.

Afzonderlijke taakwachtrijen kunnen ook worden toegevoegd voor tijdelijke werkstromen.

Workflow leegmaken configureren configure-workflow-purging

In een standaardinstallatie AEM een onderhoudsconsole biedt waar dagelijkse en wekelijkse onderhoudsactiviteiten kunnen worden gepland en geconfigureerd; bijvoorbeeld :

http://localhost:4502/libs/granite/operations/content/maintenance.html

Standaard worden de Wekelijks onderhoudvenster heeft een Werkstroom leegmaken taak, maar dit moet worden gevormd alvorens het zal lopen. Voor het configureren van werkstroompuren wordt een nieuwe Adobe Granite-werkstroom leegmaken configuratie moet in de console van het Web worden toegevoegd.

Zie voor meer informatie over onderhoudstaken in AEM Operations-dashboard.

Aanpassing customization

Bij het schrijven van aangepaste workflowprocessen moet u rekening houden met een aantal zaken.

Locaties locations

Definities van workflowmodellen, draagraketten, scripts en meldingen worden in de gegevensopslagruimte opgeslagen volgens het type; d.w.z. out-of-the-box, aangepast, enz.

Locaties - workflowmodellen locations-workflow-models

Workflowmodellen worden in de opslagplaats opgeslagen volgens het type:

Locaties - Workflowstartprogramma's locations-workflow-launchers

Werkstroomstartdefinities worden ook volgens het type opgeslagen in de opslagplaats:

Locaties - Workflowscripts locations-workflow-scripts

Workflowscripts worden ook in de repository opgeslagen volgens het type:

Locaties - Workflowmeldingen locations-workflow-notifications

Workflowmeldingen worden ook opgeslagen in de repository volgens het type:

Processessies process-sessions

Net als bij elke aangepaste ontwikkeling wordt altijd aangeraden de sessie van een gebruiker te gebruiken als dat mogelijk is:

Bij het implementeren van een workflowproces:

public void execute(WorkItem item, WorkflowSession workflowSession, MetaDataMap args) throws WorkflowException {
        // to obtain a jcr session:
        javax.jcr.Session jcrSession = workflowSession.adaptTo(javax.jcr.Session.class);

        // to obtain a sling resource resolver:
        org.apache.sling.api.resource.ResourceResolver slingResourceResolver = workflowSession.adaptTo(org.apache.sling.api.resource.ResourceResolver.class);

Een sessie opslaan:

Aantal/bereik van opstarters minimaliseren minimize-the-number-scope-of-launchers

Er is één listener die verantwoordelijk is voor alle workflowstartprogramma's die zijn geregistreerd:

Het maken van te veel draagraketten zorgt ervoor dat het evaluatieproces langzamer wordt uitgevoerd.

Door een globbingpad in de basis van de opslagplaats te maken op één startpunt, zou de workflowengine luisteren naar gebeurtenissen voor het maken/wijzigen van gebeurtenissen in elk knooppunt in de opslagplaats en deze evalueren. Daarom wordt aangeraden alleen de nodige draagraketten te maken en het globbende pad zo specifiek mogelijk te maken.

Vanwege de invloed van deze draagraketten op het workflowgedrag, kan het ook handig zijn om alle draagraketten die niet in gebruik zijn, uit te schakelen.

Verbeterde configuratie voor opstartprogramma's configuration-enhancements-for-launchers

De aangepaste opstartconfiguratie is uitgebreid ter ondersteuning van het volgende:

Workflows niet starten vanuit andere Workflows do-not-start-workflows-from-other-workflows

Workflows kunnen een aanzienlijke hoeveelheid overhead met zich meebrengen, zowel in termen van objecten die in het geheugen zijn gemaakt als van knooppunten die in de opslagplaats worden bijgehouden. Daarom is het beter om een workflow op zichzelf te laten verwerken in plaats van extra workflows te laten starten.

Een voorbeeld hiervan is een workflow die een bedrijfsproces implementeert op een set inhoud en die inhoud vervolgens activeert. Het is beter een aangepast workflowproces te maken dat elk van deze knooppunten activeert in plaats van een Inhoud activeren model voor elk van de inhoudsknooppunten die moeten worden gepubliceerd. Deze benadering vereist extra ontwikkelingswerk, maar is efficiënter wanneer uitgevoerd dan het beginnen van een afzonderlijke werkschemainstantie voor elke activering.

Een ander voorbeeld zou een werkschema zijn dat een aantal knopen verwerkt, tot een werkschemapakket leidt, dan genoemd pakket activeert. In plaats van het pakket te maken en vervolgens een aparte workflow te starten met het pakket als de lading, kunt u de lading van uw workflow wijzigen in de stap die het pakket maakt en vervolgens de stap aanroepen om het pakket te activeren binnen hetzelfde workflowmodel.

Handler Advance handler-advance

Bij het ontwerpen van een workflowmodel hebt u de optie om de handler in staat te stellen de stappen van uw workflow te doorlopen. U kunt ook code toevoegen aan de workflowstap om te bepalen welke stap vervolgens moet worden uitgevoerd en vervolgens moet worden uitgevoerd.

Het wordt aanbevolen om de voortgang van de handlers te gebruiken omdat deze betere prestaties levert.

Werkstroomfasen workflow-stages

U kunt werkstroomfasenen wijst u vervolgens taken/stappen toe aan een specifieke werkstroomfase.

Deze informatie wordt gebruikt voor het weergeven van de voortgang van een workflow wanneer u op de knop Workflowinfo tabblad van een werkitem van het tabblad Inbox. Bestaande workflowmodellen kunnen worden bewerkt om stadia toe te voegen.

Stap in paginaproces activeren activate-page-process-step

De Paginaproces activeren Met deze stap worden pagina's voor u geactiveerd, maar worden DAM-middelen waarnaar wordt verwezen, niet automatisch gevonden en worden deze ook geactiveerd.

Dit is iets om in mening te houden als u deze stap als deel van een werkschemamodel wilt gebruiken.

Overwegingen voor upgrades upgrade-considerations

Wanneer u uw exemplaar upgradet:

Systeemgereedschappen system-tools

Er zijn vele systeemhulpmiddelen beschikbaar om met controle, het handhaven, en het oplossen van problemenwerkschema's te helpen. Alle onderstaande voorbeeld-URL's localhost:4502, maar moet beschikbaar zijn voor elke instantie van de auteur ( <hostname>:<port>).

Sling Job Handling Console sling-job-handling-console

http://localhost:4502/system/console/slingevent

De Sling Job Handling-console geeft het volgende weer:

Workflow Report Tool workflow-report-tool

Het werkstroomrapportagehulpprogramma wordt verwijderd in 6.3 om te voorkomen dat de prestaties afnemen.

Workflowonderhoudsbewerkingen MBean workflow-maintenance-operations-mbean

http://localhost:4502/system/console/jmx/com.adobe.granite.workflow:type=Maintenance

Het werkstroomonderhoud MBean stelt verscheidene nuttige onderhoudroutines zoals het zuiveren van voltooide werkschema's en het terugwinnen van werkschemastatistieken bloot.

Aanvullende informatie further-information

Zie voor meer informatie: