Frame.io V4-Module
Mit den Frame.io-Modulen von Adobe Workfront Fusion können Sie Assets und Kommentare in Ihrem Frame.io-Konto überwachen, erstellen, aktualisieren, abrufen oder löschen.
Workfront bietet zwei Frame.io-Connectoren an, abhängig von der Frame.io-Version, zu der Sie eine Verbindung herstellen.
Anweisungen zur Legacy-Version des Frame.io-Connectors finden Sie unter Frame.io-Connector für Legacy-Versionen.
Eine Videoeinführung zum Frame.io-Connector finden Sie über folgenden Link:
Zugriffsanforderungen
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront-Paket |
Ein beliebiges Adobe Workfront Workflow- und Adobe Workfront Automation and Integration-Paket 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 (veraltet): 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 Ihre Organisation Adobe Workfront Fusion erwerben. |
Weitere Details zu den Informationen 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 Frame.io-Module verwenden zu können, müssen Sie über ein Frame.io-Konto verfügen.
Informationen zur Frame.io-API
Der Frame.io-Connector verwendet Folgendes:
Verbinden von Frame.io mit Adobe Workfront Fusion
Sie können automatisch oder manuell eine Verbindung mit Benutzeranmeldeinformationen oder eine Server-zu-Server-Verbindung erstellen.
Automatisches Erstellen einer Verbindung mit Benutzeranmeldeinformationen
Diese Methode stellt automatisch eine Verbindung her, wenn Sie bei Frame.io angemeldet sind, oder leitet Sie zur Anmeldeseite von Frame.io weiter, damit Sie sich anmelden können.
- Klicken Sie in einem beliebigen Frame.io-Modul neben dem Verbindungsfeld auf die Option Add.
- Geben Sie einen Namen für die Verbindung ein.
- Klicken Sie auf Fortfahren.
- Wenn Sie zur Anmeldung bei Ihrem Frame.io-Konto aufgefordert werden, führen Sie diese durch.
- Wenn Sie Mitglied mehrerer Frame.io-Organisationen sind, wählen Sie die Organisation aus, die Sie für diese Verbindung verwenden möchten.
Die Verbindung wird hergestellt.
Manuelles Erstellen einer Verbindung mit Benutzeranmeldeinformationen
Sie können eine Verbindung mit Benutzeranmeldeinformationen erstellen, indem Sie sich bei Frame.io anmelden oder eine Client-ID bzw. ein Client-Geheimnis angeben.
Um eine Server-zu-Server-Verbindung zu erstellen, müssen Sie zunächst eine Anwendung in der Adobe Developer Console konfigurieren.
Erstellen von Benutzeranmeldeinformationen in der Adobe Developer Console
Falls Sie noch keine Server-zu-Server-Anmeldeinformationen für ein Adobe Developer Console-Projekt haben, können Sie diese erstellen.
-
Öffnen Sie die Adobe Developer Console.
-
Wählen Sie ein vorhandenes Projekt in der Adobe Developer Console aus, das für diese Verbindung verwendet werden soll.
ODER
Erstellen Sie ein neues Projekt in der Adobe Developer Console. Anweisungen finden Sie auf der Seite zum Erstellen eines leeren Projekts.
-
Klicken Sie auf der Seite für den Projektüberblick oder der Seite für erste Schritte mit Ihrem neuen Projekt auf die Option Add API.
-
Suchen Sie auf der sich öffnenden Seite nach der Option Frame.io API und klicken Sie darauf.
-
Wählen Sie auf der Seite zum Auswählen des Authentifizierungstyps die Option User Authentication aus und klicken Sie auf Next.
-
Wählen Sie auf der Seite zum Hinzufügen von Benutzerauthentifizierung und Anmeldeinformationen die Option OAuth Web App aus und klicken Sie auf Next.
-
Geben Sie auf der Seite zum Konfigurieren von Anmeldeinformationen für OAuth-Web-Anwendungen Folgendes ein:
table 0-row-2 1-row-2 layout-auto html-authored no-header Standardumleitungs-URI https://oauth.app.workfrontfusion.com/oauth/cb/frame-io2Umleitungs-URI-Muster https://oauth\.app\.workfrontfusion\.com/oauth/cb/frame-io2 -
Klicken Sie auf Weiter.
-
Klicken Sie auf Save configured API.
-
Klicken Sie auf der Produktseite auf die Karte für die soeben erstellten Anmeldeinformationen.
Hier finden Sie Ihre Client-ID und Ihr Client-Geheimnis.
Konfigurieren einer Verbindung mit Benutzerauthentifizierung
-
Klicken Sie in einem beliebigen Frame.io-Modul neben dem Verbindungsfeld auf Add.
-
Klicken Sie im Feld zum Erstellen einer Verbindung auf Show advanced settings.
-
Füllen Sie die folgenden Felder aus:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Verbindungstyp Wählen Sie die Option IMS User authentication aus. Verbindungsname Geben Sie einen Namen für die Verbindung ein. Client-ID Geben Sie Ihre Adobe-Client-ID ein. Diese finden Sie im Abschnitt mit den Anmeldeinformationen-Details der Adobe Developer Console.
Anweisungen zum Erstellen von Anmeldeinformationen finden Sie in diesem Artikel unter Erstellen von Benutzeranmeldeinformationen in der Adobe Developer Console.
Client-Geheimnis Geben Sie Ihr Adobe-Client-Geheimnis ein. Diese finden Sie im Abschnitt mit den Anmeldeinformationen-Details der Adobe Developer Console.
Anweisungen zum Erstellen von Anmeldeinformationen finden Sie in diesem Artikel unter Erstellen von Benutzeranmeldeinformationen in der Adobe Developer Console.
-
Wenn Sie zur Anmeldung bei Ihrem Frame.io-Konto aufgefordert werden, führen Sie diese durch.
-
Wenn Sie Mitglied mehrerer Frame.io-Organisationen sind, wählen Sie die Organisation aus, die Sie für diese Verbindung verwenden möchten.
Die Verbindung wird hergestellt.
Erstellen einer Server-zu-Server-Verbindung
Um eine Server-zu-Server-Verbindung zu erstellen, müssen Sie zunächst eine Anwendung in der Adobe Developer Console konfigurieren.
Erstellen von Server-zu-Server-Anmeldeinformationen in der Adobe Developer Console
Falls Sie noch keine Server-zu-Server-Anmeldeinformationen für ein Adobe Developer Console-Projekt haben, können Sie diese erstellen.
-
Öffnen Sie die Adobe Developer Console.
-
Wählen Sie ein vorhandenes Projekt in der Adobe Developer Console aus, das für diese Verbindung verwendet werden soll.
ODER
Erstellen Sie ein neues Projekt in der Adobe Developer Console. Anweisungen finden Sie auf der Seite zum Erstellen eines leeren Projekts.
-
Klicken Sie auf der Seite für den Projektüberblick oder der Seite für erste Schritte mit Ihrem neuen Projekt auf die Option Add API.
-
Suchen Sie auf der sich öffnenden Seite nach der Option Frame.io API und klicken Sie darauf.
-
Wählen Sie auf der Seite zum Auswählen des Authentifizierungstyps die Option Server-to-Server Authentication aus und klicken Sie auf Next.
-
Geben Sie einen Namen für die Anmeldeinformationen ein. Auf diese Weise können Sie die Anmeldeinformationen später im Bereich für API-Anmeldeinformationen der Adobe Admin Console identifizieren.
-
Klicken Sie auf Weiter.
-
Wählen Sie auf der Seite zum Auswählen von Produktprofilen das Produktprofil aus, das das Frame.io-Konto enthält, mit dem Sie eine Verbindung herstellen möchten.
-
Klicken Sie auf Save configured API.
-
Klicken Sie auf der Produktseite auf die Karte für die soeben erstellten Anmeldeinformationen.
Hier finden Sie Ihre Client-ID und Ihr Client-Geheimnis.
Konfigurieren einer Server-zu-Server-Verbindung
-
Klicken Sie in einem beliebigen Frame.io-Modul neben dem Verbindungsfeld auf Add.
-
Füllen Sie die folgenden Felder aus:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Verbindungstyp Wählen Sie die Option IMS Server to Server aus. Verbindungsname Geben Sie einen Namen für die Verbindung ein. Client-ID Geben Sie Ihre Adobe-Client-ID ein. Diese finden Sie im Abschnitt mit den Anmeldeinformationen-Details der Adobe Developer Console.
Anweisungen zum Erstellen von Anmeldeinformationen finden Sie in diesem Artikel unter Erstellen von Server-zu-Server-Anmeldeinformationen in der Adobe Developer Console.
Client-Geheimnis Geben Sie Ihr Adobe-Client-Geheimnis ein. Diese finden Sie im Abschnitt mit den Anmeldeinformationen-Details der Adobe Developer Console.
Anweisungen zum Erstellen von Anmeldeinformationen finden Sie in diesem Artikel unter Erstellen von Server-zu-Server-Anmeldeinformationen in der Adobe Developer Console.
-
Klicken Sie auf Continue, um die Verbindung zu speichern und zum Modul zurückzukehren.
Frame.io-Module und ihre Felder
Beim Konfigurieren von Frame.io-Modulen werden in Workfront Fusion die unten aufgeführten Felder angezeigt. Darüber hinaus können abhängig von Faktoren wie Ihrer Zugriffsebene in der Anwendung oder im Service weitere Frame.io-Felder angezeigt werden. Ein fett formatierter Titel in einem Modul kennzeichnet ein Pflichtfeld.
Wenn die Schaltfläche „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.
Assets
Asset erstellen
Dieses Aktionsmodul erstellt ein neues Asset. Sie können eine lokale Datei hochladen oder die URL für eine Remote-Datei angeben, aus der das Asset erstellt werden soll.
Erstellen eines Assets (veraltet)
Dieses Aktionsmodul erstellt ein neues Asset.
Asset löschen
Dieses Aktionsmodul löscht ein angegebenes Asset.
Asset abrufen
Dieses Aktionsmodul ruft Asset-Details ab.
Asset auflisten
Dieses Suchmodul ruft alle Assets im Ordner des angegebenen Projekts ab.
Gelöschtes Asset überwachen
Dieses Auslösermodul startet ein Szenario, wenn ein Asset gelöscht wird.
Wählen Sie den Webhook aus, der für dieses Modul verwendet werden soll, oder klicken Sie neben dem Feld „Webhook“ auf „Hinzufügen“ und geben Sie die folgenden Informationen ein:
Neues Asset überwachen
Dieses Auslösermodul startet ein Szenario, wenn ein neues Asset erstellt wird.
Wählen Sie den Webhook aus, der für dieses Modul verwendet werden soll, oder klicken Sie neben dem Feld „Webhook“ auf „Hinzufügen“ und geben Sie die folgenden Informationen ein:
Kommentare
Kommentar erstellen
Dieses Aktionsmodul fügt dem Asset einen neuen Kommentar oder eine neue Antwort hinzu.
Kommentar löschen
Dieses Aktionsmodul löscht einen vorhandenen Kommentar.
Kommentar abrufen
Dieses Aktionsmodul ruft Details des angegebenen Kommentars ab.
Kommentare auflisten
Dieses Suchmodul ruft alle Kommentare des angegebenen Assets ab.
Kommentar aktualisieren
Dieses Aktionsmodul bearbeitet einen vorhandenen Kommentar.
Kommentaraktualisierungen überwachen
Dieses Auslösermodul startet ein Szenario, wenn ein Kommentar aktualisiert wird.
Wählen Sie den Webhook aus, der für dieses Modul verwendet werden soll, oder klicken Sie neben dem Feld „Webhook“ auf „Hinzufügen“ und geben Sie die folgenden Informationen ein:
Neue Kommentare überwachen
Dieses Auslösermodul startet ein Szenario, wenn ein Kommentar erstellt wird.
Wählen Sie den Webhook aus, der für dieses Modul verwendet werden soll, oder klicken Sie neben dem Feld „Webhook“ auf „Hinzufügen“ und geben Sie die folgenden Informationen ein:
Ordner
Ordner erstellen
Dieses Aktionsmodul erstellt einen neuen Ordner in Frame.io.
Projekte
Projekt erstellen
Dieses Aktionsmodul erstellt ein neues Projekt in Frame.io.
Benutzende zu einem Frame.io-Projekt einladen
Dieses Aktionsmodul lädt Benutzende zum angegebenen Frame.io-Projekt ein.
Projekte auflisten
Dieses Suchmodul ruft alle Projekte für das angegebene Team ab.
Freigaben
Assets zu einem Freigabe-Link hinzufügen
Dieses Aktionsmodul fügt ein Asset zu einem Freigabe-Link in Frame.io hinzu.
Freigabe-Link erstellen
Dieses Aktionsmodul erstellt einen neuen Freigabe-Link in Frame.io.
Arbeitsbereiche
Arbeitsbereich erstellen
Dieses Aktionsmodul erstellt einen neuen Arbeitsbereich in Frame.io.
Arbeitsbereiche auflisten
Dieses Modul listet alle Arbeitsbereiche in einem Konto auf.
Metadaten
Erstellen eines Felds auf Kontoebene
Dieses Aktionsmodul erstellt und konfiguriert ein neues Metadatenfeld auf Kontoebene.
Löschen eines Felds auf Kontoebene
Dieses Aktionsmodul löscht ein einzelnes Metadatenfeld auf Kontoebene.
Metadaten abrufen
Dieses Aktionsmodul ruft die Metadaten für eine Datei in Frame.io ab.
Felder auf Kontoebene auflisten
Dieses Modul ruft eine Liste von Metadatenfeldern auf Kontoebene für das angegebene Konto ab.
Aktualisieren einer Felddefinition auf Kontoebene
Dieses Modul aktualisiert die Definition eines einzelnen vorhandenen Metadatenfelds.
Aktualisieren von Metadaten über mehrere Dateien hinweg
Dieses Modul aktualisiert Metadatenfelder in einer oder mehreren Dateien mit von Ihnen angegebenen Werten.
Sonstiges
Benutzerdefinierten API-Aufruf durchführen
Mit diesem Modul können Sie einen benutzerdefinierten API-Aufruf durchführen.
Ereignisse ansehen
Dieses Instant Trigger-Modul startet ein Szenario, wenn das ausgewählte Ereignis in Frame.io auftritt.
Sie können einen vorhandenen Webhook verwenden oder einen neuen erstellen.
So erstellen Sie einen neuen Webhook:
-
Klicken Sie neben dem Feld „Webhook“ auf Hinzufügen.
-
Geben Sie die folgenden Informationen ein:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header Webhook-Name Geben Sie einen Namen für den neuen Webhook ein. Verbindung Anweisungen zum Erstellen einer Verbindung zu Frame.io finden Sie in diesem Artikel unter Verbinden von Frame.io mit Adobe Workfront Fusion. Konto-ID Wählen Sie das Konto aus, das den Arbeitsbereich enthält, in dem Sie Ereignisse beobachten möchten, oder ordnen Sie es zu. Arbeitsbereich-ID Geben Sie die ID des Arbeitsbereichs ein, in dem Sie Ereignisse beobachten möchten. -Ereignisse Wählen Sie die Ereignisse aus, für die Sie dieses Modul Trigger erstellen möchten -
Klicken Sie Speichern, um den Webhook zu speichern und zum Modul zurückzukehren.
-
Klicken Sie Modul Ereignisse auf OK, um die Konfiguration zu speichern.
Aktualisierung des Metadatenwerts überwachen
Dieses Auslösermodul startet ein Szenario, wenn ein Kommentar aktualisiert wird.
Wählen Sie den Webhook aus, der für dieses Modul verwendet werden soll, oder klicken Sie neben dem Feld „Webhook“ auf „Hinzufügen“ und geben Sie die folgenden Informationen ein: