Scatola
Box™ è un servizio che mantiene i file al sicuro, sincronizzati e facili da condividere. Connettersi a Box per gestire i file. È possibile eseguire varie azioni, ad esempio caricare, aggiornare, ottenere ed eliminare file in Box.
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Servizio | Class | Regions |
|---|---|---|
| Copilot Studio | Normale | Tutte le aree di Power Automate , ad eccezione delle seguenti: - China Cloud gestito da 21Vianet |
| App per la logica | Normale | Tutte le aree di App per la logica , ad eccezione delle seguenti: - Aree di Azure Cina - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Apps | Normale | Tutte le aree di Power Apps , ad eccezione dei seguenti: - China Cloud gestito da 21Vianet |
| Power Automate | Normale | Tutte le aree di Power Automate , ad eccezione delle seguenti: - China Cloud gestito da 21Vianet |
| Contatto | |
|---|---|
| Nome | Microsoft |
| URL |
Supporto di Microsoft LogicApps Supporto di Microsoft Power Automate Supporto di Microsoft Power Apps |
| Metadati del connettore | |
|---|---|
| Editore | Microsoft |
| Sito web | https://www.box.com/ |
| Informativa sulla privacy | https://www.box.com/legal/privacypolicy |
Stato DELL'API Box
Usare questa risorsa per tenere traccia delle interruzioni dell'API Box
Problemi noti e limitazioni
- Il connettore non supporta le connessioni Single Sign On (SSO), usare invece una connessione standard.
- Non confondere il parametro Identificatore file con il nome file effettivo. A causa delle restrizioni dell'API REST di Box, gli identificatori di file non validi con i caratteri seguenti : [\ { } " <>] possono causare errori di escapetimeout del connettore.
- Ogni cartella nel percorso specificato (Percorso cartella o Percorso file), inclusa la cartella radice non deve contenere più di 10000 elementi.
- Quando si sceglie un file di una cartella tramite selezione file, il percorso risultante può iniziare con '//Tutti i file', ad esempio '//Tutti i file/Cartella personale/MyFile.txt'. Per evitare di creare una nuova cartella 'Tutti i file' nella radice, questo percorso deve essere modificato manualmente in '/My Folder/MyFile.txt'. Per fare riferimento alla cartella radice, usare una singola barra, ad esempio '//Tutti i file' -> '/'.
- I trigger vengono attivati sull'occorrenza dell'evento corrispondente quasi immediatamente nella maggior parte dei casi, ma potrebbero verificarsi rare circostanze in cui il ritardo del trigger per l'attivazione potrebbe richiedere fino a un giorno a causa di limitazioni dell'API sottostanti. Per altre informazioni, vedere (API Eventi Box). È consigliabile conservare un file in una cartella per quel periodo. In caso contrario, non verrà segnalato dalla logica del trigger.
- Se un file esiste già in una cartella, il caricamento del file con lo stesso nome non verrà considerato come evento di creazione ma evento di aggiornamento.
- Questo connettore non è più un connettore tabulare e pertanto non può essere usato come origine dati tabulare, incluso per il connettore Excel.
- Questo connettore potrebbe inviare una richiesta di no-op al back-end.
Limiti generali
| Nome | Value |
|---|---|
| Dimensioni massime del file (in MB) | 75 |
| Numero massimo di elementi della cartella | 10.000 |
| Numero massimo di megabyte trasferiti dal connettore entro un intervallo di tempo di larghezza di banda (per connessione) | 1000 |
| Intervallo di tempo della larghezza di banda (in milisecondi) | 60000 |
Limiti per la limitazione delle richieste
| Nome | Chiamate | Periodo di rinnovo |
|---|---|---|
| Chiamate API per connessione | 100 | 60 secondi |
Azioni
| Aggiorna file |
Aggiorna un file esistente in Box. |
| Copia file |
Copiare un file in un percorso di file in Box. |
| Crea un file |
Carica un file in Box. |
| Elencare file e cartelle nella cartella |
Elenca i file e le cartelle in una cartella Box. |
| Elencare file e cartelle nella cartella radice |
Elenca i file e le cartelle nella cartella radice box. |
| Elimina file |
Elimina un file esistente da Box. |
| Estrarre l'archivio nella cartella |
Estrae un file di archivio in una cartella in Box (ad esempio: .zip). |
| Ottenere i metadati dei file con ID |
Recupera i metadati del file da Box usando l'ID file. |
| Ottenere i metadati dei file usando il percorso |
Recupera i metadati del file da Box usando il percorso. |
| Ottenere il contenuto del file con ID |
Recupera il contenuto del file da Box usando l'ID. |
| Ottenere il contenuto del file usando il percorso |
Recupera il contenuto del file da Box usando il percorso. |
Aggiorna file
Aggiorna un file esistente in Box.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
File Id
|
id | True | string |
Identificatore univoco del file da aggiornare in Box. |
|
Contenuto del file
|
body | True | binary |
Contenuto del file da aggiornare in Box. |
Restituisce
Metadati BLOB
- Corpo
- BlobMetadata
Copia file
Copiare un file in un percorso di file in Box.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
URL di origine
|
source | True | string |
URL del file di origine. |
|
Percorso file di destinazione
|
destination | True | string |
Percorso del file di destinazione in Box, incluso il nome file di destinazione. |
|
Sovrascrivere
|
overwrite | boolean |
Sovrascrive il file di destinazione se impostato su 'true'. |
Restituisce
Metadati BLOB
- Corpo
- BlobMetadata
Crea un file
Carica un file in Box.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Percorso cartella
|
folderPath | True | string |
Percorso della cartella per caricare il file in Box. |
|
Nome del file
|
name | True | string |
Nome del file da creare in Box. |
|
Contenuto del file
|
body | True | binary |
Contenuto del file da caricare in Box. |
Restituisce
Metadati BLOB
- Corpo
- BlobMetadata
Elencare file e cartelle nella cartella
Elenca i file e le cartelle in una cartella Box.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID cartella
|
id | True | string |
Identificatore univoco della cartella in Box. |
Restituisce
- response
- array of BlobMetadata
Elencare file e cartelle nella cartella radice
Elimina file
Elimina un file esistente da Box.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
File Id
|
id | True | string |
Identificatore univoco del file da eliminare da Box. |
Estrarre l'archivio nella cartella
Estrae un file di archivio in una cartella in Box (ad esempio: .zip).
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Percorso del file di archivio di origine
|
source | True | string |
Percorso del file di archivio. |
|
Percorso cartella di destinazione
|
destination | True | string |
Percorso in Box per estrarre il contenuto dell'archivio. |
|
Sovrascrivere
|
overwrite | boolean |
Sovrascrive i file di destinazione se impostato su 'true'. |
Restituisce
- response
- array of BlobMetadata
Ottenere i metadati dei file con ID
Recupera i metadati del file da Box usando l'ID file.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
File Id
|
id | True | string |
Identificatore univoco del file in Box. |
Restituisce
Metadati BLOB
- Corpo
- BlobMetadata
Ottenere i metadati dei file usando il percorso
Recupera i metadati del file da Box usando il percorso.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Percorso file
|
path | True | string |
Percorso univoco del file in Box. |
Restituisce
Metadati BLOB
- Corpo
- BlobMetadata
Ottenere il contenuto del file con ID
Recupera il contenuto del file da Box usando l'ID.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
File Id
|
id | True | string |
Identificatore univoco del file in Box. |
|
Dedurre il tipo di contenuto
|
inferContentType | boolean |
Valore booleano (true, false) per dedurre il tipo di contenuto in base all'estensione. |
Restituisce
Contenuto del file.
- Contenuto del file
- binary
Ottenere il contenuto del file usando il percorso
Recupera il contenuto del file da Box usando il percorso.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Percorso file
|
path | True | string |
Percorso univoco del file in Box. |
|
Dedurre il tipo di contenuto
|
inferContentType | boolean |
Valore booleano (true, false) per dedurre il tipo di contenuto in base all'estensione. |
Restituisce
Contenuto del file.
- Contenuto del file
- binary
Trigger
| Quando un file viene modificato (solo proprietà) |
Questa operazione attiva un flusso quando un file viene modificato in una cartella. Il trigger non viene attivato se un file viene aggiunto/aggiornato in una sottocartella. Se è necessario attivare nelle sottocartelle, è necessario creare più trigger. |
| Quando un file viene modificato (solo proprietà) (V2) (anteprima) |
Questa operazione attiva un flusso quando un file viene modificato in una cartella. Il trigger non viene attivato se un file viene aggiunto/aggiornato in una sottocartella. Se è necessario attivare nelle sottocartelle, è necessario creare più trigger. Nel caso in cui l'opzione "Dividi su" sia disattivata per> le esecuzioni di trigger con esito positivo delle impostazioni trigger può produrre una matrice vuota per l'output "Elenco di file". |
| Quando un file viene modificato [DEPRECATO] |
Attiva un flusso quando un file viene modificato in una cartella Box. Il trigger non viene attivato se un file viene aggiunto/aggiornato in una sottocartella. Se è necessario attivare nelle sottocartelle, è necessario creare più trigger. |
| Quando viene creato un file (solo proprietà) (V2) |
Questa operazione attiva un flusso quando viene creato un nuovo file in una cartella. Il trigger non viene attivato se un file viene aggiunto/aggiornato in una sottocartella. Se è necessario attivare nelle sottocartelle, è necessario creare più trigger. Nel caso in cui l'opzione "Dividi su" sia disattivata per> le esecuzioni di trigger con esito positivo delle impostazioni trigger può produrre una matrice vuota per l'output "Elenco di file". |
| Quando viene creato un file (solo proprietà) [DEPRECATO] |
Questa azione è stata deprecata. Usare invece Quando viene creato un file (solo proprietà) (V2).
|
| Quando viene creato un file [DEPRECATO] |
Attiva un flusso quando viene creato un nuovo file in una cartella Box. Il trigger non viene attivato se un file viene aggiunto/aggiornato in una sottocartella. Se è necessario attivare nelle sottocartelle, è necessario creare più trigger. |
Quando un file viene modificato (solo proprietà)
Questa operazione attiva un flusso quando un file viene modificato in una cartella. Il trigger non viene attivato se un file viene aggiunto/aggiornato in una sottocartella. Se è necessario attivare nelle sottocartelle, è necessario creare più trigger.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Cartella
|
folderId | True | string |
Selezionare una cartella |
|
Numero di file da restituire
|
maxFileCount | integer |
Numero massimo di file da restituire in base all'esecuzione di un singolo trigger (1-100). Si noti che l'impostazione "Split On" può forzare l'elaborazione di ogni elemento singolarmente. |
Restituisce
Metadati BLOB
- Elenco di file
- BlobMetadata
Quando un file viene modificato (solo proprietà) (V2) (anteprima)
Questa operazione attiva un flusso quando un file viene modificato in una cartella. Il trigger non viene attivato se un file viene aggiunto/aggiornato in una sottocartella. Se è necessario attivare nelle sottocartelle, è necessario creare più trigger. Nel caso in cui l'opzione "Dividi su" sia disattivata per> le esecuzioni di trigger con esito positivo delle impostazioni trigger può produrre una matrice vuota per l'output "Elenco di file".
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Cartella
|
folderId | True | string |
Selezionare una cartella |
|
Numero di file da restituire
|
maxFileCount | integer |
Numero massimo di file da restituire in base all'esecuzione di un singolo trigger (1-100). Si noti che l'impostazione "Split On" può forzare l'elaborazione di ogni elemento singolarmente. |
Restituisce
Metadati BLOB
- Elenco di file
- BlobMetadata
Quando un file viene modificato [DEPRECATO]
Attiva un flusso quando un file viene modificato in una cartella Box. Il trigger non viene attivato se un file viene aggiunto/aggiornato in una sottocartella. Se è necessario attivare nelle sottocartelle, è necessario creare più trigger.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID cartella
|
folderId | True | string |
Identificatore univoco della cartella in Box. |
|
Dedurre il tipo di contenuto
|
inferContentType | boolean |
Valore booleano (true, false) per dedurre il tipo di contenuto in base all'estensione. |
Restituisce
Contenuto del file.
- Contenuto del file
- binary
Quando viene creato un file (solo proprietà) (V2)
Questa operazione attiva un flusso quando viene creato un nuovo file in una cartella. Il trigger non viene attivato se un file viene aggiunto/aggiornato in una sottocartella. Se è necessario attivare nelle sottocartelle, è necessario creare più trigger. Nel caso in cui l'opzione "Dividi su" sia disattivata per> le esecuzioni di trigger con esito positivo delle impostazioni trigger può produrre una matrice vuota per l'output "Elenco di file".
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Cartella
|
folderId | True | string |
Identificatore univoco della cartella. |
|
Numero di file da restituire
|
maxFileCount | integer |
Numero massimo di file da restituire in base all'esecuzione di un singolo trigger (1-100). Si noti che l'impostazione "Split On" può forzare l'elaborazione di ogni elemento singolarmente. |
Restituisce
Metadati BLOB
- Elenco di file
- BlobMetadata
Quando viene creato un file (solo proprietà) [DEPRECATO]
Questa azione è stata deprecata. Usare invece Quando viene creato un file (solo proprietà) (V2).
Questa operazione attiva un flusso quando viene creato un nuovo file in una cartella. Il trigger non viene attivato se un file viene aggiunto/aggiornato in una sottocartella. Se è necessario attivare nelle sottocartelle, è necessario creare più trigger.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Cartella
|
folderId | True | string |
Identificatore univoco della cartella. |
|
Numero di file da restituire
|
maxFileCount | integer |
Numero massimo di file da restituire in base all'esecuzione di un singolo trigger (1-100). Si noti che l'impostazione "Split On" può forzare l'elaborazione di ogni elemento singolarmente. |
Restituisce
Metadati BLOB
- Elenco di file
- BlobMetadata
Quando viene creato un file [DEPRECATO]
Attiva un flusso quando viene creato un nuovo file in una cartella Box. Il trigger non viene attivato se un file viene aggiunto/aggiornato in una sottocartella. Se è necessario attivare nelle sottocartelle, è necessario creare più trigger.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID cartella
|
folderId | True | string |
Identificatore univoco della cartella in Box. |
|
Dedurre il tipo di contenuto
|
inferContentType | boolean |
Valore booleano (true, false) per dedurre il tipo di contenuto in base all'estensione. |
Restituisce
Contenuto del file.
- Contenuto del file
- binary
Definizioni
BlobMetadata
Metadati BLOB
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
id
|
Id | string |
ID univoco del file o della cartella. |
|
Nome
|
Name | string |
Nome del file o della cartella. |
|
Nome visualizzato
|
DisplayName | string |
Nome visualizzato del file o della cartella. |
|
Percorso
|
Path | string |
Percorso del file o della cartella. |
|
UltimaModifica
|
LastModified | date-time |
Data e ora dell'ultima modifica del file o della cartella. |
|
Misura
|
Size | integer |
Dimensioni del file o della cartella. |
|
Tipo di media
|
MediaType | string |
Tipo di supporto del file o della cartella. |
|
IsFolder
|
IsFolder | boolean |
Valore booleano (true, false) per indicare se il BLOB è o meno una cartella. |
|
ETag
|
ETag | string |
Etag del file o della cartella. |
|
FileLocator
|
FileLocator | string |
Filelocatore del file o della cartella. |
|
UltimaModificaDa
|
LastModifiedBy | string |
Utente che ha modificato il file o la cartella per l'ultima volta. |
binario
Questo è il tipo di dati di base 'binario'.