Configuration et personnalisation des 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 à chaque étape. Vous pouvez, par exemple, envoyer une notification électronique à tous les réviseurs d’un groupe lorsqu’une révision de rubrique est créée. Ou envoyez 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 guident tout au long des différentes personnalisations que vous pouvez effectuer dans les workflows par défaut fournis dans les Guides d’AEM.

Personnalisation du processus de révision id176NE0C00HS

L’équipe de création de contenu de chaque entreprise travaille de manière spécifique pour répondre aux besoins de son entreprise. Dans certaines organisations, il existe un éditeur dédié, tandis que d’autres pourraient avoir mis en place un système automatisé d’examen éditorial. Par exemple, dans une organisation, un processus de création et de publication type peut inclure des tâches comme : chaque fois qu’un auteur a terminé la création de contenu, il est automatiquement envoyé aux réviseurs, et lorsque la révision est terminée, il est envoyé à 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 combinées sous la forme d’un processus et mappées à un workflow AEM. Pour plus d’informations sur les workflows dans AEM, voir Administration des workflows dans la documentation AEM.

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

Lorsque vous créez un processus de révision personnalisé, la première tâche consiste à définir les métadonnées requises par le processus de création de révision. Pour ce faire, vous pouvez créer un script ECMA. Vous trouverez ci-dessous un exemple de script ECMA qui affecte les métadonnées :

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());

Vous pouvez créer ce script dans la variable /etc/workflows/scripts noeud . Le tableau suivant décrit les propriétés affectées par ce script ECMA :

Une fois que vous avez créé le script, 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 régulièrement purger les instances de workflow terminées du référentiel AEM. Si vous utilisez les configurations d’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 la purge automatique des workflows de révision en supprimant le modèle de workflow de révision (information) de la configuration de purge automatique. Vous devez utiliser la variable 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 le 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 :

Ajouter un workflow dans la Configuration de la purge du workflow Adobe Granite s’assure 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 variable Configuration de la purge du workflow Adobe Granite, voir Administration des instances de workflow dans la documentation AEM.

Personnalisation des modèles de courrier électronique

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

AEM Guides contient un ensemble de modèles de courrier électronique que vous pouvez personnaliser. Effectuez les étapes suivantes pour personnaliser ces modèles :

Personnaliser le workflow de génération après la sortie id17A6GI004Y4

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

Vous pouvez créer un modèle de workflow à utiliser comme workflow de génération après sortie. Lorsqu’un workflow de génération de sortie est déclenché, le workflow de génération de sortie partage des informations contextuelles par le biais de la carte des métadonnées de workflow, que vous pouvez utiliser pour effectuer le 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 du 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 que vous avez créé le script, appelez le script personnalisé dans votre workflow. Ensuite, en fonction de vos besoins, vous pouvez appeler les autres processus du workflow. Une fois que vous avez conçu votre workflow personnalisé, appelez la fonction Finalisation de la génération de publication comme dernière étape de votre processus de workflow. La variable Finalisation de la génération de publication l’étape permet de s’assurer que l’état de la tâche de génération de sortie est mis à jour vers Terminé une fois le processus de génération de sortie terminé. Après avoir créé un workflow personnalisé de génération de sortie, vous pouvez le configurer avec l’un de vos paramètres prédéfinis de génération de sortie. Sélectionnez le workflow requis dans la Exécuter le processus de génération de publication 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é, l’état de la tâche (dans l’onglet Sortie) passe à Post-traitement.

Personnalisation du processus de mise à jour des ressources id18C3D0I0B5Z

Par défaut, la variable Ressource de mise à jour de gestion des actifs 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 la mettez à jour, la variable Ressource de mise à jour de gestion des actifs numériques le workflow est exécuté. La variable Ressource de mise à jour de gestion des actifs numériques workflow tente d’extraire les métadonnées appropriées à partir des ressources. La clé en main Workflow de mise à jour des ressources ne comprend aucune procédure pour extraire les métadonnées appropriées d’un fichier DITA et de la variable Ressource de mise à jour de gestion des actifs numériques workflow génère beaucoup de logs au moment de l’exécution. Si vous souhaitez éviter les logs supplémentaires, vous pouvez configurer le workflow pour qu’il ignore tous les fichiers XML du traitement.

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

Configuration du workflow XML de post-traitement id18CJB03J0Y4

AEM Guides crée un ensemble de processus qui vous permettent de travailler avec 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 processus 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 à de nouvelles cartes DITA et d’autres tâches associées.

Les propriétés suivantes régissent la manière dont AEM Guides exécute les workflows de post-traitement :