Modules Figma

Avec les modules Figma Adobe Workfront Fusion, vous pouvez récupérer des listes de commentaires, de fichiers, de versions de fichiers ou de projets. Vous pouvez également publier un commentaire ou faire un appel à l’API Figma.

Si vous avez besoin d’instructions sur la création d’un scénario, consultez la section Créer un scénario.

Pour plus d’informations sur les modules, voir Modules dans Adobe Workfront Fusion.

Conditions d’accès

Vous devez disposer des accès suivants pour utiliser les fonctionnalités de cet article :

Adobe Workfront formule*
Pro ou version supérieure
Adobe Workfront licence*
Plan, Work
Adobe Workfront Fusion licence**

Exigences de licence actuelles : aucune exigence de licence Workfront Fusion requise.

Ou

Exigences de licence héritées : Workfront Fusion for Work Automation and Integration

Produit

Exigences actuelles du produit : si vous avez le plan Select ou Prime Adobe Workfront, votre entreprise doit acheter Adobe Workfront Fusion ainsi que Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article. Workfront Fusion est inclus dans la formule Workfront Ultimate.

Ou

Exigences liées aux produits hérités : votre entreprise doit acheter Adobe Workfront Fusion ainsi qu’Adobe Workfront pour utiliser la fonctionnalité décrite dans 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, voir Licences Adobe Workfront Fusion.

Conditions préalables

Pour utiliser les modules Figma, vous devez disposer d’un compte Figma.

Informations sur l’API Figma

Le connecteur Figma utilise les éléments suivants :

URL de base
https://api.figma.com/v1
Version de l’API
v1
Balise API
v1.8.25

Modules Figma et leurs champs

Lorsque vous configurez les modules Figma, Workfront Fusion affiche les champs répertoriés ci-dessous. En plus de ces derniers, des champs Figma supplémentaires peuvent s’afficher, selon des facteurs tels que votre niveau d’accès dans l’application ou le service. Un titre en gras dans un module indique un champ obligatoire.

Si le bouton « Mapper » apparaît au-dessus d’un champ ou d’une fonction, vous pouvez l’utiliser pour définir des variables et des fonctions pour ce champ. Pour plus d’informations, voir Mapper des informations d’un module à un autre dans Adobe Workfront Fusion.

Commentaires

Supprimer un commentaire

Ce module d’action supprime un seul commentaire d’un fichier.

Connection
Pour savoir comment connecter votre compte Figma à Workfront Fusion, consultez la section Se connecter à Adobe Workfront Fusion - Instructions de base.
File ID
Saisissez ou mappez l’ID du fichier auquel vous souhaitez ajouter ou supprimer un commentaire.
Comment
Saisissez le texte du commentaire que vous souhaitez supprimer.

Répertorier les commentaires

Ce module de recherche répertorie tous les commentaires attachés à un seul fichier dans Figma.

Connection
Pour savoir comment connecter votre compte Figma à Workfront Fusion, consultez la section Se connecter à Adobe Workfront Fusion - Instructions de base.
File ID

Saisissez ou mappez l’ID du fichier dont vous voulez récupérer les commentaires.

  • Si vous ne connaissez pas l’ID, cliquez sur Find Files et saisissez ou mappez l’ID du projet auquel le fichier est associé, puis sélectionnez le fichier.

  • Si vous ne connaissez pas l’ID du projet, cliquez sur Find Projects et saisissez ou mappez l’ID de l’équipe qui possède le projet auquel le fichier est associé, puis sélectionnez le projet et enfin le fichier.

Limit
Saisissez ou mappez le nombre maximum de commentaires que vous souhaitez que le module renvoie lors de chaque cycle d’exécution du scénario.

Publier un commentaire

Ce module d’action publie un commentaire dans un fichier Figma.

Connection
Pour savoir comment connecter votre compte Figma à Workfront Fusion, consultez la section Se connecter à Adobe Workfront Fusion - Instructions de base.
File ID

Saisissez ou mappez l’ID du fichier sur lequel vous souhaitez publier un commentaire.

  • Si vous ne connaissez pas l’ID du fichier, cliquez sur Find Files et saisissez ou mappez l’ID du projet auquel le fichier est associé, puis sélectionnez le fichier.

  • Si vous essayez de trouver l’ID du fichier et que vous ne connaissez pas l’ID du projet, cliquez sur Find Projects et saisissez ou mappez l’ID de l’équipe qui possède le projet auquel le fichier est associé. Sélectionnez le projet, puis le fichier.

Comment
Saisissez le texte du commentaire.

Projets et fichiers

Obtenir un fichier ou une image

Ce module d’action permet de récupérer un seul fichier ou une seule image dans une bibliothèque Figma.

Connection
Pour savoir comment connecter votre compte Figma à Workfront Fusion, consultez la section Se connecter à Adobe Workfront Fusion - Instructions de base.
Object type

Sélectionnez le type d’objet que vous souhaitez récupérer.

  • File

    Le module renvoie le document auquel se réfère la Key sous la forme d’un objet JSON. La clé de fichier peut être analysée à partir de n’importe quelle URL de fichier Figma.

    Pour les champs, consultez Get a file or image: File.

  • File nodes

    Renvoie les nœuds référencés par les ID sous la forme d’un objet JSON. Les nœuds sont extraits du fichier Figma auquel renvoie la Key.

    Pour les champs, consultez Get a file or image: File nodes.

  • Image

    Le module rend les images à partir d’un fichier.

    Pour les champs, consultez Get a file or image: Image.

  • Image fills

    Le module renvoie les liens de téléchargement pour toutes les images présentes dans les champs d’images d’un document. Les remplissages d’images sont la façon dont Figma représente les images fournies par l’utilisateur ou l’utilisatrice. Lorsque vous faites glisser une image dans Figma, Figma crée un rectangle avec un remplissage unique qui représente l’image, et l’utilisateur ou l’utilisatrice peut transformer le rectangle (et les propriétés du remplissage).

    Pour les champs, consultez Get a file or image: Image fills.

Obtenir un fichier ou une image : fichier
File key
Sélectionnez le fichier à partir duquel vous souhaitez renvoyer du JSON.
Version ID
Saisissez ou mappez la version du fichier que vous souhaitez que le module renvoie. Pour le module actuel, laissez ce champ vide.
Node IDs

Pour ne renvoyer qu’un sous-ensemble du document, saisissez les nœuds que vous souhaitez que le module renvoie. Le module renvoie les nœuds répertoriés, leurs tâches enfant et tout ce qui se trouve entre le nœud racine et les nœuds répertorés.

Pour chaque nœud que vous souhaitez renvoyer, cliquez sur Add et saisissez le texte du nœud.

Depth

Saisissez ou mappez un nombre entier représentant la profondeur de l’arborescence du document pour laquelle vous souhaitez obtenir des résultats.

Exemple :

  • Pour renvoyer des pages uniquement, saisissez 1.

  • Pour renvoyer des pages et des objets de niveau supérieur, saisissez 2.

Pour renvoyer tous les nœuds, laissez ce champ vide.

Geometry
Pour renvoyer des données vectorielles, saisissez paths.
Plugin data
Liste d’ID de plug-ins séparés par des virgules et/ou la chaîne de caractères « shared ». Toute donnée présente dans le document écrit par ces plug-ins sera incluse dans le résultat dans les propriétés pluginData et sharedPluginData.
Branch data
Activez cette option pour renvoyer les métadonnées de la branche pour le fichier demandé. Si le fichier est une branche, la clé du fichier principal est incluse dans la réponse renvoyée. Si le fichier comporte des branches, leurs métadonnées sont incluses dans la réponse renvoyée. Par défaut : false.
Obtenir un fichier ou une image : nœuds de fichiers
File key
Sélectionnez le fichier à partir duquel vous souhaitez renvoyer du JSON.
Node IDs

Saisir les nœuds que vous souhaitez que le module renvoie et convertisse.

Pour chaque nœud que vous souhaitez renvoyer, cliquez sur Add et saisissez le texte du nœud.

Version ID
Saisissez ou mappez la version du fichier que vous souhaitez que le module renvoie. Pour le module actuel, laissez ce champ vide.
Depth

Saisissez ou mappez un nombre entier représentant la profondeur de l’arborescence du document pour laquelle vous souhaitez obtenir des résultats.

Exemple :

  • Pour renvoyer des pages uniquement, saisissez 1.

  • Pour renvoyer des pages et des objets de niveau supérieur, saisissez 2.

Pour renvoyer tous les nœuds, laissez ce champ vide.

Geometry
Pour renvoyer des données vectorielles, saisissez paths.
Plugin data
Liste d’ID de plug-ins séparés par des virgules et/ou la chaîne de caractères « shared ». Toute donnée présente dans le document écrit par ces plug-ins sera incluse dans le résultat dans les propriétés pluginData et sharedPluginData.
Obtenir un fichier ou une image : image
File key
Sélectionnez le fichier à partir duquel vous souhaitez renvoyer du JSON.
Node IDs

Saisissez les nœuds que vous souhaitez que le module renvoie.

Pour chaque nœud que vous souhaitez voir renvoyé, cliquez sur Add et saisissez le texte du nœud.

Scale
Pour mettre l’image à l’échelle, saisissez ou mappez le facteur d’échelle. Ce nombre doit être compris entre 0,01 et 4.
Format

Sélectionnez le format de l’image en sortie.

  • JPG

  • PNG

  • SVG

  • PDF

SVG - Include ID
Activez cette option pour inclure des attributs d’identification pour tous les éléments SVG. Valeur par défaut : false.
SVG - Simplify Stroke
Activez cette option pour simplifier les traits intérieurs/extérieurs et utilisez l’attribut stroke si possible au lieu de <mask>. Valeur par défaut : true.
Use absolute bounds
Activez cette option pour utiliser les dimensions intégrales du nœud, qu’il soit ou non recadré ou que l’espace autour de lui soit vide. Cette option permet d’exporter des nœuds de texte sans recadrage. Valeur par défaut : false.
Version ID
Saisissez ou mappez la version du fichier que vous souhaitez que le module renvoie. Pour le module actuel, laissez ce champ vide.
Obtenir un fichier ou une image : remplissages de l’image
File key
Sélectionnez le fichier à partir duquel vous souhaitez renvoyer du JSON.

Répertorier l’historique des versions des fichiers

Ce module de recherche renvoie l’historique des versions d’un seul fichier dans Figma.

Connection
Pour savoir comment connecter votre compte Figma à Workfront Fusion, consultez la section Se connecter à Adobe Workfront Fusion - Instructions de base.
File ID

Saisissez ou mappez l’ID du fichier dont vous souhaitez récupérer l’historique des versions.

  • Si vous ne connaissez pas l’ID du fichier, cliquez sur Find Files et saisissez ou mappez l’ID du projet auquel le fichier est associé, puis sélectionnez le fichier.

  • Si vous essayez de trouver l’ID du fichier et que vous ne connaissez pas l’ID du projet, cliquez sur Find Projects et saisissez ou mappez l’ID de l’équipe qui possède le projet auquel le fichier est associé. Sélectionnez le projet, puis le fichier.

Limit
Saisissez ou mappez le nombre maximum d’enregistrements que le module doit renvoyer pour chaque cycle d’exécution du scénario.

Répertorier les fichiers du projet

Ce module de recherche renvoie une liste de tous les fichiers du projet spécifié.

Connection
Pour savoir comment connecter votre compte Figma à Workfront Fusion, consultez la section Se connecter à Adobe Workfront Fusion - Instructions de base.
File ID

Saisissez ou mappez l’ID du projet pour lequel vous souhaitez récupérer les fichiers.

  • Si vous ne connaissez pas l’ID du projet, cliquez sur Find Projects et saisissez ou mappez l’ID de l’équipe à laquelle le projet est associé, puis sélectionnez le projet.
Limit
Saisissez ou mappez le nombre maximum d’enregistrements que le module doit renvoyer pour chaque cycle d’exécution du scénario.

Répertorier les projets

Ce module de recherche renvoie une liste de tous les projets de l’équipe spécifiée.

Connection
Pour savoir comment connecter votre compte Figma à Workfront Fusion, consultez la section Se connecter à Adobe Workfront Fusion - Instructions de base.
Team ID
Saisissez ou mappez l’ID du projet pour lequel vous souhaitez récupérer les fichiers. L’identifiant de l’équipe se trouve dans l’URL de la page de l’équipe dans Figma.
Limit
Saisissez ou mappez le nombre maximum d’enregistrements que le module doit renvoyer pour chaque cycle d’exécution du scénario.

Composants et styles

Obtenir un style ou un composant

Ce module d’action permet de récupérer un style ou un composant unique, ou un ensemble de styles ou de composants.

Connection
Pour savoir comment connecter votre compte Figma à Workfront Fusion, consultez la section Se connecter à Adobe Workfront Fusion - Instructions de base.
<Object> key
Saisissez la clé (identifiant unique) de l’objet que vous souhaitez récupérer.
Team ID
Saisissez ou mappez l’ID de l’équipe à laquelle l’enregistrement ou les enregistrements sont associés.
Page Size
Saisissez ou mappez le nombre de résultats à renvoyer par page. Valeur par défaut : 30.
After

Saisissez ou mappez le numéro du résultat après lequel vous souhaitez commencer à extraire des résultats. Ce champ peut être combiné avec le champ Page Size pour paginer les résultats.

Cette valeur ne correspond pas aux ID des objets.

Ce champ ne peut pas être utilisé en combinaison avec le champ Before.

Before

Saisissez ou mappez le numéro du résultat avant lequel vous souhaitez commencer à extraire des résultats. Ce champ peut être combiné avec le champ Page Size pour paginer les résultats.

Cette valeur ne correspond pas aux ID des objets.

Ce champ ne peut pas être utilisé en combinaison avec le champ After.

Autre

Effectuer un appel API

Ce module d’action vous permet d’effectuer un appel authentifié personnalisé à l’API Figma sans avoir à réfléchir à l’authentification. De cette façon, vous pouvez créer une automatisation des flux de données qui ne peut pas être réalisée par les autres modules Figma.

Connection
Pour savoir comment connecter votre compte Figma à Workfront Fusion, voir Créer une connexion à Adobe Workfront Fusion - Instructions de base..
URL

Saisissez un chemin d’accès relatif à https://api.figma.com/v1/.

Par exemple : files/7179110/comments

Method
Sélectionnez la méthode de requête HTTP dont vous avez besoin pour configurer l’appel API. Pour plus d’informations, voir Méthodes de requête HTTP dans Adobe Workfront Fusion.
Headers

Ajoutez les en-têtes de la requête sous la forme d’un objet JSON standard.

Par exemple, {"Content-type":"application/json"}

Workfront Fusion ajoute les en-têtes d’autorisation pour vous.

Query String

Ajoutez la requête pour l’appel API sous la forme d’un objet JSON standard.

Par exemple : {"name":"something-urgent"}

Body

Ajoutez le contenu du corps de l’appel API sous la forme d’un objet JSON standard.

Note :

Lorsque vous utilisez des instructions conditionnelles telles que if dans votre JSON, mettez les guillemets à l’extérieur de l’instruction conditionnelle.

Surveiller les événements

Ce module déclencheur lance un scénario lorsque l’un des événements suivants se produit pour une équipe spécifique dans votre espace d’équipe Figma.

  • Mise à jour de fichier

  • Mise à jour de la version du fichier

  • Suppression de fichier

  • Publication de bibliothèque

  • Commentaire de fichier

Webhook

Sélectionnez le webhook que le module surveille.

Pour ajouter un nouveau webhook :

  1. Cliquez sur Add à côté du champ Webhook.

  2. Sélectionnez la connexion que vous souhaitez utiliser pour ce webhook. Pour obtenir des instructions sur la connexion de votre compte Figma à Workfront Fusion, consultez la section Se connecter à Adobe Workfront Fusion - Instructions de base.

  3. Sélectionnez le type d’événement que vous voulez que le module surveille.

  4. Saisissez l’ID de l’équipe dont vous souhaitez que le webhook surveille les événements.

  5. Saisissez le Status ou la Description des événements que vous souhaitez que le webhook surveille.

  6. Cliquez sur Save pour enregistrer le webhook et revenir au module.

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