Modules Dropbox

Dans un scénario Adobe Workfront Fusion, vous pouvez automatiser les workflows qui utilisent Dropbox ou Dropbox Business, et les connecter à plusieurs applications et services tiers. Vous pouvez ainsi automatiser des activités telles que la surveillance, la recherche, la récupération, la mise en liste, la création et la modification de fichiers et de dossiers dans votre Dropbox.

Pour obtenir des instructions sur la création d’un scénario, consultez les articles sous Créer des scénarios : index d’article.

Pour plus d’informations sur les modules, consultez les articles sous Modules : index des articles.

Conditions d’accès

Conditions préalables

Informations sur l’API Dropbox

Le connecteur Dropbox utilise les éléments suivants :

Créer une connexion à Dropbox

Pour créer une connexion pour vos modules Dropbox, procédez comme suit :

Modules Dropbox et leurs champs

Lorsque vous configurez les modules Dropbox, Workfront Fusion affiche les champs répertoriés ci-dessous. En plus de ces derniers, des champs Dropbox 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.

Modules déclencheurs

Surveiller des fichiers

Ce module de type Déclencheur renvoie les détails du fichier lorsque le fichier d’un dossier spécifié est modifié.

Modules pour l’obtention de fichiers et de dossiers Dropbox

Télécharger un fichier

Ce module d’action télécharge un fichier à partir d’un dossier.

Vous spécifiez le fichier et son emplacement.

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.

Obtenir les métadonnées d’un dossier

Ce module d’action récupère les détails d’un dossier partagé.

Vous spécifiez l’ID du dossier.

Le module renvoie l’ID du dossier et de tous les champs associés, ainsi que les champs personnalisés et les valeurs 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.

Lister tous les fichiers/sous-dossiers dans un dossier

Ce module d’action répertorie les fichiers ou les dossiers d’un dossier spécifique.

Vous spécifiez l’ID du dossier.

Le module renvoie les ID des fichiers ou dossiers 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.

Lister les révisions de fichier

Ce module d’action récupère toutes les révisions de fichier (un historique de version) d’un fichier particulier.
Vous spécifiez l’identifiant du fichier.

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

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

Rechercher des fichiers/dossiers

Ce module de recherche recherche les enregistrements dans un objet dans Dropbox qui correspondent à la requête que vous avez spécifiée.

Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Modules pour la création et la modification de fichiers et de dossiers Dropbox

Créer un dossier

Ce module d’action crée un dossier.

Vous spécifiez le chemin et un nom pour le dossier.

Le module renvoie l’ID du dossier 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.

Créer/remplacer un fichier texte

Ce module d'action crée un fichier DOC ou remplace le contenu d'un fichier existant.

Vous spécifiez le fichier source et le dossier.

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

Créer/mettre à jour un lien de partage

Ce module d’action crée un lien public vers un fichier.

Vous spécifiez le fichier et des informations sur le lien.

Le module renvoie l’ID du lien 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.

Supprimer un fichier/dossier

Ce module d’action supprime un fichier ou un dossier.

Vous spécifiez le fichier ou le dossier.

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

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

Déplacer un fichier/dossier

Ce module d’action déplace un fichier ou un dossier vers un autre emplacement.

Vous spécifiez le fichier ou le dossier, ainsi que la méthode et l’emplacement de son déplacement.

Le module renvoie l’ID du fichier ou du dossier 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.

Renommer un fichier/dossier

Ce module d’action renomme un fichier ou un dossier.

Indiquez le fichier ou le dossier et le nouveau nom.

Le module renvoie l’ID du fichier ou du dossier 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.

Restaurer un fichier

Ce module d’action restaure une version précédente d’un fichier.

Vous spécifiez le fichier et le numéro de la révision que vous souhaitez.

Le module renvoie l’identifiant de la version et de tous les champs associés, ainsi que les champs personnalisés et les valeurs 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.

Charger fichier

Ce module d’action charge un fichier dans un dossier.

Vous spécifiez des informations telles que l’emplacement du document, le fichier à charger et éventuellement un nouveau nom pour le fichier.

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.

Autres modules

Effectuer un appel API

Ce module d’action permet d’effectuer un appel authentifié personnalisé vers l’API Dropbox. Cela vous permet de créer une automatisation du flux de données qui ne peut pas être réalisée par les autres modules Dropbox.

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

Exemple :

L’appel API suivant renvoie les 10 premiers fichiers du dossier /Text files de votre compte Dropbox :

URL : /2/files/list_folder

Corps :

{
"path": "/Text files",
"limit": 10,
"recursive": false,
"include_deleted": false
}

Les correspondances de la recherche se trouvent dans la sortie du module sous Lot > Corps > entrées.

Dans notre exemple, 10 billets ont été retournés.

Problèmes courants

Impossible de charger ou de mettre à jour un fichier

Voici quelques raisons possibles de l’échec du chargement ou de la mise à jour d’un fichier :

L’image référencée via un lien partagé n’est pas rendue.

L’URL renvoyée par Dropbox >Créer un lien partagé n’est pas directement liée à une image, mais à une page Dropbox. Pour forcer le téléchargement de l’image, remplacez le ?dl=0 de fin par ?dl=1. Pour forcer le rendu de l’image (par exemple, dans un navigateur web ou dans Facebook Messenger), ajoutez &raw=1 à l’URL.

Si vous devez obtenir le lien direct ou brut de l’image pour votre site web ou pour d’autres modules de Workfront Fusion, vous devez modifier l’URL partagée initiale de la manière suivante :

URL d’origine :

https://www.dropbox.com/s/ia8qtvs20f3a5ux/Screen%20Shot%202018-10-15%20at%204.21.11%20PM.png?dl=0

URL finale :

https://dl.dropbox.com/s/ia8qtvs20f3a5ux/Screen%20Shot%202018-10-15%20at%204.21.11%20PM.png

Pour modifier automatiquement l’URL, vous pouvez utiliser la fonction replace() deux fois :

Pour le faire en une seule étape, combinez les fonctions suivantes :

Vous pouvez également la copier et la coller dans le champ. Remplacez 1.url par l’URL.

{{replace(replace(1.url; "?dl=0"; ""); "www"; "dl")}}