Bonnes pratiques relatives aux workflows - configuration et surveillance dans Campaign Classic

Cet article explique certaines bonnes pratiques en matière de configuration et de surveillance des workflows dans Adobe Campaign Classic.

Description description

Environnement

Problème

La plupart du temps, les workflows font partie des principales fonctionnalités (intégrées ou personnalisées) de la plateforme. Pour cette raison, il est très important de prendre soin de leur configuration.

Résolution resolution

Configuration générale

Organisation

Créez vos workflows, tels qu’un import dans tableXXX, dans un dossier personnalisé.

Ce n’est que si le workflow générique affecte l’ensemble de la plateforme (nettoyage, par exemple) que vous pouvez envisager de l’ajouter dans le dossier Technical Workflows intégré.

Nom du workflow

Comme nous l’avons expliqué plus haut, il est très important de donner aux workflows des libellés et des noms appropriés. Comme un opérateur ne se réfère pas toujours à la documentation, renseignez le champ description du workflow pour résumer le processus à exécuter.

Si le workflow fait partie d'un processus impliquant plusieurs workflows, n'hésitez pas à être explicite lorsque vous saisissez un libellé. L'utilisation de nombres est un excellent moyen d'organiser les workflows (par libellé). Par exemple :

Gravité

Configurez la gravité d'un workflow dans les propriétés du workflow, dans l'onglet Exécution :

Fournir ces informations lors de la création d’un workflow permet de comprendre la gravité du processus configuré.

Journaux

La méthode JavaScript logInfo() est une excellente solution pour déboguer un workflow. Elle est utile, mais elle doit être utilisée avec précaution, en particulier pour les activités qui sont fréquemment exécutées : elle peut surcharger les logs et augmenter considérablement la taille de la table des logs.

Mais il se peut que vous ayez également besoin de plus de logInfo(). Deux autres solutions sont disponibles.

Conserver le résultat des populations intermédiaires entre deux exécutions

Cette option, disponible dans l'onglet Général des propriétés du workflow, peut être aussi utile que dangereuse. Elle empêche Adobe Campaign de supprimer les tables temporaires créées entre deux exécutions. Bien qu’il puisse s’avérer utile pour les environnements de développement, il est interdit de l’utiliser sur les environnements de production et doit être surveillé. La conservation des tables temporaires peut entraîner une augmentation significative de la taille de la base de données et, par la suite, l'atteinte de la limite de taille. De plus, cela ralentira la sauvegarde.

Cette option ne doit pas être sélectionnée pour les workflows en production à tout moment.

Enregistrer les requêtes SQL dans le journal:

Disponible dans l'onglet Exécution des propriétés du workflow, il consigne toutes les requêtes SQL générées par l'outil à partir des différentes activités. C'est une excellente façon de voir ce qui est réellement exécuté par la plateforme. Toutefois, cette option ne doit être utilisée que temporairement pendant le développement et non activée en production.

Surveillance

Vous devez surveiller tous les workflows planifiés s'exécutant dans des environnement de production afin d'être averti en cas d'erreur.

Dans les propriétés du workflow, sélectionnez un groupe de superviseurs, soit le groupe par défaut "superviseurs de workflow", soit un groupe personnalisé. Assurez-vous qu'au moins un opérateur appartient à ce groupe, avec une configuration d'email.

Ne pas laisser les workflows en pause:

Si vous créez un workflow temporaire, assurez-vous qu’il sera en mesure de se terminer correctement et qu’il ne restera pas dans un état "en pause". S’il est en pause, cela signifie que vous devez conserver les tables temporaires et ainsi augmenter la taille de la base de données.

Dans le workflow

Nom de l’activité

Lors du développement de votre workflow, toutes les activités seront dotées d’un nom, tout comme les objets Adobe Campaign. Bien que ce nom soit généré par l’outil, il est recommandé d’attribuer à une activité un nom explicite lors de sa configuration. Si vous le faites plus tard, le workflow peut être interrompu si les activités utilisent le nom d’activités précédentes et la mise à jour des noms risque d’être difficile.

Le nom d'une activité figure dans l'onglet Avancé. Ne les laissez pas nommés query, query1, query11, mais attribuez-leur des noms explicites tels que querySubscribedRecipients. Ce nom apparaît dans le journal et les logs SQL, le cas échéant, et permet de déboguer le workflow lors de sa configuration.

JavaScript dans une activité

Vous souhaiterez peut-être ajouter du code JavaScript lors de l'initialisation d'une activité de workflow. Vous pouvez le faire dans l’onglet Avancé d’une activité. Pour faciliter la localisation du workflow, il est recommandé d'utiliser deux tirets au début et à la fin du libellé de l'activité comme suit : — Mon libellé —

Signal

La plupart du temps, vous ne saurez pas d’où provient le signal. Pour éviter ce problème, utilisez le champ Commentaire de l’onglet Avancé de l’activité de signal pour documenter l’origine attendue d’un signal pour l’activité en question.

Mise à jour des workflows

Un workflow de production ne doit pas être mis à jour directement. A moins que le processus ne consiste à créer une campagne avec des workflows de modèle, les processus doivent d’abord être testés dans un environnement de développement si possible. Ce n’est qu’après cette validation que le workflow peut être déployé et démarré en production.

Les workflows archivés peuvent être conservés sur des plateformes de développement ou de test, dans un dossier Archivé, mais la production doit rester aussi propre que possible. Les anciens workflows doivent être supprimés de la production s’ils sont inactifs.