Configuration et personnalisation de workflows id181AI0OJ0RO

Les workflows vous permettent d’automatiser les activités Adobe Experience Manager (AEM). Un workflow se compose d’une série d’étapes exécutées dans un ordre spécifique. Vous pouvez définir une activité distincte à exécuter sur chaque étape. Par exemple, vous pouvez envoyer une notification par e-mail à tous les réviseurs et réviseuses d’un groupe lors de la création d’une révision de rubrique. Vous pouvez également envoyer une notification à l’éditeur lorsqu’une tâche de génération de sortie est terminée.

Pour plus d’informations sur les workflows dans AEM, voir :

Les sections de cette rubrique vous guideront à travers différentes personnalisations que vous pouvez effectuer dans les workflows par défaut fournis dans AEM Guides.

Personnaliser le workflow de révision id176NE0C00HS

L’équipe de création de contenu de chaque organisation travaille d’une manière spécifique pour répondre aux besoins de son entreprise. Dans certaines organisations, il y a un éditeur spécialisé, tandis que dans d'autres organisations, il pourrait y avoir un système automatisé de révision éditoriale. Par exemple, dans une organisation, un workflow de création et de publication standard peut inclure des tâches telles que : chaque fois qu’un auteur crée du contenu, il passe automatiquement aux réviseurs et, une fois la révision terminée, il passe à l’éditeur pour générer la sortie finale. Dans AEM, les activités que vous effectuez sur votre contenu et vos ressources peuvent être regroupées sous la forme d’un processus et mappées à un workflow AEM. Pour plus d’informations sur les workflows dans AEM, consultez la section Administration des workflows dans la documentation AEM.

AEM Guides vous permet de personnaliser le workflow de révision par défaut. Vous pouvez utiliser les quatre processus personnalisés suivants liés aux révisions avec vos autres workflows de création ou de publication.

Lorsque vous créez un workflow de révision personnalisé, la première tâche consiste à définir les métadonnées nécessaires au processus de création d’une révision. Pour ce faire, vous pouvez créer un script ECMA. Vous trouverez ci-dessous un exemple de script ECMA qui attribue les métadonnées pour la rubrique et pour le mappage.

Pour rubrique

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());
workflowdata.getMetaDataMap().put("reviewType", "AEM");
workflowdata.getMetaDataMap().put("versionJson", "[{\"path\":\"GUID-ca6ae229-889a-4d98-a1c6-60b08a820bb3.dita\",\"review\":true,\"version\":\"1.0\",\"reviewers\":[\"projects-samplereviewproject-owner\"]}]");
workflowdata.getMetaDataMap().put("isDitamap","false");
workflowdata.getMetaDataMap().put("reviewVersion","3.0");

Pour la carte

var workflowdata = workItem.getWorkflowData();
workflowdata.getMetaDataMap().put("initiator", "admin");
workflowdata.getMetaDataMap().put("operation", "AEM_REVIEW");
workflowdata.getMetaDataMap().put("orgTopics", "GUID-ae42f13c-7201-4453-9a3a-c87675a5868e.dita|GUID-28a6517b-1b62-4d3a-b7dc-0e823225b6a5.dita|GUID-dd699e10-118d-4f1b-bf19-7f1973092227.dita|");
var payloadJson = "{\"referrer\":\"\",\"rootMap\":\"GUID-17feb385-acf3-4113-b838-77b11fd6988d.ditamap\",\"asset\":[\"GUID-17feb385-acf3-4113-b838-77b11fd6988d.ditamap\"],\"base\":\"/content/dam\"}";
workflowdata.getMetaDataMap().put("payloadJson", payloadJson);
workflowdata.getMetaDataMap().put("deadline", "2047-06-27T13:19:00.000+05:30");
workflowdata.getMetaDataMap().put("title", "Review task via workflow with map");
workflowdata.getMetaDataMap().put("description", "Review task via workflow with map Description");
workflowdata.getMetaDataMap().put("assignee", "user-one");
workflowdata.getMetaDataMap().put("status", "1");
workflowdata.getMetaDataMap().put("projectPath", "/content/projects/review_project_via_workflow");
workflowdata.getMetaDataMap().put("startTime", new Date().getTime());
var versionJson = "[{\"path\":\"GUID-ae42f13c-7201-4453-9a3a-c87675a5868e.dita\",\"version\":\"1.0\",\"review\":true,\"reviewers\":[\"starling-regression-user\"]},{\"path\":\"GUID-28a6517b-1b62-4d3a-b7dc-0e823225b6a5.dita\",\"version\":\"1.0\",\"review\":true,\"reviewers\":[\"starling-regression-user\"]},{\"path\":\"GUID-dd699e10-118d-4f1b-bf19-7f1973092227.dita\",\"version\":\"1.0\",\"review\":true,\"reviewers\":[\"starling-regression-user\"]}]";
workflowdata.getMetaDataMap().put("versionJson", versionJson);
workflowdata.getMetaDataMap().put("notifyViaEmail", "true");
workflowdata.getMetaDataMap().put("allowAllReviewers", "false");
workflowdata.getMetaDataMap().put("isDitamap", "true");
workflowdata.getMetaDataMap().put("ditamap", "GUID-17feb385-acf3-4113-b838-77b11fd6988d.ditamap");
var ditamapHierarchy = "[{\"path\":\"GUID-17feb385-acf3-4113-b838-77b11fd6988d.ditamap\",\"items\":[{\"path\":\"GUID-db5787bb-5467-4dc3-b3e5-cfde562ee745.ditamap\",\"items\":[{\"path\":\"GUID-ae42f13c-7201-4453-9a3a-c87675a5868e.dita\",\"items\":[],\"title\":\"\"},{\"path\":\"GUID-28a6517b-1b62-4d3a-b7dc-0e823225b6a5.dita\",\"items\":[],\"title\":\"\"}],\"title\":\"\"},{\"path\":\"GUID-dd699e10-118d-4f1b-bf19-7f1973092227.dita\",\"items\":[],\"title\":\"\"}]}]";
workflowdata.getMetaDataMap().put("ditamapHierarchy", ditamapHierarchy);
workflowdata.getMetaDataMap().put("reviewVersion","3.0");

Vous pouvez créer ce script dans le nœud /etc/workflows/scripts . Le tableau suivant décrit les propriétés affectées par ce script ECMA :

Une fois le script créé, appelez-le avant d’appeler le processus Créer une révision dans votre workflow. Ensuite, en fonction de vos besoins, vous pouvez appeler les autres processus de workflow de révision.

Supprimer le workflow de révision de la configuration de purge

Pour améliorer les performances du moteur de workflow, vous pouvez purger régulièrement les instances de workflow terminées du référentiel AEM. Si vous utilisez les configurations AEM par défaut, toutes les instances de workflow terminées sont nettoyées après une période spécifique. Cela entraîne également la purge de tous les workflows de révision du référentiel AEM.

Vous pouvez empêcher les workflows de révision de se purger automatiquement en supprimant le modèle de workflow de révision (informations) de la configuration de purge automatique. Vous devez utiliser la configuration de la purge du workflow Adobe Granite pour supprimer les modèles de workflow de révision de la liste de purge automatique.

Dans la configuration de la purge du workflow Adobe Granite ​, veillez à répertorier au moins un workflow que vous pouvez purger en toute sécurité. Par exemple, vous pouvez utiliser l’un des workflows suivants créés par AEM Guides :

L’ajout d’un workflow à la Configuration de la purge du workflow Adobe Granite garantit qu’AEM purge uniquement les workflows répertoriés dans la configuration. Cela empêche AEM de purger les informations du workflow de révision.

Pour plus d’informations sur la configuration de la configuration de la purge du workflow Adobe Granite ​, voir Administration d’instances de workflow dans la documentation AEM.

Personnalisation des notifications par e-mail et AEM

Un certain nombre de workflows AEM Guides utilisent les notifications par e-mail. Par exemple, si vous lancez une tâche de révision, une notification est envoyée par e-mail aux réviseurs. Cependant, pour vous assurer que la notification par e-mail est envoyée, vous devez activer cette fonctionnalité dans AEM. Pour activer les notifications par e-mail dans AEM, consultez l’article Configuration des notifications par e-mail dans la documentation AEM.

AEM Guides contient un ensemble d’e-mails et de notifications AEM que vous pouvez personnaliser. Pour personnaliser ces notifications, procédez comme suit :

La définition de chaque type de notification est décrite ci-dessous :

Lors de la personnalisation d’un e-mail ou d’une notification AEM, veillez à n’utiliser que l’ensemble prédéfini de variables suivant, utilisé dans les fichiers primary.vm et secondary.vm.

Personnalisation du workflow de génération après sortie id17A6GI004Y4

AEM Guides vous offre la possibilité de spécifier un workflow de génération post-sortie. Vous pouvez effectuer certaines tâches de post-traitement sur la sortie générée à l’aide d’AEM Guides. Par exemple, vous pouvez appliquer certaines balises CQ sur la sortie de site AEM générée, définir certaines propriétés sur la sortie PDF ou envoyer un e-mail à un ensemble d’utilisateurs une fois la sortie générée.

Vous pouvez créer un nouveau modèle de workflow à utiliser comme workflow de génération post-sortie. Lorsqu’un workflow de génération post-sortie est déclenché, il partage des informations contextuelles par le biais du mappage de métadonnées de workflow, que vous pouvez utiliser pour effectuer un traitement sur la sortie générée. Le tableau suivant décrit les informations contextuelles partagées en tant que métadonnées :

Pour utiliser les métadonnées de génération de sortie, vous pouvez créer un script ECMA ou un lot OSGi. Vous trouverez ci-dessous un exemple de script ECMA qui utilise les métadonnées :

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);
*/

Une fois le script créé, appelez le script personnalisé dans votre workflow. Ensuite, en fonction de vos besoins, vous pouvez appeler les autres processus de workflow. Une fois que vous avez conçu votre workflow personnalisé, appelez la Finaliser la post-génération comme dernière étape de votre processus de workflow. L’étape Finaliser la post-génération garantit que le statut de la tâche de génération de sortie est mis à jour sur Terminé à la fin du processus de génération de sortie. Après avoir créé un workflow personnalisé de génération post-sortie, vous pouvez le configurer avec n’importe lequel de vos paramètres prédéfinis de génération de sortie. Sélectionnez le workflow requis dans la propriété Exécuter le workflow de post-génération du paramètre prédéfini requis. Lorsque vous exécutez une tâche de génération de sortie à l’aide du paramètre prédéfini de sortie configuré, le statut de la tâche (dans l’onglet Sortie) passe à Post-traitement.

Personnaliser le workflow de mise à jour de ressource id18C3D0I0B5Z

Par défaut, le workflow Ressource de mise à jour de gestion des ressources numériques se déclenche chaque fois que vous créez ou mettez à jour une ressource AEM (XML ou non-XML). Par exemple, lorsque vous créez une rubrique ou que vous la mettez à jour, le workflow Ressource de mise à jour de gestion des ressources numériques est exécuté. Le workflow Ressource de mise à jour de gestion des ressources numériques tente d’extraire les métadonnées pertinentes d’Assets. Le workflow de mise à jour des ressources prêt à l’emploi Asset Update Workflow ne comporte aucune étape pour extraire des métadonnées pertinentes d’un fichier DITA et le workflow Ressource de mise à jour de gestion des ressources numériques génère un grand nombre de journaux au moment de l’exécution. Si vous souhaitez éviter la création de journaux supplémentaires, vous pouvez configurer le workflow de sorte à ignorer le traitement de tous les fichiers XML.

Effectuez les étapes suivantes pour personnaliser le workflow Ressource de mise à jour de gestion des ressources numériques :

Configuration du workflow XML de post-traitement id18CJB03J0Y4

AEM Guides crée un ensemble de workflows qui vous permettent d'utiliser du contenu DITA dans AEM. Par exemple, certains workflows sont exécutés lorsque vous chargez du contenu DITA ou mettez à jour du contenu existant. Ces workflows analysent les documents DITA et effectuent diverses tâches, telles que la définition des métadonnées, l'ajout de paramètres prédéfinis de sortie par défaut aux nouveaux mappages DITA et d'autres tâches associées.

Les propriétés suivantes régissent l’exécution des workflows de post-traitement par AEM Guides :