Informations sur l’API CloudConvert

Le connecteur CloudConvert utilise les éléments suivants :

URL de basehttps://api.cloudconvert.com/v2/
Version de l’APIv2
Balise API2.14.22

Connecter CloudConvert à 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 Tableau de bord.

  2. Ouvrez la section Autorisation > Clés API.

  3. Cliquez sur Créer une clé API.

  4. Saisissez le nom de la clé API, activez les étendues que vous souhaitez utiliser, puis cliquez sur Créer.

  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 Créer une connexion 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 Continuer pour établir la connexion.

Modules CloudConvert et leurs champs

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.

ConnectionPour obtenir des instructions sur la connexion de votre compte CloudConvert à Workfront Fusion, consultez la section Connecter CloudConvert à Workfront Fusion de cet article.
URLSaisissez l’URL du site web que vous souhaitez capturer.
Output FormatSélectionnez si vous souhaitez enregistrer le site web capturé au format PNG, JPG ou PDF.
File NameSaisissez 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 optionsSpé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 fileActivez cette option si vous souhaitez également inclure des données de fichier dans la sortie du module.

Convertir un fichier

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

ConnectionPour obtenir des instructions sur la connexion de votre compte CloudConvert à Workfront Fusion, voir Connecter CloudConvert à Workfront Fusion dans cet article.
Input fileIndiquez si vous souhaitez charger un fichier à l’aide de Workfront Fusion ou indiquez l’URL à partir de laquelle le fichier sera chargé.
Upload a fileSé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.

FormatIndiquez 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 FormatSélectionnez le format actuel du fichier.
Output FormatSélectionnez le format de fichier cible vers lequel vous souhaitez convertir le fichier.
File NameChoisissez un nom de fichier (extension comprise) pour le fichier de sortie cible.
Conversion and engine specific optionsSpé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 fileActivez cette option si vous souhaitez également inclure des données de fichier dans la sortie du module.

Créer une archive

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

ConnectionPour savoir comment connecter votre compte CloudConvert à Workfront Fusion, consultez la section Connecter CloudConvert à Workfront Fusion dans cet article.
Input FilesSpécifiez les fichiers que vous souhaitez ajouter à l’archive.
Upload a FileSé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 FormatSélectionnez le format cible du fichier archivé.
File nameSaisissez le nom du fichier (extension incluse) pour le fichier de sortie cible.
Conversion and engine specific optionsSpécifiez les options de conversion et spécifiques au moteur. Pour afficher les options disponibles, consultez la documentation de l’API CloudConvert pour input_format et output_format.
Download a FileActivez cette option si vous souhaitez également inclure des données de fichier dans la sortie du module.

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.

ConnectionPour savoir comment connecter votre compte CloudConvert à Workfront Fusion, consultez la section Connecter CloudConvert à Workfront Fusion dans cet article.
Input FilesSpécifiez les fichiers que vous souhaitez fusionner.
Upload a FileSé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 FormatSélectionnez le format cible du fichier fusionné.
File nameSaisissez le nom du fichier (extension incluse) pour le fichier de sortie cible.
Conversion and engine specific optionsSpécifiez les options de conversion et spécifiques au moteur. Pour afficher les options disponibles, consultez la documentation de l’API CloudConvert pour input_format et output_format.
Download a FileActivez cette option si vous souhaitez également inclure des données de fichier dans la sortie du module.

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.

ConnectionPour savoir comment connecter votre compte CloudConvert à Workfront Fusion, consultez la section Connecter CloudConvert à Workfront Fusion dans cet article.
Input FileIndiquez si vous souhaitez charger un fichier à l’aide de Workfront Fusion ou fournissez l’URL à partir de laquelle le fichier sera chargé.
Upload a FileSé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  : (facultatif) définissez des en-têtes de demande. 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 la réduction maximale de la taille.

    • Utiliser la compression maximale possible

    • Peut réduire la qualité visuelle

Input formatSélectionnez le format du fichier d’entrée que vous souhaitez optimiser.
File nameSaisissez un nom de fichier (extension incluse) pour le fichier de sortie cible.
Conversion and engine specific optionsSpé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 fileActivez cette option si vous souhaitez également inclure des données de fichier dans la sortie du module.

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.

ConnectionPour savoir comment connecter votre compte CloudConvert à Workfront Fusion, consultez la section Connecter CloudConvert à Workfront Fusion dans cet article.
Input FilesIndiquez si vous souhaitez charger un fichier à l’aide de Workfront Fusion ou fournissez l’URL à partir de laquelle le fichier sera chargé.
Upload a FileSé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 des en-têtes de demande. 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).

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

Supprimer un traitement

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.
ConnectionPour savoir comment connecter votre compte CloudConvert à Workfront Fusion, consultez la section Connecter CloudConvert à Workfront Fusion dans cet article.
Job IDSaisissez ou mappez l’ID du traitement que vous souhaitez supprimer.

Obtenir un traitement

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

ConnectionPour savoir comment connecter votre compte CloudConvert à Workfront Fusion, consultez la section Connecter CloudConvert à Workfront Fusion dans cet article.
Job IDSaisissez ou mappez l’ID du traitement dont vous souhaitez récupérer les détails.

Répertorier les traitements

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

ConnectionPour savoir comment connecter votre compte CloudConvert à Workfront Fusion, consultez la section Connecter CloudConvert à Workfront Fusion dans cet article.
StatusSélectionnez le statut du traitement sur lequel filtrer les travaux renvoyés.
LimitDéfinissez le nombre de traitements que Workfront Fusion 2.0 renverra au cours d’un cycle d’exécution.

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.

NOTE
  • 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é.
Webhook nameSaisissez le nom du webhook.
ConnectionPour obtenir des instructions sur la procédure de connexion de votre compte CloudConvert à Workfront Fusion, consultez Connecter CloudConvert à Workfront Fusion dans cet article.
Output FormatSélectionnez si vous souhaitez enregistrer le site web capturé au format PNG, JPG ou PDF.
EventSé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, 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.) :

    >