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 pour créer un scénario, consultez les articles sous Créer un scénario : index d’article.

Pour plus d’informations sur les modules, consultez les articles sous Modules : index des articles.

Conditions d’accès

Développez pour afficher les exigences d’accès aux fonctionnalités de cet article.

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

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Package Adobe Workfront Tous
Licence Adobe Workfront

Nouveau : Standard

Ou

En cours : Travail ou version ultérieure

Licence Adobe Workfront Fusion **

Actuel : aucune exigence de licence Workfront Fusion.

Ou

Hérité : Workfront Fusion pour l’automatisation et l’intégration du travail

Produit

Nouveau :

  • Sélectionnez ou le package Prime Workfront : votre entreprise doit acheter Adobe Workfront Fusion.
  • Package Ultimate Workfront : Workfront Fusion est inclus.

Ou

Actuel : votre entreprise doit acheter Adobe Workfront Fusion.

Pour plus d’informations sur les informations contenues dans ce tableau, voir Conditions d’accès requises dans la documentation.

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

Créer une connexion vers Figma

Pour créer une connexion pour vos modules Figma :

  1. Dans un module Figma, cliquez sur Add en regard de la zone Connexion .

  2. Remplissez les champs suivants :

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header
    Connection type

    Pour les nouvelles connexions, sélectionnez Figma sans la balise héritée.

    La Figma a modifié ses exigences d’authentification en janvier 2025. Le type de connexion Figma répond aux nouvelles exigences. Le type de connexion Figma (Legacy) sera supprimé ultérieurement.

    Connection name Saisissez un nom pour cette connexion.
    Client ID Saisissez votre Client ID de Figme.
    Client Secret Entrez votre Client Secret Figma.
    Portées personnalisées Saisissez les portées personnalisées requises pour cette connexion.
    URL de vérification de connexion personnalisée Le point d’entrée par défaut permettant de vérifier que la connexion a été créée est le suivant : https://api.figma.com/v1/me Si cette URL n’est pas prise en charge pour la portée personnalisée, fournissez une URL de vérification personnalisée.
  3. Cliquez sur Continue pour enregistrer la connexion et revenir au module .

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 Mappage des informations d’un module à un autre.

Basculement de carte

Commentaires

Delete a comment

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

Connection
Pour plus d’informations sur la connexion de votre compte Figma à Workfront Fusion, voir Créer une connexion à Figma dans cet article.
File ID
Saisissez ou mappez l’ID du fichier auquel vous souhaitez ajouter ou supprimer un commentaire.
Comment ID
Saisissez le texte du commentaire que vous souhaitez supprimer.

List comments

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

Connection
Pour plus d’informations sur la connexion de votre compte Figma à Workfront Fusion, voir Créer une connexion à Figma dans cet article.
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 propriétaire du projet auquel le fichier est associé, puis sélectionnez le projet et sélectionnez le fichier.

Maximum number of returned comments
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.

Post a comment

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

Connection
Pour plus d’informations sur la connexion de votre compte Figma à Workfront Fusion, voir Créer une connexion à Figma dans cet article.
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 tentez de trouver l’ID du fichier sans connaître l’ID du projet, cliquez sur Find Projects et saisissez ou mappez l’ID de l’équipe propriétaire du projet auquel le fichier est associé. Sélectionnez le projet, puis le fichier.

Comment
Saisissez le texte du commentaire.

Projets et fichiers

Get a file or image

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

Connection
Pour plus d’informations sur la connexion de votre compte Figma à Workfront Fusion, voir Créer une connexion à Figma dans cet article.
Object type

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

  • File

    Le module renvoie le document appelé objet JSON par Key. La clé de fichier peut être analysée à partir de n’importe quelle URL de fichier Figma.

    Pour les champs, voir 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 récupérés à partir du fichier Figma auquel Key fait référence.

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

  • Image

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

    Pour les champs, voir 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, voir 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 à 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-in séparés par des virgules et/ou chaîne « 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 fichier
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 à 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 dont vous souhaitez effectuer le rendu, cliquez sur Add et saisissez le texte correspondant.

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. 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>. 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. Par défaut : false.
Version
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.

List file version history

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

Connection
Pour plus d’informations sur la connexion de votre compte Figma à Workfront Fusion, voir Créer une connexion à Figma dans cet article.
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 tentez de trouver l’ID du fichier sans connaître l’ID du projet, cliquez sur Find Projects et saisissez ou mappez l’ID de l’équipe propriétaire du projet auquel le fichier est associé. Sélectionnez le projet, puis le fichier.

Maximum number of returned files
Saisissez ou mappez le nombre maximum d’enregistrements que le module doit renvoyer pour chaque cycle d’exécution du scénario.

List project files

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

Connection
Pour plus d’informations sur la connexion de votre compte Figma à Workfront Fusion, voir Créer une connexion à Figma dans cet article.
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.
Maximum number of returned files
Saisissez ou mappez le nombre maximum d’enregistrements que le module doit renvoyer pour chaque cycle d’exécution du scénario.

List projects

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

Connection
Pour plus d’informations sur la connexion de votre compte Figma à Workfront Fusion, voir Créer une connexion à Figma dans cet article.
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.
Maximum number of returned projects
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

Get a style or component

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 plus d’informations sur la connexion de votre compte Figma à Workfront Fusion, voir Créer une connexion à Figma dans cet article.
Type> objet
Sélectionnez le type d'objet à récupérer.
<Object> key
Saisissez la clé (identifiant unique) de l’objet que vous souhaitez récupérer.
Team ID
Si vous récupérez un composant d'équipe ou un jeu de composants d'équipe, saisissez ou mappez l'identifiant de l'équipe à laquelle le ou les enregistrements sont associés.
Page Size
Si vous récupérez un composant d’équipe ou un ensemble de composants d’équipe, saisissez ou mappez le nombre ou les résultats à renvoyer par page. Valeur par défaut : 30.
After

Si vous récupérez un composant d'équipe ou un ensemble de composants d'équipe, saisissez ou mappez le numéro du résultat après lequel commencer à récupérer les résultats. Elle peut être combinée 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é conjointement avec le champ Before.

Before

Si vous récupérez un composant d'équipe ou un ensemble de composants d'équipe, saisissez ou mappez le numéro du résultat avant lequel commencer à récupérer les résultats. Elle peut être combinée 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é conjointement avec le champ After.

Autre

Make an API call

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 plus d’informations sur la connexion de votre compte Figma à Workfront Fusion, voir Créer une connexion à Figma dans cet article.
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.
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, placez les guillemets à l’extérieur de l’instruction conditionnelle.

Watch events

Ce module de déclenchement démarre 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 en regard du champ Webhook .

  2. Saisissez un nom pour le webhook.

  3. Sélectionnez la connexion que vous souhaitez utiliser pour ce webhook. Pour savoir comment connecter votre compte Figma à Workfront Fusion, consultez la section Se connecter à Adobe Workfront Fusion - Instructions de base.

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

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

  6. Choisissez si vous souhaitez que le Webhook soit actif ou en pause.

  7. Saisissez une description pour le webhook.

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

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3