DokumentationWorkfrontAdobe Workfront Fusion

Figma Module

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

Mit den Adobe Workfront Fusion Figma-Modulen können Sie Listen mit 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, um die Zugriffsanforderungen für die in diesem Artikel beschriebene Funktionalität anzuzeigen.
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront-Paket

Jedes Paket für Adobe Workfront Workflow und Workfront Automation and Integration

Workfront Ultimate

Workfront Prime- und Select-Pakete bei zusätzlichem Kauf von Workfront Fusion.
Adobe Workfront-Lizenzen

Standard

Work oder höher
Adobe Workfront Fusion-Lizenz

Betriebsbasiert: keine Workfront Fusion-Lizenz erforderlich

Connector-basiert (alt): Workfront Fusion for Work Automation and Integration
Produkt Wenn Ihre Organisation über ein Workfront Select- oder Prime-Paket ohne Workfront Automation and Integration verfügt, muss Adobe Workfront Fusion erworben werden.

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

Informationen zu Adobe Workfront Fusion-Lizenzen 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

IMPORTANT
  • Die Figma änderte im Januar 2025 ihre Authentifizierungspflichten. Der Figma Verbindungstyp erfüllt die neuen Anforderungen. Der Figma (Legacy) Verbindungstyp ist veraltet und wird in naher Zukunft entfernt.
  • Wenn Sie eine Umleitungs-URL verwenden, verwenden Sie https://oauth.app.workfrontfusion.com/oauth/cb/figma3.

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

  1. Klicken Sie in einem beliebigen Figma-Modul Hinzufügen 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 Figma ohne das ältere Tag aus.

    Die Figma änderte im Januar 2025 ihre Authentifizierungspflichten. Der Figma Verbindungstyp erfüllt die neuen Anforderungen. Der Figma (Legacy) Verbindungstyp ist veraltet und wird in Zukunft entfernt.
    Connection name Geben Sie einen Namen für diese Verbindung ein.
    Client ID Geben Sie Ihre Figma Client ID ein.
    Client Secret Geben Sie Ihr 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 von Figma-Modulen zeigt Workfront Fusion die unten aufgeführten Felder an. Darüber hinaus können abhängig von Faktoren wie Ihrer Zugriffsebene in der Anwendung oder im Dienst weitere Figma-Felder angezeigt werden. Eine fett formatierte Überschrift in einem Modul kennzeichnet ein Pflichtfeld.

Wenn die Schaltfläche für Zuordnung ü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 zwischen Modulen.

Umschalter für Zuordnung

Kommentare

Löschen eines Kommentars

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

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

Auflisten von Kommentaren

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

Verbindung
Anweisungen zum Verbinden Ihres Figma-Kontos mit Workfront Fusion finden Sie Erstellen einer Verbindung zu Figma in diesem Artikel.
Datei-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 Dateien suchen und geben Sie die ID des Projekts, mit dem die Datei verknüpft ist, ein oder mappen Sie sie. Wählen Sie dann die Datei aus.

  • Wenn Sie die Projekt-ID nicht kennen, klicken Sie auf Projekte suchen 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 dann das Projekt aus und wählen Sie die Datei aus.

Maximale Anzahl der zurückgegebenen Kommentare
Geben Sie die maximale Anzahl von Kommentaren ein, die das Modul während jedes Ausführungszyklus eines Szenarios zurückgeben soll, oder ordnen Sie eine Zahl zu.

Kommentar posten

Dieses Aktionsmodul postet einen Kommentar in eine Figma-Datei.

Verbindung
Anweisungen zum Verbinden Ihres Figma-Kontos mit Workfront Fusion finden Sie Erstellen einer Verbindung zu Figma in diesem Artikel.
Datei-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 Dateien suchen und geben Sie die ID des Projekts, mit dem die Datei verknüpft ist, ein oder mappen Sie sie. Wählen Sie dann die Datei aus.

  • Wenn Sie versuchen, die Datei-ID zu finden und die Projekt-ID nicht kennen, klicken Sie auf Projekte suchen 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 das Projekt und dann die Datei aus.

-Kommentar
Geben Sie den Text des Kommentars ein.

Projekte und Dateien

Datei oder Bild abrufen

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

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

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

  • -Datei

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

    Felder finden Sie unter Datei oder Bild abrufen: Datei.

  • -Dateiknoten

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

    Felder finden Sie unter Datei oder Bild abrufen: Dateiknoten.

  • image

    Das Modul rendert Bilder aus einer -Datei.

    Felder finden Sie unter Datei oder Bild abrufen: Bild.

  • Bildfüllungen

    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 Datei oder Bild abrufen: Bilddateien.

Datei oder Bild abrufen: Datei
-Dateischlüssel
Wählen Sie die Datei aus, aus der Sie JSON zurückgeben möchten.
Versions-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.
Knoten-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 Hinzufügen und geben Sie den Text des Knotens ein.

-Tiefe

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-Daten
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.
Verzweigungsdaten
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
-Dateischlüssel
Wählen Sie die Datei aus, aus der Sie JSON zurückgeben möchten.
Knoten-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 Hinzufügen und geben Sie den Text des Knotens ein.

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

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-Daten
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
-Dateischlüssel
Wählen Sie die Datei aus, aus der Sie JSON zurückgeben möchten.
Knoten-IDs

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

Klicken Sie für jeden Knoten, den Sie rendern möchten, auf Hinzufügen 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 - Strich vereinfachen
Aktivieren Sie diese Option, um innere/äußere Konturen zu vereinfachen und wenn möglich das Konturattribut anstelle von <Maske> zu verwenden. Standard: true.
Absolute Grenzen verwenden
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
-Dateischlüssel
Wählen Sie die Datei aus, aus der Sie JSON zurückgeben möchten.

Dateiversionsverlauf auflisten

Dieses Suchmodul gibt den Versionsverlauf einer einzelnen Datei in „Figma.

Verbindung
Anweisungen zum Verbinden Ihres Figma-Kontos mit Workfront Fusion finden Sie Erstellen einer Verbindung zu Figma in diesem Artikel.
Datei-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 Dateien suchen und geben Sie die ID des Projekts, mit dem die Datei verknüpft ist, ein oder mappen Sie sie. Wählen Sie dann die Datei aus.

  • Wenn Sie versuchen, die Datei-ID zu finden und die Projekt-ID nicht kennen, klicken Sie auf Projekte suchen 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 das Projekt und dann die Datei aus.

Maximale Anzahl der zurückgegebenen Dateien
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.

Projektdateien auflisten

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

Verbindung
Anweisungen zum Verbinden Ihres Figma-Kontos mit Workfront Fusion finden Sie Erstellen einer Verbindung zu Figma in diesem Artikel.
Datei-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 Projekte suchen und geben Sie die ID des Teams ein, dem das Projekt zugeordnet ist, oder mappen Sie sie, und wählen Sie dann das Projekt aus.
Maximale Anzahl der zurückgegebenen Dateien
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.

Projekte auflisten

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

Verbindung
Anweisungen zum Verbinden Ihres Figma-Kontos mit Workfront Fusion finden Sie 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
Maximale Anzahl der zurückgegebenen Projekte
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

Abrufen eines Stils oder einer Komponente

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

Verbindung
Anweisungen zum Verbinden Ihres Figma-Kontos mit Workfront Fusion finden Sie Erstellen einer Verbindung zu Figma in diesem Artikel.
Objekt> Typ
Wählen Sie den Typ des Objekts aus, das Sie abrufen möchten.
<Object>-Schlüssel
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.
Seitengröße
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“.
nach

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 Seitengröße kombiniert werden, um die Ergebnisse zu paginieren.

Dieser Wert entspricht nicht den Objekt-IDs.

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

davor

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 Seitengröße kombiniert werden, um die Ergebnisse zu paginieren.

Dieser Wert entspricht nicht den Objekt-IDs.

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

Sonstiges

Erstellen eines API-Aufrufs

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.

Verbindung
Anweisungen zum Verbinden Ihres Figma-Kontos mit Workfront Fusion finden Sie 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

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

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.

Abfragezeichenfolge

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

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

Text

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

Hinweis:

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

Ereignisse ansehen

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 auf Hinzufügen 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 mit Adobe Workfront Fusion - Grundanweisungen.

  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 Speichern, um den Webhook zu speichern und zum Modul zurückzukehren.

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