Créer, superviser et gérer des fichiers FTP avec Azure Logic AppsCreate, monitor, and manage FTP files by using Azure Logic Apps

Avec Azure Logic Apps et le connecteur FTP, vous pouvez créer des tâches et des flux de travail automatisés qui créent, supervisent, envoient et reçoivent des fichiers via votre compte sur un serveur FTP, ainsi que d’autres actions, par exemple :With Azure Logic Apps and the FTP connector, you can create automated tasks and workflows that create, monitor, send, and receive files through your account on an FTP server, along with other actions, for example:

  • Superviser à quel moment des fichiers sont ajoutés ou changés.Monitor when files are added or changed.
  • Obtenir, créer, copier, mettre à jour, lister et supprimer des fichiers.Get, create, copy, update, list, and delete files.
  • Obtenir les métadonnées et le contenu des fichiers.Get file content and metadata.
  • Extraire des archives dans des dossiers.Extract archives to folders.

Vous pouvez utiliser des déclencheurs qui obtiennent des réponses de votre serveur FTP, et mettent la sortie à la disposition d’autres actions.You can use triggers that get responses from your FTP server and make the output available to other actions. Vous pouvez utiliser des actions d’exécution dans vos applications logiques pour la gestion des fichiers sur votre serveur FTP.You can use run actions in your logic apps for managing files on your FTP server. Vous pouvez également faire en sorte que des actions utilisent la sortie d’actions FTP.You can also have other actions use the output from FTP actions. Par exemple, si vous obtenez régulièrement des fichiers à partir de votre serveur FTP, vous pouvez envoyer un e-mail au sujet de ces fichiers et de leur contenu en utilisant le connecteur Office 365 Outlook ou le connecteur Outlook.com.For example, if you regularly get files from your FTP server, you can send email about those files and their content by using the Office 365 Outlook connector or Outlook.com connector. Si vous débutez avec les applications logiques, consultez Qu’est-ce qu’Azure Logic Apps ?.If you're new to logic apps, review What is Azure Logic Apps.

LimitesLimitations

  • Le connecteur FTP ne prend en charge que FTPS (FTP sur SSL en mode explicite) ; il n’est pas compatible avec le protocole FTPS implicite.The FTP connector supports only explicit FTP over SSL (FTPS) and isn't compatible with implicit FTPS.

  • Par défaut, les actions FTP peuvent lire ou écrire des fichiers dont la taille est inférieure ou égale à 50 Mo.By default, FTP actions can read or write files that are 50 MB or smaller. Pour gérer les fichiers dont la taille est supérieure à 50 Mo, les actions FTP prennent en charge la segmentation des messages.To handle files larger than 50 MB, FTP actions support message chunking. L’action Obtenir le contenu du fichier utilise implicitement la segmentation.The Get file content action implicitly uses chunking.

  • Les déclencheurs FTP ne prennent pas en charge la segmentation.FTP triggers don't support chunking. Quand ils demandent du contenu de fichiers, les déclencheurs sélectionnent uniquement des fichiers dont la taille est inférieure ou égale à 50 Mo.When requesting file content, triggers select only files that are 50 MB or smaller. Pour obtenir des fichiers supérieurs à 50 Mo, suivez ce modèle :To get files larger than 50 MB, follow this pattern:

    • Utilisez un déclencheur FTP qui retourne des propriétés de fichier comme Quand un fichier est ajouté ou modifié (propriétés uniquement) .Use an FTP trigger that returns file properties, such as When a file is added or modified (properties only).

    • Suivez le déclencheur avec l’action FTP Obtenir le contenu du fichier, qui lit le fichier complet et utilise implicitement la segmentation.Follow the trigger with the FTP Get file content action, which reads the complete file and implicitly uses chunking.

  • Si vous disposez d’un serveur FTP local, envisagez de créer un environnement de service d'intégration (ISE) ou d’utiliser des connexions hybrides d’Azure App Service ; cela vous permet dans les deux cas d’accéder à des sources de données locales sans utiliser de passerelle de données locale.If you have an on-premises FTP server, consider creating an integration service environment (ISE) or using Azure App Service Hybrid connections, which both let you access on-premises data sources without using an on-premises data gateway.

Fonctionnement des déclencheurs FTPHow FTP triggers work

Les déclencheurs FTP fonctionnent en interrogeant le système de fichiers FTP et en recherchant tout fichier changé depuis la dernière interrogation.FTP triggers work by polling the FTP file system and looking for any file that was changed since the last poll. Certains outils permettent de conserver l’horodatage lorsque les fichiers sont modifiés.Some tools let you preserve the timestamp when the files change. Dans ce cas, vous devez désactiver cette fonctionnalité pour permettre l’exécution du déclencheur.In these cases, you have to disable this feature so your trigger can work. Voici quelques paramètres communs :Here are some common settings:

Client SFTPSFTP client ActionAction
WinscpWinscp Accédez à Options > Préférences > Transférer > Modifier > Conserver l’horodatage > DésactiverGo to Options > Preferences > Transfer > Edit > Preserve timestamp > Disable
FileZillaFileZilla Accédez à Transférer > Conserver les horodatages des fichiers transférés > DésactiverGo to Transfer > Preserve timestamps of transferred files > Disable

Quand un déclencheur détecte un nouveau fichier, il vérifie que le nouveau fichier est complet et non partiellement écrit.When a trigger finds a new file, the trigger checks that the new file is complete, and not partially written. Par exemple, un fichier peut être en cours de modification lorsque le déclencheur vérifie le serveur de fichiers.For example, a file might have changes in progress when the trigger checks the file server. Pour éviter de retourner un fichier partiellement écrit, le déclencheur note l’horodatage du fichier qui comporte des modifications récentes, mais ne retourne pas immédiatement ce fichier.To avoid returning a partially written file, the trigger notes the timestamp for the file that has recent changes, but doesn't immediately return that file. Le déclencheur retourne le fichier uniquement lors d’une nouvelle interrogation du serveur.The trigger returns the file only when polling the server again. Parfois, ce comportement peut entraîner un retard correspondant à jusqu’à deux fois l’intervalle d’interrogation du déclencheur.Sometimes, this behavior might cause a delay that is up to twice the trigger's polling interval.

Conditions préalables requisesPrerequisites

  • Un abonnement Azure.An Azure subscription. Si vous n’avez pas d’abonnement Azure, inscrivez-vous pour bénéficier d’un compte Azure gratuit.If you don't have an Azure subscription, sign up for a free Azure account.

  • Vos informations d’identification de compte et adresse du serveur hôte FTPYour FTP host server address and account credentials

    Le connecteur FTP a besoin que votre serveur FTP soit accessible à partir d’Internet, et configuré pour fonctionner en mode passif.The FTP connector requires that your FTP server is accessible from the internet and set up to operate in passive mode. Vos informations d’identification permettent à votre application logique de créer une connexion et d’accéder à votre compte FTP.Your credentials let your logic app create a connection and access your FTP account.

  • Des connaissances de base en création d’applications logiquesBasic knowledge about how to create logic apps

  • L’application logique à partir de laquelle vous souhaitez accéder à votre compte FTP.The logic app where you want to access your FTP account. Pour démarrer avec un déclencheur FTP, créez une application logique vide.To start with an FTP trigger, create a blank logic app. Pour utiliser une action FTP, démarrez votre application logique avec un autre déclencheur, par exemple le déclencheur Périodicité.To use an FTP action, start your logic app with another trigger, for example, the Recurrence trigger.

Se connecter à FTPConnect to FTP

Quand vous utilisez un déclencheur ou une action qui accède à un service pour la première fois, le concepteur Logic Apps vous invite à créer une connexion avec ce service.When you use a trigger or action that accesses a service for the first time, the Logic Apps Designer prompts you to create a connection to that service. Vous pouvez ensuite fournir les informations de connexion nécessaires directement à partir de votre application logique, à l’intérieur du concepteur.You can then provide the necessary connection information directly from your logic app inside the designer.

  1. Connectez-vous au Portail Azure, puis ouvrez votre application logique dans le concepteur d’application logique.Sign in to the Azure portal, and open your logic app in Logic App Designer.

  2. Pour les applications logiques vides, dans la zone de recherche, entrez ftp comme filtre.For blank logic apps, in the search box, enter ftp as your filter. Dans la liste des déclencheurs, sélectionnez celui qui vous intéresse.From the Triggers list, select the trigger that you want.

    -ou--or-

    Pour les applications logiques existantes, sous la dernière étape où vous souhaitez ajouter une action, sélectionnez Nouvelle étape, puis Ajouter une action.For existing logic apps, under the last step where you want to add an action, select New step, and then select Add an action. Dans la zone de recherche, entrez ftp en guise de filtre.In the search box, enter ftp as your filter. Dans la liste des actions, sélectionnez l’action qui vous intéresse.From the Actions list, select the action that you want.

    Pour ajouter une action entre des étapes, placez votre pointeur au-dessus de la flèche qui les sépare.To add an action between steps, move your pointer over the arrow between steps. Cliquez sur le signe ( + ) qui s’affiche, puis sélectionnez Ajouter une action.Select the plus sign (+) that appears, and then select Add an action.

  3. Indiquez vos informations de connexion et sélectionnez Créer.Provide your connection information, and select Create.

  4. Fournissez les informations pour le déclencheur ou l’action sélectionnés et continuez à générer le flux de travail de votre application logique.Provide the information for your selected trigger or action and continue building your logic app's workflow.

ExemplesExamples

Ajouter un déclencheur FTPAdd FTP trigger

Le déclencheur Quand un fichier est ajouté ou modifié (propriétés uniquement) démarre un flux de travail d’application logique quand il détecte qu’un fichier est ajouté ou modifié sur un serveur FTP.The When a file is added or modified (properties only) trigger starts a logic app workflow when the trigger detects that a file is added or changed on an FTP server. Par exemple, vous pouvez ajouter une condition qui vérifie le contenu du fichier pour savoir s’il peut être obtenu.For example, you can add a condition that checks the file's content and decides whether to get that content, based on whether that content meets a specified condition. Enfin, vous pouvez ajouter une action qui obtient le contenu du fichier et le place dans un dossier différent sur le serveur SFTP.Finally, you can add an action that gets the file's content, and put that content into a different folder on the SFTP server.

Par exemple, vous pouvez utiliser ce déclencheur pour superviser l’apparition dans un dossier FTP de nouveaux fichiers qui décrivent les commandes des clients.For example, you can use this trigger to monitor an FTP folder for new files that describe customer orders. Vous pouvez ensuite utiliser une action FTP telle que Obtenir les métadonnées d’un fichier pour obtenir les propriétés de ce nouveau fichier, puis utiliser Obtenir le contenu d’un fichier pour obtenir le contenu de ce fichier en vue d’un traitement ultérieur et de le stocker dans une base de données de commandes.You can then use an FTP action such as Get file metadata to get the properties for that new file, and then use Get file content to get the content from that file for further processing and store that order in an orders database.

Voici un exemple qui montre comment utiliser le déclencheur Quand un fichier est ajouté ou modifié (propriétés uniquement) .Here is an example that shows how to use the When a file is added or modified (properties only) trigger.

  1. Connectez-vous au portail Azure et ouvrez votre application logique dans le concepteur d’application logique, si elle n’est pas déjà ouverte.Sign in to the Azure portal, and open your logic app in Logic App Designer, if not open already.

  2. Pour les applications logiques vides, dans la zone de recherche, entrez ftp comme filtre.For blank logic apps, in the search box, enter ftp as your filter. Dans la liste des déclencheurs, sélectionnez ce déclencheur : Quand un fichier est ajouté ou modifié (propriétés uniquement)Under the triggers list, select this trigger: When a filed is added or modified (properties only)

    Rechercher et sélectionner le déclencheur FTP

  3. Fournissez les informations nécessaires pour votre connexion, puis sélectionnez Créer.Provide the necessary details for your connection, and then select Create.

    Par défaut, ce connecteur transfère les fichiers au format texte.By default, this connector transfers files in text format. Pour transférer des fichiers au format binaire, par exemple quand l’encodage est utilisé, sélectionnez Transport binaire.To transfer files in binary format, for example, where and when encoding is used, select Binary Transport.

    Créer une connexion au serveur FTP

  4. Dans la zone Dossier, sélectionnez l’icône de dossier pour faire apparaître une liste.In the Folder box, select the folder icon so that a list appears. Afin de trouver le dossier que vous souhaitez superviser pour les fichiers nouveaux ou modifiés, sélectionnez le chevron droit ( > ), accédez à ce dossier et sélectionnez-le.To find the folder you want to monitor for new or edited files, select the right angle arrow (>), browse to that folder, and then select the folder.

    Recherche et sélection du dossier à superviser

    Votre dossier sélectionné s’affiche dans la zone Dossier.Your selected folder appears in the Folder box.

    Le dossier sélectionné s’affiche dans la propriété « Dossier ».

  5. Enregistrez votre application logique.Save your logic app. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.On the designer toolbar, select Save.

À présent que votre application logique dispose d’un déclencheur, ajoutez les actions que vous souhaitez exécuter lorsqu’elle trouve un fichier nouveau ou modifié.Now that your logic app has a trigger, add the actions you want to run when your logic app finds a new or edited file. Pour cet exemple, vous pouvez ajouter une action FTP qui obtient le contenu nouveau ou mis à jour.For this example, you can add an FTP action that gets the new or updated content.

Ajouter une action FTPAdd FTP action

L’action Obtenir les métadonnées du fichier obtient les propriétés d’un fichier qui se trouve sur votre serveur FTP et l’action Obtenir le contenu du fichier obtient le contenu du fichier en fonction des informations relatives à ce fichier sur votre serveur FTP.The Get file metadata action gets the properties for a file that's on your FTP server and the Get file content action gets the file content based on the information about that file on your FTP server. Par exemple, vous pouvez ajouter le déclencheur de l’exemple précédent et ces actions pour obtenir le contenu du fichier après l’ajout ou la modification de celui-ci.For example, you can add the trigger from the previous example and these actions to get the file's content after that file is added or edited.

  1. Sous le déclencheur ou n’importe quel autre action, sélectionnez Nouvelle étape.Under the trigger or any other actions, select New step.

  2. Dans la zone de recherche, entrez ftp en guise de filtre.In the search box, enter ftp as your filter. Dans la liste des actions, sélectionnez cette action : Obtenir les métadonnées d’un fichierUnder the actions list, select this action: Get file metadata

    Sélectionner l’action « Obtenir les métadonnées du fichier »

  3. Si vous disposez déjà d’une connexion à vos compte et serveur FTP, passez à l’étape suivante.If you already have a connection to your FTP server and account, go to the next step. Sinon, fournissez les informations nécessaires pour cette connexion, puis sélectionnez Créer.Otherwise, provide the necessary details for that connection, and then select Create.

    Création d’une connexion serveur FTP

  4. Après l’apparition de l’action Obtenir les métadonnées du fichier, cliquez à l’intérieur de la zone Fichier pour que la liste de contenu dynamique s’affiche.After the Get file metadata action appears, click inside the File box so that the dynamic content list appears. Vous pouvez à présent sélectionner des propriétés pour les sorties des étapes précédentes.You can now select properties for the outputs from previous steps. Dans la liste contenu dynamique, sous Obtenir les métadonnées d’un fichier, sélectionnez la propriété List of Files Id (Id Liste des fichiers), qui fait référence à la collection dans laquelle le fichier a été ajouté ou mis à jour.In the dynamic content list, under Get file metadata, select the List of Files Id property, which references the collection where the file was added or updated.

    Rechercher et sélectionner la propriété « Id Liste des fichiers »

    La propriété List of Files Id (Id Liste de fichiers) apparaît maintenant dans la zone Fichier.The List of Files Id property now appears in the File box.

    Propriété « Id Liste des fichiers » sélectionnée

  5. Ajoutez maintenant cette action FTP : Obtenir le contenu d’un fichierNow add this FTP action: Get file content

    Rechercher et sélectionner l’action « Obtenir le contenu du fichier »

  6. Après l’apparition de l’action Obtenir le contenu du fichier, cliquez à l’intérieur de la zone Fichier pour que la liste de contenu dynamique s’affiche.After the Get file content action appears, click inside the File box so that the dynamic content list appears. Vous pouvez à présent sélectionner des propriétés pour les sorties des étapes précédentes.You can now select properties for the outputs from previous steps. Dans la liste contenu dynamique, sous Obtenir les métadonnées d’un fichier, sélectionnez la propriété Id, qui fait référence au fichier qui a été ajouté ou mis à jour.In the dynamic content list, under Get file metadata, select the Id property, which references the file that was added or updated.

    Rechercher et sélectionner la propriété « Id »

    La propriété Id apparaît maintenant dans la zone Fichier.The Id property now appears in the File box.

    Propriété « Id » sélectionnée

  7. Enregistrez votre application logique.Save your logic app.

Tester votre application logiqueTest your logic app

Pour vérifier que votre workflow retourne le contenu attendu, ajoutez une autre action qui vous envoie le contenu à partir du fichier téléchargé ou mis à jour.To check that your workflow returns the content that you expect, add another action that sends you the content from the uploaded or updated file.

  1. Sous l’action Obtenir le contenu du fichier, ajoutez une action qui peut vous envoyer le contenu du fichier.Under the Get file content action, add an action that can send you the file's contents. Cet exemple ajoute l’action Envoyer un e-mail pour Office 365 OutlookThis example adds the Send an email action for the Office 365 Outlook.

    Ajouter une action pour l’envoi de courrier

  2. Une fois que l’action s’affiche, fournissez les informations et incluez les propriétés que vous souhaitez tester.After the action appears, provide the information and include the properties that you want to test. Par exemple, incluez la propriété Contenu du fichier, qui apparaît dans la liste de contenu dynamique après avoir sélectionné Voir plus dans la section Obtenir le contenu d’un fichier.For example, include the File content property, which appears in the dynamic content list after you select See more in the Get file content section.

    Fournir des informations sur l’action d’e-mail

  3. Enregistrez votre application logique.Save your logic app. Pour exécuter et déclencher l’application logique, dans la barre d’outils, sélectionnez Exécuter, puis ajoutez un fichier au dossier FTP supervisé par votre application logique.To run and trigger the logic app, on the toolbar, select Run, and then add a file to the FTP folder that your logic app now monitors.

Référence de connecteurConnector reference

Pour obtenir des détails techniques sur les déclencheurs, les actions et les limites, qui sont décrits par la description OpenAPI du connecteur (anciennement Swagger), consultez la page de référence du connecteur.For technical details about triggers, actions, and limits, which are described by the connector's OpenAPI (formerly Swagger) description, review the connector's reference page.

Étapes suivantesNext steps