Documentation Campaign Interface utilisateur web de Campaign

Code JavaScript

Dernière mise à jour : 11 avril 2025

S'applique à :
Campaign v8 Web User Interface

L’activité Code JavaScript est une activité de Gestion des données. Utilisez cette activité pour exécuter un script JavaScript dans le contexte d’un workflow. Vous pouvez ainsi collecter des informations dans la base de données ou effectuer d’autres opérations complexes.

Configurer une activité Code JavaScript

Pour configurer l’activité Code JavaScript, procédez comme suit :

Ajoutez une activité Code JavaScript dans votre workflow.
Choisissez le type d'activité à créer :
- Simple : exécutez un extrait de code.
- Avancé : effectuez des opérations plus avancées en exécutant deux fragments de code différents. Découvrir comment configurer une activité JavaScript avancée
NOTE
Avec l’interface utilisateur web de Campaign, deux activités ont été consolidées en une seule en fusionnant les fonctionnalités de code JavaScript simple et avancé. Cette consolidation n’a aucune incidence sur la fonctionnalité de l’activité.
Confirmez, puis cliquez sur le bouton Modifier le code pour ouvrir l’éditeur d’expression. Le volet de gauche fournit des syntaxes prédéfinies que vous pouvez utiliser pour créer votre code, y compris des variables d’événement. Découvrez comment utiliser les variables d’événement et l’éditeur d’expression.
Dans la section Exécution, configurez le délai pour arrêter l’activité après une période d’exécution. Par défaut, la phase d’exécution ne peut pas dépasser 1 heure. Passé ce délai, le processus est abandonné en incluant un message d’erreur et l’exécution de l’activité échoue. Pour ignorer cette limite, définissez la valeur sur 0.
Activez l’option Traiter les erreurs pour conserver les erreurs qui se produisent pendant l’exécution du script dans une transition de sortie supplémentaire.

Activités de code JavaScript avancées

Les activités JavaScript avancées vous permettent d’effectuer des opérations complexes. Ces activités vous permettent d’effectuer les opérations suivantes :

Exécuter deux extraits de code différents. Le premier fragment de code est exécuté au premier démarrage du workflow. Chaque fois que le workflow s’exécute de nouveau, l’extrait de code défini dans le deuxième appel est exécuté.
Ajoutez plusieurs transitions de sortie avec lesquelles vous pouvez interagir dynamiquement à l’aide d’un script.

Pour configurer une activité Code JavaScript avancée, procédez comme suit :

Sélectionnez le type Avancé, puis configurez les fragments de code à exécuter :
- Cliquez sur Modifier le code du premier appel pour définir le script à exécuter lors du premier appel.
- Cliquez sur Modifier le code d’appel suivant pour définir le script à exécuter lors des appels suivants du workflow. (Facultatif)
Pour ajouter une ou plusieurs transitions de sortie, cliquez sur le bouton Ajouter des transitions et indiquez un libellé et un nom interne pour chaque transition.

Dans cet exemple, deux transitions sont configurées et activées par le script dans le fragment de code, selon des conditions spécifiques.
Terminez la configuration de l’activité et démarrez le workflow.

Exemple

Initialiser des variables basées sur la population entrante

Cet exemple montre comment initialiser une variable en fonction du nombre de profils ciblés par un workflow.

Exemple d’initialisation de variable en fonction du nombre de profils

Dans cet exemple, les profils VIP de la base de données sont ciblés. Une variable nommée « canal » est créée avec une valeur qui dépend du nombre de profils ciblés par l’activité Créer une audience :

Si plus de 1 000 profils sont ciblés, initialisez la variable avec la valeur « e-mail ».
Sinon, initialisez-la avec la valeur « SMS ».

Pour ce faire, procédez comme suit :

Ajouter une activité Code JavaScript de type Simple après l’activité Créer une audience.
Cliquez sur Modifier le code et configurez le fragment de code comme illustré ci-dessous :
if (vars.recCount > 1000) vars.channel = "email"; else vars.channel = "sms";
Démarrez le workflow. La variable « Canal » est créée avec la valeur « E-mail» ou « SMS », selon le nombre de profils ciblés par l’activité Créer une audience.

Déclencher des transitions en fonction de la valeur d’une variable

Cet exemple montre comment déclencher une transition en fonction de la valeur d’une variable.

Exemple de transitions déclenchées par des valeurs de variable

Dans cet exemple, le workflow commence par une activité Signal externe dans laquelle une variable (interest) est transmise par un autre workflow. La valeur de la variable est « Course » ou « Yoga », selon les opérations de filtrage effectuées dans le workflow initial.

Différentes transitions dans le workflow sont déclenchées en fonction de la valeur de la variable.

Pour ce faire, procédez comme suit :

Ajoutez une activité Code JavaScript après l’activité Signal externe avec le type Avancé.
Ajoutez deux transitions : une pour chaque valeur de variable possible (« Course », « Yoga »).

Cliquez sur Modifier le code du premier appel et configurez le fragment de code comme illustré ci-dessous :

if (vars.interest == "running")
    task.postEvent(task.transitionByName("running"));
else
    task.postEvent(task.transitionByName("yoga"));

Effectuez le paramétrage de chaque transition en fonction de vos besoins, puis démarrez le workflow. L'une des deux transitions de sortie est activée en fonction de la valeur de la variable interest passée par l'activité Signal externe.

recommendation-more-help