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 Tableau de bord.
-
Ouvrez la section Autorisation > Clés API.
-
Cliquez sur Créer une clé API.
-
Saisissez le nom de la clé API, activez les étendues que vous souhaitez utiliser, puis cliquez sur Créer.
-
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 Créer une connexion 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 Continuer 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, consultez Mappage des informations d’un module à un autre dans Adobe Workfront Fusion.
Tâches courantes
Capturer un site web
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.
Convertir un fichier
Convertit un fichier dans le format de sortie sélectionné.
Créer une archive
Permet d’ajouter un ou plusieurs fichiers à l’archive ZIP, RAR, 7Z, TAR, TAR.GZ ou TAR.BZ2.
Fusionner des fichiers
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.
Optimiser un fichier
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
Créer un traitement (avancé)
Ce module crée un traitement. Un traitement peut correspondre à une ou plusieurs tâches identifiées dans le champ Nom et liées entre elles à l’aide du champ Entrée.
Supprimer un traitement
Ce module supprime un traitement, y compris toutes les tâches et données.
Obtenir un traitement
Ce module récupère les détails du traitement.
Répertorier les traitements
Ce module récupère tous les traitements qui ont été exécutés dans votre compte.
Nouvel événement de traitement
Se déclenche lorsqu’un traitement ou une tâche est créé(e), terminé(e) ou échoue dans votre compte.
- Un traitement créé avec le module Créer un traitement (avancé) est composé de plusieurs tâches.
- Le déclencheur Nouvel événement de traitement se déclenche également lorsqu’une tâche individuelle est créée, est terminée ou a échoué.
-
Si vous utilisez l’agrégateur de tableaux (par exemple, vous avez plusieurs fichiers dans différents formats à convertir), utilisez l’option Je ne connais pas le format d’entrée dans la boîte de dialogue Ajouter une tâche. Sinon, l’erreur est renvoyée.
-
Lier des tâches dans un traitement (nom > entrée, nom > entrée, etc.) :
Tâches
Annuler une tâche
Ce module annule une tâche dont le statut est en attente ou en cours de traitement.
Supprimer une tâche
Supprime une tâche, y compris toutes les données.
Télécharger un fichier
Ce module récupère le nom de fichier et les données du fichier à partir de la tâche spécifiée.
Obtenir une tâche
Ce module récupère les détails d’une tâche.
Lister des tâches
Ce module récupère toutes les tâches de votre compte en fonction des paramètres de filtrage.
Réessayer une tâche
Ce module crée une nouvelle tâche, en fonction des paramètres (payload) d’une autre tâche.
Autre
Obtenir mes informations
Récupère les détails du compte authentifié de la personne actuelle.
Effectuer un appel API
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 dans Adobe Workfront Fusion.
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 résultats de la recherche peuvent être trouvés dans la sortie du module sous Lot > Corps > Données.
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 fixé à 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. En option, vous pouvez joindre un itinéraire 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 nouveau 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 Sélectionner un fichier et choisissez votre exemple de fichier MOV.
-
Cliquez sur le menu déroulant, à côté de Convertir en et choisissez MP4.
-
Cliquez sur l’icône en forme de clé à molette.
-
Configurez les paramètres de compression MP4 selon vos besoins.
-
Cliquez sur Convertir.
-
Une fois la conversion terminée, cliquez sur Télécharger.
-
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.
-
Choisissez mov pour le champ input_format.
-
Choisissez 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 > Convertir un fichier 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.