Sistema di File
Connettersi ai file system nei computer locali o di rete per leggere e scrivere nei file usando il gateway dati locale.
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Servizio | Class | Regions |
|---|---|---|
| Copilot Studio | Normale | Tutte le aree di Power Automate |
| App per la logica | Normale | Tutte le aree di App per la logica |
| Power Apps | Normale | Tutte le aree di Power Apps |
| Power Automate | Normale | Tutte le aree di Power Automate |
| Contatto | |
|---|---|
| Nome | Microsoft |
| URL |
Supporto di Microsoft LogicApps Supporto di Microsoft Power Automate Supporto di Microsoft Power Apps |
| Metadati del connettore | |
|---|---|
| Editore | Microsoft |
Approfondimento del connettore
Per altre informazioni sul connettore, vedere la sezione dettagliata.
Problemi noti e limitazioni
- In alcuni casi, quando un file viene aggiunto o modificato (solo proprietà) e Quando viene creato un file (solo proprietà) i trigger possono ritardare la restituzione immediata dei file e posticipare i file appena creati/modificati per l'esecuzione successiva del trigger. Ciò significa che il trigger non garantisce la restituzione di tutti i file in una singola esecuzione quando l'opzione "Split On" è disabilitata.
Limiti generali
| Nome | Value |
|---|---|
| Dimensioni massime del file per le operazioni generali (in MB) | 30 |
| Dimensioni massime del file per l'operazione di creazione file (in MB) | 20 |
| Timeout connessione gateway dati locale (in secondi) | 30 |
| 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 |
Creazione di una connessione
Il connettore supporta i tipi di autenticazione seguenti:
| Predefinita | Parametri per la creazione della connessione. | Tutte le aree geografiche | Non condivisibile |
Predefinito
Applicabile: tutte le aree
Parametri per la creazione della connessione.
Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.
| Nome | TIPO | Description | Obbligatorio |
|---|---|---|---|
| Cartella radice | corda | Percorso della cartella radice (esempi: \MACHINE\myShare o C:\myShare) | Vero |
| Tipo di autenticazione | corda | Tipo di autenticazione per la connessione al computer gateway | |
| Nome utente | securestring | Credenziali del nome utente (ad esempio DOMAIN\Username) | Vero |
| Parola chiave | securestring | Credenziali password | Vero |
| Gateway | gatewaySetting | Gateway locale (vedere https://docs.microsoft.com/data-integration/gateway per altri dettagli |
Limiti per la limitazione delle richieste
| Nome | Chiamate | Periodo di rinnovo |
|---|---|---|
| Chiamate API per connessione | 100 | 60 secondi |
Azioni
| Aggiorna file |
Questa operazione aggiorna un file. |
| Aggiungi file |
Questa operazione aggiunge i dati a un file. |
| Copia file |
Questa operazione copia un file in un file system. |
| Crea un file |
Questa operazione crea un file. Se il file esiste già, il contenuto esistente viene sostituito. |
| Elencare i file nella cartella |
Questa operazione ottiene l'elenco di file e sottocartelle in una cartella. |
| Elencare i file nella cartella radice |
Questa operazione ottiene l'elenco di file e sottocartelle nella cartella radice. |
| Elimina file |
Questa operazione elimina un file. |
| Estrarre l'archivio nella cartella |
Questa operazione estrae un file di archivio in una cartella ,ad esempio .zip. |
| Ottenere i metadati dei file usando il percorso |
Questa operazione ottiene i metadati di un file usando il percorso. |
| Ottenere il contenuto del file usando il percorso |
Questa operazione ottiene il contenuto di un file usando il percorso. |
| Ottieni contenuto del file |
Questa operazione ottiene il contenuto di un file. |
| Ottieni metadati del file |
Questa operazione ottiene i metadati per un file. |
| Rinominare file |
Questa operazione rinomina un file. |
Aggiorna file
Questa operazione aggiorna un file.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
File
|
id | True | string |
Selezionare un file |
|
Contenuto del file
|
body | True | binary |
Contenuto del file |
Restituisce
Metadati BLOB
- Corpo
- BlobMetadata
Aggiungi file
Questa operazione aggiunge i dati a un file.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
File
|
id | True | string |
Selezionare un file |
|
Contenuto del file
|
body | True | binary |
Contenuto da aggiungere al file |
Restituisce
Metadati BLOB
- Corpo
- BlobMetadata
Copia file
Questa operazione copia un file in un file system.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Percorso di origine
|
source | True | string |
Percorso del file di origine |
|
Percorso del file di destinazione
|
destination | True | string |
Percorso del file di destinazione, 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
Questa operazione crea un file. Se il file esiste già, il contenuto esistente viene sostituito.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Percorso cartella
|
folderPath | True | string |
Selezionare una cartella |
|
Nome del file
|
name | True | string |
Nome del file |
|
Contenuto del file
|
body | True | binary |
Contenuto del file |
Restituisce
Metadati BLOB
- Corpo
- BlobMetadata
Elencare i file nella cartella
Questa operazione ottiene l'elenco di file e sottocartelle in una cartella.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Cartella
|
id | True | string |
Selezionare una cartella |
Restituisce
- response
- array of BlobMetadata
Elencare i file nella cartella radice
Questa operazione ottiene l'elenco di file e sottocartelle nella cartella radice.
Restituisce
- response
- array of BlobMetadata
Elimina file
Questa operazione elimina un file.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
File
|
id | True | string |
Selezionare un file |
Estrarre l'archivio nella cartella
Questa operazione estrae un file di archivio in una cartella ,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 della cartella di destinazione |
|
Sovrascrivere?
|
overwrite | boolean |
Sovrascrive i file di destinazione se impostato su 'true' |
Restituisce
- response
- array of BlobMetadata
Ottenere i metadati dei file usando il percorso
Questa operazione ottiene i metadati di un file usando il percorso.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Percorso del file
|
path | True | string |
Selezionare un file |
Restituisce
Metadati BLOB
- Corpo
- BlobMetadata
Ottenere il contenuto del file usando il percorso
Questa operazione ottiene il contenuto di un file usando il percorso.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Percorso del file
|
path | True | string |
Selezionare un file |
|
Dedurre il tipo di contenuto
|
inferContentType | boolean |
Dedurre il tipo di contenuto in base all'estensione |
Restituisce
Contenuto del file.
- Contenuto del file
- binary
Ottieni contenuto del file
Questa operazione ottiene il contenuto di un file.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
File
|
id | True | string |
Selezionare un file |
|
Dedurre il tipo di contenuto
|
inferContentType | boolean |
Dedurre il tipo di contenuto in base all'estensione |
Restituisce
Contenuto del file.
- Contenuto del file
- binary
Ottieni metadati del file
Questa operazione ottiene i metadati per un file.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
File
|
id | True | string |
Selezionare un file |
Restituisce
Metadati BLOB
- Corpo
- BlobMetadata
Rinominare file
Questa operazione rinomina un file.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
File
|
id | True | string |
Selezionare un file |
|
Nuovo nome
|
newName | True | string |
Nuovo nome per il file |
Restituisce
Rappresenta la risposta ai metadati dei set di dati BLOB
- Corpo
- BlobMetadataResponse
Trigger
| Quando un file viene aggiunto o modificato (solo proprietà) |
Questa operazione attiva un flusso quando uno o più file vengono aggiunti o modificati 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 viene creato un file (solo proprietà) |
Questa operazione attiva un flusso quando uno o più file vengono creati 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 aggiunto o modificato (solo proprietà)
Questa operazione attiva un flusso quando uno o più file vengono aggiunti o modificati 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. |
|
|
Controllare l'ora di creazione e modifica
|
checkBothCreatedAndModifiedDateTime | boolean |
Se il flag è impostato su true, il trigger verificherà la data e l'ora di creazione del file e la data e l'ora dell'ultima modifica del file. Se il flag è impostato su false, il trigger verificherà solo la data e l'ora dell'ultima modifica del file. |
Restituisce
Metadati BLOB
- Elenco di file
- BlobMetadata
Quando viene creato un file (solo proprietà)
Questa operazione attiva un flusso quando uno o più file vengono creati 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
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. |
BlobMetadataResponse
Rappresenta la risposta ai metadati dei set di dati 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. |
binario
Questo è il tipo di dati di base 'binario'.