Se connecter à des serveurs FTP à partir de flux de travail dans Azure Logic Apps

S’applique à : Azure Logic Apps (Consommation + Standard)

Cet article explique comment accéder à votre serveur FTP (File Transfer Protocol) à partir d’un flux de travail dans Azure Logic Apps avec le connecteur FTP. Vous pouvez créer des flux de travail automatisés qui s’exécutent lorsqu’ils sont déclenchés par des événements dans votre serveur FTP ou dans d’autres systèmes et exécutent des actions pour gérer des fichiers sur votre serveur FTP.

Par exemple, votre flux de travail peut commencer par un déclencheur FTP qui surveille et traite les événements sur votre serveur FTP. Le déclencheur rend les sorties disponibles pour les actions dans votre flux de travail. Votre flux de travail peut exécuter des actions FTP qui créent, envoient, reçoivent et gèrent des fichiers via votre compte de serveur FTP à l’aide des tâches spécifiques suivantes :

Superviser à quel moment des fichiers sont ajoutés ou changés.
Créer, copier, supprimer, répertorier et mettre à jour des fichiers.
Obtenir les métadonnées et le contenu de fichiers.
Gérer les dossiers.

Si vous débutez avec Azure Logic Apps, consultez la documentation suivante :

Référence technique du connecteur

Le connecteur FTP a différentes versions, en fonction du type d’application logique et de l’environnement hôte.

Type d’application logique (plan)	Environnement	Version du connecteur
Consommation	Azure Logic Apps multilocataire	Connecteur managé, qui apparaît dans la galerie de connecteurs avec le filtre Partagé . Pour plus d’informations, consultez : - Référence du connecteur managé FTP - Connecteurs managés dans Azure Logic Apps
Standard	Azure Logic Apps monolocataire et App Service Environment v3 (plans Windows uniquement)	- Connecteur managé, qui apparaît dans la galerie de connecteurs avec le filtre partagé . - Connecteur intégré, qui apparaît dans la galerie de connecteurs avec le filtre intégré et est basé sur le fournisseur de services. Le connecteur intégré peut accéder directement aux réseaux virtuels Azure avec une chaîne de connexion. Pour plus d’informations, consultez : - Référence du connecteur managé FTP - Opérations du connecteur intégré FTP - Connecteurs managés dans Azure Logic Apps - Connecteurs intégrés dans Azure Logic Apps

Limites

Capacité et débit
- Connecteur intégré pour flux de travail Standard :
  
  Par défaut, les actions FTP peuvent lire ou écrire des fichiers dont la taille est inférieure ou égale à 200 Mo. Actuellement, le connecteur intégré FTP ne prend pas en charge la segmentation.
- Connecteur managé pour les flux de travail Consommation et Standard
  
  Par défaut, les actions FTP peuvent lire ou écrire des fichiers dont la taille est inférieure ou égale à 50 Mo. Pour gérer les fichiers dont la taille est supérieure à 50 Mo, les actions FTP prennent en charge la segmentation des messages. L’action Obtenir le contenu du fichier utilise implicitement la segmentation.
Les déclencheurs pour le connecteur géré FTP ou hébergé par Azure peuvent rencontrer des résultats manquants, incomplets ou retardés lorsque l'horodatage dernier modifié est conservé. Par ailleurs, le déclencheur de connecteur intégré FTP dans des flux de travail d’application logique Standard n’a pas cette limitation. Pour plus d’informations, consultez les limitations du connecteur FTP.
Le connecteur managé FTP peut créer un nombre limité de connexions au serveur FTP. La limite est basée sur la capacité de connexion dans la région Azure où existe votre ressource d’application logique. Si cette limite pose un problème dans un flux de travail d’application logique Consommation, créez un flux de travail d’application logique standard qui utilise le connecteur intégré FTP.

Le connecteur FTP intégré et géré prend uniquement en charge FTP explicite via FTPS, qui est une extension de TLS. Aucune version du connecteur ne prend en charge FTPS implicite.

Prérequis

Un compte et un abonnement Azure. Si vous n’avez pas d’abonnement Azure, inscrivez-vous pour bénéficier d’un compte Azure gratuit.
Le flux de travail d’application logique dans lequel vous voulez accéder à votre compte FTP. Pour démarrer votre flux de travail avec un déclencheur FTP, vous devez commencer par un flux de travail vide. Pour utiliser une action SFTP-SSH, démarrez votre flux de travail avec un autre déclencheur, tel que le déclencheur Périodicité.
Pour plus d’exigences qui s’appliquent à la fois au connecteur managé FTP et au connecteur intégré, consultez la référence du connecteur managé FTP - Configuration requise.

Problèmes connus

Par défaut, les déclencheurs qui acceptent ou qui retournent des tableaux ont souvent un paramètre Fractionner sur déjà activé. Le déclencheur débatche automatiquement un tableau en créant en interne une instance de workflow distincte pour traiter chaque élément du tableau. Toutes les instances de flux de travail s’exécutent en parallèle afin que les éléments du tableau soient traités en même temps.

Avec le paramètre Fractionné activé, les déclencheurs de connecteur géré renvoient les résultats de tous les éléments de tableau sous forme de listes. Toutes les actions suivantes qui référencent ces sorties doivent d’abord gérer ces sorties sous forme de listes. Pour traiter chaque élément du tableau individuellement, vous pouvez ajouter des actions. Par exemple, pour itérer dans ces éléments de tableau, vous pouvez utiliser une boucle For each. Pour les déclencheurs qui retournent uniquement des métadonnées ou des propriétés, utilisez une action qui obtient les métadonnées de l’élément de tableau, puis une action pour obtenir le contenu des éléments.

Vous devez appliquer cette approche uniquement pour les déclencheurs de connecteur géré, et non pour les déclencheurs de connecteur intégrés qui retournent des sorties pour un élément de tableau à la fois avec le paramètre Split on activé.

Par exemple, supposons que vous avez un déclencheur de connecteur managé nommé Quand un fichier est ajouté ou modifié (propriétés uniquement) qui retourne les métadonnées ou les propriétés pour les fichiers nouveaux ou mis à jour sous forme de tableaux. Pour obtenir les métadonnées séparément pour chaque fichier, vous pouvez utiliser une boucle For each qui itère dans le tableau. Dans cette boucle, utilisez les actions de connecteur managé suivantes dans l’ordre spécifié :

Obtenir les métadonnées du fichier pour obtenir les métadonnées de chaque fichier.
Obtenir de contenu du fichier pour obtenir le contenu de chaque fichier.

Ajouter un déclencheur FTP

Un flux de travail d’application logique Consommation ne peut utiliser que le connecteur managé FTP. En revanche, un flux de travail d’application logique Standard peut utiliser aussi bien le connecteur managé FTP que le connecteur intégré FTP.

Les connecteurs FTP managé et intégré n’ont chacun qu’un seul déclencheur disponible :

Déclencheur de connecteur managé : le déclencheur FTP nommé Quand un fichier est ajouté ou modifié (propriétés uniquement) exécute un flux de travail d’application logique Consommation ou Standard quand un ou plusieurs fichiers sont ajoutés ou modifiés dans un dossier sur le serveur FTP. Ce déclencheur obtient uniquement les propriétés ou les métadonnées du fichier, pas son contenu. Pour obtenir le contenu du fichier, votre flux de travail peut suivre ce déclencheur avec d’autres actions FTP.

Pour plus d’informations, consultez Quand un fichier est ajouté ou modifié (propriétés uniquement).
Déclencheur de connecteur intégré : le déclencheur FTP nommé Quand un fichier est ajouté ou mis à jour exécute un flux de travail d’application logique Standard quand un ou plusieurs fichiers sont ajoutés ou modifiés dans un dossier sur le serveur FTP. Ce déclencheur obtient uniquement les propriétés ou les métadonnées du fichier, pas son contenu. Pour obtenir le contenu, votre flux de travail peut suivre ce déclencheur avec d’autres actions FTP. Pour plus d’informations, consultez Quand un fichier est ajouté ou mis à jour.

Les procédures suivantes utilisent le portail Azure. Avec l’extension Azure Logic Apps correspondante pour la consommation ou les applications logiques standard, vous pouvez utiliser les outils suivants pour créer et modifier des flux de travail d’application logique :

Workflows d’application logique de consommation : Visual Studio Code
Flux de travail d’application logique standard : Visual Studio Code

Cette section présente les étapes à suivre pour les déclencheurs de connecteur FTP suivants :

Déclencheur intégré nommé Quand un fichier est ajouté ou mis à jour

Si vous utilisez ce déclencheur intégré FTP, vous pouvez obtenir le contenu du fichier à l’aide de l’action intégrée FTP nommée Obtenir le contenu du fichier sans utiliser d’abord l’action Obtenir les métadonnées du fichier , contrairement au déclencheur managé FTP. Pour plus d’informations sur les opérations de connecteur intégrées FTP, consultez les opérations de connecteur intégrées FTP.

Ce déclencheur FTP intégré n’est pas disponible pour les workflows d’application logique Consommation.
Déclencheur managé nommé Quand un fichier est ajouté ou modifié (propriétés uniquement)

Si vous utilisez ce déclencheur managé FTP, vous devez utiliser l’action Obtenir les métadonnées du fichier pour obtenir un élément de tableau unique avant d’utiliser une autre action sur le fichier qui a été ajouté ou modifié. Cette solution de contournement résulte du problème connu lié au paramètre Fractionner sur décrit précédemment dans cet article.

Ajouter un déclencheur de connecteur intégré

Pour ajouter un déclencheur de connecteur intégré à un flux de travail Standard :

Dans le portail Azure, ouvrez votre ressource d’application logique.
Dans le menu de la barre latérale des ressources, sous Flux de travail, sélectionnez Flux de travail, puis sélectionnez votre flux de travail vide, qui s’ouvre dans le concepteur.
Dans le concepteur, sélectionnez Ajouter un déclencheur.
Suivez les étapes générales pour ajouter le déclencheur FTP lorsqu’un fichier est ajouté ou mis à jour (préversion).
Fournissez les informations de votre connexion. Lorsque vous avez terminé, sélectionnez Créer nouveau.

Remarque

Par défaut, ce connecteur transfère les fichiers au format texte. Pour transférer des fichiers au format binaire, par exemple quand l’encodage est utilisé, sélectionnez l’option Transport binaire.
Une fois le volet d’informations du déclencheur affiché, dans la zone Chemin du dossier, spécifiez le chemin d’accès au dossier que vous souhaitez surveiller.
Lorsque vous avez terminé, enregistrez votre flux de travail.

Lorsque vous enregistrez votre flux de travail, Azure publie vos mises à jour dans votre application logique déployée et dynamique dans Azure. Avec un seul déclencheur, votre flux de travail vérifie simplement le serveur FTP en fonction de votre planification spécifiée. Vous devez ajouter une action qui répond au déclencheur et effectuer quelque chose avec les sorties du déclencheur, comme décrit dans les sections ultérieures.

Ajouter un déclencheur de connecteur managé

Pour ajouter un déclencheur de connecteur géré à un flux de travail de type Consommation ou Standard :

Dans le portail Azure, recherchez et ouvrez votre ressource d’application logique.
Selon que vous disposez d’une application logique Consommation ou Standard :
- Consommation : dans le menu de la barre latérale des ressources, sous Outils de développement, sélectionnez le concepteur pour ouvrir le flux de travail.
- Standard : dans le menu de la barre latérale des ressources, sous Flux de travail, sélectionnez Flux de travail. Sélectionnez le flux de travail vide, qui s’ouvre dans le concepteur.
Dans le concepteur de flux de travail, sélectionnez Ajouter un déclencheur.
Suivez les étapes générales pour ajouter le déclencheur FTP lorsqu’un fichier est ajouté ou modifié (propriétés uniquement).
Fournissez les informations de votre connexion. Lorsque vous avez terminé, sélectionnez Créer nouveau.

Remarque

Par défaut, ce connecteur transfère les fichiers au format texte. Pour transférer des fichiers au format binaire, par exemple quand l’encodage est utilisé, sélectionnez l’option Transport binaire.
Lorsque le volet d’informations du déclencheur s’ouvre, recherchez le dossier que vous souhaitez surveiller pour les fichiers nouveaux ou modifiés.
1. Dans la zone Dossier, sélectionnez l’icône de dossier pour afficher le répertoire du dossier.
2. Sélectionnez la flèche droite (>). Accédez au dossier souhaité, puis sélectionnez-le.
Votre dossier sélectionné s’affiche dans la zone Dossier.
Lorsque vous avez terminé, enregistrez votre flux de travail.

Lorsque vous enregistrez votre flux de travail, Azure publie vos mises à jour dans votre application logique déployée et dynamique. Avec un seul déclencheur, votre flux de travail vérifie simplement le serveur FTP en fonction de votre planification spécifiée. Vous devez ajouter une action qui répond au déclencheur et effectuer quelque chose avec les sorties du déclencheur, comme décrit dans les sections ultérieures.

Ajouter une action FTP

Un flux de travail d’application logique Consommation ne peut utiliser que le connecteur managé FTP. Un flux de travail d’application logique standard peut utiliser le connecteur managé FTP et le connecteur intégré FTP. Chaque version a plusieurs actions. Par exemple, les versions managée et intégrée du connecteur ont leurs propres actions pour obtenir les métadonnées et le contenu du fichier.

Actions de connecteur intégré : ces actions s’exécutent uniquement dans un flux de travail d’application logique Standard.
Actions du connecteur managé : ces actions s’exécutent dans un flux de travail d’application logique Consommation ou Standard.

Les procédures suivantes utilisent le portail Azure. Avec l’extension correspondante Azure Logic Apps pour les niveaux de service Consumption ou Standard, vous pouvez utiliser les outils suivants pour créer et modifier des flux de travail Logic Apps :

Flux de travail de consommation : Visual Studio Code
Workflow Standard : Visual Studio Code

Avant que vous puissiez utiliser une action FTP, votre flux de travail doit déjà commencer par un déclencheur du type de votre choix. Par exemple, vous pouvez utiliser le déclencheur intégré générique Périodicité pour démarrer votre flux de travail selon une planification spécifique.

Les étapes à suivre pour ajouter et utiliser une action FTP diffèrent selon que votre workflow utilise le connecteur intégré ou le connecteur managé.

Flux de travail de déclencheur intégrés : décrit les étapes permettant d’ajouter une action intégrée à un flux de travail qui commence par un déclencheur intégré.

Si vous avez utilisé le déclencheur intégré FTP et que vous souhaitez obtenir le contenu d’un fichier nouvellement ajouté ou mis à jour, vous pouvez utiliser une boucle Pour chaque pour itérer dans le tableau retourné par le déclencheur. Vous pouvez ensuite utiliser simplement l’action Obtenir le contenu du fichier sans aucune action intermédiaire. Pour plus d’informations sur les opérations de connecteur intégrées FTP, consultez les opérations de connecteur intégrées FTP.
Flux de travail de déclencheur managé : décrit les étapes permettant d’ajouter une action managée à un flux de travail qui commence par un déclencheur managé.

Si vous avez utilisé le déclencheur de connecteur managé FTP et souhaitez obtenir le contenu d’un fichier nouvellement ajouté ou modifié, vous pouvez utiliser une boucle For chaque pour parcourir le tableau retourné par le déclencheur. Vous devez ensuite utiliser des actions intermédiaires, telles que l’action FTP nommée Obtenir les métadonnées du fichier, avant d’utiliser l’action Obtenir le contenu du fichier.

Flux de travail avec un déclencheur intégré

Pour ajouter des actions à un flux de travail Standard qui commence par un déclencheur de connecteur intégré :

Dans le portail Azure, recherchez et ouvrez votre ressource d’application logique.
Dans le menu de la barre latérale des ressources, sous Flux de travail, sélectionnez Flux de travail. Sélectionnez le flux de travail avec le déclencheur intégré FTP.
Dans le concepteur, suivez ces étapes générales pour ajouter l’action FTP nommée Get file content à votre flux de travail.
Si nécessaire, fournissez les informations pour votre connexion. Lorsque vous avez terminé, sélectionnez Créer nouveau.

Remarque

Par défaut, ce connecteur transfère les fichiers au format texte. Pour transférer des fichiers au format binaire, par exemple quand l’encodage est utilisé, sélectionnez l’option Transport binaire.
Dans le volet d’informations de l’action qui s’ouvre, sélectionnez à l’intérieur du Chemin d’accès au fichier pour afficher les options d’entrée. Sélectionnez l’icône éclair pour ouvrir la liste de contenu dynamique.

Vous pouvez maintenant sélectionner des sorties du déclencheur précédent.
Dans la liste de contenu dynamique, sous Quand un fichier est ajouté ou mis à jour, sélectionnez Chemin d’accès du fichier.

La propriété Chemin d’accès au fichier fait désormais référence à la sortie du déclencheur Chemin d’accès du fichier.
Ajoutez toutes les autres actions dont votre flux de travail a besoin.
Lorsque vous avez terminé, enregistrez votre flux de travail. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.

Flux de travail avec un déclencheur managé

Pour ajouter des actions à un workflow Consommation ou Standard qui commence par un déclencheur de connecteur managé :

Dans le portail Azure, recherchez et ouvrez votre ressource d’application logique.
Selon que vous disposez d’une application logique Consommation ou Standard :
- Consommation : dans le menu de la barre latérale des ressources, sous Outils de développement, sélectionnez le concepteur pour ouvrir le flux de travail.
- Standard : dans le menu de la barre latérale des ressources, sous Flux de travail, sélectionnez Flux de travail. Sélectionnez le flux de travail qui commence par le déclencheur de connecteur managé FTP. Dans le menu de la barre latérale du flux de travail, sélectionnez le concepteur pour ouvrir le flux de travail.
Dans le concepteur, suivez ces étapes générales pour ajouter l’action FTP nommée Obtenir les métadonnées de fichier à votre flux de travail.
Si nécessaire, fournissez les informations pour votre connexion. Lorsque vous avez terminé, sélectionnez Créer nouveau.

Remarque

Par défaut, ce connecteur transfère les fichiers au format texte. Pour transférer des fichiers au format binaire, par exemple quand l’encodage est utilisé, sélectionnez l’option Transport binaire.
Dans le volet d’informations d’action qui s’ouvre, sélectionnez Fichier pour afficher les options d’entrée. Sélectionnez l’icône éclair pour ouvrir la liste de contenu dynamique.

Vous pouvez maintenant sélectionner des sorties du déclencheur précédent.
Dans la liste de contenu dynamique, sous Quand un fichier est ajouté ou modifié (propriétés uniquement), sélectionnez ID de liste de fichiers.

La propriété Fichier fait maintenant référence à la sortie du déclencheur ID de liste de fichiers.
Dans le concepteur, suivez ces étapes générales pour ajouter l’action FTP nommée Get file content à votre flux de travail.
Dans le volet d’informations d’action qui s’affiche, sélectionnez Fichier pour afficher les options d’entrée. Sélectionnez l’icône éclair pour ouvrir la liste de contenu dynamique.

Vous pouvez maintenant sélectionner des sorties du déclencheur ou des actions précédents.
Dans la liste de contenu dynamique, sous Obtenir les métadonnées du fichier, sélectionnez Id.

La propriété Fichier fait désormais référence à la sortie de l’action Id.
Ajoutez toutes les autres actions dont votre flux de travail a besoin.
Lorsque vous avez terminé, enregistrez votre flux de travail. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.

Tester votre workflow

Pour vérifier que votre flux de travail retourne le contenu attendu, ajoutez une autre action qui vous envoie le contenu à partir du fichier ajouté ou mis à jour. Cet exemple utilise l’action Office 365 Outlook intitulée Envoyer un e-mail.

Flux de travail avec déclencheur et actions intégrés

Pour ajouter une action Office 365 Outlook à votre flux de travail Standard :

Dans le concepteur, sous l’action Obtenir le contenu du fichier , suivez ces étapes générales pour ajouter l’action nommée Envoyer un e-mail à votre flux de travail.

Si vous disposez d’un compte Outlook.com à la place, ajoutez le Outlook.com Envoyer une action par e-mail .
Si nécessaire, connectez-vous à votre compte e-mail.
Dans le volet d’informations d’action, fournissez les valeurs requises et incluez les autres paramètres ou propriétés que vous souhaitez tester.

Par exemple, vous pouvez inclure la sortie Contenu du fichier résultant de l’action Obtenir le contenu du fichier. Pour rechercher cette sortie, procédez comme suit :
1. Dans l’action Obtenir le contenu du fichier , sélectionnez dans le corps pour afficher les options d’entrée. Sélectionnez l’icône éclair pour ouvrir la liste de contenu dynamique. Dans cette liste, sous Obtenir le contenu du fichier, sélectionnez Contenu de fichier.
2. Dans la liste de contenu dynamique, sous Obtenir le contenu du fichier, sélectionnez Contenu du fichier.
  
  La propriété Body contient maintenant la sortie de l’action contenu de fichier.
Enregistrez votre flux de travail.

Pour déclencher et exécuter le flux de travail, procédez comme suit :

Dans la barre d’outils du concepteur, sélectionnez Exécuter>Exécuter.
Ajoutez un fichier au dossier FTP que votre flux de travail surveille.

Flux de travail avec déclencheur et actions managés

Pour ajouter une action Office 365 Outlook à votre flux de travail Consommation ou Standard :

Dans le concepteur, sous l’action Obtenir le contenu du fichier , suivez ces étapes générales pour ajouter l’action nommée Envoyer un e-mail à votre flux de travail.

Si vous disposez d’un compte Outlook.com à la place, ajoutez le Outlook.com Envoyer une action par e-mail .
Si nécessaire, connectez-vous à votre compte e-mail.
Dans la zone d’informations sur l’action, entrez les valeurs requises et incluez les autres paramètres ou propriétés que vous souhaitez tester.

Par exemple, vous pouvez inclure la sortie Contenu du fichier résultant de l’action Obtenir le contenu du fichier. Pour rechercher cette sortie, procédez comme suit :
1. Dans l’action Obtenir le contenu du fichier , sélectionnez dans la zone Corps pour afficher les options d’entrée. Sélectionnez l’icône éclair pour ouvrir la liste de contenu dynamique. Dans cette liste, sous Obtenir le contenu du fichier, sélectionnez Contenu de fichier.
2. Dans la liste de contenu dynamique, sous Obtenir le contenu du fichier, sélectionnez Contenu du fichier.
  
  La propriété Body contient maintenant la sortie de l’action contenu de fichier.
Enregistrez votre workflow d’application logique.