Mapper les informations d’un module à un autre dans Adobe Workfront Fusion

Le mappage est le processus d’affectation des sorties d’un module, structurées en éléments, aux champs d’entrée d’un autre module.

Le panneau de mappage s’affiche lorsque vous cliquez sur un champ dans lequel vous souhaitez insérer une valeur extraite d’un module précédent dans un scénario. Dans un module, dans n’importe quel champ disponible pour le mappage, 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 du texte statique saisi. Ces éléments peuvent être imbriqués les uns dans les autres.

Conditions d’accès

Pour utiliser les fonctionnalités décrites dans cet article, vous devez disposer des éléments suivants :

Adobe Workfront forfait*
Pro ou supérieur
Adobe Workfront licence*
Plan, Work
Licence Adobe Workfront Fusion**

Exigences de licence actuelle : aucune exigence de licence Workfront Fusion

Ou

Exigence de licence héritée : Workfront Fusion for Work Automation and Integration

Produit

Exigences du produit actuel : si vous disposez du forfait Adobe Workfront Select ou Prime, votre entreprise doit acheter Adobe Workfront Fusion et Adobe Workfront pour utiliser les fonctionnalités décrites dans cet article. Workfront Fusion est inclus dans le forfait Workfront Ultimate.

Ou

Exigences du produit hérité : votre entreprise doit acheter Adobe Workfront Fusion et Adobe Workfront pour utiliser les fonctionnalités décrites dans cet article.

Pour connaître la formule, le type de licence ou l’accès dont vous disposez, contactez vote administrateur ou administratrice Workfront.

Pour plus d’informations sur les licences Adobe Workfront Fusion, consultez les Adobe Workfront Fusion licences.

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 :

  1. Cliquez sur Exécuter une fois pour exécuter le module.

  2. Cliquez sur la bulle au-dessus du module.

    Un journal contenant toutes les phases du module s’affiche. Vous pouvez trouver le lot ou les lots générés par la phase d’opération d’un module sous l’en-tête Output . Chaque lot contient ses éléments et les valeurs de chaque élément.

INFO
Exemple : Cet exemple illustre le module Email > Watch emails. Vous pouvez constater qu’il a effectué une opération produisant un seul lot contenant divers éléments tels que Date, Email ID (UID), size, etc.
NOTE
Les sorties des modules placés entre un itérateur et un agrégateur ne sont pas accessibles au-delà du module agrégateur.

Mappage d’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 :

  1. Cliquez sur le module qui doit traiter la sortie du ou des modules précédents.

  2. 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.

  3. Cliquez sur un élément du panneau de mappage pour l’insérer dans le champ.

  4. (Facultatif) Pour rechercher un champ particulier dans le panneau de mappage, cliquez sur la barre de recherche du panneau de mappage et saisissez le terme à rechercher. Cliquez sur le champ lorsqu’il apparaît dans la liste.

    Les résultats de la recherche contiennent le terme recherché et ne sont pas sensibles à la casse.

Pour plus d’informations, voir Configuration des 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 :

TIP
Lorsque vous créez une formule complexe que vous souhaitez réutiliser dans un autre champ, vous pouvez cliquer sur le champ qui contient la combinaison, utiliser Commande-A ou Ctrl-A pour la sélectionner, puis copier-coller dans l'autre champ.

Pour plus d’informations sur le mappage des éléments à l’aide de fonctions, voir Mappage 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 étendue :

NOTE
Dans la plupart des cas, vous mappez les sous-éléments de la collection plutôt que l’élément représentant l’ensemble de la collection.

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

Mappage du premier élément d’un tableau

Si vous mappez l’élément Recipient name d’un 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.

Mappage du 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 :

Mise en correspondance de 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érentes métadonnées, attributs, etc.

L’exemple suivant illustre la sortie de l’application Jira.

Dans cet exemple, nous obtenons un nom de fichier provenant d’un tableau de pièces jointes pour la pièce jointe spécifique avec 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 réalisé avec une formule utilisant une combinaison des fonctions map() et get().

Vous trouverez ci-dessous une répartition détaillée de la formule :

  1. Le premier paramètre de la fonction map() est l’élément de tableau entier.

  2. Le deuxième paramètre est le nom brut de l’élément de valeur. Pour obtenir le nom brut, passez la souris sur l’élément dans le panneau 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 qu’en majuscules, il est nécessaire d’utiliser le nom brut, qui est entièrement en minuscules, contrairement au libellé Valeur.
  3. Le troisième paramètre est le nom brut de l’élément clé :

  4. Le quatrième paramètre est la valeur de clé donnée.

Comme la fonction map() renvoie un tableau (car 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 fonction map().

  • 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, voir 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 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écouvrir 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é

  1. 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 webhooks en file d’attente, le module attend qu’un nouveau webhook soit traité.

  2. Générez un webhook.

    Par exemple, le module webhook Slack>Listen for new events (qui recherche les nouveaux messages de canal dans un canal) envoie un message au canal.

  3. 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.

Sondage

  1. Cliquez avec le bouton droit sur le module, puis cliquez sur Exécuter ce module uniquement dans le menu qui s’affiche.

  2. S'il n'y a pas de sortie, cliquez sur Choisir où démarrer et ajustez les paramètres.

  3. Si aucun événement ne doit être traité, créez-en un et revenez à l’étape 2.

    Par exemple, le module webhook Gmail >Watch emails envoie un courrier électronique au dossier que le module regarde.

  4. 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 :

Si vous choisissez d’exécuter uniquement le module unique :

  1. Cliquez avec le bouton droit sur le module, puis cliquez sur Exécuter ce module uniquement dans le menu qui s’affiche.

  2. Indiquez des exemples de valeurs pour les éléments d’entrée, puis cliquez sur OK .

  3. 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.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43