DocumentazioneWorkfrontAdobe Workfront Fusion

Figma moduli

Last update: Thu Nov 20 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Con i moduli di 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à descritta in questo articolo.
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Pacchetto Adobe Workfront

Qualsiasi pacchetto Workflow di Adobe Workfront, e qualsiasi pacchetto Automation and Integration di Adobe Workfront

Workfront Ultimate

Pacchetti Workfront Prime e Select con un ulteriore acquisto di Workfront Fusion.
Licenze di Adobe Workfront

Standard

Work o successiva
Licenza di Adobe Workfront Fusion

Basata sulle operazioni: nessun requisito di licenza di Workfront Fusion

Basata sul connettore (precedente): Workfront Fusion for Work Automation and Integration
Prodotto Se la tua organizzazione dispone di un pacchetto Workfront Select o Prime che non include Workfront Automation and Integration, dovrà acquistare Adobe Workfront Fusion.

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

Per informazioni sulle licenze di Adobe Workfront Fusion, consulta Licenze di Adobe Workfront Fusion.

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

IMPORTANT
  • 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) è stato dichiarato obsoleto e verrà rimosso nel prossimo futuro.
  • Se si utilizza un reindirizzamento, URL, utilizzare https://oauth.app.workfrontfusion.com/oauth/cb/figma3.

Per creare una connessione per i moduli Figma:

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

  2. Compila i campi obbligatori:

    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 (Tipo di connessione)

    Seleziona 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) è stato dichiarato obsoleto e verrà rimosso in futuro.
    Connection name (Nome della connessione) Specifica un nome per questa connessione.
    Client ID Immetti il Figma Client ID.
    Client Secret (Segreto client) Immetti il segreto client Figma .
    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. Fai clic su Continue per salvare la connessione e tornare al modulo.

Moduli Figma e relativi campi

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

Se visualizzi il pulsante Map (Mappa) sopra un campo o una funzione, puoi utilizzarlo per impostare variabili e funzioni per tale campo. Per ulteriori informazioni, consulta Mappare le informazioni da un modulo a un altro.

Pulsante di attivazione/disattivazione mappatura

Commenti

Elimina un commento

Questo modulo elimina un singolo commento da un file.

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

Elenca commenti

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

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

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

  • Se non si conosce l'ID, fare clic su Trova file 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 Trova progetti 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.

Numero massimo di commenti restituiti
Inserisci oppure mappa il numero massimo di commenti che il modulo potrà restituire durante ciascun ciclo di esecuzione dello scenario.

Pubblica un commento

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

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

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 Trova file e immettere o mappare l'ID del progetto a cui è associato il file, quindi selezionare il file.

  • Se si sta tentando di trovare l'ID del file e non si conosce l'ID del progetto, fare clic su Trova progetti e immettere o mappare l'ID del team proprietario del progetto a cui è associato il file. Seleziona il progetto, quindi il file.

Comment
Immettere il testo del commento.

Progetti e file

Ottieni un file o un'immagine

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

Connessione
Per istruzioni sulla connessione dell'account Figma a Workfront Fusion, vedere Creare una connessione a Figma in questo articolo.
Tipo di oggetto

Selezionare il tipo di oggetto da recuperare.

  • File

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

    Per i campi, vedere Ottenere un file o un'immagine: File.

  • Nodi file

    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 Ottenere un file o un'immagine: Nodi di file.

  • Image

    Il modulo esegue il rendering delle immagini da un file.

    Per i campi, vedere Ottenere un file o un'immagine: Image.

  • Riempimenti immagine

    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 Ottenere un file o un'immagine: riempimenti immagine.

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

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.
ID nodo

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.

ID versione
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.
ID nodo

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 - ID inclusione
Abilita questa opzione per includere gli attributi ID per tutti gli elementi SVG. Impostazione predefinita: false.
SVG - Tratto semplificato
Abilita questa opzione per semplificare i tratti interni ed esterni e se possibile utilizza l'attributo tratto anziché <mask>. Impostazione predefinita: true.
Usa limiti assoluti
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.
versione
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.

Elenca cronologia versioni file

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

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

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 Trova file e immettere o mappare l'ID del progetto a cui è associato il file, quindi selezionare il file.

  • Se si sta tentando di trovare l'ID del file e non si conosce l'ID del progetto, fare clic su Trova progetti e immettere o mappare l'ID del team proprietario del progetto a cui è associato il file. Seleziona il progetto, quindi il file.

Numero massimo di file restituiti
Immettere o mappare il numero massimo di record che il modulo deve restituire durante ogni ciclo di esecuzione dello scenario.

Elenca file di progetto

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

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

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

  • Se non conosci l'ID del progetto, fai clic su Trova progetti e immetti o mappa l'ID del team a cui è associato il progetto, quindi seleziona il progetto.
Numero massimo di file restituiti
Immettere o mappare il numero massimo di record che il modulo deve restituire durante ogni ciclo di esecuzione dello scenario.

Elencare progetti

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

Connessione
Per istruzioni sulla connessione dell'account Figma a Workfront Fusion, vedere Creare una connessione a Figma in questo articolo.
ID team
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
Numero massimo di progetti restituiti
Immettere o mappare il numero massimo di record che il modulo deve restituire durante ogni ciclo di esecuzione dello scenario.

Componenti e stili

Ottieni uno stile o un componente

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

Connessione
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> chiave
Immettere la chiave (identificatore univoco) dell'oggetto da recuperare.
ID team
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.
Dimensioni Pagina
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. Questo può essere combinato con il campo Dimensioni pagina 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. Questo può essere combinato con il campo Dimensioni pagina per impaginare i risultati.

Questo valore non corrisponde agli ID oggetto.

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

Altro

Effettuare una chiamata API

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.

Connessione
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

Metodo
Seleziona il metodo di richiesta HTTP necessario per configurare la chiamata API. Per ulteriori informazioni, consulta Metodi di richiesta HTTP.
Intestazioni

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

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

Workfront Fusion aggiunge automaticamente le intestazioni di autorizzazione.

Stringa Di Query

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

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

Corpo

Aggiungi il contenuto del corpo della chiamata API sotto forma di oggetto JSON standard.

Nota:

Quando utilizzi istruzioni condizionali come if in JSON, inserisci le virgolette al di fuori dell’istruzione condizionale.

Guarda gli eventi

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. Fai clic su Salva per salvare il webhook e tornare al modulo.

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