Modules Dropbox

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, consultez Modules dans Adobe Workfront Fusion.

Conditions d’accès

Pour utiliser les fonctionnalités décrites dans cet article, vous devez disposer des éléments suivants :

Adobe Workfront forfait*
Pro ou un forfait supérieur
Adobe Workfront licence*
Plan, Work
Adobe Workfront Fusion licence**

Exigences de licence actuelle : aucune exigence de licence Workfront Fusion

Ou

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

Produit

Exigences du produit actuel : si vous disposez du forfait Adobe Workfront Select ou Prime, votre entreprise doit acheter Adobe Workfront Fusion et Adobe Workfront pour utiliser les fonctionnalités décrites dans cet article. Workfront Fusion est inclus dans le forfait Workfront Ultimate.

Ou

Exigences du produit hérité : votre entreprise doit acheter Adobe Workfront Fusion et Adobe Workfront pour utiliser les fonctionnalités décrites dans cet article.

Pour connaître la formule, le type de licence ou l’accès dont vous disposez, contactez vote administrateur ou administratrice Workfront.

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

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.

Créer une connexion à Dropbox

Pour créer une connexion pour vos modules Dropbox :

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

  2. Renseignez 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 Nommez cette connexion.
    Environment Indiquez si cette connexion est destinée à un environnement de production ou hors production.
    Type Choisissez 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 des modules Dropbox, Workfront Fusion affiche les champs répertoriés ci-dessous. Des champs Dropbox supplémentaires peuvent également s’afficher, en fonction 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 de mappage situé au-dessus d’un champ ou d’une fonction s’affiche, vous pouvez l’utiliser pour définir des variables et des fonctions pour ce champ. Pour plus d’informations, consultez Mapper les informations d’un module à un autre dans Adobe Workfront Fusion.

Modules déclencheurs

Fichiers de contrôle

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 compte Dropbox à Workfront Fusion, voir Créer une connexion à Dropbox dans cet article.
Folder
Sélectionnez le dossier dont vous souhaitez surveiller les modifications.
Watch also subfolders
Activez cette option pour surveiller également les sous-dossiers du dossier sélectionné pour les fichiers modifiés.
Limit
Saisissez ou mappez le nombre maximal d’enregistrements que le module doit renvoyer pour chaque cycle d’exécution du scénario.

Modules pour obtenir des fichiers et dossiers Dropbox

Rechercher des fichiers/dossiers

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

Vous pouvez mapper 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 à rechercher. Ce module recherche Dropbox dans son intégralité si vous ne sélectionnez pas de dossier.
Statut du fichier
Sélectionnez le statut du fichier pour restreindre la recherche au statut du fichier sélectionné.
Catégories de fichiers
Sélectionnez les catégories de fichiers pour restreindre la recherche aux catégories sélectionnées.
Extensions de fichiers
Sélectionnez les extensions de fichier à rechercher.
Limite
Saisissez ou mappez le nombre maximal 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 indiquez 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 mapper ces informations dans les modules suivants du scénario.

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

Lors de la configuration de 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.
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 des métadonnées de dossier

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

Vous spécifiez l’identifiant du dossier.

Le module renvoie l’ID du dossier et des champs associés, ainsi que les valeurs et les champs personnalisés auxquels la connexion a accès. Vous pouvez mapper ces informations dans les modules suivants du scénario.

Lors de la configuration de 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’identifiant du dossier dont vous souhaitez récupérer les détails.

Répertorier 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’identifiant du dossier.

Le module renvoie les ID des fichiers ou dossiers et des champs associés, ainsi que les valeurs et les champs personnalisés auxquels la connexion a accès. Vous pouvez mapper ces informations dans les modules suivants du scénario.

Lors de la configuration de 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 Docs, 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 répertorier pour chaque cycle d’exécution du scénario.

Répertorier des révisions de fichiers

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’ID du fichier.

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

Lors de la configuration de 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 répertorier pour chaque cycle d’exécution du scénario.

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

Charger un fichier

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

Renseignez des informations telles que l’emplacement du fichier, 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 mapper ces informations dans les modules suivants du scénario.

Lors de la configuration de 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 à 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).

Note : 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.

Spécifiez le chemin et un nom pour le dossier.

Le module renvoie l’identifiant 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 mapper ces informations dans les modules suivants du scénario.

Lors de la configuration de 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 un nom pour le nouveau dossier.
Folder

Saisissez ou mappez le chemin d’accès où vous souhaitez créer un dossier.

Remarque :

Si vous utilisez un compte Dropbox Business (avec espaces d’équipe), vous devez supprimer la barre oblique /, ou ne cliquez pas sur Click here pour sélectionner un dossier afin de créer un dossier d’équipe dans 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’identifiant 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 mapper ces informations dans les modules suivants du scénario.

Lors de la configuration de 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 à ajouter au dossier Dropbox.

Nom du fichier

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

Contenu du fichier

Saisissez le contenu texte 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 les informations sur le lien.

Le module renvoie l’ID du lien et des champs associés, ainsi que les valeurs et les champs personnalisés auxquels la connexion a accès. Vous pouvez mapper ces informations dans les modules suivants du scénario.

Lors de la configuration de 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
Choisissez si vous souhaitez mapper ou saisir le chemin d’accès au 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 limité 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 ulté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 la 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 disposant de Dropbox Pro ou de versions ultérieures.

Link's Access Level

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

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

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

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

Restaurer un fichier

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

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 mapper ces informations dans les modules suivants du scénario.

Lors de la configuration de 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
Choisissez si vous souhaitez mapper ou saisir le chemin d’accès au 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 la révision à restaurer.

Déplacer un fichier/dossier

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

Spécifiez le fichier ou le dossier, ainsi que l’emplacement et la manière dont vous souhaitez le déplacer.

Le module renvoie l’identifiant du fichier ou 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 mapper ces informations dans les modules suivants du scénario.

Lors de la configuration de 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
Choisissez si vous souhaitez mapper ou saisir le chemin d’accès au fichier, ou sélectionnez le fichier manuellement.
File/Folder Path/File/Folder

File/Folder Path

Saisissez ou mappez le chemin cible sur 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 au nouvel emplacement.
Auto Rename
Activez cette option pour vous 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înerait un transfert de propriété pour le contenu déplacé.

Renommer un fichier/dossier

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

Spécifiez le fichier ou le dossier, et le nouveau nom.

Le module renvoie l’identifiant du fichier ou 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 mapper ces informations dans les modules suivants du scénario.

Lors de la configuration de 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 ou saisir le chemin d’accès au fichier, ou sélectionnez le fichier manuellement.
Chemin du dossier/fichier / Fichier/Dossier

Chemin du fichier/dossier

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

Fichier/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.

Spécifiez le fichier ou le dossier.

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

Lors de la configuration de 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
Choisissez si vous souhaitez mapper ou saisir le chemin d’accès au 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 vous permet d’effectuer un appel authentifié personnalisé à l’API Dropbox. Ainsi, vous pouvez créer une automatisation du flux de données qui ne peut pas être réalisée par les autres modules Dropbox.

Lors de la configuration de 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

Remarque : pour obtenir la liste des points d’entrée disponibles, voir 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.

Remarque :

lors de l’utilisation d’instructions conditionnelles telles que if dans votre JSON, placez les guillemets en dehors de l’instruction conditionnelle.

INFO
Exemple : l’appel API suivant renvoie les 10 premiers fichiers du dossier /Text files dans 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 entraînant l’échec du chargement ou de la mise à jour d’un fichier :

  • Le fichier chargé est trop volumineux et dépasse la taille de fichier maximale autorisée pour votre plan Dropbox ou vous avez utilisé l’ensemble du quota de stockage de votre compte Dropbox. Vous devez supprimer les 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 retournée par Dropbox >Créer un lien partagé ne renvoie pas directement à une image, mais à une page Dropbox. Pour forcer le téléchargement de l’image, remplacez ?dl=0 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 :

  • Remplacez www par dl.

  • Et supprimez ?dl=0.

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

Vous pouvez également le copier et le 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