CloudConvert moduli
In uno scenario Adobe Workfront Fusion, puoi automatizzare i flussi di lavoro che utilizzano CloudConvert e collegarlo a più applicazioni e servizi di terze parti. I moduli CloudConvert ti consentono di monitorare e gestire processi, attività e importare ed esportare file nel tuo account CloudConvert.
Informazioni API di CloudConvert
Il connettore CloudConvert utilizza quanto segue:
Connetti CloudConvert a Workfront Fusion connect-cloudconvert-to-workfront-fusion
Per connettere l'account CloudConvert a Workfront Fusion, è necessario ottenere la chiave API dall'account CloudConvert.
-
Accedi al tuo account CloudConvert e apri Dashboard.
-
Apri la sezione Authorization>API Keys.
-
Fare clic su Create New API key.
-
Immettere il nome per la chiave API, abilitare gli ambiti che si desidera utilizzare, quindi fare clic su Create.
-
Copia il token fornito e archivialo in un luogo sicuro.
-
In Workfront Fusion, iniziare a creare uno scenario e aprire la finestra di dialogo Create a connection del modulo CloudConvert.
Per istruzioni, vedere Creare uno scenario in Adobe Workfront Fusion.
-
Immettere il token salvato nel passaggio 5, quindi fare clic su Continue per stabilire la connessione.
CloudConvert moduli e relativi campi cloudconvert-modules-and-their-fields
Quando configuri CloudConvert moduli, Workfront Fusion visualizza i campi elencati di seguito. Insieme a questi, potrebbero essere visualizzati ulteriori campi di CloudConvert, a seconda di fattori quali il livello di accesso nell'app o nel servizio. Un titolo in grassetto in un modulo indica un campo obbligatorio.
Se viene visualizzato il pulsante Mappa sopra un campo o una funzione, è possibile utilizzarlo per impostare variabili e funzioni per tale campo. Per ulteriori informazioni, vedere Mappare le informazioni da un modulo a un altro.
Attività comuni
Capture a Website
Questo modulo di azione acquisisce un sito web specifico e lo salva in formato PDF, JPG o PNG.
Puoi specificare l’URL del sito web e altre informazioni, ad esempio dove desideri che vengano memorizzate.
Il modulo restituisce l’ID del file e dei campi associati, insieme a eventuali campi e valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.
Convert a file
Converte un file nel formato di output selezionato.
Create an Archive
Consente di aggiungere uno o più file all'archivio ZIP, RAR, 7Z, TAR, TAR.GZ o TAR.BZ2.
Merge Files
Unisce almeno due file in un unico PDF. Se i file di input non sono PDF, vengono automaticamente convertiti in PDF.
Optimize a File
Questo modulo di azione ottimizza e comprime un file in formato PDF, PNG o JPG.
È possibile specificare il file e i parametri per l'ottimizzazione e la memorizzazione.
Il modulo restituisce l’ID del file e dei campi associati, insieme a eventuali campi e valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.
Lavori
Create a Job (advanced)
Questo modulo crea un processo. Un processo può essere costituito da una o più attività identificate nel campo Name e collegate tra loro mediante il campo Input.
Delete a Job
Questo modulo elimina un processo, inclusi tutti i task e i dati.
Get a Job
Questo modulo recupera i dettagli del processo.
List Jobs
Questo modulo recupera tutti i processi eseguiti nel tuo account.
New Job Event
Si attiva quando un processo nell’account o nell’attività viene creato, terminato o ha esito negativo.
- Il processo creato dal modulo Create a Job (advanced) è costituito da diverse attività.
- Il trigger New Job Event viene attivato anche quando viene creata, terminata o non riuscita un'attività individuale.
-
Se si utilizza l'aggregatore di matrici (ad esempio, sono presenti molti file in formati diversi da convertire), utilizzare l'opzione I don’t know the input format nella finestra di dialogo Add a task. In caso contrario, viene restituito l’errore.
-
Collegamento di task all'interno del job (nome > input, nome > input,…):
Attività
Cancel a Task
Questo modulo annulla un'operazione con stato In attesa o in elaborazione.
Delete a Task
Elimina un'attività, inclusi tutti i dati.
Download a File
Questo modulo recupera il nome e i dati del file dall'operazione specificata.
Get a Task
Questo modulo recupera i dettagli dell’attività.
List Tasks
Questo modulo recupera tutte le attività nell’account in base alle impostazioni del filtro.
Retry a Task
Questo modulo crea una nuova attività, basata sulle impostazioni (payload) di un’altra attività.
Altro
Get My Info
Recupera i dettagli dell'account autenticato dell'utente corrente.
Make an API Call
Consente di eseguire una chiamata API personalizzata.
Seleziona il metodo di richiesta HTTP necessario per configurare la chiamata API. Per ulteriori informazioni, vedere Metodi di richiesta HTTP.
Immettere un percorso relativo a https://api.cloudconvert.com/. Ad esempio: /v2/tasks
Per un elenco degli endpoint disponibili, vedere la documentazione dell'API v2 CloudConvert.
Aggiungi le intestazioni della richiesta sotto forma di oggetto JSON standard.
Ad esempio: {"Content-type":"application/json"}
Workfront Fusion 2.0 aggiunge automaticamente le intestazioni di autorizzazione.
Aggiungi la query per la chiamata API sotto forma di oggetto JSON standard.
Ad esempio: {"name":"something-urgent"}
if nel JSON, inserisci le virgolette al di fuori dell'istruzione condizionale.
Esempio: attività elenco
La seguente chiamata API restituisce tutte le attività dal tuo account CloudFront:
URL: /v2/tasks
Metodo: GET
Le corrispondenze della ricerca si trovano nell'output del modulo in Bundle > Body > data.
Nel nostro esempio, sono state restituite 6 attività:
Risoluzione dei problemi troubleshooting
Per informazioni sui possibili errori e sulle relative soluzioni, vedere la tabella seguente:
RuntimeError:
Maximum number of repeats exceeded.
Individua il processo CloudConvert corrispondente nell'elenco dei processi del dashboard CloudConvert e controlla la durata del processo:
Il timeout del modulo CloudConvert > Convert a File è impostato su 3 minuti. Se la durata del processo supera i 3 minuti (probabilmente a causa di un sovraccarico temporaneo del servizio CloudConvert), il modulo restituisce l'errore sopra indicato.
In questo caso, considera una delle seguenti opzioni:
- Abilitare l'opzione Allow storing of Incomplete Executions nelle impostazioni dello scenario per memorizzare le esecuzioni incomplete per una successiva risoluzione manuale. Facoltativamente, è possibile allegare un percorso di gestione degli errori al modulo CloudConvert con la direttiva Break per risolvere automaticamente le esecuzioni incomplete.
- Disattivare l'opzione Download a file nel modulo CloudConvert > Convert a file. In questo caso, il modulo non attende il risultato della conversione. Per ottenere il risultato della conversione, creare un nuovo scenario e utilizzare il trigger CloudConvert > New Job Event.
Esempio di flusso di lavoro per il connettore CloudConvert
-
Fare clic su Select File e scegliere il file MOV di esempio.
-
Fare clic sul menu a discesa accanto a Convert to e scegliere MP4.
-
Fare clic sull'icona wrench.
-
Configura le impostazioni di compressione MP4 come lo ritieni opportuno.
-
Fare clic su Convert.
-
Una volta completata la conversione, fare clic su Download.
-
Rivedi il video convertito.
-
Ripetere i passaggi da 1 a 8 fino a trovare le impostazioni di conversione ottimali per il passaggio 5.
-
Visita https://cloudconvert.com/api/v2/convert#convert-tasks
-
Scegliere mov per il campo input_format.
-
Scegliere mp4 per il campo output_format.
-
Un elenco di tutti i parametri possibili come video_codec, crf, ecc. verrà visualizzato.
-
In Workfront Fusion 2.0, inserisci il modulo CloudConvert > Convert a File nello scenario.
-
Apri le impostazioni del modulo.
-
Configura il modulo come mostrato di seguito:
-
Assicurati di includere tutte le impostazioni nel campo Conversione e opzioni specifiche del motore: per ogni impostazione dal punto 5, individua il parametro corrispondente dal punto 13 e il relativo valore corrispondente.