Mapper les informations d’un module à un autre dans Adobe Workfront Fusion
Le mappage désigne le processus d’affectation des sorties d’un module, structurées en éléments, aux champs d’entrée d’un autre.
Le panneau de mappage s’affiche lorsque vous cliquez sur un champ dans lequel vous souhaitez insérer une valeur émise par un module précédent dans un scénario. Dans n’importe quel champ disponible pour le mappage au sein d’un module, vous pouvez créer une formule à l’aide de n’importe quelle combinaison de fonctions et d’éléments mappés du panneau de mappage avec le texte statique saisi. Ces éléments peuvent être imbriqués les uns dans les autres.
Conditions d’accès
Vous devez disposer des accès suivants pour utiliser les fonctionnalités de cet article :
Pour connaître la formule, le type de licence ou l’accès dont vous disposez, contactez votre équipe d’administration Workfront.
Pour plus d’informations sur les licences Adobe Workfront Fusion, consultez Licences Adobe Workfront Fusion.
Lots et éléments
L’opération d’un module produit zéro, un ou plusieurs lots en tant que sortie. Un lot se compose d’un ou de plusieurs éléments.
Pour explorer la sortie d’un module, procédez comme suit :
-
Cliquez sur Exécuter une fois pour lancer le module.
-
Cliquez sur la bulle au-dessus du module.
Un journal contenant toutes les phases du module s’affiche. Vous trouverez le ou les lots émis par la phase d’opération d’un module sous l’en-tête Sortie. Chaque lot contient ses éléments et les valeurs de chaque élément.
Date
, Email ID (UID)
, size
, etc.Mapper un élément
Après avoir créé une séquence de modules en les liant, chaque module peut traiter les valeurs des éléments générés par les modules qui le précèdent.
Pour affecter les éléments aux champs de saisie d’un module, procédez comme suit :
-
Cliquez sur le module qui doit traiter la sortie du ou des modules précédents.
-
Dans le panneau Paramètres du module qui s’affiche, cliquez sur un champ dans lequel vous souhaitez utiliser la valeur d’un élément généré à partir d’un ou plusieurs modules précédents.
Le panneau de mappage s’ouvre.
-
Cliquez sur un élément du panneau de mappage pour l’insérer dans le champ.
-
(Facultatif) Pour trouver un champ spécifique dans le panneau de mappage, cliquez sur la barre de recherche du panneau de mappage et saisissez le terme souhaité. Cliquez sur le champ lorsqu’il apparaît dans la liste.
Les résultats de recherche contiennent le terme de recherche et ne sont pas sensibles à la casse.
Pour plus d’informations, voir Configurer les paramètres d’un module dans Adobe Workfront Fusion.
Formules
Vous pouvez mapper plusieurs éléments dans un champ, les combiner avec des littéraux (valeurs fixes) et utiliser des opérateurs et des fonctions pour créer des formules complexes :
Les fonctions et opérateurs sont disponibles dans le panneau de mappage sous l’un de ses onglets.
Le premier onglet (affiché à l’ouverture du panneau) affiche les éléments que vous pouvez mapper à partir d’autres modules.
Les autres onglets contiennent les types de fonctions suivants :
-
Fonctions générales - Voir Fonctions générales dans Adobe Workfront Fusion pour plus d’informations.
-
Fonctions mathématiques - Voir Fonctions mathématiques dans Adobe Workfront Fusion pour plus d’informations.
-
Fonctions de texte et binaires - Voir Fonctions de chaîne de caractères dans Adobe Workfront Fusion pour plus d’informations.
-
Date et heure - Voir Fonctions de date et d’heure dans Adobe Workfront Fusion et les articles ci-dessous pour plus d’informations.
-
Fonctions relatives à l’utilisation de tableaux - Voir Fonctions de tableau dans Adobe Workfront Fusion pour plus d’informations.
Pour plus d’informations sur le mappage des éléments à l’aide de fonctions, voir Mapper des éléments à l’aide de fonctions dans Adobe Workfront Fusion.
Collections
Certains éléments peuvent contenir plusieurs valeurs de différents types. Il s’agit d’éléments de type collection.
Vous pouvez identifier un élément de type collection par le petit rectangle noir affiché à droite du libellé de l’élément et sa liste de sous-éléments automatiquement développée :
Pour plus d’informations sur les collections, voir Types de données d’élément dans Adobe Workfront Fusion.
Tableaux
Certains éléments peuvent contenir plusieurs éléments du même type. Il s’agit d’éléments de type tableau.
Vous pouvez identifier un élément de type tableau par les crochets à la fin du libellé de l’élément. Cliquez sur le petit rectangle noir à droite du libellé de l’élément pour afficher les éléments de l’élément :
Pour plus d’informations sur les tableaux, voir Types de données d’élément dans Adobe Workfront Fusion
Mapper le premier élément d’un tableau
Si vous mappez un élément Recipient name
de tableau, il s’affiche dans le champ comme suit :
Le nombre entre crochets est un index qui détermine l’élément du tableau qui sera utilisé. Il est défini sur 1 par défaut.
Mapper le n-ième élément d’un tableau
Si vous souhaitez accéder à un autre élément, cliquez sur les crochets et modifiez la valeur de l’index :
Mapper l’élément d’un tableau avec une clé donnée
Certains tableaux contiennent plusieurs collections avec des éléments de clé et de valeur. Il s’agit généralement de différents attributs, métadonnées, etc.
L’exemple suivant illustre la sortie de l’application Jira.
Dans cet exemple, nous obtenons un nom du fichier provenant d’un tableau de pièces jointes pour la pièce jointe spécifique ayant un ID de 10108.
La sortie de Jira ressemble à ceci :
En règle générale, il est nécessaire de rechercher un élément par sa valeur de clé donnée et d’obtenir la valeur correspondante de l’élément de valeur. Cela peut être obtenu avec une formule utilisant une combinaison des fonctions map()
et get()
.
Vous trouverez ci-dessous une ventilation détaillée de la formule :
-
Le premier paramètre de la fonction
map()
est l’élément de tableau entier. -
Le deuxième paramètre est le nom brut de l’élément de valeur. Pour obtenir le nom brut, pointez sur l’élément dans le panneau de mapping :
note note NOTE Tous les paramètres respectent la casse. Même si, dans cet exemple particulier, le libellé de l’élément ne diffère de son nom brut que par la mise en majuscules, il est nécessaire d’utiliser le nom brut, qui est entièrement en minuscules, contrairement au libellé Valeur. -
Le troisième paramètre est le nom brut de l’élément clé :
-
Le quatrième paramètre est la valeur de clé donnée.
Parce que la fonction map()
renvoie un tableau (puisqu’il peut y avoir plus d’éléments avec la valeur de clé donnée), il est nécessaire d’appliquer la fonction get()
pour obtenir son premier élément :
-
Le premier paramètre de la fonction
get()
est le résultat de la fonctionmap()
. -
Le deuxième paramètre est l’index de l’élément - un.
Pour plus d’informations sur la fonction map()
, voir Fonctions de tableau dans Adobe Workfront Fusion.
Pour plus d’informations sur la fonction get()
, voir Fonctions générales dans Adobe Workfront Fusion.
Conversion d’éléments en une série de lots
Les tableaux peuvent être convertis en une série de lots à l’aide du module Itérateur. Pour plus d’informations, consultez le module Itérateur dans Adobe Workfront Fusion.
Dépannage
Éléments manquants dans le panneau de mappage
Pour chaque module, le panneau de mappage affiche tous les éléments de sortie, répertoriés par l’auteur ou l’autrice du module. Dans certains cas, cette liste peut être incomplète pour diverses raisons et certains éléments peuvent être manquants. Workfront Fusion peut déterminer automatiquement les éléments de sortie manquants lorsque vous exécutez le module dans l’éditeur de scénario. La procédure exacte diffère légèrement selon le type du module :
Déclencheur instantané
-
Cliquez avec le bouton droit sur le module, puis cliquez sur Exécuter ce module uniquement dans le menu qui s’affiche.
S’il n’existe aucun webhook en file d’attente, le module attend qu’un nouveau webhook soit traité.
-
Générez un webhook.
Par exemple, le module webhook Slack > Écouter les nouveaux événements (qui recherche les nouveaux messages de canal dans un canal) envoie un message au canal.
-
Lorsque l’exécution du module est terminée, cliquez sur la bulle au-dessus du module pour explorer sa sortie complète.
Le panneau de mappage contient tous les éléments qui ont été découverts dans la sortie du module.
Déclencheur d’attente active
-
Cliquez avec le bouton droit sur le module, puis cliquez sur Exécuter ce module uniquement dans le menu qui s’affiche.
-
Si aucune sortie n’est disponible, cliquez sur Choisir l’emplacement de départ et ajustez les paramètres.
-
S’il n’y a aucun événement à traiter, créez-en un et revenez à l’étape 2.
Par exemple, le module webhook Gmail > Surveiller les e-mails envoie un e-mail au dossier que le module surveille.
-
Lorsque l’exécution du module est terminée, cliquez sur la bulle au-dessus du module pour explorer sa sortie complète.
Le panneau de mappage contient désormais tous les éléments qui ont été découverts dans la sortie du module.
Autres modules
Vous pouvez choisir d’exécuter les éléments suivants :
-
L’ensemble du scénario (ou seulement la partie contenant le module)
Si votre scénario commence par un déclencheur, reportez-vous à la section Déclencheur instantané ou Déclencheur d’attente active ci-dessus.
-
Seulement le module unique
Si vous choisissez d’exécuter seulement le module unique, procédez comme suit :
-
Cliquez avec le bouton droit sur le module, puis cliquez sur Exécuter ce module uniquement dans le menu qui s’affiche.
-
Indiquez des exemples de valeurs pour les éléments d’entrée, puis cliquez sur OK.
-
Lorsque l’exécution du module est terminée, cliquez sur la bulle au-dessus du module pour explorer sa sortie complète.
Le panneau de mappage contient désormais tous les éléments qui ont été découverts dans la sortie du module.