Connettersi ai file system locali dai flussi di lavoro in App per la logica di Azure
Si applica a: App per la logica di Azure (a consumo e standard)
Questa guida pratica illustra come accedere a una condivisione file locale da un flusso di lavoro in App per la logica di Azure usando il connettore File System. È quindi possibile creare dei flussi di lavoro automatizzati, che vengono eseguiti quando sono attivati da eventi nella condivisione file o in altri sistemi, ed eseguono azioni per gestire i file. Il connettore offre le funzionalità seguenti:
- Creare, leggere, accodare, aggiornare ed eliminare file.
- Elencare i file in cartelle o in cartelle radice.
- Leggere contenuti e metadati dei file.
In questa guida pratica gli scenari di esempio illustrano le attività seguenti:
- Attivare un flusso di lavoro quando un file viene creato o aggiunto a una condivisione file e quindi inviare un messaggio di posta elettronica.
- Attivare un flusso di lavoro durante la copia di un file da un account Dropbox a una condivisione file e quindi inviare un messaggio di posta elettronica.
Limitazioni e problemi noti
- Il connettore file system supporta attualmente solo i file system Windows nei sistemi operativi Windows.
- Le unità di rete mappate non sono supportate.
Informazioni tecniche sul connettore
Il connettore File system ha versioni diverse, in base al tipo di app per la logica e all'ambiente host.
| App per la logica | Ambiente | Versione del connettore |
|---|---|---|
| Consumo | App per la logica di Azure multi-tenant | Connettore gestito, visualizzato nella raccolta di connettori in Runtime>Condiviso. Per altre informazioni, vedere la documentazione seguente: - Informazioni di riferimento sul connettore gestito del file system - Connettori gestiti in App per la logica di Azure |
| Standard | App per la logica di Azure a tenant singolo e ambiente del servizio app v3 (solo piani di Windows) | Connettore gestito, visualizzato nella raccolta dei connettori in Runtime>Condiviso e connettore predefinito, visualizzato nella raccolta dei connettori in Runtime>in-App ed è basato sul provider di servizi. Il connettore predefinito è diverso nei modi seguenti: - Il connettore predefinito supporta solo le app per la logica Standard eseguite in un ambiente del servizio app v3 solo con piani di Windows. - La versione predefinita può connettersi direttamente a una condivisione file e accedere alle reti virtuali di Azure usando una stringa di connessione senza un gateway dati locale. Per altre informazioni, vedere la documentazione seguente: - Informazioni di riferimento sul connettore gestito del file system - Informazioni di riferimento sul connettore predefinito per il file system - Connettori predefiniti in App per la logica di Azure |
Prerequisiti
Account e sottoscrizione di Azure. Se non si ha una sottoscrizione di Azure, iscriversi per creare un account Azure gratuito.
Per connettersi alla condivisione file, si applicano requisiti diversi, in base all'app per la logica e all'ambiente di hosting:
Flussi di lavoro delle app per la logica A consumo
In App per la logica di Azure multi-tenant è necessario soddisfare i requisiti seguenti, se non è già stato fatto:
Installare il gateway dati locale in un computer locale.
Il connettore gestito del file system richiede che l'installazione del gateway e il server di file system esistano nello stesso dominio Windows.
Dopo aver aggiunto un trigger o un'azione del connettore gestito del file system al flusso di lavoro, selezionare la risorsa del gateway dati creata in precedenza in modo da potersi connettere al file system.
Flussi di lavoro dell'app per la logica Standard
È possibile usare il connettore predefinito di File system o il connettore gestito.
Per usare il connettore gestito file system, seguire gli stessi requisiti di un flusso di lavoro dell'app per la logica A consumo in App per la logica di Azure multi-tenant.
Per usare il connettore predefinito file system, il flusso di lavoro dell'app per la logica Standard deve essere eseguito nell'ambiente del servizio app v3, ma non richiede la risorsa gateway dati.
Accesso al computer con il file system che si vuole usare. Ad esempio, se si installa il gateway dati nello stesso computer come file system, saranno necessarie le credenziali dell'account per quel computer.
Per seguire lo scenario di esempio in questa guida pratica, è necessario un account di posta elettronica di un provider supportato da App per la logica di Azure, ad esempio Office 365 Outlook, Outlook.com o Gmail. Per altri provider, vedere altri connettori di posta elettronica supportati. Questo esempio usa il connettore Office 365 Outlook con un account aziendale o dell'istituto di istruzione. Se si usa un altro account di posta elettronica, la procedura generale resta invariata, ma l'interfaccia utente potrebbe essere leggermente diversa.
Importante
Se si vuole usare il connettore Gmail, solo gli account G Suite Business possono usare questo connettore senza restrizioni nelle app per la logica. Se si dispone di un account Gmail consumer, è possibile usare questo connettore solo con servizi approvati da Google specifici oppure è possibile creare un'app client Google da usare per l'autenticazione con il connettore Gmail. Per altre informazioni, vedere Informative sulla privacy e sulla sicurezza dei dati per i connettori Google in App per la logica di Azure.
Per lo scenario di azione file system di esempio, è necessario un account Dropbox, a cui è possibile iscriversi gratuitamente.
Flusso di lavoro dell'app per la logica in cui si desidera accedere alla condivisione file. Per avviare il flusso di lavoro con un trigger del File system, è necessario iniziare con un flusso di lavoro vuoto. Per aggiungere un'azione File System, avviare il flusso di lavoro con qualsiasi trigger.
Aggiungere un trigger del file system
Nel portale di Azure, aprire il flusso di lavoro dell'app per la logica vuota nella finestra di progettazione.
Nella finestra di progettazione, seguire questa procedura generale per aggiungere il trigger file system che si vuole eseguire al flusso di lavoro.
Per altre informazioni, vedere Trigger File system. Questo esempio continua con il trigger denominato Quando viene creato un file.
Nella casella informazioni di connessione specificare le informazioni seguenti in base alle esigenze:
Proprietà Richiesto Valore Descrizione Nome connessione Sì <nome connessione> Nome da usare per la connessione Cartella radice Sì <root-folder-name> La cartella radice per il file system, che è in genere la cartella padre principale ed è la cartella usata per i percorsi relativi con tutti i trigger che funzionano sui file.
Ad esempio, se è stato installato il gateway dati locale, usare la cartella locale nel computer con l'installazione del gateway dati. In alternativa, usare la cartella per la condivisione di rete in cui il computer può accedere a tale cartella, ad esempio\\PublicShare\\MyFileSystem.Tipo di autenticazione No <auth-type> Tipo di autenticazione usato dal server del file system, ovvero Windows Nome utente Sì <dominio e nome utente> Dominio e nome utente per il computer in cui si dispone del file system.
Per il connettore file system gestito, usare uno dei valori seguenti con la barra rovesciata (\):
- <domain>\<username>
- <local-computer>\<username>
Ad esempio, se la cartella del file system si trova nello stesso computer dell'installazione del gateway dati locale, è possibile usare <computer locale>\<nome utente>.Password Sì <password> La password per il computer in cui è presente il file system gateway No - <Sottoscrizione di Azure>
- <gateway-resource-name>Questa sezione si applica solo al connettore del file system gestito:
- Sottoscrizione: sottoscrizione di Azure associata alla risorsa gateway dati
- Gateway di connessione: risorsa gateway datiL'esempio seguente mostra le informazioni di connessione per il trigger del connettore gestito del file system:
Al termine, seleziona Crea.
App per la logica di Azure crea e testa la connessione, assicurandosi che la connessione funzioni correttamente. Se la connessione è configurata correttamente, vengono visualizzate le opzioni di installazione per il trigger selezionato.
Continuare a creare il flusso di lavoro.
Specificare le informazioni richieste per il trigger.
Per questo esempio, selezionare il percorso della cartella nel file system server per verificare la presenza di un file appena creato. Specificare il numero di file da restituire e la frequenza di controllo.
Per testare il flusso di lavoro, aggiungere un'azione di Outlook che invia un messaggio di posta elettronica quando viene creato un file nel file system nella cartella specificata. Immettere i destinatari, l'oggetto e il corpo del messaggio di posta elettronica. Ai fini del test è possibile indicare il proprio indirizzo e-mail.
Suggerimento
Per aggiungere output dei passaggi precedenti nel flusso di lavoro, selezionare all'interno delle caselle di modifica del trigger. Quando viene visualizzato l'elenco di contenuto dinamico, selezionare tra gli output disponibili.
Al termine, salvare il flusso di lavoro.
Per testare il flusso di lavoro, caricare un file che attiva il flusso di lavoro.
In caso di esito positivo, il flusso di lavoro invia un messaggio di posta elettronica sul nuovo file.
Aggiungere un'azione file system
Il flusso di lavoro dell'app per la logica di esempio inizia con il trigger Dropbox, ma è possibile usare qualsiasi trigger desiderato.
Nel portale di Azure, aprire il flusso di lavoro dell'app per la logica nella finestra di progettazione.
Nella finestra di progettazione seguire questa procedura generale per aggiungere l'azione File System che si vuole eseguire per il flusso di lavoro.
Per altre informazioni, vedere Trigger File system. Questo esempio continua con l'azione denominata Crea file.
Nella casella informazioni di connessione specificare le informazioni seguenti in base alle esigenze:
Proprietà Richiesto Valore Descrizione Nome connessione Sì <nome connessione> Nome da usare per la connessione Cartella radice Sì <root-folder-name> La cartella radice per il file system, che è in genere la cartella padre principale ed è la cartella usata per i percorsi relativi con tutti i trigger che funzionano sui file.
Ad esempio, se è stato installato il gateway dati locale, usare la cartella locale nel computer con l'installazione del gateway dati. In alternativa, usare la cartella per la condivisione di rete in cui il computer può accedere a tale cartella, ad esempio\\PublicShare\\MyFileSystem.Tipo di autenticazione No <auth-type> Tipo di autenticazione usato dal server del file system, ovvero Windows Nome utente Sì <dominio e nome utente> Dominio e nome utente per il computer in cui si dispone del file system.
Per il connettore file system gestito, usare uno dei valori seguenti con la barra rovesciata (\):
- <domain>\<username>
- <local-computer>\<username>
Ad esempio, se la cartella del file system si trova nello stesso computer dell'installazione del gateway dati locale, è possibile usare <computer locale>\<nome utente>.Password Sì <password> La password per il computer in cui è presente il file system gateway No - <Sottoscrizione di Azure>
- <gateway-resource-name>Questa sezione si applica solo al connettore del file system gestito:
- Sottoscrizione: sottoscrizione di Azure associata alla risorsa gateway dati
- Gateway di connessione: risorsa gateway datiL'esempio seguente mostra le informazioni di connessione per l'azione connettore gestito del file system:
Al termine, seleziona Crea.
App per la logica di Azure crea e testa la connessione, assicurandosi che la connessione funzioni correttamente. Se la connessione è configurata correttamente, vengono visualizzate le opzioni di installazione per l'azione selezionata.
Continuare a creare il flusso di lavoro.
Specificare le informazioni richieste per l'azione.
Per questo esempio, selezionare il percorso della cartella nel file system da usare, che è la cartella radice qui. Immettere il nome e il contenuto del file, in base al file caricato in Dropbox.
Suggerimento
Per aggiungere output dei passaggi precedenti nel flusso di lavoro, selezionare all'interno delle caselle di modifica dell'azione. Quando viene visualizzato l'elenco di contenuto dinamico, selezionare tra gli output disponibili.
Per testare il flusso di lavoro, aggiungere un'azione di Outlook che invia un messaggio di posta elettronica quando l'azione File System crea un file. Immettere i destinatari, l'oggetto e il corpo del messaggio di posta elettronica. Ai fini del test è possibile indicare il proprio indirizzo e-mail.
Al termine, salvare il flusso di lavoro.
Per testare il flusso di lavoro, caricare un file che attiva il flusso di lavoro.
In caso di esito positivo, il flusso di lavoro crea un file nel file system, in base al file caricato in DropBox e invia un messaggio di posta elettronica sul file creato.
