Projecten ontwikkelen in AEM

Maak eerst een map onder /apps/<your-app-folder> genaamd projects . Maak een andere map onder de naam templates .

/apps/aem-guides/projects-tasks/
                    + projects (nt:folder)
                             + templates (nt:folder)

Om dingen gemakkelijker te maken, zullen wij ons douanemalplaatje van het bestaande Eenvoudige malplaatje van het Project beginnen.

1. Kopieer en kleef de knoop /libs/cq/core/content/projects/templates/default onder de malplaatjes omslag die in Stap 1 wordt gecreeerd.

/apps/aem-guides/projects-tasks/
             + templates (nt:folder)
                  + default (cq:Template)

U zou nu een weg zoals /apps/aem-gidsen/projecten-taken/projecten/malplaatjes/authoring-project moeten hebben.

1. Bewerk jcr:titel en jcr:beschrijving eigenschappen van de auteur-project knoop aan douanetitel en beschrijvingswaarden.

   1. Verlaat het tovenaar bezit richtend aan de eigenschappen van het standaardProject.

/apps/aem-guides/projects-tasks/projects/
         + templates (nt:folder)
              + authoring-project (cq:Template)
                   - jcr:title = "Authoring Project"
                   - jcr:description = "A project to manage approval and publish process for AEM Sites or Assets"
                   - wizard = "/libs/cq/core/content/projects/wizard/steps/defaultproject.html"

Voor dit projectmalplaatje willen wij gebruik maken van Taken.

1. Voeg een nieuwe niet toe:ongestructureerde knoop onder authoring-project/gadgets geroepen taken.
2. Voeg de eigenschappen van het Koord aan de takenknoop voor cardWeight toe = "100", jcr:title= "Taken", en het sling:resourceType= "cq/gui/components/projects/admin/pod/taskpod".

Nu zal de tegel van Takendoor gebrek tonen wanneer een nieuw project wordt gecreeerd.

../projects/templates/authoring-project
    + gadgets (nt:unstructured)
         + team (nt:unstructured)
         + asset (nt:unstructured)
         + work (nt:unstructured)
         + experiences (nt:unstructured)
         + projectinfo (nt:unstructured)
         ..
         + tasks (nt:unstructured)
              - cardWeight = "100"
              - jcr:title = "Tasks"
              - sling:resourceType = "cq/gui/components/projects/admin/pod/taskpod"

We voegen een aangepaste rol fiatteur toe aan ons projectsjabloon.

1. Onder het projectmalplaatje (creatie-project) knoop voegt een nieuwe niet toe:ongestructureerde knoop-geëtiketteerde rollen.

2. Voeg een andere niet toe:ongestructureerde knoop geëtiketteerd goedkeurt als kind van de rolknoop.

3. Voeg de eigenschappen van het Koord jcr toe:titel = "Approvers", roleclass ="eigenaar", roleid="goedkeurt".

   1. De naam van het knooppunt fiatteurs en jcr:title en roleid kunnen elke tekenreekswaarde zijn (zolang roleid uniek is).
   2. roleclass regeert de toestemmingen die voor die rol worden toegepast op de drie rollen OTBworden gebaseerd: eigenaar, redacteur, en waarnemer.
   3. In het algemeen als de douanerol meer van een beheerdersrol dan is kan de roleclass eigenaar zijn; als het een specifiekere auteursrol zoals Fotograaf of Designer dan redacteursklasse roleclass zou moeten volstaan. Het grote verschil tussen eigenaar en redacteur is dat de projecteigenaars de projecteigenschappen kunnen bijwerken en nieuwe gebruikers aan het project toevoegen.

../projects/templates/authoring-project
    + gadgets (nt:unstructured)
    + roles (nt:unstructured)
        + approvers (nt:unstructured)
             - jcr:title = "Approvers"
             - roleclass = "owner"
             - roleid = "approver"

Door het Eenvoudige malplaatje van het Project te kopiëren, zult u vier gevormde werkschema's OOTB krijgen. Elk knooppunt onder workflows/modellen verwijst naar een specifieke workflow en een wizard voor begindialoogvenster voor die workflow. Later in deze zelfstudie maken we een aangepaste workflow voor dit project. Verwijder voorlopig de knooppunten onder workflow(en):

../projects/templates/authoring-project
    + gadgets (nt:unstructured)
    + roles (nt:unstructured)
    + workflows (nt:unstructured)
         + models (nt:unstructured)
            - (remove ootb models)

Om het voor inhoudsauteurs gemakkelijk te maken om het Malplaatje van het Project te identificeren kunt u een douaneminiatuur toevoegen. De aanbevolen grootte is 319x319 pixels.

1. In CRXDE Lite creeer een dossier als sibling van gadgets, rollen, en werkstroomknopen genoemd thumbnail.png.
2. Sla het knooppunt op, navigeer naar het knooppunt jcr:content en dubbelklik op de eigenschap jcr:data (klik niet op 'view').
   1. Hiermee wordt u gevraagd een dialoogvenster voor het bewerken van jcr:data -bestanden te openen en kunt u een aangepaste miniatuur uploaden.

../projects/templates/authoring-project
    + gadgets (nt:unstructured)
    + roles (nt:unstructured)
    + workflows (nt:unstructured)
    + thumbnail.png (nt:file)

Navigeer in het menu Start AEM naar Extra -> Workflow -> Modellen. Klik op 'Maken' in de rechterbovenhoek om een workflowmodel te maken.

Geef het nieuwe model een titel: "Workflow voor inhoudsgoedkeuring" en een URL-naam: "workflow voor inhoudsgoedkeuring".

voor meer informatie met betrekking tot het creëren van werkschema's, lees hier.

Aangepaste workflows kunt u het beste groeperen in een eigen map onder /etc/workflow/modellen. In CRXDE Lite, creeer a "niet:omslag" onder /etc/workflow/modellen genoemd "aem-gidsen". Als u een submap toevoegt, zorgt u ervoor dat aangepaste workflows niet per ongeluk worden overschreven tijdens upgrades of Service Pack-installaties.

* Nota het is belangrijk om nooit de omslag of douanewerkschema's onder wortelsubfolders zoals /etc/workflow/models/dam of /etc/workflow/models/projecten te plaatsen aangezien volledige subfolder ook door verbeteringen of de dienstpakken kan worden beschreven.

Locatie van het workflowmodel in 6.3

NOTE

Als AEM 6.4+ wordt gebruikt, is de locatie van de workflow gewijzigd. Zie hier voor meer details.

Als u AEM 6.4+ gebruikt, wordt het workflowmodel onder /conf/global/settings/workflow/models gemaakt. Herhaal bovenstaande stappen met de map /conf en voeg een submap met de naam aem-guides toe en verplaats de map content-approval-workflow eronder.

Locatie van workflowmodel in 6.4+

De introductie in AEM 6.3 is de mogelijkheid werkstroomfasen toe te voegen aan een bepaalde werkstroom. De fasen worden aan de gebruiker weergegeven vanuit het Postvak In op het tabblad Workflowinfo. Het toont de gebruiker het huidige werkgebied in het werkschema evenals de stadia voorafgaand aan en na het.

Als u de fasen wilt configureren, opent u het dialoogvenster Pagina-eigenschappen vanuit de Sidekick. Het vierde tabblad heet "Stages". Voeg de volgende waarden toe om de drie fasen van deze workflow te configureren:

1. Inhoud bewerken
2. Goedkeuring
3. Publish

Configureer de werkstroomfasen in het dialoogvenster Pagina-eigenschappen.

De werkstroomvoortgangsbalk zoals deze wordt weergegeven in het AEM Inbox.

Naar keuze kunt u een Beeld aan de Eigenschappen van de Pagina uploaden die als duimnagel van het Werkschema wordt gebruikt wanneer de gebruikers het selecteren. Afbeeldingsafmetingen moeten 319x319 pixels zijn. Het toevoegen van a Beschrijving aan de Eigenschappen van de Pagina zal ook verschijnen wanneer een gebruiker het werkschema gaat selecteren.

Het workflowproces Projecttaak maken is ontworpen om een taak te maken als een stap in de workflow. Pas na het voltooien van de taak gaat de workflow verder. Een krachtig aspect van de stap van de Taak van het Project creëren is dat het werkschema meta-gegevens waarden kan lezen en die gebruiken om de taak dynamisch tot stand te brengen.

Verwijder eerst de Stap van de Deelnemer die standaard wordt gemaakt. Van de Sidekick in het componentenmenu breidt uit "Projecten" onderverdeling en sleep + laat vallen "creëren de Taak van het Project" op het model.

Dubbelklik op de stap Projecttaak maken om het workflowdialoogvenster te openen. Configureer de volgende eigenschappen:

Dit tabblad wordt veel gebruikt voor alle stappen in het workflowproces en we stellen de Titel en Beschrijving in (deze zijn niet zichtbaar voor de eindgebruiker). Het belangrijke bezit dat wij zullen plaatsen is het Stadium van het Werkschema aan "geeft Inhoud" van het drop-down menu uit.

Common Tab
-----------------
    Title = "Start Task Creation"
    Description = "This the first task in the Workflow"
    Workflow Stage = "Edit Content"

Het workflowproces Projecttaak maken is ontworpen om een taak te maken als een stap in de workflow. Met het tabblad Taak kunnen we alle waarden van de taak instellen. In ons geval willen we dat de ontvanger dynamisch is, dus laten we hem leeg. De overige eigenschapswaarden:

Task Tab
-----------------
    Name* = "Edit Content"
    Task Priority = "Medium"
    Description = "Edit the content and finalize for approval. Once finished submit for approval."
    Due In - Days = "2"

Het verpletterende lusje is een facultatieve dialoog die beschikbare acties voor de gebruiker kan specificeren die de taak voltooit. Deze handelingen zijn alleen tekenreekswaarden en worden opgeslagen in de metagegevens van de workflow. Deze waarden kunnen door manuscripten en/of processtappen later in het werkschema worden gelezen om de werkschema dynamisch "te leiden". Op basis van de workflowdoelstellingen die we gaan uitvoeren, voegt u drie acties toe aan dit tabblad:

Routing Tab
-----------------
    Actions =
        "Normal Approval"
        "Rush Approval"
        "Bypass Approval"

Dit lusje staat ons toe om een pre-Create Manuscript van de Taak te vormen waar wij kunnen programmatically diverse waarden van de Taak beslissen alvorens het wordt gecreeerd. U kunt het script verwijzen naar een extern bestand of een kort script rechtstreeks in het dialoogvenster insluiten. In ons geval wijzen we het script voor het maken van taken naar een extern bestand. In Stap 5 zullen wij dat manuscript tot stand brengen.

Advanced Settings Tab
-----------------
   Pre-Create Task Script = "/apps/aem-guides/projects/scripts/start-task-config.ecma"

In de vorige stap hebben we verwezen naar een Pre-Create Taakscript. Wij zullen dat manuscript nu tot stand brengen waarin wij de Ontvanger van de Taak zullen plaatsen die op de waarde van een waarde van werkschemagegevens "wordt gebaseerd toegewezen". De "toegewezen" waarde wordt geplaatst wanneer het werkschema weg wordt geschopt. Wij zullen ook de werkschemameta-gegevens lezen om de prioriteit van de taak dynamisch te kiezen door "taskPriority"te lezen waarde van de meta-gegevens van het werkschema evenals "taskdueDate" ​ aan dynamisch te plaatsen wanneer de eerste taak wordt vereist.

Voor organisatorische doeleinden hebben we onder onze toepassingsmap een map gemaakt voor al onze projectgerelateerde scripts: /apps/aem-guides/projects-tasks/projects/scripts . Creeer een dossier onder deze omslag genoemd "start-task-config.ecma". * Nota zorgt ervoor de weg aan uw begin-taak-config.ecma- dossier de weg aanpast die op het Geavanceerde Lusje van Montages in Stap 4 wordt geplaatst.

Voeg het volgende toe als de inhoud van het bestand:

// start-task-config.ecma
// Populate the task using values stored as workflow metadata originally posted by the start workflow wizard

// set the assignee based on start workflow wizard
var assignee = workflowData.getMetaDataMap().get("assignee", Packages.java.lang.String);
task.setCurrentAssignee(assignee);

//Set the due date for the initial task based on start workflow wizard
var dueDate = workflowData.getMetaDataMap().get("taskDueDate", Packages.java.util.Date);
if (dueDate != null) {
    task.setProperty("taskDueDate", dueDate);
}

//Set the priority based on start workflow wizard
var taskPriority = workflowData.getMetaDataMap().get("taskPriority", "Medium");
task.setProperty("taskPriority", taskPriority);

Navigeer terug naar de workflow voor goedkeuring van inhoud. Sleep+Daling OF Splitste component (die in de Sidekick onder de "categorie van het Werkschema"wordt gevonden) onder de 3} Stap van de Taak van het Begin {. Selecteer in het dialoogvenster Algemeen het keuzerondje voor 3 vertakkingen. OR Splitst zal de waarde van werkschemameta-gegevens "lastTaskAction" lezen om de route van het werkschema te bepalen. Het "lastTaskAction" bezit wordt geplaatst aan één van de waarden van het Verpletterende Lusje dat in Stap 4 wordt gevormd. Voor elk van de lusjes van de Tak vult het 1} de tekstgebied van het Manuscript {met de volgende waarden uit:

function check() {
var lastAction = workflowData.getMetaDataMap().get("lastTaskAction","");

if(lastAction == "Normal Approval") {
    return true;
}

return false;
}

function check() {
var lastAction = workflowData.getMetaDataMap().get("lastTaskAction","");

if(lastAction == "Rush Approval") {
    return true;
}

return false;
}

function check() {
var lastAction = workflowData.getMetaDataMap().get("lastTaskAction","");

if(lastAction == "Bypass Approval") {
    return true;
}

return false;
}

* Nota wij doen een directe gelijke van het Koord om de route te bepalen zodat is het belangrijk dat de waarden die in de manuscripten van de Tak worden geplaatst de waarden van de Route aanpassen die in Stap 4 worden geplaatst.

Sleep+Daling een andere "creeer de Taak van het Project"stap op het model aan uiterst links (Tak 1) onder OF spleet. Vul het dialoogvenster met de volgende eigenschappen in:

Common Tab
-----------------
    Title = "Approval Task Creation"
    Description = "Create a an approval task for Project Approvers. Priority is Medium."
    Workflow Stage = "Approval"

Task Tab
------------
    Name* = "Approve Content for Publish"
    Task Priority = "Medium"
    Description = "Approve this content for publication."
    Days = "5"

Routing Tab - Actions
----------------------------
    "Approve and Publish"
    "Send Back for Revision"

Aangezien dit de Normale route van de Goedkeuring is wordt de prioriteit van de taak geplaatst aan Medium. Daarnaast geven we de groep fiatteurs vijf dagen om de taak te voltooien. De toegewezen persoon wordt leeg gelaten op het tabblad Taak aangezien wij dit dynamisch zullen toewijzen op het tabblad Geavanceerde instellingen. Wij geven de Approvers groep twee mogelijke routes wanneer het voltooien van deze taak: "keur en Publish" goed als zij de inhoud goedkeuren en het kan worden gepubliceerd en "verzend terug voor Herziening" als er kwesties zijn die de originele redacteur moet verbeteren. De fiatteur kan commentaren verlaten die de originele redacteur zal zien of is het werkschema teruggekeerd aan hem/haar.

Sleep+Daling een andere "creeer de Taak van het Project"stap op het model aan de middentak (Tak 2) onder OF spleet. Vul het dialoogvenster met de volgende eigenschappen in:

Common Tab
-----------------
    Title = "Rush Approval Task Creation"
    Description = "Create a an approval task for Project Approvers. Priority is High."
    Workflow Stage = "Approval"

Task Tab
------------
    Name* = "Rush Approve Content for Publish"
    Task Priority = "High"
    Description = "Rush approve this content for publication."
    Days = "1"

Routing Tab - Actions
----------------------------
    "Approve and Publish"
    "Send Back for Revision"

Aangezien dit de route van de Goedkeuring van Rusland is wordt de prioriteit van de taak geplaatst aan Hoog. Daarnaast geven we de groep fiatteurs slechts één dag om de taak te voltooien. De toegewezen persoon wordt leeg gelaten op het tabblad Taak aangezien wij dit dynamisch zullen toewijzen op het tabblad Geavanceerde instellingen.

Wij kunnen het zelfde manuscriptfragment zoals in Stap 7 opnieuw gebruiken om het manuscript tekst-gebied op het ​ Geavanceerde Montages ​ tab te bevolken. Kopiëren en de onderstaande code plakken:

var projectApproverGrp = workflowData.getMetaDataMap().get("project.group.approvers","administrators");

task.setCurrentAssignee(projectApproverGrp);

Sleep een component ​ Geen bewerking naar de vertakking uiterst rechts (vertakking 3). De component Geen bewerking voert geen handeling uit en wordt onmiddellijk uitgevoerd, omdat de oorspronkelijke editor de goedkeuringsstap wil omzeilen. Technisch gezien konden wij deze Tak zonder enige werkschemastappen verlaten, maar als beste praktijken zullen wij een Geen stap van de Verrichting toevoegen. Dit maakt het aan andere ontwikkelaars duidelijk wat het doel van Tak 3 is.

Dubbelklik op de workflowstap en configureer de titel en beschrijving:

Common Tab
-----------------
    Title = "Bypass Approval"
    Description = "Placeholder step to indicate that the original editor decided to bypass the approver group."

Het model van het Werkschema zou als dit moeten kijken nadat alle drie takken in OF verdeeld zijn gevormd.

Aangezien de Approvers groep de optie heeft om het werkschema terug naar de originele redacteur voor verdere revisies te verzenden zullen wij op de Goto stap vertrouwen om de laatste genomen actie te lezen en het werkschema aan het begin te leiden of het te laten verdergaan.

Sleep en zet de component Goto Step (gevonden in de Sidekick onder Workflow) onder OF spleet waar deze opnieuw wordt samengevoegd. Dubbelklik op de volgende eigenschappen en configureer deze in het dialoogvenster:

Common Tab
----------------
    Title = "Goto Step"
    Description = "Based on the Approver groups action route the workflow to the beginning or continue and publish the payload."

Process Tab
---------------
    The step to go to. = "Start Task Creation"

Het laatste stuk dat wij zullen vormen is het Manuscript als deel van Goto processtap. De scriptwaarde kan worden ingesloten via het dialoogvenster of worden geconfigureerd om te wijzen naar een extern bestand. Goto Manuscript moet a functiecontrole () bevatten en waar terugkeren als het werkschema naar de gespecificeerde stap zou moeten gaan. Als er false worden geretourneerd, gaat de workflow verder.

Als de goedkeurende groep "achteruit voor Herziening" actie (gevormd in Stap 7 en 8) kiest dan willen wij het werkschema aan de "Taakverwezenlijking van het Begin"terugkeren stap.

Voeg op het tabblad Proces het volgende fragment toe aan het tekstgebied Script:

function check() {
var lastAction = workflowData.getMetaDataMap().get("lastTaskAction","");

if(lastAction == "Send Back for Revision") {
    return true;
}

return false;
}

Om te publiceren zullen wij de nuttige lading gebruiken de weg pagina/activa stap van het Proces activeren. Deze processtap vereist weinig configuratie en zal de nuttige lading van het werkschema aan de replicatierij voor activering toevoegen. Wij zullen de stap onder de stap van de Goto toevoegen en op deze manier kan het slechts worden bereikt als de groep Approver de inhoud voor publicatie heeft goedgekeurd of de originele redacteur de route van de Goedkeuring van de Bypass koos.

Sleep+Daling activeer de stap van het het Proces van de Pagina/van Activa (die in de Sidekick onder Werkschema WCM) onder de Stap van het Goto in het model wordt gevonden.

Hoe moet het workflowmodel eruitzien nadat u de stap Ga naar hebt toegevoegd en de stap Pagina/element activeren hebt geactiveerd.

Als de Approver groep de inhoud voor herziening terugstuurt willen wij de originele redacteur het weten. Dit kunnen we bereiken door de eigenschappen voor het maken van taken dynamisch te wijzigen. Wij zullen van de lastActionTake bezitswaarde van "achteruit voor Herziening"verzenden. Als die waarde aanwezig is, zullen wij de titel en de beschrijving wijzigen om erop te wijzen dat deze taak het resultaat van inhoud is die voor herziening wordt teruggestuurd. Wij zullen ook de prioriteit aan "Hoog" bijwerken zodat het het eerste punt is de redacteur aan werkt. Tot slot zullen wij de taak vervaldatum aan één dag plaatsen vanaf wanneer het werkschema voor revisie werd teruggestuurd.

Vervang het start start-task-config.ecma -script (gemaakt in Stap 5) door de volgende code:

// start-task-config.ecma
// Populate the task using values stored as workflow metadata originally posted by the start workflow wizard

// set the assignee based on start workflow wizard
var assignee = workflowData.getMetaDataMap().get("assignee", Packages.java.lang.String);
task.setCurrentAssignee(assignee);

//Set the due date for the initial task based on start workflow wizard
var dueDate = workflowData.getMetaDataMap().get("taskDueDate", Packages.java.util.Date);
if (dueDate != null) {
    task.setProperty("taskDueDate", dueDate);
}

//Set the priority based on start workflow wizard
var taskPriority = workflowData.getMetaDataMap().get("taskPriority", "Medium");
task.setProperty("taskPriority", taskPriority);

var lastAction = workflowData.getMetaDataMap().get("lastTaskAction","");

//change the title and priority if the approver group sent back the content
if(lastAction == "Send Back for Revision") {
  var taskName = "Review and Revise Content";

  //since the content was rejected we will set the priority to High for the revison task
  task.setProperty("taskPriority", "High");

  //set the Task name (displayed as the task title in the Inbox)
  task.setProperty("name", taskName);
  task.setProperty("nameHierarchy", taskName);

  //set the due date of this task 1 day from current date
  var calDueDate = Packages.java.util.Calendar.getInstance();
  calDueDate.add(Packages.java.util.Calendar.DATE, 1);
  task.setProperty("taskDueDate", calDueDate.getTime());

}