DocumentationWorkfrontGuide Workfront

Modules Dropbox

Last update: Thu Nov 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Utilisateur ou utilisatrice

Dans un scénario Adobe Workfront Fusion, vous pouvez automatiser les workflows qui utilisent Dropbox ou Dropbox Business, ainsi que les connecter à plusieurs applications et services tiers. Cela vous permet d’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 vos Dropbox.

Si vous avez besoin d’instructions sur la création d’un scénario, voir Créer un scénario dans Adobe Workfront Fusion.

Pour plus d’informations sur les modules, voir Modules dans Adobe Workfront Fusion.

Conditions d’accès

Vous devez disposer des accès suivants pour utiliser les fonctionnalités de cet article :

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

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

Ou

Exigences de licence héritées : Workfront Fusion for Work Automation and Integration

Produit

Exigences actuelles du produit : si vous avez le plan Select ou Prime Adobe Workfront, votre entreprise doit acheter Adobe Workfront Fusion ainsi que Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article. Workfront Fusion est inclus dans la formule 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.

Pour connaître la formule, le type de licence ou l’accès dont vous disposez, contactez votre équipe d’administration Workfront.

Pour plus d’informations sur les licences Adobe Workfront Fusion, voir Licences Adobe Workfront Fusion.

Conditions préalables

  • Pour utiliser des modules Dropbox, vous devez disposer d’un compte Dropbox.
IMPORTANT
Dropbox doit approuver les demandes comptant plus de 50 utilisateurs et utilisatrices.
Pour plus d’informations, recherchez « Production approval » dans le guide de développement de Dropbox.

Informations sur l’API de Dropbox

Le connecteur de Dropbox utilise les éléments suivants :

URL de base
https://api.dropboxapi.com/2
Version de l’API
2
Balise API

  • Dropbox

    v5.3.9

  • Dropbox Business

    v1.0.12

Créer une connexion à Dropbox

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

  1. Cliquez sur Ajouter en regard de la case Connexion.

  2. Remplissez les champs suivants :

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header
    Connection name Saisissez un nom pour cette connexion.
    Environment Indiquez si cette connexion est destinée à un environnement de production ou hors production.
    Type Indiquez si vous vous connectez à un compte de service ou à un compte personnel.
    Client ID Saisissez votre Dropbox Client ID.
    Client Secret Saisissez votre Dropbox Client Secret.
    Account Type Choisissez si vous vous connectez à un compte personnel Dropbox ou à un compte professionnel (Dropbox Business).

  3. Cliquez sur Continuer pour enregistrer la connexion et revenir au module.## Modules Dropbox et leurs champs

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 Mapper des informations d’un module à l’autre dans Adobe Workfront Fusion.

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

Connection
Pour obtenir des instructions sur la connexion de votre application Dropbox à Workfront Fusion, voir Créer une connexion à Dropbox dans cet article.
Folder
Sélectionnez le dossier où vous souhaitez surveiller les modifications.
Watch also subfolders
Activez cette option pour surveiller également les fichiers modifiés dans les sous-dossiers du dossier sélectionné.
Limit
Saisissez ou mappez le nombre maximum d’enregistrements que le module doit renvoyer pour chaque cycle d’exécution du scénario.

Modules pour l’obtention de fichiers et de dossiers Dropbox

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.

Connection
Pour obtenir des instructions sur la connexion de votre compte Dropbox à Workfront Fusion, voir Créer une connexion à Dropbox dans cet article.
Search
Saisissez le terme de recherche.
Folder
Sélectionnez le dossier où vous souhaitez rechercher. Ce module recherche l’intégralité de Dropbox si vous ne sélectionnez pas de dossier.
Statut du fichier
Sélectionnez le statut du fichier pour limiter la recherche au statut du fichier sélectionné.
Catégories de fichiers
Sélectionnez les catégories de fichiers pour limiter la recherche aux catégories sélectionnées.
Extensions de fichiers
Sélectionnez les extensions de fichiers à rechercher.
Limite
Saisissez ou mappez le nombre maximum d’enregistrements que le module doit renvoyer pour chaque cycle d’exécution du scénario.

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.

NOTE
Ce module est utile pour fournir des fichiers aux modules suivants.

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

Connection
Pour obtenir des instructions sur la connexion de votre compte Dropbox à Workfront Fusion, voir Créer une connexion à Dropbox dans cet article.
Sélection des fichiers
Choisissez si vous souhaitez mapper le chemin du fichier ou sélectionnez le fichier manuellement.
Chemin du fichier / Fichier

Chemin du fichier

Saisissez ou mappez le chemin cible sur le fichier.

Fichier

Sélectionnez le fichier dans le menu.

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.

Connection
Pour obtenir des instructions sur la connexion de votre compte Dropbox à Workfront Fusion, voir Créer une connexion à Dropbox dans cet article.
Identifiant de dossier partagé
Saisissez ou mappez l’ID du dossier dont vous souhaitez récupérer les détails.

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.

Connection
Pour obtenir des instructions sur la connexion de votre application Dropbox à Workfront Fusion, voir Créer une connexion à Dropbox dans cet article.
Liste
Indiquez si vous souhaitez récupérer des fichiers ou des dossiers.
Afficher uniquement les fichiers téléchargeables
Activez cette option pour ne renvoyer que les fichiers téléchargeables. Certains types de fichiers, tels que les documents Google, ne sont pas téléchargeables.
Dossier
Saisissez ou mappez le dossier à partir duquel vous souhaitez récupérer des fichiers ou des dossiers.
Limite
Saisissez ou mappez le nombre maximal d’enregistrements que le module doit lister pour chaque cycle d’exécution de scénario.

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.

Connection
Pour obtenir des instructions sur la connexion de votre compte Dropbox à Workfront Fusion, voir Créer une connexion à Dropbox dans cet article.
Sélection des fichiers
Choisissez si vous souhaitez mapper le chemin du fichier ou sélectionnez le fichier manuellement.
Chemin du fichier / Fichier

Chemin du fichier

Saisissez ou mappez le chemin cible sur le fichier.

Fichier

Sélectionnez le fichier dans le menu.

Limite
Saisissez ou mappez le nombre maximal d’enregistrements que le module doit lister pour chaque cycle d’exécution de scénario.

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

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.

Connection
Pour obtenir des instructions sur la connexion de votre application Dropbox à Workfront Fusion, voir Créer une connexion à Dropbox dans cet article.
Folder
Sélectionnez le dossier de votre Dropbox dans lequel vous souhaitez charger le fichier.
Source File

Saisissez ou mappez le fichier que vous souhaitez ajouter au dossier Dropbox sélectionné ci-dessus.

File name

Saisissez ou mappez le nom du fichier, y compris son extension.

File data

Saisissez ou mappez les données du fichier (du module précédent, tel que Google Drive >Get a File).

Remarque : la taille maximale du fichier chargé est de 150 Mo.

Overwrite an existing file
Activez cette option pour remplacer le fichier existant par le nouveau fichier. Si cette option est désactivée, le fichier chargé est renommé.

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.

Connection
Pour obtenir des instructions sur la connexion de votre compte Dropbox à Workfront Fusion, voir Créer une connexion à Dropbox dans cet article.
Folder Name
Saisissez le nom du nouveau dossier.
Folder

Saisissez ou mappez le chemin où vous souhaitez créer un dossier.

Note :

Si vous utilisez un compte Dropbox Business (avec des espaces d’équipe), vous devez supprimer la barre oblique /, ou ne cliquez pas sur Click here pour choisir un dossier afin de créer un dossier d’équipe à la racine.

Si la barre oblique n’est pas supprimée, une erreur [409] path/malformed_path/.. est renvoyée.

Auto rename
Activez cette option pour renommer le nouveau dossier si un dossier portant le même nom existe déjà à l’emplacement cible.

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.

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.

Connection
Pour obtenir des instructions sur la connexion de votre compte Dropbox à Workfront Fusion, voir Créer une connexion à Dropbox dans cet article.
Select to
Indiquez si vous souhaitez créer ou remplacer un fichier DOC.
Folder
Sélectionnez l’emplacement cible où vous souhaitez créer un fichier.
Source File

Saisissez ou mappez le fichier que vous souhaitez ajouter au dossier Dropbox.

Nom du fichier

Saisissez le nom du nouveau fichier DOC (sans extension).

Contenu du fichier

Saisissez le contenu textuel du fichier DOC.

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.

Connection
Pour obtenir des instructions sur la connexion de votre compte Dropbox à Workfront Fusion, voir Créer une connexion à Dropbox dans cet article.
Way of selecting files
Indiquez si vous souhaitez mapper ou saisir le chemin du fichier, ou sélectionnez le fichier manuellement.
File Path / File

File Path

Saisissez ou mappez le chemin cible sur le fichier.

File

Sélectionnez le fichier dans le menu.

Requested Visibility

Indiquez si le lien est public, pour l’équipe ou restreint par un mot de passe.

Remarque : les options Team only et Access with password ne sont disponibles que pour les utilisateurs et utilisatrices qui disposent de Dropbox Pro ou d’une version supérieure.

Link's Expiration Date

Saisissez la date et l’heure d’expiration du lien, il ne sera alors plus accessible. Si ce champ n’est pas renseigné, le lien n’expire pas. Pour consulter une liste des formats de date et d’heure pris en charge, voir la section Coercition de type dans Adobe Workfront Fusion.

Remarque : les options Team only et Access with password ne sont disponibles que pour les utilisateurs et utilisatrices qui disposent de Dropbox Pro ou d’une version supérieure.

Link's Access Level

Définissez l’autorisation de la personne destinataire du lien.

Viewer  - Les utilisateurs et utilisatrices qui utilisent le lien peuvent afficher et commenter le contenu.

Editor  - Les utilisateurs et utilisatrices qui utilisent le lien peuvent modifier, afficher et commenter le contenu.

Max  - Les utilisateurs et utilisatrices qui utilisent le lien reçoivent le niveau d’accès maximal auquel vous pouvez définir le lien.

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.

Connection
Pour obtenir des instructions sur la connexion de votre compte Dropbox à Workfront Fusion, voir Créer une connexion à Dropbox dans cet article.
Way of selecting files
Indiquez si vous souhaitez mapper ou saisir le chemin du fichier, ou sélectionnez le fichier manuellement.
File Path / File

File Path

Saisissez ou mappez le chemin cible sur le fichier.

File

Sélectionnez le fichier dans le menu.

Revision
Saisissez ou mappez le numéro de révision de la révision que vous souhaitez restaurer.

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.

Connection
Pour obtenir des instructions sur la connexion de votre compte Dropbox à Workfront Fusion, voir Créer une connexion à Dropbox dans cet article.
Way of selecting files
Indiquez si vous souhaitez mapper ou saisir le chemin du fichier, ou sélectionnez le fichier manuellement.
File/Folder Path / File/Folder

File/Folder Path

Saisissez ou mappez le chemin cible vers le fichier ou le dossier.

File/Folder

Sélectionnez le fichier ou le dossier dans le menu.

To Folder
Saisissez ou mappez l’emplacement cible du fichier ou du dossier.
New Name
Saisissez le nouveau nom du fichier ou du dossier dans le nouvel emplacement.
Auto Rename
Activez cette option pour assurer que s’il existe un fichier ou un dossier portant le même nom, le module renomme le nouveau fichier ou dossier en ajoutant (NUMBER) après le nom du fichier ou du dossier. Sinon, le fichier ou le dossier de l’emplacement cible est remplacé.
Allow ownership transfer
Activez cette option pour permettre les déplacements par la personne propriétaire, même si cela entraîne un transfert de propriété pour le contenu déplacé.

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.

Connection
Pour obtenir des instructions sur la connexion de votre compte Dropbox à Workfront Fusion, voir Créer une connexion à Dropbox dans cet article.
Sélection des fichiers
Indiquez si vous souhaitez mapper ou saisir le chemin du fichier, ou sélectionnez le fichier manuellement.
Chemin d’accès au fichier/dossier/Fichier/Dossier

Chemin d’accès au fichier/dossier

Saisissez ou mappez le chemin cible vers le fichier ou le dossier.

Fichier ou dossier

Sélectionnez le fichier ou le dossier dans le menu.

Renommer
Saisissez le target name du fichier, y compris son extension.

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.

Connection
Pour obtenir des instructions sur la connexion de votre compte Dropbox à Workfront Fusion, voir Créer une connexion à Dropbox dans cet article.
Way of selecting files
Indiquez si vous souhaitez mapper ou saisir le chemin du fichier, ou sélectionnez le fichier manuellement.
File Path / File

File Path

Saisissez ou mappez le chemin cible sur le fichier.

File

Sélectionnez le fichier dans le menu.

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.

Connection
Pour obtenir des instructions sur la connexion de votre compte Dropbox à Workfront Fusion, voir Créer une connexion à Dropbox dans cet article.
URL

Saisissez un chemin relatif à https://api.dropboxapi.com. Par exemple, /2/files/list_folder

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

Method
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.
Headers
Saisissez les en-têtes de requête de votre choix. Workfront Fusion ajoute automatiquement des en-têtes d’autorisation.
Query String
Saisissez la chaîne de requête.
Body

Ajoutez le contenu du corps de l’appel API sous la forme d’un objet JSON standard.

Note :

Lorsque vous utilisez des instructions conditionnelles telles que if dans votre JSON, mettez les guillemets à l’extérieur de l’instruction conditionnelle.

INFO
Exemple : l’appel API suivant renvoie le 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 tickets ont été renvoyés :

Problèmes courants

Impossible de charger ou de mettre à jour un fichier

Il existe plusieurs situations dans lesquelles le chargement ou la mise à jour d’un fichier échoue :

  • Le fichier chargé est trop volumineux et dépasse la taille de fichier maximale autorisée pour votre plan Dropbox ou vous avez utilisé la totalité des quotas de stockage de votre compte Dropbox. Vous devez supprimer des fichiers existants de votre compte Dropbox ou mettre à niveau votre plan.
  • Le dossier précédemment sélectionné, dans lequel le fichier est chargé, n’existe plus. Le scénario s’arrête et vous devez sélectionner à nouveau le dossier cible.

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 votre image pour votre site web ou pour d’autres modules 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

  1. Remplacez www par dl.
  2. Supprimez ?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 :

  • Remplacer www par dl

  • Et pour supprimer ?dl=0

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")}}
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43