Introduzione al connettore SFTPGet started with the SFTP connector

Usare il connettore SFTP per accedere a un account SFTP al fine di inviare e ricevere file.Use the SFTP connector to access an SFTP account to send and receive files. È possibile eseguire varie operazioni come creare, aggiornare, recuperare o eliminare file.You can perform various operations such as create, update, get or delete files.

Per usare qualsiasi connettore, è necessario innanzitutto creare un'app per la logica.To use any connector, you first need to create a logic app. Come prima operazione creare un'app per la logica.You can get started by creating a logic app now.

Connettersi a SFTPConnect to SFTP

Perché l'app per la logica possa accedere a qualsiasi servizio, è necessario creare una connessione al servizio.Before your logic app can access any service, you first need to create a connection to the service. Una connessione fornisce la connettività tra un'app per la logica e un altro servizio.A connection provides connectivity between a logic app and another service.

Creare una connessione a SFTPCreate a connection to SFTP

PrerequisitiPrerequisites

Prima di poter usare l'account SFTP in un'app per la logica, è necessario autorizzare l'app per la logica a connettersi a tale account.Before you can use your SFTP account in a logic app, you must authorize the logic app to connect to your SFTP account. Fortunatamente, è possibile eseguire questa operazione in modo facile dalla propria app per la logica nel portale di Azure.Fortunately, you can do this easily from within your logic app on the Azure Portal.

Ecco i passaggi per autorizzare l'app per la logica a connettersi all'account SFTP:Here are the steps to authorize your logic app to connect to your SFTP account:

  1. Per creare una connessione a SFTP, nella finestra di progettazione dell'app per la logica selezionare Mostra API gestite da Microsoft nell'elenco a discesa, quindi immettere SFTP nella casella di ricerca.To create a connection to SFTP, in the logic app designer, select Show Microsoft managed APIs in the drop down list then enter SFTP in the search box. Selezionare il trigger SFTP - Quando viene aggiunto o modificato un file:Select the SFTP - When a file is added or modified trigger:
    Immagine di connessione online a SFTP 1SFTP online connection image 1
  2. Se non sono mai state create connessioni a SFTP prima d'ora, verrà chiesto di fornire le relative credenziali.If you haven't created any connections to SFTP before, you'll get prompted to provide your SFTP credentials. Queste credenziali verranno usate per autorizzare l'app per la logica a connettersi e ad accedere ai dati dell'account SFTP:These credentials will be used to authorize your logic app to connect to, and access your SFTP account's data:
    Immagine di connessione online a SFTP 2
  3. Si noti che la connessione è stata creata ed è ora possibile procedere con gli altri passaggi nell'app per la logica:Notice the connection has been created and you are now free to proceed with the other steps in your logic app:
    Immagine di connessione online a SFTP 3

Usare un trigger SFTPUse an SFTP trigger

Un trigger è un evento che può essere usato per avviare il flusso di lavoro definito in un'app per la logica.A trigger is an event that can be used to start the workflow defined in a logic app. Altre informazioni sui trigger.Learn more about triggers.

In questo esempio il trigger SFTP - Quando viene aggiunto o modificato un file viene usato per avviare un flusso di lavoro dell'app per la logica quando viene aggiunto o modificato un file in un server SFTP.In this example, the SFTP - When a file is added or modified trigger is used to initiate a logic app workflow when a file is added to, or modified on, an SFTP server. Viene aggiunta anche una condizione che controlla il contenuto del file nuovo o modificato e decide di estrarre il file se il relativo contenuto indica che il file deve essere estratto prima di usare il contenuto.You also add a condition that checks the contents of the new or modified file, and makes a decision to extract the file if its contents indicate that it should be extracted before using the contents. Viene infine aggiunta un'azione per estrarre il contenuto di un file e inserire il contenuto estratto in una cartella sul server SFTP.Finally, add an action to extract the contents of a file, and place the extracted contents in a folder on the SFTP server.

In un esempio riguardante un'organizzazione si potrebbe usare questo trigger per monitorare una cartella SFTP per nuovi file di ordini dei clienti.In an enterprise example, you could use this trigger to monitor an SFTP folder for new files that represent customer orders. È quindi possibile usare un'azione connettore SFTP come Recuperare i contenuti del file per recuperare il contenuto dell'ordine per elaborarlo ulteriormente e archiviarlo nel database degli ordini.You could then use an SFTP connector action, such as Get file content, to get the contents of the order for further processing and storage in an orders database.

Aggiungere un trigger.Let's add a trigger.

  1. Immettere sftp nella casella di ricerca della finestra di progettazione delle app per la logica, quindi selezionare il trigger SFTP - Quando viene aggiunto o modificato un file.Enter sftp in the search box on the logic apps designer then select the SFTP - When a file is added or modified trigger
    Immagine di trigger SFTP 1SFTP trigger image 1
  2. Il controllo Quando viene aggiunto o modificato un file viene visualizzato.The When a file is added or modified control opens up
    Immagine di trigger SFTP 2SFTP trigger image 2
  3. Selezionare ... sul lato destro del controllo.Select the ... located on the right side of the control. Viene visualizzato il controllo di selezione della cartella.This opens the folder picker control
    Immagine di trigger SFTP 3SFTP trigger image 3
  4. Selezionare SFTP per scegliere la cartella principale da monitorare per la presenza di file nuovi o modificati.Select the SFTP to select the root folder as the folder to monitor for new or modified files. Tenere presente che ora la cartella principale viene visualizzata nel controllo Cartella .Notice the root folder is now displayed in the Folder control.
    Immagine di trigger SFTP 4SFTP trigger image 4

A questo punto, l'app per la logica è stata configurata con un trigger che avvierà l'esecuzione di altri trigger e altre azioni nel flusso di lavoro quando un file viene modificato o creato nell'apposita cartella SFTP.At this point, your logic app has been configured with a trigger that will begin a run of the other triggers and actions in the workflow when a file is either modified or created in the specific SFTP folder.

Nota

Affinché sia funzionale, l'app per la logica deve contenere almeno un trigger e un'azione.For a logic app to be functional, it must contain at least one trigger and one action. Seguire i passaggi nella sezione successiva per aggiungere un'azione.Follow the steps in the next section to add an action.

Add a conditionAdd a condition

  1. Selezionare + nuovo passaggio per aggiungere l'azione.Select + New step to add the action.
  2. Selezionare il collegamento Aggiungi un'azione .Select the Add an action link. Viene aperta la casella di ricerca per cercare qualsiasi azione si desideri eseguire.This opens the search box where you can search for any action you would like to take. In questo esempio, l'interesse è rivolto alle azioni di SharePoint.For this example, SharePoint actions are of interest.
    Immagine di condizione SFTP 1SFTP condition image 1
  3. Selezionare Scegli un valore a sinistra.Select Choose a value on the left. Immagine di condizione SFTP 2SFTP condition image 2
  4. Selezionare Contenuto file per indicare che si desidera valutare i contenuti del file nella condizione.Select File content to indicate that you want to evaluate the file contents in the condition.
    Immagine di condizione SFTP 3SFTP condition image 3
  5. Selezionare contiene dall'elenco degli operatori.Select contains from the list of operators.
    Immagine di condizione SFTP 4SFTP condition image 4
  6. Selezionare Scegli un valore a destra e immettere ExtractMeFirst.Select Choose a value on the right and enter ExtractMeFirst. In questo esempio, ExtractMeFirst è un valore previsto all'interno di un file da chi ha accesso alla cartella SFTP per indicare che si tratta di un file di archivio da estrarre.In this example, ExtractMeFirst is a value that is expected to be in a file by persons who have access to the SFTP folder to indicate that it is an archive file that should be extracted.
    Immagine di condizione SFTP 5SFTP condition image 5

Usare un'azione SFTPUse an SFTP action

Un'azione è un'operazione eseguita dal flusso di lavoro e definita in un'app per la logica.An action is an operation carried out by the workflow defined in a logic app. Altre informazioni sulle azioni.Learn more about actions.

Una volta aggiunto un trigger, è possibile svolgere delle operazioni interessanti con i dati generati dal trigger.Now that you have added a trigger, its time to do something interesting with the data that's generated by the trigger. Attenersi alla procedura seguente per aggiungere un'azione SFTP - Estrai cartella .Follow these steps to add a the SFTP - extract folder action. Questa azione consente di estrarre i contenuti di un file se le condizioni impostate vengono soddisfatte.This action will extract the contents of a file if the conditions defined are met.

Per configurare questa azione, è necessario fornire le informazioni indicate di seguito.To configure the this action, you will need to provide the following information. Si noterà che è facile usare i dati generati dal trigger come input per alcune proprietà del nuovo file:You will notice that it is easy to use data generated by the trigger as input for some of the properties for the new file:

SFTP - Proprietà della cartella di estrazioneSFTP - extract folder property DescrizioneDescription
Percorso file di archiviazione di origineSource archive file path Si tratta del percorso del file estratto.This is the path for the file being extracted. È possibile selezionare uno dei token da un'azione precedente o esplorare il server SFTP per trovare il percorso del file.You can select one of the tokens from an earlier action or browse the SFTP server to find the file path.
Percorso cartella di destinazioneDestination folder path Questo è il percorso in cui verranno posizionati i file estratti.This is the path where the extracted files will be placed. È possibile selezionare uno dei token da un'azione precedente come percorso di destinazione oppure esplorare il server SFTP e selezionare un percorso.You can select one of the tokens from an earlier action as the destination path or browse the SFTP server and select a path.
Sovrascrivere?Overwrite? Se nel percorso della cartella di destinazione è presente un file con lo stesso nome del file estratto, questo messaggio indica che è possibile sovrascrivere il file esistente.Indicates if a file with the same name as the extracted file is found in the destination folder path if the existing file should be overwritten or not.

Iniziamo aggiungendo l'azione per estrarre i file se la condizione definita in precedenza restituisce il valore True.Let's get started adding the action to extract the files if the condition defined earlier evaluates to True.

  1. Selezionare Aggiungi un'azione.Select Add an action.
    Immagine di condizione dell'azione SFTP 6SFTP action condition image 6
  2. Selezionare l'azione SFTP - Estrai cartellaSelect the SFTP - Extract folder action
    Immagine di condizione dell'azione SFTP 7SFTP action condition image 7
  3. Selezionare Percorso file di archiviazione di origine Select Source archive file path
    Immagine di condizione dell'azione SFTP 9SFTP action condition image 9
  4. Selezionare il token Percorso file .Select the File path token. Ciò indica che si utilizzerà il percorso del file che il trigger ha rilevato come percorso file di archiviazione di origine.This indicates that you will use the file path of the file that the trigger found as the source archive file path.
    Immagine di condizione dell'azione SFTP 10SFTP action condition image 10
  5. Selezionare Percorso cartella di destinazione Select Destination folder path
    Immagine di condizione dell'azione SFTP 11SFTP action condition image 11
  6. Selezionare il token Percorso file .Select the File path token. Ciò indica che si utilizza il percorso del file che il trigger ha rilevato come percorso di destinazione dei file estratti.This indicates that you will use the file path of the file that the trigger found as the destination path for the extracted files.
  7. Immettere \ExtractedFile nel controllo Percorso cartella di destinazione.Enter \ExtractedFile in the Destination folder path control. Eseguire questa operazione dopo il token del percorso file nel controllo Percorso cartella di destinazione.Do this just after the file path token in the Destination folder path control.
    Immagine di condizione dell'azione SFTP 12SFTP action condition image 12
  8. Immettere True nel controllo *Sovrascrivere? per indicare che i file esistenti devono essere sovrascritti se hanno lo stesso nome dei file estratti.Enter True in the *Overwrite? control to indicate that existing files should be overwritten if they have the same name as the extracted files.
    Immagine di condizione dell'azione SFTP 13SFTP action condition image 13
  9. Salvare le modifiche al flusso di lavoroSave the changes to your workflow

Dettagli specifici del connettoreConnector-specific details

Per visualizzare eventuali azioni e trigger definiti in Swagger ed eventuali limiti, vedere i dettagli del connettore.View any triggers and actions defined in the swagger, and also see any limits in the connector details.

Altri connettoriMore connectors

Tornare all' elenco di API.Go back to the APIs list.