Frame.io V4-Module
Mit den Frame.io-Modulen von Adobe Workfront Fusion können Sie Medienelemente 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 Version von Frame.io, zu der Sie eine Verbindung herstellen.
Anweisungen zur älteren Version des Frame.io-Connectors finden Sie unter Frame.io-Connector für ältere 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 |
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 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 Continue.
- 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 oder einen geheimen Client-Schlüssel 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 Next.
-
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 Ihren geheimen Client-Schlüssel.
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 Connection type Wählen Sie die Option IMS User authentication aus. Connection name Geben Sie einen Namen für diese Verbindung ein. Client ID Geben Sie Ihre Adobe-Client-ID ein. Diese finden Sie im Abschnitt für Credentials details der Adobe Developer Console.
Anweisungen zum Erstellen von Anmeldeinformationen finden Sie unter Erstellen von Benutzeranmeldeinformationen in der Adobe Developer Console in diesem Artikel.
Client Secret Geben Sie Ihren geheimen Adobe-Client-Schlüssel ein. Diesen finden Sie im Abschnitt für Credentials details der Adobe Developer Console.
Anweisungen zum Erstellen von Anmeldeinformationen finden Sie unter Erstellen von Benutzeranmeldeinformationen in der Adobe Developer Console in diesem Artikel.
-
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 Next.
-
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 die Option für Save configured API.
-
Klicken Sie auf der Produktseite auf die Karte für die soeben erstellten Anmeldeinformationen.
Hier finden Sie Ihre Client-ID und Ihren geheimen Client-Schlüssel.
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 Connection type Wählen Sie die Option IMS Server to Server aus. Connection name Geben Sie einen Namen für diese Verbindung ein. Client ID Geben Sie Ihre Adobe-Client-ID ein. Diese finden Sie im Abschnitt Credentials details der Adobe Developer Console.
Anweisungen zum Erstellen von Anmeldeinformationen finden Sie unter Erstellen von Server-zu-Server-Anmeldeinformationen in der Adobe Developer Console in diesem Artikel.
Client Secret Geben Sie Ihren geheimen Adobe-Client-Schlüssel ein. Diese finden Sie im Abschnitt Credentials details der Adobe Developer Console.
Anweisungen zum Erstellen von Anmeldeinformationen finden Sie unter Erstellen von Server-zu-Server-Anmeldeinformationen in der Adobe Developer Console in diesem Artikel.
-
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 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 Frame.io-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.
Medienelemente
Erstellen eines Medienelements
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 Medienelement.
Löschen eines Medienelements
Dieses Aktionsmodul löscht ein angegebenes Medienelement.
Abrufen eines Medienelements
Dieses Aktionsmodul ruft Medienelement-Details ab.
Auflisten von Medienelementen
Dieses Suchmodul ruft alle Medienelemente im Ordner des angegebenen Projekts ab.
Überwachen eines gelöschten Medienelements
Dieses Auslösermodul startet ein Szenario, wenn ein Medienelement gelöscht wird.
Wählen Sie den Webhook aus, den Sie für dieses Modul verwenden möchten, oder klicken Sie neben dem Feld „Webhook“ auf „Hinzufügen“ und geben Sie die folgenden Informationen ein:
Überwachen eines neuen Medienelements
Dieses Auslösermodul startet ein Szenario, wenn ein neues Medienelement erstellt wird.
Wählen Sie den Webhook aus, den Sie für dieses Modul verwenden möchten, oder klicken Sie neben dem Feld „Webhook“ auf „Hinzufügen“ und geben Sie die folgenden Informationen ein:
Kommentare
Erstellen eines Kommentars
Dieses Aktionsmodul fügt dem Medienelement einen neuen Kommentar oder eine neue Antwort hinzu.
Löschen eines Kommentars
Dieses Aktionsmodul löscht einen vorhandenen Kommentar.
Abrufen eines Kommentars
Dieses Aktionsmodul ruft Details des angegebenen Kommentars ab.
Auflisten von Kommentaren
Dieses Suchmodul ruft alle Kommentare des angegebenen Medienelements ab.
Aktualisieren eines Kommentars
Dieses Aktionsmodul bearbeitet einen vorhandenen Kommentar.
Überwachen von Kommentaraktualisierungen
Dieses Auslösermodul startet ein Szenario, wenn ein Kommentar aktualisiert wird.
Wählen Sie den Webhook aus, den Sie für dieses Modul verwenden möchten, oder klicken Sie neben dem Feld „Webhook“ auf „Hinzufügen“ und geben Sie die folgenden Informationen ein:
Überwachen eines neuen Kommentars
Dieses Auslösermodul startet ein Szenario, wenn ein Kommentar erstellt wird.
Wählen Sie den Webhook aus, den Sie für dieses Modul verwenden möchten, oder klicken Sie neben dem Feld „Webhook“ auf „Hinzufügen“ und geben Sie die folgenden Informationen ein:
Ordner
Erstellen eines Ordners
Dieses Aktionsmodul erstellt einen neuen Ordner in Frame.io.
Projekte
Erstellen eines Projekts
Dieses Aktionsmodul erstellt ein neues Projekt in Frame.io.
Einladen von Personen zu einem Frame.io-Projekt
Dieses Aktionsmodul lädt Personen zum angegebenen Frame.io-Projekt ein.
Auflisten von Projekten
Dieses Suchmodul ruft alle Projekte für das angegebene Team ab.
Freigaben
Hinzufügen eines Medienelements zu einem Freigabe-Link
Dieses Aktionsmodul fügt ein Medienelement zu einem Freigabe-Link in Frame.io hinzu.
Erstellen eines Freigabe-Links
Dieses Aktionsmodul erstellt einen neuen Freigabe-Link in Frame.io.
Arbeitsbereiche
Arbeitsbereich erstellen
Dieses Aktionsmodul erstellt einen neuen Arbeitsbereich in Frame.io
Auflisten von Arbeitsbereichen
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
Durchführen eines benutzerdefinierten API-Aufrufs
Mit diesem Modul können Sie einen benutzerdefinierten API-Aufruf durchführen.
Überwachen der Aktualisierung des Metadatenwerts
Dieses Auslösermodul startet ein Szenario, wenn ein Kommentar aktualisiert wird.
Wählen Sie den Webhook aus, den Sie für dieses Modul verwenden möchten, oder klicken Sie neben dem Feld „Webhook“ auf „Hinzufügen“ und geben Sie die folgenden Informationen ein: