Connessione a un file server SFTP dai flussi di lavoro in App per la logica di Azure
Si applica a: App per la logica di Azure (consumo + standard)
Questa guida pratica illustra come accedere al server SSH File Transfer Protocol (SFTP) da un flusso di lavoro in App per la logica di Azure. SFTP è un protocollo di rete che fornisce l'accesso ai file, il trasferimento di file e la gestione dei file su qualsiasi flusso di dati affidabile e usa il protocollo Secure Shell (SSH).
Nei flussi di lavoro delle app per la logica a consumo è possibile usare il connettore gestito SFTP-SSH, mentre nei flussi di lavoro dell'app per la logica Standard è possibile usare il connettore predefinito SFTP o il connettore gestito SFTP-SSH. È possibile usare queste operazioni del connettore per creare flussi di lavoro automatizzati eseguiti quando vengono attivati da eventi nel server SFTP o in altri sistemi ed eseguire azioni per gestire i file nel server SFTP. Sia i connettori gestiti che predefiniti usano il protocollo SSH.
Nota
Il connettore gestito SFTPè stato deprecato, quindi le operazioni di questo connettore non vengono più visualizzate nella finestra di progettazione del flusso di lavoro.
Ad esempio, il flusso di lavoro può iniziare con un trigger SFTP che monitora e risponde agli eventi nel server SFTP. Il trigger rende gli output disponibili per le azioni successive nel flusso di lavoro. Il flusso di lavoro può eseguire azioni SFTP che ottengono, creano e gestiscono file tramite l'account del server SFTP. L'elenco seguente include altre attività di esempio:
- Monitorare quando i file vengono aggiunti o modificati.
- Ottenere, creare, copiare, rinominare, aggiornare, creare elenchi ed eliminare file.
- Creare cartelle.
- Leggere contenuti e metadati dei file.
- Estrarre archivi nella cartella.
I passaggi seguenti usano il portale di Azure, ma con l'estensione App per la logica di Azure appropriata, è anche possibile usare gli strumenti seguenti per creare e modificare i flussi di lavoro dell'app per la logica:
Flussi di lavoro delle app per la logica a consumo: Visual Studio o Visual Studio Code
Flussi di lavoro dell'app per la logica standard: Visual Studio Code
Riferimento tecnico Connessione or
Il connettore SFTP ha versioni diverse, in base al tipo di app per la logica e all'ambiente host.
| Tipo di app per la logica (piano) | Ambiente | versione di Connessione or |
|---|---|---|
| Consumo | App per la logica di Azure multi-tenant | Connettore gestito, visualizzato nella finestra di progettazione sotto l'etichetta Standard . Per altre informazioni, vedere la documentazione seguente: - Informazioni di riferimento sul connettore gestito SFTP-SSH - Connettori gestiti in App per la logica di Azure |
| Consumo | Ambiente del servizio di integrazione | Connettore gestito, visualizzato nella finestra di progettazione sotto l'etichetta Standard e la versione I edizione Standard, visualizzata nella finestra di progettazione con l'etichetta I edizione Standard e presenta limiti di messaggio diversi rispetto al connettore gestito. Per altre informazioni, vedere la documentazione seguente: - Informazioni di riferimento sul connettore gestito SFTP-SSH - I edizione Standard limiti dei messaggi - 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 connettori in Runtime>Condiviso e connettore predefinito, visualizzato nella raccolta connettori in Runtime>in-App ed è basato sul provider di servizi. Il connettore predefinito può connettersi direttamente a un server SFTP e accedere alle reti virtuali di Azure usando un stringa di connessione senza un gateway dati locale. Per altre informazioni, vedere la documentazione seguente: - Informazioni di riferimento sul connettore gestito SFTP-SSH - Informazioni di riferimento sul connettore predefinito SFTP - Connettori gestiti in App per la logica di Azure - Connettori predefiniti in App per la logica di Azure |
Limitazioni generali
Prima di usare il connettore gestito SFTP-SSH, esaminare i problemi noti e le limitazioni nel riferimento al connettore gestito SFTP-SSH.
Prima di usare il connettore predefinito SFTP, esaminare i problemi noti e le limitazioni nel riferimento al connettore predefinito SFTP.
Problemi noti
Per impostazione predefinita, i trigger che restituiscono una matrice hanno un'impostazione Split On già abilitata. Con questa impostazione abilitata, il trigger discute automaticamente la matrice creando internamente un'istanza del flusso di lavoro separata per elaborare ogni elemento della matrice. Tutte le istanze del flusso di lavoro vengono eseguite in parallelo in modo che gli elementi della matrice vengano elaborati contemporaneamente.
Tuttavia, quando l'impostazione Split On è abilitata, i trigger del connettore gestito restituiscono gli output per tutti gli elementi della matrice come elenchi. Tutte le azioni successive che fanno riferimento a questi output devono prima gestire questi output come elenchi. Per gestire singolarmente ogni elemento di matrice, è possibile aggiungere azioni aggiuntive. Ad esempio, per scorrere questi elementi di matrice, è possibile usare un ciclo For each . Per i trigger che restituiscono solo metadati o proprietà, usare un'azione che ottiene prima i metadati dell'elemento della matrice e quindi usare un'azione per ottenere il contenuto degli elementi.
È necessario applicare questo approccio solo per i trigger del connettore gestito , non per i trigger del connettore predefiniti che restituiscono output per un elemento di matrice alla volta quando l'impostazione Split On è abilitata.
Si supponga, ad esempio, di avere un trigger del connettore gestito denominato Quando un file viene aggiunto o modificato (solo proprietà) che restituisce i metadati o le proprietà per i file nuovi o aggiornati come matrici. Per ottenere i metadati separatamente per ogni file, è possibile usare un ciclo For each che scorre la matrice. In questo ciclo usare le azioni del connettore gestito seguenti nell'ordine specificato:
Ottenere i metadati del file per ottenere i metadati di ogni file.
Ottenere l'azione relativa al contenuto del file per ottenere il contenuto di ogni file.
Suddivisione in blocchi
Per altre informazioni su come il connettore gestito SFTP-SSH può gestire file di grandi dimensioni che superano i limiti di dimensioni predefinite, vedere Riferimento al connettore gestito SFTP-SSH - Suddivisione in blocchi.
Prerequisiti
Account e sottoscrizione di Azure. Se non si ha una sottoscrizione di Azure, iscriversi per creare un account Azure gratuito.
Connessione e le informazioni di autenticazione per accedere al server SFTP, ad esempio l'indirizzo del server, le credenziali dell'account, l'accesso a una chiave privata SSH e la password della chiave privata SSH. Per altre informazioni, vedere Informazioni di riferimento sul connettore gestito SFTP-SSH - Autenticazione e autorizzazioni.
Importante
Quando si crea la connessione e si immette la chiave privata SSH nella proprietà chiave privata SSH, assicurarsi di seguire la procedura per fornire il valore completo e corretto per questa proprietà. In caso contrario, una chiave non valida causa l'esito negativo della connessione.
Flusso di lavoro dell'app per la logica in cui si vuole accedere all'account SFTP. Per iniziare con un trigger SFTP-SSH, è necessario iniziare con un flusso di lavoro vuoto. Per usare un'azione SFTP-SSH, avviare il flusso di lavoro con un altro trigger, ad esempio il trigger Ricorrenza .
Aggiungere un trigger SFTP
Nella portale di Azure aprire l'app per la logica a consumo con un flusso di lavoro vuoto nella finestra di progettazione.
Nella finestra di progettazione seguire questa procedura generale per aggiungere il trigger SFTP-SSH desiderato.
Se richiesto, specificare le informazioni di connessione necessarie. Al termine, seleziona Crea.
Dopo aver visualizzato la casella delle informazioni sul trigger, specificare i dettagli necessari per il trigger selezionato. Per altre informazioni, vedere Informazioni di riferimento sui trigger del connettore gestito SFTP-SSH.
Al termine, salvare il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione seleziona Salva.
Quando si salva il flusso di lavoro, questo passaggio pubblica automaticamente gli aggiornamenti nell'app per la logica distribuita, disponibile in Azure. Con solo un trigger, il flusso di lavoro controlla solo il server FTP in base alla pianificazione specificata. È necessario aggiungere un'azione che risponde al trigger ed esegue un'operazione con gli output del trigger.
Ad esempio, il trigger denominato Quando un file viene aggiunto o modificato avvia un flusso di lavoro quando un file viene aggiunto o modificato in un server SFTP. Come azione successiva, è possibile aggiungere una condizione che controlla se il contenuto del file soddisfa i criteri specificati. Se il contenuto soddisfa la condizione, usare l'azione Get file content (Recupera contenuto file) per ottenere il contenuto del file e quindi usare un'altra azione per inserire il contenuto del file in una cartella diversa nel server SFTP.
Aggiungere un'azione SFTP
Prima di poter usare un'azione SFTP, il flusso di lavoro deve già iniziare con un trigger, che può essere qualsiasi tipo scelto. Ad esempio, è possibile usare il trigger predefinito Ricorrenza generica per avviare il flusso di lavoro in base a una pianificazione specifica.
Nella portale di Azure aprire l'app per la logica a consumo con il flusso di lavoro nella finestra di progettazione.
Nella finestra di progettazione seguire questa procedura generale per aggiungere l'azione SFTP-SSH desiderata.
Se richiesto, specificare le informazioni di connessione necessarie. Al termine, seleziona Crea.
Dopo aver visualizzato la casella delle informazioni sull'azione, specificare i dettagli necessari per l'azione selezionata. Per altre informazioni, vedere Informazioni di riferimento sulle azioni del connettore gestito SFTP-SSH.
Al termine, salvare il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione seleziona Salva.
Ad esempio, l'azione get file content using path ottiene il contenuto da un file in un server SFTP specificando il percorso del file. È possibile usare il trigger dell'esempio precedente e una condizione che il contenuto del file deve soddisfare. Se la condizione è true, un'azione successiva può ottenere il contenuto.
Risoluzione dei problemi
Per altre informazioni, consultare la documentazione seguente:
- Informazioni di riferimento sul connettore gestito SFTP-SSH - Risoluzione dei problemi
- Informazioni di riferimento sul connettore predefinito SFTP - Risoluzione dei problemi