CloudConvert
In einem Adobe Workfront Fusion-Szenario können Sie Workflows automatisieren, die CloudConvert verwenden, und es mit mehreren Anwendungen und Services von Drittanbietern verbinden. Mit den CloudConvert-Modulen können Sie Aufträge und Aufgaben überwachen und verwalten sowie Dateien in Ihr CloudConvert-Konto importieren und exportieren.
CloudConvert-API-Informationen
Der CloudConvert-Connector verwendet Folgendes:
CloudConvert mit Workfront Fusion verbinden connect-cloudconvert-to-workfront-fusion
Um Ihr CloudConvert-Konto mit Workfront Fusion zu verbinden, müssen Sie den API-Schlüssel von Ihrem CloudConvert-Konto abrufen.
-
Melden Sie sich bei Ihrem CloudConvert Konto an und öffnen Sie Ihre Dashboard.
-
Öffnen Sie den Abschnitt Authorization>API Keys .
-
Klicken Sie auf Create New API key.
-
Geben Sie den Namen für den API-Schlüssel ein, aktivieren Sie die gewünschten Bereiche und klicken Sie dann auf Create.
-
Kopieren Sie das bereitgestellte Token und bewahren Sie es an einem sicheren Ort auf.
-
Beginnen Sie Workfront Fusion mit der Erstellung eines Szenarios und öffnen Sie das Create a connection-Dialogfeld des CloudConvert.
Anweisungen finden Sie unter Erstellen eines Szenarios in Adobe Workfront Fusion.
-
Geben Sie das Token ein, das Sie in Schritt 5 gespeichert haben, und klicken Sie dann auf Continue , um die Verbindung herzustellen.
CloudConvert Module und ihre Felder cloudconvert-modules-and-their-fields
Beim Konfigurieren CloudConvert 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 CloudConvert 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.
Allgemeine Aufgaben
Capture a Website
Dieses Aktionsmodul erfasst eine bestimmte Website und speichert sie im PDF-, JPG- oder PNG-Format.
Geben Sie die URL der Website und andere Informationen an, z. B. wo die Informationen gespeichert werden sollen.
Das Modul gibt die ID der Datei und aller zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Convert a file
Konvertiert eine Datei in ein ausgewähltes Ausgabeformat.
Create an Archive
Ermöglicht das Hinzufügen einer oder mehrerer Dateien zum ZIP, RAR, 7Z, TAR, TAR.GZ oder TAR.BZ2 Archiv.
Merge Files
Führt mindestens zwei Dateien zu einer PDF zusammen. Wenn Eingabedateien keine PDF sind, werden sie automatisch in PDF konvertiert.
Optimize a File
Dieses Aktionsmodul optimiert und komprimiert eine Datei im PDF-, PNG- oder JPG-Format.
Sie geben die Datei und die Parameter für die Optimierung und Speicherung an.
Das Modul gibt die ID der Datei und aller zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Jobs
Create a Job (advanced)
Dieses Modul erstellt einen Auftrag. Ein Auftrag kann eine oder mehrere Aufgaben sein, die im Feld Name identifiziert und mithilfe des Felds Input miteinander verknüpft werden.
Delete a Job
Dieses Modul löscht einen Auftrag einschließlich aller Aufgaben und Daten.
Get a Job
Dieses Modul ruft Auftragsdetails ab.
List Jobs
Dieses Modul ruft alle Aufträge ab, die in Ihrem Konto ausgeführt wurden.
New Job Event
Trigger, wenn ein Vorgang in Ihrem Konto oder einer Aufgabe erstellt wird, abgeschlossen wird oder fehlschlägt.
- Der vom Create a Job (advanced) Modul erstellte Auftrag besteht aus mehreren Aufgaben.
- Der New Job Event Trigger wird auch ausgelöst, wenn eine individuelle Aufgabe erstellt, abgeschlossen oder fehlgeschlagen wird.
-
Wenn Sie mit dem Array-Aggregator arbeiten (z. B. wenn Sie viele Dateien in verschiedenen Formaten haben, die konvertiert werden sollen), verwenden Sie die Option I don’t know the input format im Dialogfeld Add a task . Andernfalls wird der Fehler zurückgegeben.
-
Verknüpfen von Aufgaben innerhalb des Auftrags (Name > Eingabe, Name > Eingabe usw.):
Aufgaben
Cancel a Task
Mit diesem Modul wird eine Aufgabe mit dem Status Warten oder Verarbeiten abgebrochen.
Delete a Task
Aufgabe einschließlich aller Daten löschen
Download a File
Dieses Modul ruft den Dateinamen und die Dateidaten von der angegebenen Aufgabe ab.
Get a Task
Dieses Modul ruft Aufgabendetails ab.
List Tasks
Dieses Modul ruft alle Aufgaben in Ihrem Konto basierend auf den Filtereinstellungen ab.
Retry a Task
Dieses Modul erstellt eine neue Aufgabe basierend auf den Einstellungen (Payload) einer anderen Aufgabe.
Sonstige
Get My Info
Ruft authentifizierte Kontodetails zum aktuellen Benutzer ab.
Make an API Call
Ermöglicht die Durchführung eines benutzerdefinierten API-Aufrufs.
Wählen Sie die HTTP-Anfragemethode aus, die Sie zum Konfigurieren des API-Aufrufs benötigen. Weitere Informationen finden Sie unter HTTP-Anfragemethoden.
Geben Sie einen Pfad relativ zu https://api.cloudconvert.com/ ein. Beispiel: /v2/tasks
Eine Liste der verfügbaren Endpunkte finden Sie in der Dokumentation zur CloudConvert API v2.
Fügen Sie die Header der Anfrage in Form eines standardmäßigen JSON-Objekts hinzu.
Beispiel: {"Content-type":"application/json"}
Workfront Fusion 2.0 fügt die Autorisierungskopfzeilen für Sie hinzu.
Fügen Sie die Abfrage für den API-Aufruf in Form eines standardmäßigen JSON-Objekts hinzu.
Beispiel: {"name":"something-urgent"}
if in Ihrer JSON-Datei verwenden, setzen Sie die Anführungszeichen außerhalb der bedingten Anweisung.
Beispiel Aufgaben auflisten
Der folgende API-Aufruf gibt alle Aufgaben aus Ihrem CloudFront-Konto zurück:
URL: /v2/tasks
Methode: GET
Treffer der Suche finden Sie in der Modulausgabe unter Bundle > Body > data.
In unserem Beispiel wurden 6 Aufgaben zurückgegeben:
Fehlerbehebung troubleshooting
In der folgenden Tabelle finden Sie mögliche Fehler und deren Lösungen:
RuntimeError:
Maximum number of repeats exceeded.
Suchen Sie den entsprechenden CloudConvert Auftrag in der Liste der Aufträge im CloudConvert-Dashboard und überprüfen Sie die Dauer des Auftrags:
Die maximale Wartezeit des Moduls CloudConvert > Convert a File ist auf 3 Minuten festgelegt. Wenn die Dauer des Auftrags 3 Minuten überschreitet (möglicherweise aufgrund einer temporären Überlastung des CloudConvert-Services), gibt das Modul den oben genannten Fehler aus.
Erwägen Sie in diesem Fall eine der folgenden Optionen:
- Aktivieren Sie die Option Allow storing of Incomplete Executions in den Szenario-Einstellungen, um die unvollständigen Ausführungen für eine spätere manuelle Auflösung zu speichern. Optional können Sie eine Fehlerbehandlungsroute an das CloudConvert mit der Break anhängen, um die unvollständigen Ausführungen automatisch aufzulösen.
- Deaktivieren Sie die Option Download a file Modul CloudConvert > Convert a file . In diesem Fall wartet das Modul nicht auf das Konvertierungsergebnis. Um das Konvertierungsergebnis zu erhalten, erstellen Sie ein neues Szenario und verwenden Sie den Trigger CloudConvert > New Job Event .
Beispiel-Workflow für CloudConvert Connector
-
Klicken Sie auf Select File und wählen Sie Ihre Beispiel-MOV-Datei.
-
Klicken Sie auf das Dropdown-Menü neben Convert to und wählen Sie MP4 aus.
-
Klicken Sie auf das Symbol wrench .
-
Konfigurieren Sie die MP4-Komprimierungseinstellungen nach Bedarf.
-
Klicken Sie auf Convert.
-
Nachdem die Konvertierung abgeschlossen ist, klicken Sie auf Download.
-
Sehen Sie sich das konvertierte Video an.
-
Wiederholen Sie die Schritte 1 bis 8, bis Sie die optimalen Konvertierungseinstellungen für Schritt 5 gefunden haben.
-
https://cloudconvert.com/api/v2/convert#convert-tasks besuchen
-
Wählen Sie mov für das Feld input_format aus.
-
Wählen Sie mp4 für das Feld output_format aus.
-
Eine Liste aller möglichen Parameter wie video_codec, crf, etc. wird angezeigt.
-
Fügen Sie in Workfront Fusion 2.0 das Modul CloudConvert > Convert a File in Ihr Szenario ein.
-
Öffnen Sie die Einstellungen des Moduls.
-
Konfigurieren Sie das Modul wie unten gezeigt:
-
Stellen Sie sicher, dass Sie alle Einstellungen im Feld Konversions- und Engine-spezifische Optionen einbeziehen: Suchen Sie für jede Einstellung aus Schritt 5 den entsprechenden Parameter aus Schritt 13 und den entsprechenden Wert.