Modules CloudConvert

Dans un scénario Adobe Workfront Fusion, vous pouvez automatiser les workflows qui utilisent CloudConvert, et le connecter à plusieurs applications et services tiers. Les modules CloudConvert vous permettent de surveiller et de gérer des travaux et des tâches, ainsi que d’importer et d’exporter des fichiers dans votre compte CloudConvert.

Adobe Workfront formule*
Pro ou une version ultérieure
Adobe Workfront licence*
Plan, Work
Adobe Workfront Fusion licence**

Exigences de licence actuelles : aucune exigence de licence Workfront Fusion requise.

Ou

Ancienne exigence de licence : Workfront Fusion pour l’automatisation et l’intégration du travail

Produit

Exigences actuelles du produit : si vous disposez du plan de Adobe Workfront Select ou Prime, votre entreprise doit acheter du Adobe Workfront Fusion et Adobe Workfront utiliser les fonctionnalités décrites dans cet article. Workfront Fusion est inclus dans le plan de Workfront Ultimate.

Ou

Exigences liées aux produits hérités : votre entreprise doit acheter Adobe Workfront Fusion ainsi qu’Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article.

Informations sur l’API CloudConvert

Le connecteur CloudConvert utilise les éléments suivants :

URL de base
https://api.cloudconvert.com/v2/
Version de l’API
v2
Balise API
v2.14.22

Connecter CloudConvert à Workfront Fusion connect-cloudconvert-to-workfront-fusion

Pour connecter votre compte CloudConvert à Workfront Fusion, vous devez obtenir une clé API depuis votre compte CloudConvert.

  1. Connectez-vous à votre compte CloudConvert et ouvrez votre Dashboard.

  2. Ouvrez la section Authorization>API Keys .

  3. Cliquez sur Create New API key.

  4. Saisissez le nom de la clé API, activez les portées à utiliser, puis cliquez sur Create.

  5. Copiez le jeton fourni et stockez-le dans un endroit sûr.

  6. Dans Workfront Fusion, commencez à créer un scénario et ouvrez la boîte de dialogue de Create a connection du module CloudConvert.

    Pour obtenir des instructions, voir Créer un scénario dans Adobe Workfront Fusion.

  7. Saisissez le jeton que vous avez enregistré à l’étape 5, puis cliquez sur Continue pour établir la connexion.

Modules CloudConvert et leurs champs cloudconvert-modules-and-their-fields

Lorsque vous configurez les modules CloudConvert, Workfront Fusion affiche les champs répertoriés ci-dessous. En plus de ces derniers, des champs CloudConvert supplémentaires peuvent s’afficher, selon des facteurs tels que votre niveau d’accès dans l’application ou le service. Un titre en gras dans un module indique un champ obligatoire.

Si le bouton « Mapper » apparaît au-dessus d’un champ ou d’une fonction, vous pouvez l’utiliser pour définir des variables et des fonctions pour ce champ. Pour plus d’informations, voir Mappage des informations d’un module à un autre.

Basculement de carte

Tâches courantes

Capture a Website

Ce module d’action capture un site web spécifié et l’enregistre au format PDF, JPG ou PNG.

Vous spécifiez l’URL du site web et d’autres informations, telles que l’emplacement où vous souhaitez stocker les informations.

Le module renvoie l’ID du fichier et tous les champs associés, ainsi que les valeurs et les champs personnalisés auxquels la connexion a accès. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Connection
Pour obtenir des instructions sur la connexion de votre compte CloudConvert à Workfront Fusion, voir Connecter CloudConvert à Workfront Fusion dans cet article.
URL
Saisissez l’URL du site web que vous souhaitez capturer.
Output Format
Sélectionnez si vous souhaitez enregistrer le site web capturé au format PNG, JPG ou PDF.
File Name
Saisissez un nom de fichier (extension incluse) pour le fichier de sortie cible.
Headers

(Facultatif) Définissez des en-têtes de requête.

Cela s’avère utile, par exemple, lorsque l’URL spécifiée requiert une autorisation.

Conversion and engine specific options
Spécifiez les options de conversion et spécifiques au moteur. Pour afficher les options disponibles, voir la documentation sur l’API CloudConvert pour input_format et output_format.
Download a file
Activez cette option si vous souhaitez également inclure des données de fichier dans la sortie du module.

Convert a file

Convertit un fichier dans le format de sortie sélectionné.

Connection
Pour obtenir des instructions sur la connexion de votre compte CloudConvert à Workfront Fusion, voir Connecter CloudConvert à Workfront Fusion dans cet article.
Input file
Indiquez si vous souhaitez charger un fichier à l’aide de Workfront Fusion ou indiquez l’URL à partir de laquelle le fichier sera chargé.
Upload a file
Sélectionnez un fichier source à partir d’un module précédent ou mappez le nom et les données du fichier source.
Import a File from URL
  • URL

    Saisissez l’URL du fichier que vous souhaitez convertir.

  • Headers

    Définissez des en-têtes de demande (facultatif). Cela s’avère utile, par exemple, lorsque l’URL spécifiée requiert une autorisation.

Format
Indiquez si vous souhaitez spécifier le format d’entrée du fichier à convertir. Si elle n’est pas spécifiée, l’extension du fichier d’entrée est utilisée comme format d’entrée.
Input Format
Sélectionnez le format actuel du fichier.
Output Format
Sélectionnez le format de fichier cible vers lequel vous souhaitez convertir le fichier.
File Name
Choisissez un nom de fichier (extension comprise) pour le fichier de sortie cible.
Conversion and engine specific options
Spécifiez les options de conversion et spécifiques au moteur. Pour afficher les options disponibles, voir la documentation sur l’API CloudConvert pour input_format et output_format.
Download a file
Activez cette option si vous souhaitez également inclure des données de fichier dans la sortie du module.

Create an Archive

Permet d’ajouter un ou plusieurs fichiers à l’archive ZIP, RAR, 7Z, TAR, TAR.GZ ou TAR.BZ2.

Connection
Pour obtenir des instructions sur la connexion de votre compte CloudConvert à Workfront Fusion, voir Connecter CloudConvert à Workfront Fusion dans cet article.
Input Files
Spécifiez les fichiers que vous souhaitez ajouter à l’archive.
Upload a File
Sélectionnez un fichier source à partir d’un module précédent ou mappez le nom et les données du fichier source.
Import a file from URL

URL

Saisissez l’URL du fichier que vous souhaitez archiver.

Headers

Définissez des en-têtes de demande (facultatif). Cela s’avère utile, par exemple, lorsque l’URL spécifiée requiert une autorisation.

Output Format
Sélectionnez le format cible du fichier archivé.
File name
Saisissez le nom du fichier (extension incluse) pour le fichier de sortie cible.
Conversion and engine specific options
Spécifiez les options de conversion et spécifiques au moteur. Pour afficher les options disponibles, voir la documentation sur l’API CloudConvert pour input_format et output_format.
Download a File
Activez cette option si vous souhaitez également inclure des données de fichier dans la sortie du module.

Merge Files

Fusionne au moins deux fichiers dans un PDF. Si les fichiers d’entrée ne sont pas des PDF, ils sont automatiquement convertis au format PDF.

Connection
Pour obtenir des instructions sur la connexion de votre compte CloudConvert à Workfront Fusion, voir Connecter CloudConvert à Workfront Fusion dans cet article.
Input Files
Spécifiez les fichiers que vous souhaitez fusionner.
Upload a File
Sélectionnez un fichier source à partir d’un module précédent ou mappez le nom et les données du fichier source.
Import a file from URL

URL

Saisissez l’URL du fichier que vous souhaitez archiver.

Headers

Définissez des en-têtes de demande (facultatif). Cela s’avère utile, par exemple, lorsque l’URL spécifiée requiert une autorisation.

Output Format
Sélectionnez le format cible du fichier fusionné.
File name
Saisissez le nom du fichier (extension incluse) pour le fichier de sortie cible.
Conversion and engine specific options
Spécifiez les options de conversion et spécifiques au moteur. Pour afficher les options disponibles, voir la documentation sur l’API CloudConvert pour input_format et output_format.
Download a File
Activez cette option si vous souhaitez également inclure des données de fichier dans la sortie du module.

Optimize a File

Ce module d’action optimise et compresse un fichier au format PDF, PNG ou JPG.

Vous spécifiez le fichier et les paramètres d’optimisation et de stockage.

Le module renvoie l’ID du fichier et tous les champs associés, ainsi que les valeurs et les champs personnalisés auxquels la connexion a accès. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connection
Pour obtenir des instructions sur la connexion de votre compte CloudConvert à Workfront Fusion, voir Connecter CloudConvert à Workfront Fusion dans cet article.
Input File
Indiquez si vous souhaitez charger un fichier à l’aide de Workfront Fusion ou fournissez l’URL à partir de laquelle le fichier sera chargé.
Upload a File
Sélectionnez un fichier source à partir d’un module précédent ou mappez le nom et les données du fichier source.
Import a file from URL
  • URL: saisissez l’URL du fichier à convertir.
  • Headers: (facultatif) définissez les en-têtes de requête. Cela s’avère utile, par exemple, lorsque l’URL spécifiée requiert une autorisation.
Optimization for

Sélectionnez le profil d’optimisation en fonction des besoins spécifiques de la cible.

  • Web: optimisation pour le web (par défaut)

    • Supprimer les données redondantes et inutiles pour le web
    • Sous-échantillonner, écrêter et compresser intelligemment les images
    • Fusionner et créer des sous-ensembles de polices
    • Convertir les couleurs en RVB
  • Print: optimisation pour l’impression

    • Supprimer les données redondantes et inutiles pour l’impression

    • Sous-échantillonner, écrêter et compresser intelligemment les images

    • Fusionner et créer des sous-ensembles de polices

    • Convertir les couleurs en CMJN

  • Archive: optimisation à des fins d’archivage

    • Supprimer les données redondantes et inutiles pour l’archivage

    • Compresser intelligemment les images

    • Fusionner et créer des sous-ensembles de polices

  • Scanned images: optimisation pour les images numérisées

    • Profil optimisé pour les PDF principalement composés d’images pixellisées

    • Compresser les images sans réduire significativement la qualité visuelle

  • maximal size reduction: optimisation pour une réduction maximale de la taille

    • Utiliser la compression maximale possible

    • Peut réduire la qualité visuelle

Input format
Sélectionnez le format du fichier d’entrée que vous souhaitez optimiser.
File name
Saisissez un nom de fichier (extension incluse) pour le fichier de sortie cible.
Conversion and engine specific options
Spécifiez les options de conversion et spécifiques au moteur. Pour afficher les options disponibles, voir la documentation sur l’API CloudConvert pour input_format et output_format.
Download a file
Activez cette option si vous souhaitez également inclure des données de fichier dans la sortie du module.

Travaux

Create a Job (advanced)

Ce module crée un traitement. Une tâche peut être constituée d’une ou de plusieurs tâches identifiées dans le champ Name et liées les unes aux autres à l’aide du champ Input .

Connection
Pour obtenir des instructions sur la connexion de votre compte CloudConvert à Workfront Fusion, voir Connecter CloudConvert à Workfront Fusion dans cet article.
Input Files
Indiquez si vous souhaitez charger un fichier à l’aide de Workfront Fusion ou fournissez l’URL à partir de laquelle le fichier sera chargé.
Upload a File
Sélectionnez un fichier source à partir d’un module précédent ou mappez le nom et les données du fichier source.
Import a File from URL
  • URL: saisissez l’URL du fichier que vous souhaitez traiter.
  • Headers: (facultatif) définissez les en-têtes de requête. Cela s’avère utile, par exemple, lorsque l’URL spécifiée requiert une autorisation.
Tasks

Ajoutez les tâches qui seront exécutées dans le traitement.

Retrouvez la description des champs des opérations dans la section correspondante.

  • Execute a Command

    Pour plus d’informations sur l’exécution d’une commande, voir la documentation de l’API CloudConvert.

  • Export a File to Temporary URL

    Spécifiez le nom de la tâche et le nom de la tâche d’entrée (par exemple, Conversion).

Tag
Saisissez une balise. Les balises sont des chaînes arbitraires permettant d’identifier le traitement. Elles n’ont aucun effet et peuvent être utilisées pour associer le traitement à un ID.

Delete a Job

Ce module supprime un traitement, y compris toutes les tâches et données.

NOTE
Les traitements sont automatiquement supprimées 24 heures après leur fin.
Connection
Pour obtenir des instructions sur la connexion de votre compte CloudConvert à Workfront Fusion, voir Connecter CloudConvert à Workfront Fusion dans cet article.
Job ID
Saisissez ou mappez l’ID du traitement que vous souhaitez supprimer.

Get a Job

Ce module récupère les détails du traitement.

Connection
Pour obtenir des instructions sur la connexion de votre compte CloudConvert à Workfront Fusion, voir Connecter CloudConvert à Workfront Fusion dans cet article.
Job ID
Saisissez ou mappez l’ID du traitement dont vous souhaitez récupérer les détails.

List Jobs

Ce module récupère tous les traitements qui ont été exécutés dans votre compte.

Connection
Pour obtenir des instructions sur la connexion de votre compte CloudConvert à Workfront Fusion, voir Connecter CloudConvert à Workfront Fusion dans cet article.
Status
Sélectionnez le statut du traitement sur lequel filtrer les travaux renvoyés.
Limit
Définissez le nombre de traitements que Workfront Fusion 2.0 renverra au cours d’un cycle d’exécution.

New Job Event

Se déclenche lorsqu’un traitement ou une tâche est créé(e), terminé(e) ou échoue dans votre compte.

NOTE
  • Le traitement créé par le module Create a Job (advanced) se compose de plusieurs tâches.
  • Le déclencheur New Job Event est également déclenché lorsqu’une tâche individuelle est créée, terminée ou a échoué.
Webhhook name
Saisissez le nom du webhook.
Connection
Pour obtenir des instructions sur la connexion de votre compte CloudConvert à Workfront Fusion, voir Connecter CloudConvert à Workfront Fusion dans cet article.
Output Format
Sélectionnez si vous souhaitez enregistrer le site web capturé au format PNG, JPG ou PDF.
Event
Sélectionnez si le module se déclenche lorsque le traitement ou la tâche est créé(e), terminé(e) ou échoue.
NOTE
  • Si vous utilisez l’agrégateur de tableaux (par exemple, si vous devez convertir de nombreux fichiers dans différents formats), utilisez l’option I don’t know the input format dans la boîte de dialogue Add a task. Sinon, l’erreur est renvoyée.

  • Lier des tâches dans un traitement (nom > entrée, nom > entrée, etc.) :

    Liaison du nom entre les tâches >

Tâches

Cancel a Task

Ce module annule une tâche dont le statut est en attente ou en cours de traitement.

Connection
Pour obtenir des instructions sur la connexion de votre compte CloudConvert à Workfront Fusion, voir Connecter CloudConvert à Workfront Fusion dans cet article.
Task ID
Saisissez ou mappez l’identifiant de la tâche que vous souhaitez annuler.

Delete a Task

Supprime une tâche, y compris toutes les données.

NOTE
Les tâches terminées sont automatiquement supprimées après 24 heures.
Connection
Pour obtenir des instructions sur la connexion de votre compte CloudConvert à Workfront Fusion, voir Connecter CloudConvert à Workfront Fusion dans cet article.
Task ID
Saisissez (mappez) l’identifiant de la tâche que vous souhaitez supprimer.

Download a File

Ce module récupère le nom de fichier et les données du fichier à partir de la tâche spécifiée.

Connection
Pour obtenir des instructions sur la connexion de votre compte CloudConvert à Workfront Fusion, voir Connecter CloudConvert à Workfront Fusion dans cet article.
Task ID
Saisissez ou mappez l’identifiant de la tâche à partir de laquelle vous souhaitez télécharger le fichier.

Get a Task

Ce module récupère les détails d’une tâche.

Connection
Pour obtenir des instructions sur la connexion de votre compte CloudConvert à Workfront Fusion, voir Connecter CloudConvert à Workfront Fusion dans cet article.
Task ID
Saisissez ou mappez l’identifiant de la tâche dont vous souhaitez récupérer les détails.

List Tasks

Ce module récupère toutes les tâches de votre compte en fonction des paramètres de filtrage.

Connection
Pour obtenir des instructions sur la connexion de votre compte CloudConvert à Workfront Fusion, voir Connecter CloudConvert à Workfront Fusion dans cet article.
Status
Sélectionnez le statut de la tâche pour filtrer les tâches renvoyées.
Job ID
Saisissez ou mappez l’ID de traitement pour renvoyer uniquement les tâches du traitement spécifié.
Operation

Saisissez le type d’opération pour renvoyer uniquement les tâches avec l’opération spécifiée.

Remarque : utilisez le module List Possible Operations pour récupérer les opérations.

Limit
Saisissez ou mappez le nombre maximum d’enregistrements que le module doit renvoyer pour chaque cycle d’exécution du scénario.

Retry a Task

Ce module crée une nouvelle tâche, en fonction des paramètres (payload) d’une autre tâche.

Connection
Pour obtenir des instructions sur la connexion de votre compte CloudConvert à Workfront Fusion, voir Connecter CloudConvert à Workfront Fusion dans cet article.
Task ID
Saisissez ou mappez l’ID de la tâche à partir de laquelle vous souhaitez créer une tâche.

Autre

Get My Info

Récupère les détails du compte authentifié de la personne actuelle.

Connection
Pour obtenir des instructions sur la connexion de votre compte CloudConvert à Workfront Fusion, voir Connecter CloudConvert à Workfront Fusion dans cet article.

Make an API Call

Permet d’effectuer un appel API personnalisé.

Sélectionnez la méthode de requête HTTP dont vous avez besoin pour configurer l’appel API. Pour plus d’informations, voir Méthodes de requête HTTP.

Connection
Pour savoir comment connecter votre compte [Fusion App] à Workfront Fusion, voir Créer une connexion à Adobe Workfront Fusion - Instructions de base
URL

Saisissez un chemin d’accès relatif à https://api.cloudconvert.com/. Par exemple : /v2/tasks

Pour obtenir la liste des points d’entrée disponibles, voir la Documentation d’API v2 CloudConvert.

Method
Headers

Ajoutez les en-têtes de la requête sous la forme d’un objet JSON standard.

Par exemple, {"Content-type":"application/json"}

Workfront Fusion 2.0 ajoute les en-têtes d’autorisation pour vous.

Query String

Ajoutez la requête pour l’appel API sous la forme d’un objet JSON standard.

Par exemple : {"name":"something-urgent"}

Body
Ajoutez le contenu du corps de l’appel API sous la forme d’un objet JSON standard. Lorsque vous utilisez des instructions conditionnelles telles que if dans votre JSON, placez des guillemets à l’extérieur de l’instruction conditionnelle.

Exemple : répertorier les tâches

L’appel API suivant renvoie toutes les tâches de votre compte CloudFront :

URL : /v2/tasks

Méthode : GET

Exemple d’entrée API

Les correspondances de la recherche se trouvent dans la sortie du module sous Bundle > Body > data.

Dans notre exemple, 6 tâches ont été renvoyées :

Exemple de sortie API

Dépannage troubleshooting

Voir le tableau suivant pour les erreurs possibles et leurs solutions :

Erreur
Étapes suivantes
The output file size exceeds the limit allowed for your scenario.
Référez-vous aux limites de taille des fichiers.
You have exceeded the maximum conversion time.
Le plan gratuit CloudConvert offre 25 minutes de conversion par jour. Si votre utilisation dépasse la limite du plan gratuit, vous pouvez passer à un forfait (prépayé) ou à un abonnement.
Failed to read frame size: Could not seek to 1508. �/output/JLIADSA00137P0.mp3: Invalid argument.
Cette erreur se produit par exemple lors de la conversion de fichiers MP3 en fichiers WAV. Assurez-vous que vous avez sélectionné la bonne région, car des références à des fichiers seront trouvées, mais pas seulement le bon fichier.

RuntimeError:

Maximum number of repeats exceeded.

Localisez le traitement CloudConvert correspondant dans la liste des traitements de votre tableau de bord CloudConvert et vérifiez la durée du taitement :

Le délai d’expiration du module CloudConvert > Convert a File est défini sur 3 minutes. Si la durée du traitement dépasse 3 minutes (peut-être en raison d’une surcharge temporaire du service CloudConvert), le module génère l’erreur mentionnée ci-dessus.

Dans ce cas, envisagez l’une des options suivantes :

  • Activez l’option Allow storing of Incomplete Executions dans les paramètres du scénario pour stocker les exécutions incomplètes en vue d’une résolution manuelle ultérieure. Vous pouvez éventuellement joindre une route de gestion des erreurs au module CloudConvert avec la directive Break pour résoudre automatiquement les exécutions incomplètes.
  • Désactivez l'option Download a file dans le module CloudConvert > Convert a file . Dans ce cas, le module n’attend pas le résultat de la conversion. Pour obtenir le résultat de la conversion, créez un scénario et utilisez le déclencheur CloudConvert > New Job Event .

Exemple de workflow pour le connecteur CloudConvert

INFO
Exemple : conversion d’une vidéo du format MOV au format MP4
  1. Consultez https://cloudconvert.com/video-converter.

  2. Cliquez sur Select File et choisissez votre exemple de fichier MOV.

  3. Cliquez sur la liste déroulante en regard de Convert to et choisissez MP4.

  4. Cliquez sur l’icône wrench .

  5. Configurez les paramètres de compression MP4 selon vos besoins.

  6. Cliquez sur Convert.

  7. Une fois la conversion terminée, cliquez sur Download.

  8. Examinez la vidéo convertie.

  9. Répétez les étapes 1 à 8 jusqu’à ce que vous ayez trouvé les paramètres de conversion optimaux pour l’étape 5.

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

  11. Sélectionnez mov pour le champ input_format .

  12. Sélectionnez mp4 pour le champ output_format .

  13. Une liste de tous les paramètres possibles comme video_codec, crf, etc. apparaîtra.

  14. Dans Workfront Fusion 2.0, insérez le module CloudConvert > Convert a File dans votre scénario.

  15. Ouvrez les paramètres du module.

  16. Configurez le module comme indiqué ci-dessous :

    Exemple de CloudConvert

  17. Veillez à inclure tous les paramètres dans le champ Options spécifiques à la conversion et au moteur : pour chaque paramètre de l’étape 5, repérez le paramètre correspondant de l’étape 13 et sa valeur correspondante.

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