Figma Module

Mit den Adobe Workfront Fusion Figma können Sie Listen von Kommentaren, Dateien, Dateiversionen oder Projekten abrufen. Sie können auch einen Kommentar posten oder einen Aufruf an die Figma-API durchführen.

Anweisungen zum Erstellen eines Szenarios finden Sie in den Artikeln unter Szenario erstellen: Artikelindex.

Informationen zu Modulen finden Sie in den Artikeln unter Module: Artikelindex.

Zugriffsanforderungen

Erweitern Sie , um die Zugriffsanforderungen für die -Funktion in diesem Artikel anzuzeigen.

Sie müssen über folgenden Zugriff verfügen, um die Funktion in diesem Artikel verwenden zu können:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront-Paket Beliebig
Adobe Workfront-Lizenz

Neu: Standard

Oder

Aktuell: Arbeit oder höher

Lizenz für Adobe Workfront Fusion**

Aktuell: Keine Workfront Fusion-Lizenzanforderung.

Oder

Legacy: Workfront Fusion für Arbeitsautomatisierung und -integration

Produkt

Neu:

  • Prime oder Workfront auswählen: Ihr Unternehmen muss Adobe Workfront Fusion erwerben.
  • Ultimate Workfront-Paket: Workfront Fusion ist enthalten.

Oder

Aktuell: Ihr Unternehmen muss Adobe Workfront Fusion erwerben.

Weitere Informationen zu den Informationen in dieser Tabelle finden Sie unter Zugriffsanforderungen in der Dokumentation.

Informationen zu Adobe Workfront Fusion finden Sie unter Adobe Workfront Fusion Lizenzen.

Voraussetzungen

Um Figma-Module verwenden zu können, müssen Sie über ein Figma-Konto verfügen.

Figma API-Informationen

Der Figma-Connector verwendet Folgendes:

Basis-URL
https://api.figma.com/v1
API-Version
v1
API-Tag
v1.8.25

Erstellen einer Verbindung zu Figma

So erstellen Sie eine Verbindung für Ihre Figma-Module:

  1. Klicken Sie in einem beliebigen Figma-Modul Add neben dem Feld Verbindung .

  2. Füllen Sie die folgenden Felder aus:

    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

    Wählen Sie für neue Verbindungen Figma ohne das Legacy-Tag aus.

    Die Figma änderte im Januar 2025 ihre Authentifizierungspflichten. Der Figma Verbindungstyp erfüllt die neuen Anforderungen. Der Figma (Legacy) Verbindungstyp wird in Zukunft entfernt.

    Connection name Geben Sie einen Namen für diese Verbindung ein.
    Client ID Geben Sie Ihre Figme Client ID ein.
    Client Secret Geben Sie Ihre Figma-Client Secret ein.
    Benutzerdefinierte Bereiche Geben Sie alle benutzerdefinierten Bereiche ein, die für diese Verbindung erforderlich sind.
    URL für die Überprüfung benutzerdefinierter Verbindungen Der Standardendpunkt zum Überprüfen, ob die Verbindung erfolgreich erstellt wurde, ist: https://api.figma.com/v1/me Wenn diese URL für den benutzerdefinierten Bereich nicht unterstützt wird, geben Sie eine benutzerdefinierte Überprüfungs-URL an.
  3. Klicken Sie auf Continue , um die Verbindung zu speichern und zum Modul zurückzukehren.

Figma Module und ihre Felder

Beim Konfigurieren Figma Module zeigt Workfront Fusion die unten aufgeführten Felder an. Darüber hinaus können abhängig von Faktoren wie Ihrer Zugriffsebene in der App oder dem Service weitere Figma angezeigt werden. Ein fett gedruckter Titel in einem Modul gibt ein erforderliches Feld an.

Wenn die Zuordnungsschaltfläche über einem Feld oder einer Funktion angezeigt wird, können Sie damit Variablen und Funktionen für dieses Feld festlegen. Weitere Informationen finden Sie unter Zuordnen von Informationen von einem Modul zu einem anderen.

Umschalter für Zuordnung

Kommentare

Delete a comment

Dieses Aktionsmodul löscht einen einzelnen Kommentar aus einer Datei.

Connection
Anweisungen zum Verbinden Ihres Figma-Kontos mit Workfront Fusion finden Sie unter Erstellen einer Verbindung zu Figma in diesem Artikel.
File ID
Geben Sie die Datei-ID der Datei ein, zu der Sie einen Kommentar hinzufügen möchten, oder mappen Sie sie.
Comment ID
Geben Sie den Text des Kommentars ein, den Sie löschen möchten.

List comments

Dieses Suchmodul listet alle Kommentare auf, die an eine einzelne Datei in Figma angehängt sind.

Connection
Anweisungen zum Verbinden Ihres Figma-Kontos mit Workfront Fusion finden Sie unter Erstellen einer Verbindung zu Figma in diesem Artikel.
File ID

Geben Sie die Datei-ID der Datei ein, für die Sie Kommentare abrufen möchten, oder mappen Sie sie.

  • Wenn Sie die ID nicht kennen, klicken Sie auf Find Files und geben Sie die ID des Projekts, mit dem die Datei verknüpft ist, ein oder ordnen Sie sie zu. Wählen Sie dann die Datei aus.

  • Wenn Sie die Projekt-ID nicht kennen, klicken Sie auf Find Projects und geben Sie die ID des Teams ein, dem das Projekt gehört, dem die Datei zugeordnet ist, oder ordnen Sie sie zu. Wählen Sie dann das Projekt aus und wählen Sie die Datei aus.

Maximum number of returned comments
Geben Sie die maximale Anzahl von Kommentaren ein, die das Modul während jedes Szenario-Ausführungszyklus zurückgeben soll, oder mappen Sie sie.

Post a comment

Dieses Aktionsmodul postet einen Kommentar in eine Figma-Datei.

Connection
Anweisungen zum Verbinden Ihres Figma-Kontos mit Workfront Fusion finden Sie unter Erstellen einer Verbindung zu Figma in diesem Artikel.
File ID

Geben Sie die Datei-ID der Datei ein, an die Sie einen Kommentar senden möchten, oder mappen Sie sie.

  • Wenn Sie die Datei-ID nicht kennen, klicken Sie auf Find Files und geben Sie die ID des Projekts, mit dem die Datei verknüpft ist, ein oder ordnen Sie sie zu. Wählen Sie dann die Datei aus.

  • Wenn Sie versuchen, die Datei-ID zu finden und die Projekt-ID nicht kennen, klicken Sie auf Find Projects und geben Sie die ID des Teams ein, dem das Projekt gehört, dem die Datei zugeordnet ist, oder mappen Sie sie. Wählen Sie das Projekt und dann die Datei aus.

Comment
Geben Sie den Text des Kommentars ein.

Projekte und Dateien

Get a file or image

Dieses Aktionsmodul ruft eine einzelne Datei oder ein einzelnes Bild aus einer Figmabibliothek ab

Connection
Anweisungen zum Verbinden Ihres Figma-Kontos mit Workfront Fusion finden Sie unter Erstellen einer Verbindung zu Figma in diesem Artikel.
Object type

Wählen Sie den Typ des Objekts aus, das Sie abrufen möchten.

  • File

    Das -Modul gibt das Dokument zurück, auf das von Key als JSON-Objekt verwiesen wird. Der Dateischlüssel kann aus einer beliebigen Figmadatei-URL geparst werden.

    Felder finden Sie unter Get a file or image: File.

  • File nodes

    Gibt die Knoten zurück, auf die von IDs als JSON-Objekt verwiesen wird. Die Knoten werden aus der Figma abgerufen, auf die von Key verwiesen wird.

    Felder finden Sie unter Get a file or image: File nodes.

  • Image

    Das Modul rendert Bilder aus einer -Datei.

    Felder finden Sie unter Get a file or image: Image.

  • Image fills

    Das Modul gibt Download-Links für alle Bilder zurück, die in Bildausfüllungen in einem Dokument vorhanden sind. Bildfüllungen sind die Darstellungen Figma vom Benutzer bereitgestellten Bilder. Wenn Sie ein Bild in Figma ziehen, erstellt Figma ein Rechteck mit einer einzigen Füllung, die das Bild darstellt, und die Benutzenden können das Rechteck (und die Eigenschaften der Füllung) transformieren.

    Felder finden Sie unter Get a file or image: Image fills.

Datei oder Bild abrufen: Datei
File key
Wählen Sie die Datei aus, aus der Sie JSON zurückgeben möchten.
Version ID
Geben Sie die Version der Datei ein, die das Modul zurückgeben soll, oder ordnen Sie sie zu. Lassen Sie dieses Feld für das aktuelle Modul leer.
Node IDs

Um nur eine Teilmenge des Dokuments zurückzugeben, geben Sie die Knoten ein, die das Modul zurückgeben soll. Das -Modul gibt die aufgelisteten Knoten, ihre untergeordneten Elemente und alles zurück, was sich zwischen dem Stammknoten und den aufgelisteten Knoten befindet.

Klicken Sie für jeden Knoten, den Sie zurückgeben möchten, auf Add und geben Sie den Text des Knotens ein.

Depth

Geben Sie eine Ganzzahl ein, die darstellt, wie tief in der Dokumentstruktur Sie Ergebnisse zurückgeben möchten, oder ordnen Sie sie zu.

Beispiel:

  • Um nur Seiten zurückzugeben, geben Sie 1 ein.

  • Um Seiten und Objekte der obersten Ebene zurückzugeben, geben Sie 2 ein.

Um alle Knoten zurückzugeben, lassen Sie dieses Feld leer.

Geometry
Um Vektordaten zurückzugeben, geben Sie paths ein.
Plugin data
Eine kommagetrennte Liste von Plug-in-IDs und/oder die Zeichenfolge "shared". Alle Daten, die im Dokument vorhanden sind, das von diesen Plug-ins geschrieben wurde, werden in das Ergebnis in den pluginData- und sharedPluginData-Eigenschaften aufgenommen.
Branch data
Aktivieren Sie diese Option, um Metadaten der Verzweigung für die angeforderte Datei zurückzugeben. Wenn es sich bei der Datei um eine Verzweigung handelt, wird der Schlüssel der Hauptdatei in die zurückgegebene Antwort aufgenommen. Wenn die Datei Verzweigungen hat, werden deren Metadaten in die zurückgegebene Antwort aufgenommen. Standard: false.
Datei oder Bild abrufen: Dateiknoten
File key
Wählen Sie die Datei aus, aus der Sie JSON zurückgeben möchten.
Node IDs

Geben Sie die Knoten ein, die das Modul zurückgeben und konvertieren soll

Klicken Sie für jeden Knoten, den Sie zurückgeben möchten, auf Add und geben Sie den Text des Knotens ein.

Version ID
Geben Sie die Version der Datei ein, die das Modul zurückgeben soll, oder ordnen Sie sie zu. Lassen Sie dieses Feld für das aktuelle Modul leer.
Depth

Geben Sie eine Ganzzahl ein, die darstellt, wie tief in der Dokumentstruktur Sie Ergebnisse zurückgeben möchten, oder ordnen Sie sie zu.

Beispiel:

  • Um nur Seiten zurückzugeben, geben Sie 1 ein.

  • Um Seiten und Objekte der obersten Ebene zurückzugeben, geben Sie 2 ein.

Um alle Knoten zurückzugeben, lassen Sie dieses Feld leer.

Geometry
Um Vektordaten zurückzugeben, geben Sie paths ein.
Plugin data
Eine kommagetrennte Liste von Plug-in-IDs und/oder die Zeichenfolge „shared“. Alle Daten, die im Dokument vorhanden sind, das von diesen Plug-ins geschrieben wurde, werden in das Ergebnis in den Eigenschaften pluginData und sharedPluginData aufgenommen.
Datei oder Bild abrufen: Bild
File key
Wählen Sie die Datei aus, aus der Sie JSON zurückgeben möchten.
Node IDs

Geben Sie die Knoten ein, die das Modul rendern soll.

Klicken Sie für jeden Knoten, den Sie rendern möchten, auf Add und geben Sie den Text des Knotens ein.

Scale
Um das Bild zu skalieren, geben Sie den Skalierungsfaktor ein oder mappen Sie ihn. Diese Zahl muss zwischen 0,01 und 4 liegen.
Format

Wählen Sie das Format für die Bildausgabe aus.

  • JPG

  • PNG

  • SVG

  • PDF

SVG - Include ID
Aktivieren Sie diese Option, um ID-Attribute für alle SVG-Elemente einzuschließen. Standard: false.
SVG - Simplify Stroke
Aktivieren Sie diese Option, um innere/äußere Konturen zu vereinfachen und wenn möglich das Konturattribut anstelle von <Maske> zu verwenden. Standard: true.
Use absolute bounds
Aktivieren Sie diese Option, um die vollständigen Abmessungen des Knotens zu verwenden, unabhängig davon, ob er abgeschnitten wird oder ob der Raum um ihn herum leer ist. Hiermit können Sie Textknoten ohne Zuschnitt exportieren. Standard: false.
Version
Geben Sie die Version der Datei ein, die das Modul zurückgeben soll, oder ordnen Sie sie zu. Lassen Sie dieses Feld für das aktuelle Modul leer.
Datei oder Bild abrufen: Bilddateien
File key
Wählen Sie die Datei aus, aus der Sie JSON zurückgeben möchten.

List file version history

Dieses Suchmodul gibt den Versionsverlauf einer einzelnen Datei in Figma zurück.

Connection
Anweisungen zum Verbinden Ihres Figma-Kontos mit Workfront Fusion finden Sie unter Erstellen einer Verbindung zu Figma in diesem Artikel.
File ID

Geben Sie die Datei-ID der Datei ein, für die Sie den Versionsverlauf abrufen möchten, oder ordnen Sie sie zu.

  • Wenn Sie die Datei-ID nicht kennen, klicken Sie auf Find Files und geben Sie die ID des Projekts, mit dem die Datei verknüpft ist, ein oder ordnen Sie sie zu. Wählen Sie dann die Datei aus.

  • Wenn Sie versuchen, die Datei-ID zu finden und die Projekt-ID nicht kennen, klicken Sie auf Find Projects und geben Sie die ID des Teams ein, dem das Projekt gehört, dem die Datei zugeordnet ist, oder mappen Sie sie. Wählen Sie das Projekt und dann die Datei aus.

Maximum number of returned files
Geben Sie die maximale Anzahl von Datensätzen ein, die das Modul während jedes Szenario-Ausführungszyklus zurückgeben soll, oder mappen Sie sie.

List project files

Dieses Suchmodul gibt eine Liste aller Dateien im angegebenen Projekt zurück.

Connection
Anweisungen zum Verbinden Ihres Figma-Kontos mit Workfront Fusion finden Sie unter Erstellen einer Verbindung zu Figma in diesem Artikel.
File ID

Geben Sie die Projekt-ID für das Projekt ein, für das Sie Dateien abrufen möchten, oder ordnen Sie sie zu.

  • Wenn Sie die Projekt-ID nicht kennen, klicken Sie auf Find Projects und geben Sie die ID des Teams ein, dem das Projekt zugeordnet ist, oder ordnen Sie sie zu. Wählen Sie dann das Projekt aus.
Maximum number of returned files
Geben Sie die maximale Anzahl von Datensätzen ein, die das Modul während jedes Szenario-Ausführungszyklus zurückgeben soll, oder mappen Sie sie.

List projects

Dieses Suchmodul gibt eine Liste aller Projekte innerhalb des angegebenen Teams zurück.

Connection
Anweisungen zum Verbinden Ihres Figma-Kontos mit Workfront Fusion finden Sie unter Erstellen einer Verbindung zu Figma in diesem Artikel.
Team ID
Geben Sie die Projekt-ID des Projekts ein, für das Sie Dateien abrufen möchten, oder ordnen Sie sie zu. Die Team-ID finden Sie in der URL der Team-Seite in Figma
Maximum number of returned projects
Geben Sie die maximale Anzahl von Datensätzen ein, die das Modul während jedes Szenario-Ausführungszyklus zurückgeben soll, oder mappen Sie sie.

Komponenten und Stile

Get a style or component

Dieses Aktionsmodul ruft einen einzelnen Stil, eine einzelne Komponente oder einen Satz von Stilen oder Komponenten ab.

Connection
Anweisungen zum Verbinden Ihres Figma-Kontos mit Workfront Fusion finden Sie unter Erstellen einer Verbindung zu Figma in diesem Artikel.
Objekt> Typ
Wählen Sie den Typ des Objekts aus, das Sie abrufen möchten.
<Object> key
Geben Sie den Schlüssel (eindeutige Kennung) des Objekts ein, das Sie abrufen möchten.
Team ID
Beim Abrufen einer Team-Komponente oder eines Team-Komponentensatzes geben Sie die ID des Teams ein, mit dem der Datensatz oder die Datensätze verknüpft sind, oder ordnen Sie sie zu.
Page Size
Beim Abrufen einer Team-Komponente oder eines Team-Komponentensatzes geben Sie die Zahl oder die Ergebnisse ein, die pro Seite zurückgegeben werden sollen, oder ordnen Sie sie zu. Standardwert: 30.
After

Beim Abrufen einer Team-Komponente oder eines Team-Komponentensatzes geben Sie die Nummer des Ergebnisses ein, nach der das Abrufen der Ergebnisse beginnen soll, oder mappen Sie diese. Dies kann mit dem Feld Page Size kombiniert werden, um Ergebnisse zu paginieren.

Dieser Wert entspricht nicht den Objekt-IDs.

Dieses Feld kann nicht in Kombination mit dem Before Feld verwendet werden.

Before

Beim Abrufen einer Team-Komponente oder eines Team-Komponentensatzes geben Sie die Nummer des Ergebnisses ein, vor der das Abrufen der Ergebnisse beginnen soll, oder mappen Sie sie. Dies kann mit dem Feld Page Size kombiniert werden, um Ergebnisse zu paginieren.

Dieser Wert entspricht nicht den Objekt-IDs.

Dieses Feld kann nicht in Kombination mit dem After Feld verwendet werden.

Sonstige

Make an API call

Mit diesem Aktionsmodul können Sie die Figma-API benutzerdefiniert authentifiziert aufrufen, ohne die Authentifizierung durchdenken zu müssen. Auf diese Weise können Sie eine Datenflussautomatisierung erstellen, die von den anderen Figma-Modulen nicht durchgeführt werden kann.

Connection
Anweisungen zum Verbinden Ihres Figma-Kontos mit Workfront Fusion finden Sie unter Erstellen einer Verbindung zu Figma in diesem Artikel.
URL

Geben Sie einen Pfad relativ zu https://api.figma.com/v1/ ein.

Beispiel: files/7179110/comments

Method
Wählen Sie die HTTP-Anfragemethode aus, die Sie zum Konfigurieren des API-Aufrufs benötigen. Weitere Informationen finden Sie unter HTTP-Anfragemethoden.
Headers

Fügen Sie die Header der Anfrage in Form eines standardmäßigen JSON-Objekts hinzu.

Beispiel: {"Content-type":"application/json"}

Workfront Fusion Fügt die Autorisierungskopfzeilen für Sie hinzu.

Query String

Fügen Sie die Abfrage für den API-Aufruf in Form eines standardmäßigen JSON-Objekts hinzu.

Beispiel: {"name":"something-urgent"}

Body

Fügen Sie den Hauptteil des Inhalts für den API-Aufruf in Form eines standardmäßigen JSON-Objekts hinzu.

Hinweis:

Wenn Sie bedingte Anweisungen wie if in Ihrer JSON-Datei verwenden, setzen Sie die Anführungszeichen außerhalb der bedingten Anweisung.

Watch events

Dieses Teammodul startet ein Szenario, wenn eines der folgenden Trigger für ein bestimmtes Team in Ihrem Figma Teambereich eintritt:

  • Dateiaktualisierung

  • Dateiversionsaktualisierung

  • Datei löschen

  • Bibliothek veröffentlichen

  • Dateikommentar

Webhook

Wählen Sie den Webhook aus, den das Modul überwacht.

So fügen Sie einen neuen Webhook hinzu:

  1. Klicken Sie Add neben dem Feld Webhook .

  2. Geben Sie einen Namen für den Webhook ein.

  3. Wählen Sie die Verbindung aus, die Sie für diesen Webhook verwenden möchten. Anweisungen zum Verbinden Ihres Figma-Kontos mit Workfront Fusion finden Sie unter Erstellen einer Verbindung zu Adobe Workfront Fusion - Grundlegende Anweisungen.

  4. Wählen Sie den Ereignistyp aus, den das Modul überwachen soll.

  5. Geben Sie die ID des Teams ein, dessen Ereignisse der Webhook überwachen soll.

  6. Wählen Sie aus, ob der Webhook aktiv oder angehalten sein soll.

  7. Geben Sie eine Beschreibung für den Webhook ein.

  8. Klicken Sie auf Save , um den Webhook zu speichern und zum Modul zurückzukehren.

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