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.
Informations sur l’API CloudConvert
Le connecteur CloudConvert utilise les éléments suivants :
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.
-
Connectez-vous à votre compte CloudConvert et ouvrez votre Dashboard.
-
Ouvrez la section Authorization>API Keys .
-
Cliquez sur Create New API key.
-
Saisissez le nom de la clé API, activez les portées à utiliser, puis cliquez sur Create.
-
Copiez le jeton fourni et stockez-le dans un endroit sûr.
-
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.
-
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.
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.
Convert a file
Convertit un fichier dans le format de sortie sélectionné.
Create an Archive
Permet d’ajouter un ou plusieurs fichiers à l’archive ZIP, RAR, 7Z, TAR, TAR.GZ ou TAR.BZ2.
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.
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.
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 .
Delete a Job
Ce module supprime un traitement, y compris toutes les tâches et données.
Get a Job
Ce module récupère les détails du traitement.
List Jobs
Ce module récupère tous les traitements qui ont été exécutés dans votre compte.
New Job Event
Se déclenche lorsqu’un traitement ou une tâche est créé(e), terminé(e) ou échoue dans votre compte.
- 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é.
-
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.) :
Tâches
Cancel a Task
Ce module annule une tâche dont le statut est en attente ou en cours de traitement.
Delete a Task
Supprime une tâche, y compris toutes les données.
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.
Get a Task
Ce module récupère les détails d’une tâche.
List Tasks
Ce module récupère toutes les tâches de votre compte en fonction des paramètres de filtrage.
Retry a Task
Ce module crée une nouvelle tâche, en fonction des paramètres (payload) d’une autre tâche.
Autre
Get My Info
Récupère les détails du compte authentifié de la personne actuelle.
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.
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.
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.
Ajoutez la requête pour l’appel API sous la forme d’un objet JSON standard.
Par exemple : {"name":"something-urgent"}
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
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 :
Dépannage troubleshooting
Voir le tableau suivant pour les erreurs possibles et leurs solutions :
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
-
Consultez https://cloudconvert.com/video-converter.
-
Cliquez sur Select File et choisissez votre exemple de fichier MOV.
-
Cliquez sur la liste déroulante en regard de Convert to et choisissez MP4.
-
Cliquez sur l’icône wrench .
-
Configurez les paramètres de compression MP4 selon vos besoins.
-
Cliquez sur Convert.
-
Une fois la conversion terminée, cliquez sur Download.
-
Examinez la vidéo convertie.
-
Répétez les étapes 1 à 8 jusqu’à ce que vous ayez trouvé les paramètres de conversion optimaux pour l’étape 5.
-
Consultez https://cloudconvert.com/api/v2/convert#convert-tasks.
-
Sélectionnez mov pour le champ input_format .
-
Sélectionnez mp4 pour le champ output_format .
-
Une liste de tous les paramètres possibles comme video_codec, crf, etc. apparaîtra.
-
Dans Workfront Fusion 2.0, insérez le module CloudConvert > Convert a File dans votre scénario.
-
Ouvrez les paramètres du module.
-
Configurez le module comme indiqué ci-dessous :
-
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.