Box
Box™ est un service qui assure la sécurité, la synchronisation et le partage de vos fichiers. Connectez-vous à Box pour gérer vos fichiers. Vous pouvez effectuer différentes actions telles que le chargement, la mise à jour, l’obtention et la suppression de fichiers dans Box.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Norme | Toutes les régions Power Automate , à l’exception des éléments suivants : - China Cloud géré par 21Vianet |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Norme | Toutes les régions Power Apps , à l’exception des suivantes : - China Cloud géré par 21Vianet |
| Power Automate | Norme | Toutes les régions Power Automate , à l’exception des éléments suivants : - China Cloud géré par 21Vianet |
| Contact | |
|---|---|
| Nom | Microsoft |
| URL |
Microsoft LogicApps Support Prise en charge de Microsoft Power Automate Prise en charge de Microsoft Power Apps |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Microsoft |
| Site internet | https://www.box.com/ |
| Politique de confidentialité | https://www.box.com/legal/privacypolicy |
État de l’API Box
Utilisez cette ressource pour suivre les pannes de l’API Box
Problèmes connus et limitations
- Le connecteur ne prend pas en charge les connexions d’authentification unique ( SSO), utilisez plutôt la connexion standard.
- Ne confondez pas le paramètre Identificateur de fichier avec le nom de fichier réel. En raison des restrictions de l’API REST Box, les identificateurs de fichier non valides avec les caractères suivants : [\ { } " <>] peuvent entraîner des erreurs d’échappement de connecteur.
- Chaque dossier du chemin d’accès spécifié (chemin d’accès au dossier ou chemin d’accès au fichier), y compris le dossier racine ne doit pas contenir plus de 1 000 éléments.
- Lorsque vous choisissez un fichier d’un dossier à l’aide du sélecteur de fichiers, le chemin d’accès obtenu peut commencer par « //Tous les fichiers », par exemple « //Tous les fichiers/mon dossier/MyFile.txt». Pour éviter de créer un dossier « Tous les fichiers » à la racine, ce chemin d’accès doit être modifié manuellement en « /Mon dossier/MyFile.txt». Pour référencer un dossier racine, utilisez une barre oblique unique, par exemple « //Tous les fichiers » -> « / ».
- Les déclencheurs se déclenchent sur l’occurrence de l’événement correspondant presque immédiatement dans la plupart des cas, mais il peut y avoir des circonstances rares lorsque le délai de déclenchement du déclencheur peut prendre jusqu’à un jour en raison des limitations de l’API sous-jacentes. Pour en savoir plus, accédez à (API Box Events). Il est recommandé de conserver un fichier dans un dossier pour cette période. Sinon, elle ne sera pas signalée par la logique de déclencheur.
- Si un fichier existe déjà dans un dossier, le nouveau chargement du fichier portant le même nom n’est pas considéré comme un événement de création, mais un événement de mise à jour.
- Ce connecteur n’est plus un connecteur tabulaire et ne peut donc pas être utilisé comme source de données tabulaire, y compris pour le connecteur Excel.
- Ce connecteur peut envoyer une demande de no-op au serveur principal.
Limites générales
| Nom | Valeur |
|---|---|
| Taille maximale du fichier (en Mo) | 75 |
| Nombre maximal d’éléments de dossier | 10000 |
| Nombre maximal de mégaoctets transférés vers/depuis le connecteur dans un intervalle de temps de bande passante (par connexion) | 1 000 |
| Intervalle de temps de bande passante (en milisecondes) | 60000 |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Copier un fichier |
Copiez un fichier dans un chemin d’accès de fichier dans Box. |
| Créer un fichier |
Charge un fichier dans Box. |
| Extraire l’archive dans le dossier |
Extrait un fichier d’archivage dans un dossier dans Box (exemple : .zip). |
| Mettre à jour un fichier |
Met à jour un fichier existant dans Box. |
| Obtenir des métadonnées de fichier à l’aide de l’ID |
Récupère les métadonnées de fichier de Box à l’aide de l’ID de fichier. |
| Obtenir des métadonnées de fichier à l’aide du chemin d’accès |
Récupère les métadonnées de fichier de Box à l’aide du chemin d’accès. |
| Obtenir du contenu de fichier à l’aide de l’ID |
Récupère le contenu du fichier de Box à l’aide de l’ID. |
| Obtenir du contenu de fichier à l’aide du chemin d’accès |
Récupère le contenu du fichier de Box à l’aide du chemin d’accès. |
| Répertorier les fichiers et dossiers dans le dossier |
Répertorie les fichiers et dossiers d’un dossier Box. |
| Répertorier les fichiers et dossiers dans le dossier racine |
Répertorie les fichiers et dossiers dans le dossier racine Box. |
| Supprimer un fichier |
Supprime un fichier existant de Box. |
Copier un fichier
Copiez un fichier dans un chemin d’accès de fichier dans Box.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Source Url
|
source | True | string |
URL du fichier source. |
|
Chemin d’accès du fichier de destination
|
destination | True | string |
Chemin d’accès du fichier de destination dans Box, y compris le nom de fichier cible. |
|
Écraser
|
overwrite | boolean |
Remplace le fichier de destination si la valeur est « true ». |
Retours
Métadonnées d'objet blob
- Corps
- BlobMetadata
Créer un fichier
Charge un fichier dans Box.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Chemin d’accès au dossier
|
folderPath | True | string |
Chemin d’accès au dossier pour charger le fichier dans Box. |
|
Nom du fichier
|
name | True | string |
Nom du fichier à créer dans Box. |
|
Contenu du fichier
|
body | True | binary |
Contenu du fichier à charger dans Box. |
Retours
Métadonnées d'objet blob
- Corps
- BlobMetadata
Extraire l’archive dans le dossier
Extrait un fichier d’archivage dans un dossier dans Box (exemple : .zip).
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Chemin d’accès au fichier d’archivage source
|
source | True | string |
Chemin d’accès au fichier d’archivage. |
|
Chemin du dossier de destination
|
destination | True | string |
Chemin d’accès dans Box pour extraire le contenu de l’archive. |
|
Écraser
|
overwrite | boolean |
Remplace les fichiers de destination si la valeur est « true ». |
Retours
- response
- array of BlobMetadata
Mettre à jour un fichier
Met à jour un fichier existant dans Box.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de fichier
|
id | True | string |
Identificateur unique du fichier à mettre à jour dans Box. |
|
Contenu du fichier
|
body | True | binary |
Contenu du fichier à mettre à jour dans Box. |
Retours
Métadonnées d'objet blob
- Corps
- BlobMetadata
Obtenir des métadonnées de fichier à l’aide de l’ID
Récupère les métadonnées de fichier de Box à l’aide de l’ID de fichier.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de fichier
|
id | True | string |
Identificateur unique du fichier dans Box. |
Retours
Métadonnées d'objet blob
- Corps
- BlobMetadata
Obtenir des métadonnées de fichier à l’aide du chemin d’accès
Récupère les métadonnées de fichier de Box à l’aide du chemin d’accès.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Chemin d’accès au fichier
|
path | True | string |
Chemin unique du fichier dans Box. |
Retours
Métadonnées d'objet blob
- Corps
- BlobMetadata
Obtenir du contenu de fichier à l’aide de l’ID
Récupère le contenu du fichier de Box à l’aide de l’ID.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de fichier
|
id | True | string |
Identificateur unique du fichier dans Box. |
|
Déduire le type de contenu
|
inferContentType | boolean |
Valeur booléenne (true, false) pour déduire le type de contenu en fonction de l’extension. |
Retours
Contenu du fichier.
- Contenu du fichier
- binary
Obtenir du contenu de fichier à l’aide du chemin d’accès
Récupère le contenu du fichier de Box à l’aide du chemin d’accès.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Chemin d’accès au fichier
|
path | True | string |
Chemin unique du fichier dans Box. |
|
Déduire le type de contenu
|
inferContentType | boolean |
Valeur booléenne (true, false) pour déduire le type de contenu en fonction de l’extension. |
Retours
Contenu du fichier.
- Contenu du fichier
- binary
Répertorier les fichiers et dossiers dans le dossier
Répertorie les fichiers et dossiers d’un dossier Box.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de dossier
|
id | True | string |
Identificateur unique du dossier dans Box. |
Retours
- response
- array of BlobMetadata
Répertorier les fichiers et dossiers dans le dossier racine
Répertorie les fichiers et dossiers dans le dossier racine Box.
Retours
- response
- array of BlobMetadata
Supprimer un fichier
Supprime un fichier existant de Box.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de fichier
|
id | True | string |
Identificateur unique du fichier à supprimer de Box. |
Déclencheurs
| Lorsqu’un fichier est créé (propriétés uniquement) (V2) |
Cette opération déclenche un flux lorsqu’un nouveau fichier est créé dans un dossier. Le déclencheur ne se déclenche pas si un fichier est ajouté/mis à jour dans un sous-dossier. S’il est nécessaire de déclencher sur les sous-dossiers, plusieurs déclencheurs doivent être créés. Dans le cas où l’option « Fractionner activé » est désactivée pour les exécutions réussies du déclencheur>, les paramètres de déclencheur peuvent produire un tableau vide pour la sortie « Liste des fichiers ». |
| Lorsqu’un fichier est créé (propriétés uniquement) [DÉCONSEILLÉ] |
Cette action a été déconseillée. Utilisez plutôt quand un fichier est créé (propriétés uniquement) (V2).
|
| Lorsqu’un fichier est créé [DÉPRÉCIÉ] |
Déclenche un flux lorsqu’un nouveau fichier est créé dans un dossier Box. Le déclencheur ne se déclenche pas si un fichier est ajouté/mis à jour dans un sous-dossier. S’il est nécessaire de déclencher sur les sous-dossiers, plusieurs déclencheurs doivent être créés. |
| Lorsqu’un fichier est modifié (propriétés uniquement) |
Cette opération déclenche un flux lorsqu’un fichier est modifié dans un dossier. Le déclencheur ne se déclenche pas si un fichier est ajouté/mis à jour dans un sous-dossier. S’il est nécessaire de déclencher sur les sous-dossiers, plusieurs déclencheurs doivent être créés. |
| Lorsqu’un fichier est modifié (propriétés uniquement) (V2) (préversion) |
Cette opération déclenche un flux lorsqu’un fichier est modifié dans un dossier. Le déclencheur ne se déclenche pas si un fichier est ajouté/mis à jour dans un sous-dossier. S’il est nécessaire de déclencher sur les sous-dossiers, plusieurs déclencheurs doivent être créés. Dans le cas où l’option « Fractionner activé » est désactivée pour les exécutions réussies du déclencheur>, les paramètres de déclencheur peuvent produire un tableau vide pour la sortie « Liste des fichiers ». |
| Lorsqu’un fichier est modifié [DÉPRÉCIÉ] |
Déclenche un flux lorsqu’un fichier est modifié dans un dossier Box. Le déclencheur ne se déclenche pas si un fichier est ajouté/mis à jour dans un sous-dossier. S’il est nécessaire de déclencher sur les sous-dossiers, plusieurs déclencheurs doivent être créés. |
Lorsqu’un fichier est créé (propriétés uniquement) (V2)
Cette opération déclenche un flux lorsqu’un nouveau fichier est créé dans un dossier. Le déclencheur ne se déclenche pas si un fichier est ajouté/mis à jour dans un sous-dossier. S’il est nécessaire de déclencher sur les sous-dossiers, plusieurs déclencheurs doivent être créés. Dans le cas où l’option « Fractionner activé » est désactivée pour les exécutions réussies du déclencheur>, les paramètres de déclencheur peuvent produire un tableau vide pour la sortie « Liste des fichiers ».
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Dossier
|
folderId | True | string |
Identificateur unique du dossier. |
|
Nombre de fichiers à retourner
|
maxFileCount | integer |
Nombre maximal de fichiers à retourner par exécution de déclencheur unique (1 à 100). Notez que le paramètre « Fractionner sur » peut forcer le déclencheur à traiter chaque élément individuellement. |
Retours
Métadonnées d'objet blob
- Liste des fichiers
- BlobMetadata
Lorsqu’un fichier est créé (propriétés uniquement) [DÉCONSEILLÉ]
Cette action a été déconseillée. Utilisez plutôt quand un fichier est créé (propriétés uniquement) (V2).
Cette opération déclenche un flux lorsqu’un nouveau fichier est créé dans un dossier. Le déclencheur ne se déclenche pas si un fichier est ajouté/mis à jour dans un sous-dossier. S’il est nécessaire de déclencher sur les sous-dossiers, plusieurs déclencheurs doivent être créés.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Dossier
|
folderId | True | string |
Identificateur unique du dossier. |
|
Nombre de fichiers à retourner
|
maxFileCount | integer |
Nombre maximal de fichiers à retourner par exécution de déclencheur unique (1 à 100). Notez que le paramètre « Fractionner sur » peut forcer le déclencheur à traiter chaque élément individuellement. |
Retours
Métadonnées d'objet blob
- Liste des fichiers
- BlobMetadata
Lorsqu’un fichier est créé [DÉPRÉCIÉ]
Déclenche un flux lorsqu’un nouveau fichier est créé dans un dossier Box. Le déclencheur ne se déclenche pas si un fichier est ajouté/mis à jour dans un sous-dossier. S’il est nécessaire de déclencher sur les sous-dossiers, plusieurs déclencheurs doivent être créés.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de dossier
|
folderId | True | string |
Identificateur unique du dossier dans Box. |
|
Déduire le type de contenu
|
inferContentType | boolean |
Valeur booléenne (true, false) pour déduire le type de contenu en fonction de l’extension. |
Retours
Contenu du fichier.
- Contenu du fichier
- binary
Lorsqu’un fichier est modifié (propriétés uniquement)
Cette opération déclenche un flux lorsqu’un fichier est modifié dans un dossier. Le déclencheur ne se déclenche pas si un fichier est ajouté/mis à jour dans un sous-dossier. S’il est nécessaire de déclencher sur les sous-dossiers, plusieurs déclencheurs doivent être créés.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Dossier
|
folderId | True | string |
Sélectionner un dossier |
|
Nombre de fichiers à retourner
|
maxFileCount | integer |
Nombre maximal de fichiers à retourner par exécution de déclencheur unique (1 à 100). Notez que le paramètre « Fractionner sur » peut forcer le déclencheur à traiter chaque élément individuellement. |
Retours
Métadonnées d'objet blob
- Liste des fichiers
- BlobMetadata
Lorsqu’un fichier est modifié (propriétés uniquement) (V2) (préversion)
Cette opération déclenche un flux lorsqu’un fichier est modifié dans un dossier. Le déclencheur ne se déclenche pas si un fichier est ajouté/mis à jour dans un sous-dossier. S’il est nécessaire de déclencher sur les sous-dossiers, plusieurs déclencheurs doivent être créés. Dans le cas où l’option « Fractionner activé » est désactivée pour les exécutions réussies du déclencheur>, les paramètres de déclencheur peuvent produire un tableau vide pour la sortie « Liste des fichiers ».
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Dossier
|
folderId | True | string |
Sélectionner un dossier |
|
Nombre de fichiers à retourner
|
maxFileCount | integer |
Nombre maximal de fichiers à retourner par exécution de déclencheur unique (1 à 100). Notez que le paramètre « Fractionner sur » peut forcer le déclencheur à traiter chaque élément individuellement. |
Retours
Métadonnées d'objet blob
- Liste des fichiers
- BlobMetadata
Lorsqu’un fichier est modifié [DÉPRÉCIÉ]
Déclenche un flux lorsqu’un fichier est modifié dans un dossier Box. Le déclencheur ne se déclenche pas si un fichier est ajouté/mis à jour dans un sous-dossier. S’il est nécessaire de déclencher sur les sous-dossiers, plusieurs déclencheurs doivent être créés.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de dossier
|
folderId | True | string |
Identificateur unique du dossier dans Box. |
|
Déduire le type de contenu
|
inferContentType | boolean |
Valeur booléenne (true, false) pour déduire le type de contenu en fonction de l’extension. |
Retours
Contenu du fichier.
- Contenu du fichier
- binary
Définitions
BlobMetadata
Métadonnées d'objet blob
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Id
|
Id | string |
ID unique du fichier ou du dossier. |
|
Nom
|
Name | string |
Nom du fichier ou du dossier. |
|
DisplayName
|
DisplayName | string |
Nom complet du fichier ou du dossier. |
|
Chemin
|
Path | string |
Chemin d’accès du fichier ou du dossier. |
|
Dernière modification
|
LastModified | date-time |
Date et heure de la dernière modification du fichier ou du dossier. |
|
Taille
|
Size | integer |
Taille du fichier ou du dossier. |
|
Type de Média
|
MediaType | string |
Type de média du fichier ou du dossier. |
|
IsFolder
|
IsFolder | boolean |
Valeur booléenne (true, false) pour indiquer si l’objet blob est un dossier ou non. |
|
ETag
|
ETag | string |
Etag du fichier ou du dossier. |
|
FileLocator
|
FileLocator | string |
Filelocator du fichier ou du dossier. |
|
LastModifiedBy
|
LastModifiedBy | string |
Utilisateur qui a modifié le fichier ou le dossier pour la dernière fois. |
binaire
Il s’agit du type de données de base "binaire".