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 il Dashboard.
-
Apri la sezione Autorizzazione > Chiavi API.
-
Fai clic su Crea nuova chiave API.
-
Immettere il nome della chiave API, abilitare gli ambiti da utilizzare, quindi fare clic su Crea.
-
Copia il token fornito e archivialo in un luogo sicuro.
-
In Workfront Fusion, inizia a creare uno scenario e apri la finestra di dialogo Crea una connessione del modulo CloudConvert.
Per istruzioni, vedere Creare uno scenario in Adobe Workfront Fusion.
-
Immetti il token salvato al passaggio 5, quindi fai clic su Continua 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 all'altro in Adobe Workfront Fusion.
Attività comuni
Acquisire un sito Web
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.
Convertire un file
Converte un file nel formato di output selezionato.
Crea un archivio
Consente di aggiungere uno o più file all'archivio ZIP, RAR, 7Z, TAR, TAR.GZ o TAR.BZ2.
Unisci file
Unisce almeno due file in un unico PDF. Se i file di input non sono PDF, vengono automaticamente convertiti in PDF.
Ottimizzare un 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
Crea un processo (avanzato)
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.
Elimina processo
Questo modulo elimina un processo, inclusi tutti i task e i dati.
Ottieni un processo
Questo modulo recupera i dettagli del processo.
Elencare processi
Questo modulo recupera tutti i processi eseguiti nel tuo account.
Nuovo evento processo
Si attiva quando un processo nell’account o nell’attività viene creato, terminato o ha esito negativo.
- Il processo creato dal modulo Crea processo (avanzato) è 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 se sono presenti molti file in formati diversi da convertire), utilizzare l'opzione Non conosco il formato di input nella finestra di dialogo Aggiungi attività. In caso contrario, viene restituito l’errore.
-
Collegamento di task all'interno del job (nome > input, nome > input,…):
Attività
Annulla un'attività
Questo modulo annulla un'operazione con stato In attesa o in elaborazione.
Eliminare un'attività
Elimina un'attività, inclusi tutti i dati.
Scarica un file
Questo modulo recupera il nome e i dati del file dall'operazione specificata.
Ottieni un'attività
Questo modulo recupera i dettagli dell’attività.
Elenca attività
Questo modulo recupera tutte le attività nell’account in base alle impostazioni del filtro.
Riprova un'attività
Questo modulo crea una nuova attività, basata sulle impostazioni (payload) di un’altra attività.
Altro
Ottieni informazioni
Recupera i dettagli dell'account autenticato dell'utente corrente.
Effettuare una chiamata API
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 in Adobe Workfront Fusion.
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 > Corpo > dati.
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:
Numero massimo di ripetizioni superato.
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 Consenti l'archiviazione delle esecuzioni incomplete nelle impostazioni dello scenario per archiviare le esecuzioni incomplete per una successiva risoluzione manuale. Facoltativamente, è possibile allegare una route di gestione degli errori al modulo CloudConvert con la direttiva Break per risolvere automaticamente le esecuzioni incomplete.
- Disattivare l'opzione Scarica un file nel modulo CloudConvert > Converti un file. In questo caso, il modulo non attende il risultato della conversione. Per ottenere il risultato della conversione, crea un nuovo scenario e utilizza il trigger CloudConvert > New Job Event.
Esempio di flusso di lavoro per il connettore CloudConvert
-
Fare clic su Seleziona file e scegliere il file MOV di esempio.
-
Fare clic sul menu a discesa accanto a Converti in e scegliere MP4.
-
Fai clic sull'icona chiave inglese.
-
Configura le impostazioni di compressione MP4 come lo ritieni opportuno.
-
Fare clic su Converti.
-
Una volta completata la conversione, fai clic su Scarica.
-
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
-
Scegli 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.