Modules Box

Dans un scénario Adobe Workfront Fusion, vous pouvez automatiser les workflows qui utilisent Box et les connecter à plusieurs applications et services tiers. Il surveille un dossier spécifié pour vérifier les modifications de fichier, modifier et supprimer des fichiers existants ou charger de nouveaux fichiers dans un dossier.

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

Développez pour afficher les exigences d’accès aux fonctionnalités de cet article.

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

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Package Adobe Workfront Tous
Licence Adobe Workfront

Nouveau : Standard

Ou

En cours : Travail ou version ultérieure

Licence Adobe Workfront Fusion **

Actuel : aucune exigence de licence Workfront Fusion

Ou

Hérité : Workfront Fusion pour l’automatisation et l’intégration du travail

Produit

Nouveau :

  • Sélectionnez ou le package Prime Workfront : votre entreprise doit acheter Adobe Workfront Fusion.
  • Package Ultimate Workfront : Workfront Fusion est inclus.

Ou

Actuel : votre entreprise doit acheter Adobe Workfront Fusion.

Pour plus d’informations sur les informations contenues dans ce tableau, voir Conditions d’accès requises dans la documentation.

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

Conditions préalables

Pour utiliser les modules Box, vous devez disposer d’un compte Box.

Informations sur l’API Box

Le connecteur Box utilise les éléments suivants :

URL de base
https://api.box.com/2.0
Version de l’API
v2.0
Balise API
v3.0.3

Modules Box et leurs champs

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

Basculement de carte

Déclencheurs

Nouvel événement de fichier

Ce module de déclenchement instantané lance un scénario lorsqu’une action sélectionnée se produit sur un fichier.

Webhook

Sélectionnez le webhook que vous souhaitez utiliser pour regarder les messages sortants ou ajoutez un webhook.

Pour ajouter un webhook, cliquez sur Add et saisissez le nom et la connexion du webhook, le fichier à surveiller et les déclencheurs à surveiller.

Pour obtenir des instructions sur la connexion de votre compte Box à Workfront Fusion, consultez Connexion à un service - Instructions de base.

Nouvel événement de dossier

Ce module de déclenchement instantané lance un scénario lorsque l’action de sélection se produit dans le dossier .

Webhook

Sélectionnez le webhook que vous souhaitez utiliser pour regarder les messages sortants ou ajoutez un webhook.

Pour ajouter un webhook, cliquez sur Add et saisissez le nom et la connexion du webhook, le dossier à surveiller et les déclencheurs à surveiller.

Pour obtenir des instructions sur la connexion de votre compte Box à Workfront Fusion, consultez Connexion à un service - Instructions de base.

Surveiller des fichiers

Ce module de déclenchement lance un scénario lorsqu’un nouveau fichier est ajouté ou qu’un fichier existant est mis à jour dans un dossier surveillé.

Connexion
Pour obtenir des instructions sur la connexion de votre compte Box à Workfront Fusion, voir Création d’une connexion à Adobe Workfront Fusion - Instructions de base.
Observer dans le dossier
Sélectionnez le dossier que vous souhaitez observer. Un scénario peut surveiller un seul dossier.
Surveiller

Sélectionnez le type de fichiers à surveiller.

  • Nouveaux fichiers uniquement

    Le scénario démarre lorsqu’un nouveau fichier est ajouté.

  • Nouveaux fichiers et toutes les modifications

    Le scénario démarre lorsqu’un fichier est ajouté ou lorsque le contenu ou l’attribut d’un fichier (son nom, par exemple) est modifié.

Nombre maximal de fichiers téléchargés
Saisissez le nombre maximal de fichiers que le module doit renvoyer à chaque cycle d’exécution de scénario.

Actions

Créer un dossier

Ce module d’action crée un dossier vide dans le dossier parent spécifié.

Connection
Pour obtenir des instructions sur la connexion de votre compte Box à Workfront Fusion, voir Création d’une connexion à Adobe Workfront Fusion - Instructions de base.
Name
Saisissez ou mappez un nom pour le nouveau dossier.
Parent Folder
Sélectionnez le dossier dans lequel vous souhaitez créer le nouveau dossier.
Folder Upload Email Access
Lorsque ce paramètre a été défini, les utilisateurs peuvent envoyer des fichiers par e-mail à l’adresse e-mail qui a été automatiquement créée pour ce dossier. Les options de collaborateurs permettent uniquement les e-mails enregistrés pour les collaborateurs.
Synchronization State
Indique si un dossier doit être synchronisé ou non avec l’appareil d’un utilisateur. Il est utilisé par Box Sync (arrêté) et n'est pas utilisé par Box Drive.

Obtenir un dossier

Ce module d’action récupère les détails d’un dossier, y compris les 100 premières entrées du dossier.

Connection
Pour obtenir des instructions sur la connexion de votre compte Box à Workfront Fusion, voir Création d’une connexion à Adobe Workfront Fusion - Instructions de base.
Folder
Sélectionnez le dossier pour lequel vous souhaitez récupérer des détails.

Obtenir les métadonnées du dossier

Ce module d’action récupère les métadonnées du dossier par ID de dossier.

Connection
Pour obtenir des instructions sur la connexion de votre compte Box à Workfront Fusion, voir Création d’une connexion à Adobe Workfront Fusion - Instructions de base.
Scope
Sélectionnez l’étendue à utiliser pour cette récupération des métadonnées.
Folder
Sélectionnez le dossier pour lequel vous souhaitez récupérer les métadonnées.

Effectuer un appel API

Ce module d'action effectue un appel personnalisé à l'API Box.

Connection
Pour plus d’informations sur la connexion de votre compte Bynder à Workfront Fusion, voir Connexion de Bynder à Workfront Fusiondans cet article.
URL

Saisir un chemin relatif à https://api.box.com.

Exemple : /2.0/users/me

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

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 ajoute les en-têtes d’autorisation pour vous.

Query String

Ajoutez la requête pour l’appel API sous la forme d’un objet JSON standard.

Par exemple : {"name":"something-urgent"}

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, placez les guillemets à l’extérieur de l’instruction conditionnelle.

Mettre à jour les métadonnées de dossier

Ce module d’action crée ou met à jour les métadonnées d’un dossier.

Connection
Pour obtenir des instructions sur la connexion de votre compte Box à Workfront Fusion, voir Création d’une connexion à Adobe Workfront Fusion - Instructions de base.
Scope
Sélectionnez l’étendue à utiliser pour cette mise à jour des métadonnées.
Folder
Sélectionnez le dossier pour lequel vous souhaitez mettre à jour les métadonnées.

Recherches

Recherche de contenu

Ce module de recherche recherche les éléments disponibles pour l’utilisateur ou l’entreprise dans son ensemble.

Connection
Pour obtenir des instructions sur la connexion de votre compte Box à Workfront Fusion, voir Création d’une connexion à Adobe Workfront Fusion - Instructions de base.
Query
Saisissez ou mappez la chaîne à rechercher. Cette requête est mise en correspondance avec les noms d'éléments, les descriptions, le contenu textuel des fichiers et divers autres champs des différents types d'éléments.
Scope
Choisissez si vous recherchez du contenu associé à l’utilisateur dont les informations d’identification sont utilisées pour la connexion utilisée dans ce module, ou si vous recherchez du contenu associé à l’ensemble de l’entreprise.
Type
Choisissez si vous recherchez des fichiers, des dossiers ou des liens web.
Sort
Choisissez si vous souhaitez trier par pertinence ou par date de modification.
Trash Content
Choisissez si vous souhaitez rechercher du contenu saccagé ou du contenu qui n’a pas été saccagé.
ID de dossier parent
Pour effectuer une recherche dans un dossier spécifique, pour chaque dossier à rechercher, cliquez sur Ajouter un élément et saisissez l’identifiant du dossier.
Créé À Partir De
Pour rechercher des ressources créées dans une certaine période, saisissez la date la plus proche dans la période.
Created to
Pour rechercher des ressources créées dans une certaine période, saisissez la dernière date de la période.
Mis À Jour À Partir De
Pour rechercher des ressources mises à jour dans une certaine période, saisissez la date la plus proche dans la période.
Mise à jour vers
Pour rechercher des ressources mises à jour dans une certaine période, saisissez la dernière date de la période.
Fields

Pour chaque attribut que vous souhaitez renvoyer dans la réponse du module, cliquez sur Ajouter un élément et saisissez le champ .

Vous pouvez l’utiliser pour demander des champs qui ne sont normalement pas renvoyés dans une réponse standard. Notez que la spécification de ce paramètre a pour effet qu’aucun des champs standard n’est renvoyé dans la réponse, sauf indication explicite.

File Extensions
Pour limiter la recherche à des extensions de fichier spécifiques, entrez une liste d’extensions de fichier séparées par des virgules.
Size From
Pour rechercher des ressources dans une plage de tailles spécifique, saisissez la petite extrémité de la plage, en octets.
Size To
Pour rechercher des ressources dans une plage de tailles spécifique, saisissez l’extrémité la plus grande de la plage, en octets.
Owner ID
Pour rechercher des ressources appartenant à des utilisateurs spécifiques, saisissez une liste d’ID de propriétaire séparés par des virgules.
Limit
Saisissez ou mappez le nombre maximal de résultats que le module doit renvoyer dans chaque cycle d'exécution.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3