Personnaliser un workflow avec des paramètres externes

Une fois le workflow déclenché, les paramètres sont ingérés dans les variables d’événements et peuvent être utilisés pour personnaliser les activités du workflow.

Ils peuvent, par exemple, permettre de définir l’audience à lire dans l’activité Lecture d’audience, le nom du fichier à transférer dans l’activité Transfert de fichier, etc. (voir cette page).

Utiliser des variables d’événements

Les variables d’événements sont utilisées dans une expression qui doit respecter la syntaxe standard.

Pour utiliser des variables d’événements, la syntaxe doit suivre le format ci-dessous et utiliser le nom du paramètre défini dans l’activité Signal externe (voir Déclarer les paramètres dans l’activité Signal externe) :

$(vars/@parameterName)

Dans cette syntaxe, la fonction $ renvoie le type de données chaîne. Si vous souhaitez spécifier un autre type de données, utilisez les fonctions suivantes :

  • $long : nombre entier.
  • $float : nombre décimal.
  • $boolean : vrai/faux.
  • $datetime : horodatage.

Si vous utilisez une variable dans une activité, l’interface vous aide à l’appeler.

  •  : sélectionnez la variable d’événement parmi toutes les variables disponibles dans le workflow.

  •  : modifiez les expressions en associant des variables et des fonctions (voir cette page).

    Cette liste fournit des fonctions qui vous permettent d'effectuer un filtrage complexe. Ces fonctions sont présentées dans cette section.

    En outre, vous pouvez utiliser les fonctions ci-dessous, disponibles dans toutes les activités, qui vous permettent d'appliquer des variables d'événements après avoir appelé un workflow avec des paramètres externes (voir cette section) :

    Nom Description Syntaxe
    EndWith Indique si une chaîne (premier paramètre) se termine par une chaîne spécifique (deuxième paramètre). EndWith(<String>,<String>)
    startWith Indique si une chaîne (premier paramètre) commence par une chaîne spécifique (deuxième paramètre). startWith(<String>,<String>)
    Extract Retourne les premiers caractères d’une chaîne en utilisant un séparateur. Extract(<String>,<Separator>)
    ExtractRight Retourne les derniers caractères d’une chaîne en utilisant un séparateur. ExtractRight(<String>,<Separator>)
    DateFormat Met en forme une date en utilisant le format spécifié dans le deuxième paramètre (exemple : '%4Y%2M%2D') DateFormat(<Date>,<Format>)
    FileName Retourne le nom du chemin d’un fichier. FileName(<String>)
    FileExt Retourne l’extension du chemin d’un fichier. FileExt(<String>)
    IsNull Indique si une chaîne ou une date est nulle. IsNull(<String/date>)
    UrlUtf8Encode Encode une URL en UTF8. UrlUtf8Encode(<String>)

Personnaliser les activités avec des variables d’événements

Les variables d’événements peuvent servir à personnaliser plusieurs activités, répertoriées dans la section ci-dessous. Pour plus d’informations sur la façon d’appeler une variable à partir d’une activité, consultez cette section.

Activité Lecture d’audience : définissez l’audience à cibler en fonction de variables d’événements. Pour plus d’informations sur l’utilisation de cette activité, consultez cette section.

Activité Test : créez des conditions reposant sur des variables d’événements. Pour plus d’informations sur l’utilisation de cette activité, consultez cette section.

Activité Transfert de fichier : personnalisez le fichier à transférer en fonction des variables d’événements. Pour plus d’informations sur l’utilisation de cette activité, consultez cette section.

Activité Requête : les paramètres peuvent être référencés dans une requête en faisant appel à des expressions associant des variables d’événements et des fonctions. Pour ce faire, ajoutez une règle, puis cliquez sur le lien Mode avancé afin d’accéder à la fenêtre d’édition d’expression (voir Edition avancée d’expressions).

Pour plus d’informations sur l’utilisation de cette activité, consultez cette section.

Activités Canaux : personnalisez des diffusions en fonction de variables d’événements.

Remarque

Les valeurs des paramètres de diffusion sont récupérées chaque fois que la diffusion est préparée.

La préparation des diffusions récurrentes repose sur la période d’agrégation de diffusion. Par exemple, si la période d’agrégation est "par jour", la diffusion n’est repréparée qu’une fois par jour. Si la valeur d’un paramètre de diffusion est modifiée pendant la journée, elle n’est pas mise à jour dans la diffusion, car celle-ci a déjà été préparée une fois.

Si vous envisagez d’appeler le workflow plusieurs fois par jour, utilisez l’option Pas d’agrégation pour que les paramètres de diffusion soient mis à jour chaque fois. Pour plus d’informations sur la configuration des diffusions récurrentes, consultez cette section.

Pour personnaliser une diffusion en fonction de variables d’événements, vous devez tout d’abord déclarer dans l’activité de diffusion les variables que vous voulez utiliser :

  1. Sélectionnez l’activité, puis cliquez sur le bouton afin d’accéder aux paramètres.

  2. Sélectionnez l’onglet Général, puis ajoutez les variables d’événements qui seront disponibles dans la diffusion sous la forme de champs de personnalisation.

  3. Cliquez sur le bouton Confirmer.

Les variables d’événements déclarées sont à présent disponibles dans la liste des champs de personnalisation. Vous pouvez les utiliser dans la diffusion de façon à réaliser les actions ci-dessous :

  • Définissez le nom du modèle à utiliser pour la diffusion.

    Remarque

    Cette action est disponible uniquement pour les diffusions récurrentes.

  • Personnalisez la diffusion : lorsque vous sélectionnez un champ de personnalisation pour configurer une diffusion, des variables d’événements sont disponibles dans l’élément Paramètres de workflow. Vous pouvez les utiliser comme tout autre champ de personnalisation, par exemple pour définir l’objet de la diffusion, l’expéditeur, etc.

    La personnalisation de la diffusion est présentée dans cette section.

Codes segment : définissez le code segment en fonction des variables d’événements.

Remarque

Cette action peut être réalisée à partir de n’importe quelle activité qui vous permet de définir un code segment, tel que des activités Requête ou Segmentation.

Libellé de la diffusion : définissez le libellé de la diffusion en fonction des variables d’événements.

Sur cette page