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 in AEM Guides bereitgestellten Standard-Workflows vornehmen können.

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.

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:

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:

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 Konfigurieren von E-Mail-Benachrichtigungen in AEM Dokumentation.

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:

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 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:

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:

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.

Anpassen des Workflows "Asset aktualisieren" id18C3D0I0B5Z

Standardmäßig wird der Workflow-Trigger "DAM-Update-Asset"immer dann ausgeführt, wenn Sie AEM Asset erstellen oder aktualisieren (XML oder Nicht-XML). Wenn Sie beispielsweise ein Thema erstellen oder aktualisieren, wird der Workflow DAM-Update-Asset ausgeführt. Der Workflow DAM-Update-Asset versucht, relevante Metadaten aus der Assets zu extrahieren. Der standardmäßige Workflow Asset-Update-Workflow enthält keine Schritte zum Extrahieren relevanter Metadaten aus einer DITA-Datei. Der Workflow DAM-Update-Asset generiert zum Zeitpunkt der Ausführung eine Vielzahl von Protokollen. Wenn Sie die zusätzlichen Protokolle vermeiden möchten, können Sie den Workflow so konfigurieren, dass alle XML-Dateien von der Verarbeitung übersprungen werden.

Führen Sie die folgenden Schritte aus, um den Workflow DAM-Update-Asset anzupassen:

Konfigurieren des Nachbearbeitungs-XML-Workflows id18CJB03J0Y4

AEM Guides erstellt eine Reihe von Workflows, mit denen Sie mit DITA-Inhalten in AEM arbeiten können. Es gibt beispielsweise Workflows, die ausgeführt werden, wenn Sie DITA-Inhalte hochladen oder vorhandene Inhalte aktualisieren. Diese Workflows analysieren DITA-Dokumente und führen verschiedene Aufgaben durch, z. B. das Festlegen der Metadaten, das Hinzufügen von standardmäßigen Ausgabevorgaben zu neuen DITA-Maps und andere damit verbundene Aufgaben.

Die folgenden Eigenschaften steuern, wie AEM Guides die Nachbearbeitungs-Workflows ausführt: