Utilisation de packages de fonctions personnalisées
Les packages vous permettent de créer et d’exécuter votre propre logique personnalisée dans Adobe Workfront Fusion, sans quitter l’interface de Fusion. Lorsque les modules standard ne font pas exactement ce dont vous avez besoin, vous pouvez utiliser une fonction pour transformer des données, effectuer un calcul, appeler un service externe ou encapsuler une routine que vous souhaitez réutiliser. Vous pouvez ensuite la tester, la mettre en ligne et l’utiliser à partir de vos scénarios.
Des fonctions complexes peuvent nécessiter des ressources telles que des variables et des dépendances telles que des bibliothèques. Pour ces fonctions, vous pouvez créer un package qui inclut la fonction et ses ressources.
Un package peut inclure :
- Fonctions : logique exécutée lors de l’exécution d’un scénario.
- Variables : valeurs réutilisables, telles qu’une URL de base ou une clé API, que la fonction du package utilise.
- Dépendances : en dehors des bibliothèques sur lesquelles vos fonctions peuvent s’appuyer.
- Historique : versions antérieures de chaque fonction, enregistrées automatiquement, que vous pouvez référencer.
Conditions d’accès
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| Package Adobe Workfront |
Tout package de workflow Adobe Workfront et tout package d’automatisation et d’intégration Adobe Workfront Workfront Ultimate Packages Workfront Prime et Select, avec l’achat supplémentaire de Workfront Fusion. |
| Licences Adobe Workfront |
Standard Travail ou supérieur |
| Produit |
|
Pour plus d’informations sur le contenu de ce tableau, consultez Conditions d’accès requises dans la documentation.
Configurer la connexion à l’environnement d’exécution
La première fois que votre équipe utilise cette fonctionnalité, vous devez configurer l’environnement qui exécute les fonctions. Vous ne le faites qu’une seule fois par équipe.
-
Cliquez sur l’onglet Packages
Si l’environnement n’a pas été configuré, l’écran Environnement d’exécution non configuré s’affiche.
-
Cliquez sur Initialiser l’exécution.
-
Pour saisir un autre nom que le nom par défaut, saisissez le nom dans le champ Nom de la connexion.
-
Sélectionnez le projet Adobe App Builder auquel ce package appartiendra :
- Pour sélectionner un projet existant, commencez à saisir le nom du projet, puis sélectionnez-le lorsqu’il apparaît.
- Pour créer un projet, saisissez un nom qui n’existe pas déjà et cliquez sur Créer.
- Si vous laissez ce champ vide, Fusion utilise un projet par défaut.
-
Sélectionnez Continuer.
Fusion termine la configuration et vous êtes prêt à créer des packages.
Votre environnement s’affiche sous la forme d’un onglet de connexion en haut de la page.
-
(Conditionnel) Pour ajouter un environnement supplémentaire, cliquez sur l’icône Plus et suivez les instructions de cette section.
-
(Conditionnel) Pour supprimer un environnement existant, passez la souris sur l’onglet de connexion de l’environnement et cliquez sur X lorsqu’il apparaît.
note warning WARNING La suppression d’une connexion déconnecte Fusion de cet environnement. Les packages qu’il contient ne sont plus disponibles dans Fusion via cette connexion.
Création et ouverture d’un package
-
Cliquez sur l’onglet Packages
-
Sélectionnez l’onglet de la connexion sur laquelle vous souhaitez travailler.
-
Cliquez sur Créer un package.
-
Saisissez un nom et sélectionnez Créer.
Le package s’ouvre automatiquement.
-
Pour rouvrir un package ultérieurement, sélectionnez-le dans la liste Packages et sélectionnez Afficher.
-
Pour supprimer un package, sélectionnez-le dans la liste Packages et choisissez Supprimer.
note warning WARNING La suppression d’un package le supprime définitivement, ainsi que tout son contenu.
Gestion d’un package
Un package ouvert est organisé en quatre zones :
- Fonctions : créez, testez et publiez la fonction.
- Variables : configurez les variables de la fonction.
- Dépendances : installez des dépendances, telles que des bibliothèques externes, pour cette fonction.
- Historique : affichez les versions antérieures de chaque fonction.
En plus de ces quatre zones, un compteur de stockage en haut indique la part de votre espace utilisée. Chaque package est limité à une taille totale de 21 Mo. Cela inclut les fonctions, les variables et les dépendances, y compris les versions enregistrées.
Si vous manquez d’espace, nous vous recommandons de supprimer les dépendances, variables ou versions antérieures inutilisées pour en libérer.
Pour revenir à la liste des packages, sélectionnez la flèche Précédent en regard du nom du package.
Fonctions
La zone Fonctions affiche une liste des fonctions du package, y compris le nom de la fonction, son statut, sa taille et le nombre d’entrées attendu.
Affichage et gestion de la liste des fonctions
Pour filtrer la liste Fonctions :
- Filtrez par statut en cliquant sur Tous, Brouillons ou Publié.
- Utilisez la barre de recherche pour rechercher des fonctions spécifiques.
Une fonction peut avoir le statut brouillon ou publié.
- Brouillon : les fonctions à l’état de brouillon sont des travaux en cours. Vous pouvez modifier et tester librement sans affecter les données actives.
- Publié : les versions publiées sont en ligne. Vos scénarios exécutent des versions publiées de fonctions.
L’utilisation de brouillons permet d’apporter des modifications en toute sécurité. Vous pouvez affiner un brouillon, le tester, puis le publier lorsque vous êtes satisfait(e).
Créez ou modifiez une fonction dans la zone Packages
-
Cliquez sur l’onglet Packages
-
Dans la zone Fonctions, sélectionnez Créer une fonction.
Ou
Cochez la case en regard d’une fonction existante, puis sélectionnez Modifier dans la barre d’actions située au bas de la page.
-
(Conditionnel) Si vous créez une fonction, dans le champ Nouvelle fonction, saisissez un nom pour la fonction.
-
(Facultatif et conditionnel) Pour renommer une fonction existante, cliquez sur l’icône Modifier en regard du nom de la fonction et saisissez le nouveau nom.
-
Dans l’onglet Code, saisissez la logique de la fonction.
Tenez compte des points suivants lors de la création de votre fonction :
- Les fonctions doivent être écrites en JavaScript.
- Vous pouvez lire les entrées que vous définissez, réutiliser vos variables et appeler vos autres fonctions.
- Lorsque vous tapez, des suggestions s’affichent.
-
Pour nettoyer le formatage des fonctions, cliquez sur embellir.
-
(Facultatif) Dans l’onglet Paramètres, définissez les entrées attendues par votre fonction.
Pour plus d’informations sur les entrées, voir Définir des entrées dans cet article.
-
Dans l’onglet Test, testez votre fonction.
Pour obtenir des instructions, voir Tester une fonction dans cet article.
-
Pour enregistrer cette fonction en tant que brouillon, cliquez sur Enregistrer en tant que brouillon.
Ou
Pour publier la fonction, cliquez sur Publier.
note NOTE La publication d’une fonction efface son historique de versions. La version publiée devient le point de départ actuel et les brouillons précédents ne sont plus conservés.
Définir les entrées
Vous pouvez utiliser l’onglet Paramètres pour décrire les informations dont votre fonction a besoin à chaque exécution.
-
Cliquez sur l’onglet Packages
-
Dans la zone Fonctions, sélectionnez Créer une fonction.
Ou
Cochez la case en regard d’une fonction existante, puis sélectionnez Modifier dans la barre d’actions située au bas de la page.
-
Cliquez sur l’onglet Paramètres.
-
Pour chaque paramètre à ajouter, cliquez sur Ajouter un paramètre et configurez les éléments suivants :
- Name : nom de l’entrée
- Libellé : nom convivial affiché lorsque vous testez la fonction
- Type : type de données, tel que du texte, un nombre, true/false ou un objet structuré.
- Obligatoire : indique si une valeur doit être fournie.
Ces entrées deviennent les champs que vous renseignez lors du test et les valeurs que votre scénario transmet lorsqu’il exécute la fonction.
Tester une fonction
Nous vous recommandons de tester une fonction avant de la publier.
-
Cliquez sur l’onglet Packages
-
Dans la zone Fonctions, sélectionnez Créer une fonction.
Ou
Cochez la case en regard d’une fonction existante, puis sélectionnez Modifier dans la barre d’actions située au bas de la page.
-
Cliquez sur l’onglet Test.
-
Saisissez une valeur pour chaque entrée.
-
Exécutez la fonction :
- Sélectionnez Tester le brouillon pour essayer votre version de travail en cours.
- Sélectionnez Exécuter publié pour exécuter la version active.
-
Examinez le résultat, y compris s’il a réussi, combien de temps et la sortie renvoyée.
Apporter des modifications à une fonction active
Une fois la fonction publiée, le bouton Publier devient un menu :
- Republier — Poussez vos dernières modifications de brouillon vers la version active.
- Dépublier — mettre la fonction hors service. Votre travail est conservé en tant que brouillon afin que vous puissiez y revenir.
Suppression d’une fonction
- Cliquez sur l’onglet Packages
- Cochez la case en regard d’une fonction existante, puis sélectionnez Supprimer dans la barre d’actions située au bas de la page.
Variables
Les variables sont des valeurs réutilisables que vos fonctions peuvent utiliser, telles qu’une URL de base, un identifiant de compte ou une clé API. En les stockant en tant que variables, vous définissez une valeur une fois et la mettez à jour à un seul endroit, au lieu de la mettre à jour sur de nombreuses fonctions.
Créer ou modifier une variable
-
Cliquez sur l’onglet Packages
-
Dans l’onglet Variables, sélectionnez Nouvelle variable.
Ou
Cliquez sur l’icône Modifier en regard de la variable à modifier.
-
Renseignez les détails :
- Clé : saisissez le nom que vos fonctions utilisent pour faire référence à la valeur.
Pour renommer cette variable, modifiez la valeur Clé .
- Valeur : saisissez la valeur à stocker.
- Type : indiquez si le type de valeur est du texte, un nombre, une valeur booléenne (true/false) ou un objet structuré.
- Description : saisissez une note facultative pour vous rappeler à quoi elle sert.
- Public : activez cette option si vous souhaitez utiliser la variable dans le concepteur de scénarios. Lorsqu’elle est désactivée, la variable n’est disponible que dans les fonctions du package.
- Secret : activez cette option pour masquer les valeurs sensibles, telles que les clés. La valeur est masquée dans la liste des variables et est également assainie afin de ne pas être exposée dans le concepteur de scénarios. Vos fonctions reçoivent toujours la valeur réelle lorsqu’elles s’exécutent.
-
Sélectionnez Créer une variable ou Enregistrer les modifications.
Suppression d’une variable
- Cliquez sur l’onglet Packages
- Dans l’onglet Variables, cliquez sur l’icône Supprimer en regard de la variable à supprimer.
Dépendances
Certaines fonctions nécessitent des bibliothèques supplémentaires pour faire leur travail. L’onglet Dépendances vous permet d’ajouter et de gérer ces bibliothèques.
Ajout de bibliothèques
-
Cliquez sur l’onglet Packages
-
Dans l’onglet Dépendances, saisissez un ou plusieurs noms de bibliothèque, séparés par des virgules. Vous pouvez demander une version spécifique en l’ajoutant après le nom (par exemple,
axios, lodash@4.17.21). -
Cliquez sur Installer.
Suppression d’une bibliothèque
- Cliquez sur l’onglet Packages
- Dans l’onglet Dépendances, cliquez sur l’icône Supprimer en regard de la bibliothèque à supprimer.
Historique
Chaque fois que vous enregistrez un brouillon d’une fonction, Fusion conserve une copie. L’onglet Historique vous permet d’afficher et de restaurer des versions antérieures.
-
Cliquez sur l’onglet Packages
-
Dans l’onglet Historique, sélectionnez une fonction sur la gauche pour afficher d’abord ses versions enregistrées, la plus récente.
-
Sélectionnez une version pour afficher exactement ce qu’elle contenait à ce moment.
-
Pour restaurer une version, cliquez sur Restaurer en tant que brouillon.
La version est restaurée en tant que nouveau brouillon, afin que vous puissiez la réviser et la tester avant de la publier. Votre version active reste en place jusqu’à la publication.
-
Pour supprimer une version, sélectionnez-la, cliquez sur Supprimer la version et confirmez.
- La publication d’une fonction efface son historique. L’historique suit les modifications que vous apportez pendant que vous travaillez sur un brouillon, jusqu’à la publication.
- La suppression d’une version est irréversible.
Utilisation d’un package dans un scénario
L’objectif de la création de fonctions et de variables est de les mettre à profit dans vos scénarios. Pour utiliser des fonctions et des variables, utilisez le connecteur Adobe App Builder.
- Utiliser la fonction à partir du package : ce module exécute l’une de vos fonctions en tant qu’étape d’un scénario. Choisissez le package et la fonction, renseignez les entrées que vous avez définies, et le résultat de la fonction est transmis aux modules qui suivent.
- Utiliser la variable du package : ce module intègre l’une de vos variables de package dans un scénario afin que vous puissiez mapper sa valeur à d’autres modules.
Pour obtenir des informations et des instructions, voir Modules Adobe App Builder.