Figma moduli

Con i moduli Adobe Workfront Fusion Figma è possibile recuperare elenchi di commenti, file, versioni di file o progetti. È inoltre possibile pubblicare un commento o effettuare una chiamata all'API Figma.

Se hai bisogno di istruzioni per la creazione di uno scenario, consulta gli articoli in Creare uno scenario: indice articolo.

Per informazioni sui moduli, vedere gli articoli in Moduli: indice articolo.

Requisiti di accesso

Espandi per visualizzare i requisiti di accesso per la funzionalità in questo articolo.

Per utilizzare le funzionalità di questo articolo, è necessario disporre dei seguenti diritti di accesso:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Pacchetto Adobe Workfront Qualsiasi
Licenza Adobe Workfront

Nuovo: Standard

Oppure

Corrente: Lavoro o versione successiva

Licenza Adobe Workfront Fusion**

Corrente: nessun requisito di licenza Workfront Fusion.

Oppure

Legacy: Workfront Fusion per l'automazione e l'integrazione del lavoro

Prodotto

Nuovo:

  • Seleziona o crea un pacchetto Prime Workfront: la tua organizzazione deve acquistare Adobe Workfront Fusion.
  • Pacchetto Ultimate Workfront: è incluso Workfront Fusion.

Oppure

Corrente: la tua organizzazione deve acquistare Adobe Workfront Fusion.

Per ulteriori dettagli sulle informazioni contenute in questa tabella, vedere Requisiti di accesso nella documentazione.

Per informazioni sulle Adobe Workfront Fusion licenze, vedere Adobe Workfront Fusion licenze.

Prerequisiti

Per utilizzare i moduli Figma, è necessario disporre di un account Figma.

Informazioni API Figma

Il connettore Figma utilizza quanto segue:

URL di base
https://api.figma.com/v1
Versione API
v1
Tag API
v1.8.25

Creare una connessione a Figma

Per creare una connessione per i moduli Figma:

  1. In qualsiasi modulo Figma, fare clic su Add accanto alla casella Connessione.

  2. Compila i campi seguenti:

    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

    Per le nuove connessioni, selezionare Figma senza il tag Legacy.

    Figma ha modificato i requisiti di autenticazione nel gennaio 2025. Il tipo di connessione Figma soddisfa i nuovi requisiti. Il tipo di connessione Figma (Legacy) verrà rimosso in futuro.

    Connection name Immettere un nome per la connessione.
    Client ID Immetti Figme Client ID.
    Client Secret Immetti la tua Figma Client Secret.
    Ambiti personalizzati Immettere gli ambiti personalizzati necessari per la connessione.
    URL di verifica connessione personalizzato L'endpoint predefinito per verificare che la connessione sia stata creata correttamente è: https://api.figma.com/v1/me Se questo URL non è supportato per l'ambito personalizzato, fornire un URL di verifica personalizzato.
  3. Fare clic su Continue per salvare la connessione e tornare al modulo.

Figma moduli e relativi campi

Quando configuri Figma moduli, Workfront Fusion visualizza i campi elencati di seguito. Insieme a questi, potrebbero essere visualizzati ulteriori campi di Figma, a seconda di fattori quali il livello di accesso nell'app o nel servizio. Un titolo in grassetto in un modulo indica un campo obbligatorio.

Se viene visualizzato il pulsante Mappa sopra un campo o una funzione, è possibile utilizzarlo per impostare variabili e funzioni per tale campo. Per ulteriori informazioni, vedere Mappare le informazioni da un modulo a un altro.

Attiva/Disattiva mappa

Commenti

Delete a comment

Questo modulo elimina un singolo commento da un file.

Connection
Per istruzioni sulla connessione dell'account Figma a Workfront Fusion, vedere Creare una connessione a Figma in questo articolo.
File ID
Immettere o mappare l'ID file del file da cui si desidera aggiungere un commento.
Comment ID
Immettere il testo del commento che si desidera eliminare.

List comments

Questo modulo di ricerca elenca tutti i commenti allegati a un singolo file in Figma.

Connection
Per istruzioni sulla connessione dell'account Figma a Workfront Fusion, vedere Creare una connessione a Figma in questo articolo.
File ID

Immettere o mappare l'ID file per il quale si desidera recuperare i commenti.

  • Se non si conosce l'ID, fare clic su Find Files e immettere o mappare l'ID del progetto a cui è associato il file, quindi selezionare il file.

  • Se non si conosce l'ID del progetto, fare clic su Find Projects e immettere o mappare l'ID del team a cui appartiene il progetto a cui è associato il file, quindi selezionare il progetto e selezionare il file.

Maximum number of returned comments
Immettere o mappare il numero massimo di commenti che il modulo deve restituire durante ogni ciclo di esecuzione dello scenario.

Post a comment

Questo modulo di azione pubblica un commento su un file Figma.

Connection
Per istruzioni sulla connessione dell'account Figma a Workfront Fusion, vedere Creare una connessione a Figma in questo articolo.
File ID

Immettere o mappare l'ID file del file in cui si desidera inserire un commento.

  • Se non si conosce l'ID del file, fare clic su Find Files e immettere o mappare l'ID del progetto a cui è associato il file, quindi selezionare il file.

  • Se si tenta di trovare l'ID del file e non si conosce l'ID del progetto, fare clic su Find Projects e immettere o mappare l'ID del team a cui appartiene il progetto a cui è associato il file. Seleziona il progetto, quindi il file.

Comment
Immettere il testo del commento.

Progetti e file

Get a file or image

Questo modulo di azione recupera un singolo file o immagine da una libreria Figma

Connection
Per istruzioni sulla connessione dell'account Figma a Workfront Fusion, vedere Creare una connessione a Figma in questo articolo.
Object type

Selezionare il tipo di oggetto da recuperare.

  • File

    Il modulo restituisce il documento a cui Key fa riferimento come oggetto JSON. La chiave del file può essere analizzata da qualsiasi URL di file Figma.

    Per i campi, vedere Get a file or image: File.

  • File nodes

    Restituisce i nodi a cui fanno riferimento gli ID come oggetto JSON. I nodi vengono recuperati dal file Figma a cui fa riferimento Key.

    Per i campi, vedere Get a file or image: File nodes.

  • Image

    Il modulo esegue il rendering delle immagini da un file.

    Per i campi, vedere Get a file or image: Image.

  • Image fills

    Il modulo restituisce i collegamenti di download per tutte le immagini presenti nei riempimenti immagine di un documento. I riempimenti di immagini rappresentano il modo in cui Figma rappresenta qualsiasi immagine fornita dall'utente. Quando si trascina un'immagine in Figma, Figma crea un rettangolo con un singolo riempimento che rappresenta l'immagine e l'utente è in grado di trasformare il rettangolo (e le proprietà sul riempimento).

    Per i campi, vedere Get a file or image: Image fills.

Ottieni un file o un'immagine: File
File key
Seleziona il file da cui vuoi restituire il JSON.
Version ID
Immettere o mappare la versione del file che si desidera venga restituita dal modulo. Per il modulo corrente, lascia vuoto questo campo.
Node IDs

Per restituire solo un sottoinsieme del documento, immettere i nodi che si desidera restituire al modulo. Il modulo restituisce i nodi elencati, i relativi nodi secondari e qualsiasi cosa tra il nodo principale e i nodi elencati.

Per ogni nodo da restituire, fare clic su Add e immettere il testo del nodo.

Depth

Immettere o mappare un numero intero che rappresenta la profondità nella struttura del documento per la quale si desidera restituire i risultati.

Esempio:

  • Per restituire solo le pagine, immettere 1.

  • Per restituire pagine e oggetti di primo livello, immettere 2.

Per restituire tutti i nodi, lascia vuoto questo campo.

Geometry
Per restituire dati vettoriali, immettere paths.
Plugin data
Elenco separato da virgole di ID plug-in e/o stringa "shared". Tutti i dati presenti nel documento scritto da tali plug-in verranno inclusi nel risultato nelle proprietà pluginData e sharedPluginData.
Branch data
Abilita questa opzione per restituire i metadati del ramo per il file richiesto. Se il file è un ramo, la chiave del file principale viene inclusa nella risposta restituita. Se il file presenta rami, i relativi metadati vengono inclusi nella risposta restituita. Impostazione predefinita: false.
Ottenere un file o un'immagine: Nodi di file
File key
Seleziona il file da cui vuoi restituire il JSON.
Node IDs

Immettere i nodi che si desidera vengano restituiti e convertiti dal modulo

Per ogni nodo da restituire, fare clic su Add e immettere il testo del nodo.

Version ID
Immettere o mappare la versione del file che si desidera venga restituita dal modulo. Per il modulo corrente, lascia vuoto questo campo.
Depth

Immettere o mappare un numero intero che rappresenta la profondità nella struttura del documento per la quale si desidera restituire i risultati.

Esempio:

  • Per restituire solo le pagine, immettere 1.

  • Per restituire pagine e oggetti di primo livello, immettere 2.

Per restituire tutti i nodi, lascia vuoto questo campo.

Geometry
Per restituire dati vettoriali, immettere paths.
Plugin data
Elenco separato da virgole di ID plug-in e/o stringa "shared" (condiviso). Tutti i dati presenti nel documento scritto da tali plug-in verranno inclusi nel risultato nelle proprietà pluginData e sharedPluginData.
Ottieni un file o un’immagine: immagine
File key
Seleziona il file da cui vuoi restituire il JSON.
Node IDs

Immetti i nodi di cui vuoi eseguire il rendering nel modulo.

Per ogni nodo di cui si desidera eseguire il rendering, fare clic su Add e immettere il testo del nodo.

Scale
Per ridimensionare l'immagine, immettete o mappate il fattore di scala. Questo numero deve essere compreso tra 0,01 e 4.
Format

Selezionate il formato per l'output dell'immagine.

  • JPG-

  • PNG

  • SVG

  • PDF

SVG - Include ID
Abilita questa opzione per includere gli attributi ID per tutti gli elementi SVG. Impostazione predefinita: false.
SVG - Simplify Stroke
Abilita questa opzione per semplificare i tratti interni ed esterni e se possibile utilizza l'attributo tratto anziché <mask>. Impostazione predefinita: true.
Use absolute bounds
Abilita questa opzione per utilizzare le dimensioni complete del nodo indipendentemente dal fatto che sia ritagliato o meno o che lo spazio intorno a esso sia vuoto. Utilizzare questa opzione per esportare nodi di testo senza ritaglio. Impostazione predefinita: false.
Version
Immettere o mappare la versione del file che si desidera venga restituita dal modulo. Per il modulo corrente, lascia vuoto questo campo.
Ottenere un file o un’immagine: riempimenti immagine
File key
Seleziona il file da cui vuoi restituire il JSON.

List file version history

Questo modulo di ricerca restituisce la cronologia delle versioni di un singolo file in Figma.

Connection
Per istruzioni sulla connessione dell'account Figma a Workfront Fusion, vedere Creare una connessione a Figma in questo articolo.
File ID

Immetti o mappa l’ID file per il quale desideri recuperare la cronologia delle versioni.

  • Se non si conosce l'ID del file, fare clic su Find Files e immettere o mappare l'ID del progetto a cui è associato il file, quindi selezionare il file.

  • Se si tenta di trovare l'ID del file e non si conosce l'ID del progetto, fare clic su Find Projects e immettere o mappare l'ID del team a cui appartiene il progetto a cui è associato il file. Seleziona il progetto, quindi il file.

Maximum number of returned files
Immettere o mappare il numero massimo di record che il modulo deve restituire durante ogni ciclo di esecuzione dello scenario.

List project files

Questo modulo di ricerca restituisce un elenco di tutti i file nel progetto specificato.

Connection
Per istruzioni sulla connessione dell'account Figma a Workfront Fusion, vedere Creare una connessione a Figma in questo articolo.
File ID

Immetti o mappa l’ID del progetto per il quale desideri recuperare i file.

  • Se non conosci l'ID del progetto, fai clic su Find Projects e immetti o mappa l'ID del team a cui è associato il progetto, quindi seleziona il progetto.
Maximum number of returned files
Immettere o mappare il numero massimo di record che il modulo deve restituire durante ogni ciclo di esecuzione dello scenario.

List projects

Questo modulo di ricerca restituisce un elenco di tutti i progetti all’interno del team specificato.

Connection
Per istruzioni sulla connessione dell'account Figma a Workfront Fusion, vedere Creare una connessione a Figma in questo articolo.
Team ID
Immetti o mappa l’ID del progetto per il quale desideri recuperare i file. L’ID del team si trova nell’URL della pagina del team a Figma
Maximum number of returned projects
Immettere o mappare il numero massimo di record che il modulo deve restituire durante ogni ciclo di esecuzione dello scenario.

Componenti e stili

Get a style or component

Questo modulo di azione recupera un singolo stile o componente oppure un set di stili o componenti.

Connection
Per istruzioni sulla connessione dell'account Figma a Workfront Fusion, vedere Creare una connessione a Figma in questo articolo.
Oggetto> tipo
Selezionare il tipo di oggetto da recuperare.
<Object> key
Immettere la chiave (identificatore univoco) dell'oggetto da recuperare.
Team ID
Se si recupera un componente o un set di componenti del team, immettere o mappare l'ID del team a cui sono associati il record o i record.
Page Size
Se si recupera un componente o un set di componenti team, immettere o mappare il numero o i risultati da restituire per pagina. Predefinito: 30.
After

Se si recupera un componente o un set di componenti del team, immettere o mappare il numero del risultato dopo il quale iniziare a recuperare i risultati. Può essere combinato con il campo Page Size per impaginare i risultati.

Questo valore non corrisponde agli ID oggetto.

Questo campo non può essere utilizzato in combinazione con il campo Before.

Before

Se si recupera un componente o un set di componenti del team, immettere o mappare il numero del risultato prima del quale iniziare a recuperare i risultati. Può essere combinato con il campo Page Size per impaginare i risultati.

Questo valore non corrisponde agli ID oggetto.

Questo campo non può essere utilizzato in combinazione con il campo After.

Altro

Make an API call

Questo modulo di azione consente di effettuare una chiamata autenticata personalizzata all’API Figma senza dover ricorrere all’autenticazione. In questo modo, puoi creare un’automazione del flusso di dati che non può essere eseguita dagli altri moduli Figma.

Connection
Per istruzioni sulla connessione dell'account Figma a Workfront Fusion, vedere Creare una connessione a Figma in questo articolo.
URL

Immettere un percorso relativo a https://api.figma.com/v1/.

Ad esempio: files/7179110/comments

Method
Seleziona il metodo di richiesta HTTP necessario per configurare la chiamata API. Per ulteriori informazioni, vedere Metodi di richiesta HTTP.
Headers

Aggiungi le intestazioni della richiesta sotto forma di oggetto JSON standard.

Ad esempio: {"Content-type":"application/json"}

Workfront Fusion aggiunge le intestazioni di autorizzazione.

Query String

Aggiungi la query per la chiamata API sotto forma di oggetto JSON standard.

Ad esempio: {"name":"something-urgent"}

Body

Aggiungi il contenuto body per la chiamata API sotto forma di oggetto JSON standard.

Nota:

Quando si utilizzano istruzioni condizionali come if nel JSON, inserire le virgolette al di fuori dell'istruzione condizionale.

Watch events

Questo modulo trigger avvia uno scenario quando si verifica uno dei seguenti eventi per un team specifico nello spazio del team Figma:

  • Aggiornamento file

  • Aggiornamento versione file

  • Eliminazione file

  • Pubblicazione libreria

  • Commento file

Webhook

Seleziona il webhook controllato dal modulo.

Per aggiungere un nuovo webhook:

  1. Fare clic su Add accanto al campo Webhook.

  2. Immettere un nome per il webhook.

  3. Selezionare la connessione da utilizzare per questo webhook. Per istruzioni sulla connessione dell'account Figma a Workfront Fusion, vedere Creare una connessione a Adobe Workfront Fusion - Istruzioni di base.

  4. Seleziona il tipo di evento che desideri che il modulo controlli.

  5. Immetti l’ID del team di cui desideri che il webhook guardi gli eventi.

  6. Seleziona se desideri che il webhook sia attivo o in pausa.

  7. Immettere una descrizione per il webhook.

  8. Fare clic su Save per salvare il webhook e tornare al modulo.

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