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 Creare uno scenario.

Per informazioni sui moduli, vedere Moduli in Adobe Workfront Fusion.

Requisiti di accesso

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

Adobe Workfront piano*
Pro o versione successiva
Adobe Workfront licenza*
Plan, Work
Adobe Workfront Fusion licenza**

Requisiti di licenza correnti: nessun requisito di licenza Workfront Fusion.

Oppure

Requisito licenza legacy: Workfront Fusion per automazione e integrazione del lavoro

Prodotto

Fabbisogno prodotto corrente: se disponi del piano Select o Prime Adobe Workfront, la tua organizzazione deve acquistare Adobe Workfront Fusion e Adobe Workfront per utilizzare le funzionalità descritte in questo articolo. Workfront Fusion è incluso nel piano Ultimate Workfront.

Oppure

Requisiti del prodotto legacy: la tua organizzazione deve acquistare Adobe Workfront Fusion e Adobe Workfront per utilizzare le funzionalità descritte in questo articolo.

Per conoscere il piano, il tipo di licenza o l'accesso disponibili, contattare l'amministratore Workfront.

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

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 all'altro in Adobe Workfront Fusion.

Commenti

Elimina commento

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 Adobe Workfront Fusion - Istruzioni di base.
ID file
Immettere o mappare l'ID file del file da cui si desidera aggiungere un commento.
Comment
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.

Connection
Per istruzioni sulla connessione dell'account Figma a Workfront Fusion, vedere Creare una connessione a Adobe Workfront Fusion - Istruzioni di base.
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.

Limit
Immettere o mappare il numero massimo di commenti che il modulo deve restituire durante ogni ciclo di esecuzione dello scenario.

Pubblica un commento

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 Adobe Workfront Fusion - Istruzioni di base.
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

Connection
Per istruzioni sulla connessione dell'account Figma a Workfront Fusion, vedere Creare una connessione a Adobe Workfront Fusion - Istruzioni di base.
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.
Ottieni un file o un'immagine: nodi 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 - Includi ID
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.
ID 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.

Connection
Per istruzioni sulla connessione dell'account Figma a Workfront Fusion, vedere Creare una connessione a Adobe Workfront Fusion - Istruzioni di base.
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.

Limit
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.

Connection
Per istruzioni sulla connessione dell'account Figma a Workfront Fusion, vedere Creare una connessione a Adobe Workfront Fusion - Istruzioni di base.
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.
Limit
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.

Connection
Per istruzioni sulla connessione dell'account Figma a Workfront Fusion, vedere Creare una connessione a Adobe Workfront Fusion - Istruzioni di base.
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
Limit
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.

Connection
Per istruzioni sulla connessione dell'account Figma a Workfront Fusion, vedere Creare una connessione a Adobe Workfront Fusion - Istruzioni di base.
<Object> chiave
Immettere la chiave (identificatore univoco) dell'oggetto da recuperare.
ID team
Immettere o mappare l'ID del team a cui sono associati il record o i record.
Dimensioni Pagina
Immettere o mappare il numero o i risultati da restituire per pagina. Predefinito: 30.
After

Immetti o mappa 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

Immettere o mappare il numero del risultato prima del quale iniziare il recupero dei 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.

Connection
Per istruzioni sulla connessione dell'account Figma a Workfront Fusion, vedere Creare una connessione a Adobe Workfront Fusion - Istruzioni di base.
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 in Adobe Workfront Fusion.
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.

Stringa Di Query

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.

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

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

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

  5. Immetti lo Status o Description degli eventi che desideri che il webhook controlli.

  6. Fai clic su Salva per salvare il webhook e tornare al modulo.

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