Workflows konfigurieren und anpassen id181AI0OJ0RO

Mit Workflows können Sie Adobe Experience Manager (AEM)-Aktivitäten automatisieren. Ein Workflow besteht aus einer Reihe von Schritten, die in einer bestimmten Reihenfolge ausgeführt werden. Sie können für jeden Schritt eine eigene Aktivität definieren. Sie können beispielsweise eine E-Mail-Benachrichtigung an alle validierungsverantwortlichen Benutzer einer Gruppe senden, wenn eine Themenüberprüfung erstellt wird. Sie können auch eine Benachrichtigung an den Herausgeber senden, wenn eine Aufgabe zur Generierung der Ausgabe abgeschlossen ist.

Weitere Informationen zu Workflows in AEM finden Sie unter:

Die Abschnitte in diesem Thema führen Sie durch verschiedene Anpassungen, die Sie in den Standard-Workflows vornehmen können, die in der AEM Guides bereitgestellt werden.

Anpassen des Prüfungs-Workflows id176NE0C00HS

Das Content-Authoring-Team jedes Unternehmens arbeitet auf eine bestimmte Weise, um seine Geschäftsanforderungen zu erfüllen. In einigen Unternehmen gibt es einen dedizierten Editor, während einige andere Organisationen ein automatisiertes Redaktionsüberprüfungssystem einrichten könnten. In einer Organisation könnte beispielsweise ein typischer Bearbeitungs- und Veröffentlichungsarbeitsablauf Aufgaben wie beispielsweise umfassen: Wenn ein Autor mit Authoring-Inhalten fertig ist, wird er automatisch an die Validierer gesendet und nach Abschluss der Überprüfung wird er zum Generieren der endgültigen Ausgabe an den Herausgeber weitergeleitet. In AEM können Aktivitäten, die Sie mit Ihren Inhalten und Assets durchführen, in Form eines Prozesses kombiniert und einem AEM Workflow zugeordnet werden. Weitere Informationen zu Workflows in AEM finden Sie unter Verwalten von Workflows in AEM Dokumentation.

Mit AEM Guides können Sie den standardmäßigen Prüfungs-Workflow anpassen. Sie können die folgenden vier benutzerdefinierten Review-bezogenen Prozesse mit Ihren anderen Authoring- oder Publishing-Workflows verwenden.

  • Überprüfung erstellen: Dieser Prozess bereitet die Metadaten vor, die zum Erstellen einer Prüfungsaufgabe erforderlich sind. Beispielsweise werden den Validierungsverantwortlichen Prüfungsberechtigungen zugewiesen, der Status der zu überprüfenden Themen festgelegt, Zeitpläne für die Überprüfung festgelegt und mehr. Von den vier Prozessen ist dies der einzige erforderliche Prozess, der in Ihren benutzerdefinierten Workflow aufgenommen werden muss. Im Workflow können Sie die drei anderen Prozesse ein- oder ausschließen.

  • Prüfungsaufgabe zuweisen: Dieser Prozess erstellt die Prüfungsaufgabe und sendet die Aufgabenbenachrichtigung an den Initiator und die Überprüfer.

  • Überprüfungs-E-Mail senden: Dieser Prozess sendet die Überprüfungs-E-Mail an den Initiator und die Überprüfer.

  • Auftrag zum Schließen der Überprüfung planen: Dieser Prozess stellt sicher, dass der Überprüfungsprozess beim Erreichen des Termins abgeschlossen ist.

Wenn Sie einen benutzerdefinierten Überprüfungs-Workflow erstellen, besteht die erste Aufgabe darin, die erforderlichen Metadaten festzulegen, die für den Prozess zum Erstellen einer Überprüfung erforderlich sind. Dazu können Sie ein ECMA-Skript erstellen. Nachfolgend finden Sie ein Beispiel für das ECMA-Skript, das die Metadaten zuweist:

var workflowdata=workItem.getWorkflowData();
workflowdata.getMetaDataMap().put("initiator","admin");
workflowdata.getMetaDataMap().put("operation","AEM_REVIEW");
workflowdata.getMetaDataMap().put("orgTopics","/content/dam/xml-solution/review.xml");
workflowdata.getMetaDataMap().put("payloadJson","{\"base\":\"/content/dam/xml-solution\",\"asset\":[\"/content/dam/xml-solution/review.xml\"],\"referrer\":\""}");
workflowdata.getMetaDataMap().put("deadline","2017-06-27T13:19:00.000+05:30");
workflowdata.getMetaDataMap().put("title","Review through custom workflow");
workflowdata.getMetaDataMap().put("description","Initiate this review process using the AEM workflow");
workflowdata.getMetaDataMap().put("assignee","user-one", "user-two");
workflowdata.getMetaDataMap().put("status","1");
workflowdata.getMetaDataMap().put("projectPath","/content/projects/review");
workflowdata.getMetaDataMap().put("startTime", System.currentTimeMillis());

Sie können dieses Skript im Knoten /etc/workflows/scripts erstellen. In der folgenden Tabelle werden die von diesem ECMA-Skript zugewiesenen Eigenschaften beschrieben:

Eigenschaft
Typ
Beschreibung
initiator
Zeichenfolge
Benutzer-ID des Benutzers, der die Prüfungsaufgabe initiiert.
operation
Zeichenfolge
Ein statischer Wert, der auf AEM_REVIEW gesetzt ist.
orgTopics
Zeichenfolge
Pfad der Themen, die zur Überprüfung freigegeben werden. Geben Sie mehrere Themen durch Kommas getrennt an.
payloadJson
JSON-Objekt
Geben Sie die folgenden Werte an: - base: Pfad des übergeordneten Ordners, der das Thema enthält, das zur Überprüfung gesendet wird.
- asset: Pfad des Themas, das zur Überprüfung gesendet wird.
- referrer: Lassen Sie es leer.
deadline
Zeichenfolge
Geben Sie die Zeit im Format yyyy-MM-dd'T'HH:mm:ss.SSSXXX an.
title
Zeichenfolge
Geben Sie einen Titel für die Prüfungsaufgabe ein.
description
Zeichenfolge
Geben Sie eine Beschreibung für die Prüfungsaufgabe ein.
assignee
Zeichenfolge
Benutzer-ID der Benutzer, an die Sie die Themen senden möchten(n), um sie zu überprüfen.
status
Ganzzahl
Ein statischer Wert, der auf 1 gesetzt ist.
startTime
Long
Verwenden Sie die Funktion System.currentTimeMillis() , um die aktuelle Systemzeit abzurufen.

Nachdem Sie das Skript erstellt haben, rufen Sie es auf, bevor Sie in Ihrem Workflow den Prozess Überprüfung erstellen aufrufen. Anschließend können Sie je nach Ihren Anforderungen die anderen Workflow-Prozesse für Überprüfungen aufrufen.

Entfernen Sie den Überprüfungs-Workflow aus der Bereinigungskonfiguration

Um die Leistung der Workflow-Engine zu verbessern, können Sie regelmäßig abgeschlossene Workflow-Instanzen aus dem AEM-Repository bereinigen. Wenn Sie die standardmäßigen AEM verwenden, werden alle abgeschlossenen Workflow-Instanzen nach einem bestimmten Zeitraum bereinigt. Dies führt auch dazu, dass alle Prüfungs-Workflows aus dem AEM-Repository gelöscht werden.

Sie können die automatische Bereinigung von Überprüfungs-Workflows verhindern, indem Sie das Überprüfungs-Workflow-Modell (Informationen) aus der automatischen Bereinigungskonfiguration entfernen. Sie müssen die Adobe Granite Workflow Purge Configuration verwenden, um die Überprüfungs-Workflow-Modelle aus der Liste der automatischen Bereinigung zu entfernen.

Stellen Sie in der Adobe Granite Workflow-Bereinigungskonfiguration sicher, dass Sie mindestens einen Workflow auflisten, den Sie sicher bereinigen können. Sie können beispielsweise einen der folgenden, von AEM Guides erstellten Workflows verwenden:

  • /etc/workflow/models/publishditamap/jcr:content/model
  • /etc/workflow/models/post-dita-project-creation-tasks/ jcr:content/model

Durch Hinzufügen eines Workflows in der Adobe Granite Workflow-Bereinigungskonfiguration wird sichergestellt, dass AEM nur die in der Konfiguration aufgelisteten Workflows bereinigt. Dadurch wird verhindert, dass AEM die Informationen des Prüfungs-Workflows bereinigen.

Weitere Informationen zum Konfigurieren der Adobe Granite Workflow Purge Configuration finden Sie unter Verwalten von Workflow-Instanzen in AEM Dokumentation.

E-Mail-Vorlagen anpassen

Einige AEM Guides-Workflows nutzen E-Mail-Benachrichtigungen. Wenn Sie beispielsweise eine Prüfungsaufgabe starten, wird eine E-Mail-Benachrichtigung an die Validierer gesendet. Um jedoch sicherzustellen, dass die E-Mail-Benachrichtigung gesendet wird, müssen Sie diese Funktion in AEM aktivieren. Informationen zum Aktivieren von E-Mail-Benachrichtigungen in AEM finden Sie im Artikel E-Mail senden in AEM Dokumentation.

Der AEM Guides enthält eine Reihe von E-Mail-Vorlagen, die Sie anpassen können. Führen Sie die folgenden Schritte aus, um diese Vorlagen anzupassen:

  1. Verwenden Sie den Package Manager, um die Datei /libs/fmdita/mail herunterzuladen.

    note note
    NOTE
    Nehmen Sie keine Anpassungen in den Standardkonfigurationsdateien vor, die im Knoten libs verfügbar sind. Sie müssen eine Überlagerung des Knotens libs im Knoten apps erstellen und nur die erforderlichen Dateien im Knoten apps aktualisieren.
  2. Der E-Mail-Ordner enthält die folgenden anpassbaren Vorlagen:

    table 0-row-2 1-row-2 2-row-2 3-row-2
    Vorlagendateiname Beschreibung
    closereview.html Diese E-Mail-Vorlage wird verwendet, wenn eine Prüfungsaufgabe geschlossen wird.
    createreview.html Diese E-Mail-Vorlage wird verwendet, wenn eine neue Prüfungsaufgabe erstellt wird.
    reviewapproval.css Diese CSS-Datei enthält den Stil von E-Mail-Vorlagen.

Arbeitsablauf für die Generierung nach der Ausgabe anpassen id17A6GI004Y4

AEM Guides bietet Ihnen die Flexibilität, einen Workflow zur Erstellung nach der Ausgabe festzulegen. Sie können einige Nachbearbeitungsaufgaben für die Ausgabe ausführen, die mit der AEM Guides generiert wird. Sie können beispielsweise einige CQ-Tags auf die generierte AEM Site-Ausgabe anwenden oder bestimmte Eigenschaften für die PDF-Ausgabe festlegen oder eine E-Mail an eine Gruppe von Benutzern senden, sobald die Ausgabe generiert wurde.

Sie können ein neues Workflow-Modell erstellen, das als Workflow für die Generierung nach der Ausgabe verwendet wird. Wenn ein Workflow zur Generierung nach der Ausgabe ausgelöst wird, gibt der Workflow zur Generierung der Ausgabe Kontextdaten über die Workflow-Metadatenzuordnung frei, die Sie zur Verarbeitung der generierten Ausgabe verwenden können. In der folgenden Tabelle werden die als Metadaten freigegebenen Kontextdaten beschrieben:

Eigenschaft
Typ
Beschreibung
outputName
Zeichenfolge
Name der Ausgabevorgabe, die zum Generieren der Ausgabe verwendet wird.
generatedPath
Zeichenfolge
Pfad in DAM, in dem die generierte Ausgabe gespeichert wird.
outputType
com.adobe.fmdita.output.OutputType
Typ der Ausgabevorgabe.
outputTitle
Zeichenfolge
Titel der Ausgabevorgabe.
outputHistoryPath
Zeichenfolge
Repository-Pfad des Verlaufsknotens
isSuccess
Boolesch
Eine Markierung, die den finalen Status des Generierungsprozesses der Ausgabe darstellt - Erfolg oder Fehler.
logPath
Zeichenfolge
Pfad in DAM, in dem die Ausgabegenerierungsprotokolle gespeichert werden.
generatedTime
Long
Zeitpunkt, zu dem der Output-Generierungsprozess ausgelöst wurde.
initiator
Zeichenfolge
Die Benutzer-ID des Benutzers, der den Workflow zur Generierung der Ausgabe ausgelöst hat.

Um die Metadaten zur Ausgabegenerierung zu verwenden, können Sie ein ECMA-Skript oder ein OSGi-Bundle erstellen. Nachfolgend finden Sie ein Beispiel für das ECMA-Skript, das die Metadaten verwendet:

NOTE
Sie können dieses Skript im Knoten /etc/workflows/scripts erstellen.
var session = workflowSession.getSession(); // Obtain session object to read/write the repository.
var payload = workItem.getWorkflowData().getPayload().toString(); // Get the workflow payload (the ditamap file on which the generation was triggered)
var metadata = workItem.getWorkflowData().getMetaDataMap(); // Get the workflow metadata object
var generatedPath = metadata.get("generatedPath"); // supplied by AEM Guides
var username = metadata.get("initiator"); // supplied by AEM Guides
var successful = metadata.get("isSuccess"); // supplied by AEM Guides
var title = metadata.get("outputTitle"); // supplied by AEM Guides
var subject = "Output Generation Finished";
var message = "Generation of output " + title + " just finished " +
(successful ? "successfully. " : "unsuccessfully. ");
    message += "It was triggered by " + username;
if (successful) {
    message += "<br/><br/>The path to the generated output is " +
generatedPath;
}
/*
    MailerAPI.sendMail("dl-docs-authors", subject, message);
*/

Rufen Sie nach der Erstellung des Skripts das benutzerdefinierte Skript in Ihrem Workflow auf. Anschließend können Sie entsprechend Ihren Anforderungen die anderen Workflow-Prozesse aufrufen. Nachdem Sie Ihren benutzerdefinierten Workflow entworfen haben, rufen Sie die Post-Generierung abschließen als letzten Schritt im Workflow-Prozess auf. Der Schritt Post-Generierung abschließen stellt sicher, dass der Status der Ausgabegenerierungsaufgabe nach Abschluss des Ausgabegenerierungsprozesses auf Abgeschlossen aktualisiert wird. Nach der Erstellung eines benutzerdefinierten Workflows für die Erstellung nach der Ausgabe können Sie ihn mit einer beliebigen Ausgabegenerierungsvoreinstellung konfigurieren. Wählen Sie den erforderlichen Workflow in der Eigenschaft Post-Generierungsarbeitsablauf ausführen der erforderlichen Vorgabe aus. Wenn Sie eine Ausgabegenerierungsaufgabe mit der konfigurierten Ausgabevorgabe ausführen, ändert sich der Aufgabenstatus (auf der Registerkarte "Ausgabe") in Post-Verarbeitung.

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178