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.

Adobe Workfront piano*
Pro o superiore
Adobe Workfront licenza*
Plan, Work
Adobe Workfront Fusion licenza**

Requisiti di licenza correnti: nessun requisito di licenza Workfront Fusion.

Oppure

Requisiti di licenza legacy: Workfront Fusion per automazione e integrazione del lavoro

Prodotto

Fabbisogno prodotto corrente: se si dispone del piano Select o Prime Adobe Workfront, è necessario acquistare Adobe Workfront Fusion e Adobe Workfront per utilizzare le funzionalità descritte in questo articolo. Workfront Fusion è incluso nel piano Ultimate Workfront.

Oppure

Requisiti del prodotto legacy: la tua organizzazione deve acquistare Adobe Workfront Fusion e Adobe Workfront per utilizzare le funzionalità descritte in questo articolo.

Informazioni API di CloudConvert

Il connettore CloudConvert utilizza quanto segue:

URL di base
https://api.cloudconvert.com/v2/
Versione API
v2
Tag API
v2.14.22

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.

  1. Accedi al tuo account CloudConvert e apri Dashboard.

  2. Apri la sezione Authorization>API Keys.

  3. Fare clic su Create New API key.

  4. Immettere il nome per la chiave API, abilitare gli ambiti che si desidera utilizzare, quindi fare clic su Create.

  5. Copia il token fornito e archivialo in un luogo sicuro.

  6. 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.

  7. 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.

Attiva/Disattiva mappa

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.

Connection
Per istruzioni sulla connessione dell'account CloudConvert a Workfront Fusion, vedere Connessione di CloudConvert a Workfront Fusion in questo articolo.
URL
Immetti l’URL del sito web che desideri acquisire.
Output Format
Seleziona se desideri salvare il sito web acquisito in formato PNG, JPG-PDF o.
File Name
Immettere un nome di file (con estensione) per il file di output di destinazione.
Headers

(Facoltativo) Definisci le intestazioni delle richieste.

Ciò è utile, ad esempio, quando l’URL specificato richiede l’autorizzazione.

Conversion and engine specific options
Specifica le opzioni di conversione e specifiche per il motore. Per visualizzare le opzioni disponibili, vedere la documentazione dell'API CloudConvert per input_format e output_format.
Download a file
Abilita questa opzione se desideri includere anche i dati dei file nell’output del modulo.

Convert a file

Converte un file nel formato di output selezionato.

Connection
Per istruzioni sulla connessione dell'account CloudConvert a Workfront Fusion, vedere Connessione di CloudConvert a Workfront Fusion in questo articolo.
Input file
Selezionare se si desidera caricare un file utilizzando Workfront Fusion o specificare l'URL da cui verrà caricato il file.
Upload a file
Selezionare un file di origine da un modulo precedente o mappare il nome e i dati del file di origine.
Import a File from URL
  • URL

    Immettere l'URL del file che si desidera convertire.

  • Headers

    Definire le intestazioni di richiesta (facoltativo). Ciò è utile, ad esempio, quando l’URL specificato richiede l’autorizzazione.

Format
Specificare se si desidera specificare il formato di input del file da convertire. Se non viene specificata, come formato di input viene utilizzata l'estensione del file di input.
Input Format
Selezionare il formato corrente del file.
Output Format
Selezionare il formato di file di destinazione in cui si desidera convertire il file.
File Name
Scegliete un nome file (estensione inclusa) per il file di output di destinazione.
Conversion and engine specific options
Specifica le opzioni di conversione e specifiche per il motore. Per visualizzare le opzioni disponibili, vedere la documentazione dell'API CloudConvert per input_format e output_format.
Download a file
Abilita questa opzione se desideri includere anche i dati dei file nell’output del modulo.

Create an Archive

Consente di aggiungere uno o più file all'archivio ZIP, RAR, 7Z, TAR, TAR.GZ o TAR.BZ2.

Connection
Per istruzioni sulla connessione dell'account CloudConvert a Workfront Fusion, vedere Connessione di CloudConvert a Workfront Fusion in questo articolo.
Input Files
Specificare i file da aggiungere all'archivio.
Upload a File
Selezionare un file di origine da un modulo precedente o mappare il nome e i dati del file di origine.
Import a file from URL

URL

Immettere l'URL del file che si desidera archiviare.

Headers

Definire le intestazioni di richiesta (facoltativo). Ciò è utile, ad esempio, quando l’URL specificato richiede l’autorizzazione.

Output Format
Selezionare il formato di destinazione del file archiviato.
File name
Immettere il nome del file di output di destinazione, inclusa l'estensione.
Conversion and engine specific options
Specifica le opzioni di conversione e specifiche per il motore. Per visualizzare le opzioni disponibili, vedere la documentazione dell'API CloudConvert per input_format e output_format.
Download a File
Abilita questa opzione se desideri includere anche i dati dei file nell’output del modulo.

Merge Files

Unisce almeno due file in un unico PDF. Se i file di input non sono PDF, vengono automaticamente convertiti in PDF.

Connection
Per istruzioni sulla connessione dell'account CloudConvert a Workfront Fusion, vedere Connessione di CloudConvert a Workfront Fusion in questo articolo.
Input Files
Specificare i file da unire.
Upload a File
Selezionare un file di origine da un modulo precedente o mappare il nome e i dati del file di origine.
Import a file from URL

URL

Immettere l'URL del file che si desidera archiviare.

Headers

Definire le intestazioni di richiesta (facoltativo). Ciò è utile, ad esempio, quando l’URL specificato richiede l’autorizzazione.

Output Format
Selezionare il formato di destinazione del file unito.
File name
Immettere il nome del file di output di destinazione, inclusa l'estensione.
Conversion and engine specific options
Specifica le opzioni di conversione e specifiche per il motore. Per visualizzare le opzioni disponibili, vedere la documentazione dell'API CloudConvert per input_format e output_format.
Download a File
Abilita questa opzione se desideri includere anche i dati dei file nell’output del modulo.

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.

Connection
Per istruzioni sulla connessione dell'account CloudConvert a Workfront Fusion, vedere Connessione di CloudConvert a Workfront Fusion in questo articolo.
Input File
Seleziona se desideri caricare un file utilizzando Workfront Fusion o fornisci l’URL da cui verrà caricato il file.
Upload a File
Selezionare un file di origine da un modulo precedente o mappare il nome e i dati del file di origine.
Import a file from URL
  • URL: immetti l’URL del file da convertire.
  • Headers: (facoltativo) definisci le intestazioni della richiesta. Ciò è utile, ad esempio, quando l’URL specificato richiede l’autorizzazione.
Optimization for

Seleziona il profilo di ottimizzazione per esigenze di destinazione specifiche.

  • Web: ottimizzazione per il web (impostazione predefinita)

    • Rimuovere i dati ridondanti e non necessari per il Web
    • Downsampling, clip e compressione intelligente delle immagini
    • Unisci e crea sottoinsiemi di font
    • Converti colori in RGB
  • Print: ottimizzazione per la stampa

    • Rimuovere i dati ridondanti e non necessari per la stampa

    • Downsampling, clip e compressione intelligente delle immagini

    • Unisci e crea sottoinsiemi di font

    • Converti colori in CMYK

  • Archive: ottimizzazione a scopo di archiviazione

    • Eliminazione dei dati ridondanti e non necessari per l'archiviazione

    • Compressione intelligente delle immagini

    • Unisci e crea sottoinsiemi di font

  • Scanned images: ottimizzazione per le immagini digitalizzate

    • Profilo ottimizzato per PDF costituiti principalmente da immagini raster

    • Comprimi le immagini senza ridurre significativamente la qualità visiva

  • maximal size reduction: ottimizzazione per la massima riduzione delle dimensioni

    • Utilizzare la compressione massima possibile

    • Potrebbe ridurre la qualità visiva

Input format
Selezionare il formato del file di input che si desidera ottimizzare.
File name
Immettere un nome di file (con estensione) per il file di output di destinazione.
Conversion and engine specific options
Specifica le opzioni di conversione e specifiche per il motore. Per visualizzare le opzioni disponibili, vedere la documentazione dell'API CloudConvert per input_format e output_format.
Download a file
Abilita questa opzione se desideri includere anche i dati dei file nell’output del modulo.

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.

Connection
Per istruzioni sulla connessione dell'account CloudConvert a Workfront Fusion, vedere Connessione di CloudConvert a Workfront Fusion in questo articolo.
Input Files
Selezionare se si desidera caricare un file utilizzando Workfront Fusion o fornire l'URL da cui verrà caricato il file.
Upload a File
Selezionare un file di origine da un modulo precedente o mappare il nome e i dati del file di origine.
Import a File from URL
  • URL: immetti l’URL del file da elaborare.
  • Headers: (facoltativo) definisci le intestazioni della richiesta. Ciò è utile, ad esempio, quando l’URL specificato richiede l’autorizzazione.
Tasks

Aggiungi le attività che verranno eseguite all’interno del processo.

Le descrizioni dei campi relativi alle operazioni sono disponibili nella sezione corrispondente.

  • Execute a Command

    Per ulteriori informazioni sull'esecuzione di un comando, vedere la documentazione API CloudConvert.

  • Export a File to Temporary URL

    Specifica il nome dell’attività e il nome dell’attività di input (ad esempio, Conversione).

Tag
Immetti un tag. I tag sono stringhe arbitrarie per identificare il processo. Non hanno alcun effetto e possono essere utilizzati per associare il processo a un ID.

Delete a Job

Questo modulo elimina un processo, inclusi tutti i task e i dati.

NOTE
I processi vengono eliminati automaticamente 24 ore dopo la loro fine.
Connection
Per istruzioni sulla connessione dell'account CloudConvert a Workfront Fusion, vedere Connessione di CloudConvert a Workfront Fusion in questo articolo.
Job ID
Immetti o mappa l’ID del processo da eliminare.

Get a Job

Questo modulo recupera i dettagli del processo.

Connection
Per istruzioni sulla connessione dell'account CloudConvert a Workfront Fusion, vedere Connessione di CloudConvert a Workfront Fusion in questo articolo.
Job ID
Immetti o mappa l’ID del processo su cui desideri recuperare i dettagli.

List Jobs

Questo modulo recupera tutti i processi eseguiti nel tuo account.

Connection
Per istruzioni sulla connessione dell'account CloudConvert a Workfront Fusion, vedere Connessione di CloudConvert a Workfront Fusion in questo articolo.
Status
Selezionare lo stato del processo in base al quale filtrare i processi restituiti.
Limit
Impostare il numero di processi restituiti da Workfront Fusion 2.0 durante un ciclo di esecuzione.

New Job Event

Si attiva quando un processo nell’account o nell’attività viene creato, terminato o ha esito negativo.

NOTE
  • 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.
Webhhook name
Immetti il nome del webhook.
Connection
Per istruzioni sulla connessione dell'account CloudConvert a Workfront Fusion, vedere Connessione di CloudConvert a Workfront Fusion in questo articolo.
Output Format
Seleziona se desideri salvare il sito web acquisito in formato PNG, JPG-PDF o.
Event
Seleziona se attivare il modulo quando il processo o l'attività viene creata, terminata o non riesce.
NOTE
  • 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,…):

    Collegamento del nome tra processi >

Attività

Cancel a Task

Questo modulo annulla un'operazione con stato In attesa o in elaborazione.

Connection
Per istruzioni sulla connessione dell'account CloudConvert a Workfront Fusion, vedere Connessione di CloudConvert a Workfront Fusion in questo articolo.
Task ID
Immettere o mappare l'ID dell'attività che si desidera annullare.

Delete a Task

Elimina un'attività, inclusi tutti i dati.

NOTE
Le attività vengono eliminate automaticamente 24 ore dopo la loro fine.
Connection
Per istruzioni sulla connessione dell'account CloudConvert a Workfront Fusion, vedere Connessione di CloudConvert a Workfront Fusion in questo articolo.
Task ID
Immetti (mappa) l’ID dell’attività da eliminare.

Download a File

Questo modulo recupera il nome e i dati del file dall'operazione specificata.

Connection
Per istruzioni sulla connessione dell'account CloudConvert a Workfront Fusion, vedere Connessione di CloudConvert a Workfront Fusion in questo articolo.
Task ID
Immetti o mappa l’ID dell’attività da cui desideri scaricare il file.

Get a Task

Questo modulo recupera i dettagli dell’attività.

Connection
Per istruzioni sulla connessione dell'account CloudConvert a Workfront Fusion, vedere Connessione di CloudConvert a Workfront Fusion in questo articolo.
Task ID
Immetti o mappa l’ID dell’attività di cui desideri recuperare i dettagli.

List Tasks

Questo modulo recupera tutte le attività nell’account in base alle impostazioni del filtro.

Connection
Per istruzioni sulla connessione dell'account CloudConvert a Workfront Fusion, vedere Connessione di CloudConvert a Workfront Fusion in questo articolo.
Status
Selezionare lo stato dell'attività in base al quale filtrare le attività restituite.
Job ID
Immettere o mappare l'ID processo in modo da restituire solo le attività all'interno del processo specificato.
Operation

Immettere il tipo di operazione per restituire solo i task con l'operazione specificata.

Nota: utilizzare il modulo List Possible Operations per recuperare le operazioni.

Limit
Immettere o mappare il numero massimo di record che il modulo deve restituire durante ogni ciclo di esecuzione dello scenario.

Retry a Task

Questo modulo crea una nuova attività, basata sulle impostazioni (payload) di un’altra attività.

Connection
Per istruzioni sulla connessione dell'account CloudConvert a Workfront Fusion, vedere Connessione di CloudConvert a Workfront Fusion in questo articolo.
Task ID
Immettere o mappare l'ID dell'attività da cui si desidera creare una nuova attività.

Altro

Get My Info

Recupera i dettagli dell'account autenticato dell'utente corrente.

Connection
Per istruzioni sulla connessione dell'account CloudConvert a Workfront Fusion, vedere Connessione di CloudConvert a Workfront Fusion in questo articolo.

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.

Connection
Per istruzioni sulla connessione dell'account [Fusion App] a Workfront Fusion, vedere Creare una connessione ad Adobe Workfront Fusion - Istruzioni di base
URL

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.

Method
Headers

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.

Query String

Aggiungi la query per la chiamata API sotto forma di oggetto JSON standard.

Ad esempio: {"name":"something-urgent"}

Body
Aggiungi il contenuto body per la chiamata API sotto forma di oggetto JSON standard. Quando utilizzi istruzioni condizionali come 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

Esempio di input API

Le corrispondenze della ricerca si trovano nell'output del modulo in Bundle > Body > data.

Nel nostro esempio, sono state restituite 6 attività:

Output di esempio API

Risoluzione dei problemi troubleshooting

Per informazioni sui possibili errori e sulle relative soluzioni, vedere la tabella seguente:

Errore
Passaggi successivi
The output file size exceeds the limit allowed for your scenario.
Consulta i limiti di dimensione del file.
You have exceeded the maximum conversion time.
Il piano gratuito CloudConvert offre 25 minuti di conversione al giorno. Se l’utilizzo supera il limite del piano gratuito, puoi passare a un pacchetto (prepagato) o a un abbonamento.
Failed to read frame size: Could not seek to 1508. �/output/JLIADSA00137P0.mp3: Invalid argument.
Questo errore viene generato, ad esempio, durante la conversione di file da MP3 a WAV. Accertatevi di aver selezionato l'area corretta poiché troverà riferimenti ai file ma non solo il file corretto.

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

INFO
Esempio: conversione di un video dal formato MOV al formato MP4
  1. Visita https://cloudconvert.com/video-converter

  2. Fare clic su Select File e scegliere il file MOV di esempio.

  3. Fare clic sul menu a discesa accanto a Convert to e scegliere MP4.

  4. Fare clic sull'icona wrench.

  5. Configura le impostazioni di compressione MP4 come lo ritieni opportuno.

  6. Fare clic su Convert.

  7. Una volta completata la conversione, fare clic su Download.

  8. Rivedi il video convertito.

  9. Ripetere i passaggi da 1 a 8 fino a trovare le impostazioni di conversione ottimali per il passaggio 5.

  10. Visita https://cloudconvert.com/api/v2/convert#convert-tasks

  11. Scegliere mov per il campo input_format.

  12. Scegliere mp4 per il campo output_format.

  13. Un elenco di tutti i parametri possibili come video_codec, crf, ecc. verrà visualizzato.

  14. In Workfront Fusion 2.0, inserisci il modulo CloudConvert > Convert a File nello scenario.

  15. Apri le impostazioni del modulo.

  16. Configura il modulo come mostrato di seguito:

    Esempio CloudConvert

  17. 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.

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3