Partager via


Se connecter à des systèmes de fichiers locaux à partir de workflows dans Azure Logic Apps

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

Ce guide montre comment accéder à un partage de fichiers local à partir d’un flux de travail dans Azure Logic Apps à l’aide du connecteur système de fichiers. Vous pouvez ensuite créer des flux de travail automatisés qui s’exécutent lorsqu’ils sont déclenchés par des événements dans votre partage de fichiers ou dans d’autres systèmes, et exécuter des actions pour gérer vos fichiers. Le connecteur fournit les fonctionnalités suivantes :

  • Créer, obtenir, ajouter, mettre à jour et supprimer des fichiers.
  • Répertorier des fichiers dans des dossiers ou des dossiers racine.
  • Obtenir les métadonnées et le contenu des fichiers.

Dans ce guide pratique, les exemples de scénarios illustrent les tâches suivantes :

  • Déclencher un workflow quand un fichier est créé ou ajouté dans un partage de fichiers, puis envoyer un e-mail.
  • Déclencher un workflow quand un fichier est copié d’un compte Dropbox vers un partage de fichiers, puis envoyer un e-mail.

Limitations et problèmes connus

  • Actuellement, le connecteur de système de fichiers prend uniquement en charge les systèmes de fichiers Windows sur les systèmes d’exploitation Windows.
  • Les lecteurs réseau mappés ne sont pas pris en charge.

Référence technique du connecteur

Le connecteur Système de fichiers est disponible en différentes versions, selon le type de l’application logique et l’environnement hôte.

Application logique Environnement Version du connecteur
Consommation Azure Logic Apps multilocataire Connecteur managé, qui apparaît dans la galerie de connecteurs sous Partagé. Pour plus d’informations, consultez la documentation suivante :

- Documentation de référence du connecteur managé Système de fichiers
- 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 sous Shared et connecteur intégré, qui apparaît dans la galerie de connecteurs sous Intégré et est basé sur le fournisseur de services. Le connecteur intégré diffère des façons suivantes :

- Le connecteur intégré ne prend en charge que les applications logiques Standard s’exécutant dans App Service Environment v3, avec des plans Windows uniquement.

- La version intégrée peut se connecter directement à un partage de fichiers et accéder aux réseaux virtuels Azure à l’aide d’une chaîne de connexion sans passerelle de données locale.

Pour plus d’informations, consultez la documentation suivante :

- Documentation de référence du connecteur managé Système de fichiers
- Documentation de référence du connecteur intégré Système de fichiers
- Connecteurs intégrés dans Azure Logic Apps

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.

  • Pour la connexion à votre partage de fichiers, des exigences différentes s’appliquent en fonction de votre application logique et de l’environnement d’hébergement :

    • Flux de travail des applications de logique de consommation :

    • Flux de travail d’application logique standard :

      Vous pouvez utiliser le connecteur natif du système de fichiers ou le connecteur géré.

      • Pour utiliser le connecteur managé Système de fichiers, vous devez satisfaire aux mêmes exigences que pour un workflow d’application logique Consommation dans un environnement Azure Logic Apps multilocataire.

      • Pour utiliser le connecteur intégré du système de fichiers, votre workflow d’application logique standard doit s’exécuter dans App Service Environment v3, mais ne nécessite pas la ressource de passerelle de données.

  • Un accès à l’ordinateur qui héberge le système de fichiers que vous souhaitez utiliser. Par exemple, si vous installez la passerelle de données sur le même ordinateur que votre système de fichiers, vous avez besoin des informations d'identification du compte pour cet ordinateur.

  • Pour suivre l’exemple de scénario de ce guide, vous avez besoin d’un compte de messagerie d’un fournisseur pris en charge par Azure Logic Apps, tel qu’Office 365 Outlook, Outlook.com ou Gmail. Pour les autres fournisseurs, passez en revue d’autres connecteurs de messagerie pris en charge. Cet exemple utilise le connecteur Office 365 Outlook avec un compte professionnel ou scolaire. Si vous utilisez un autre compte de messagerie, les étapes générales sont identiques, mais votre interface utilisateur peut-être légèrement différente.

    Important

    Si vous souhaitez utiliser le connecteur Gmail, seuls les comptes professionnels G-Suite peuvent utiliser ce connecteur sans restriction dans les applications logiques. Si vous avez un compte de consommateur Gmail, vous pouvez utiliser ce connecteur uniquement avec des services google approuvés spécifiques, ou vous pouvez créer une application cliente Google à utiliser pour l’authentification avec votre connecteur Gmail. Pour plus d’informations, consultez Stratégies de confidentialité et de sécurité des données pour les connecteurs Google dans Azure Logic Apps.

  • Pour l’exemple de scénario d’action système de fichiers , vous avez besoin d’un compte Dropbox. Vous pouvez vous inscrire gratuitement.

  • Ressource d’application logique avec le workflow dans lequel vous souhaitez accéder à votre partage de fichiers.

    Pour démarrer votre flux de travail avec un déclencheur de système de fichiers, vous devez disposer d’un flux de travail vide.

    Pour utiliser une action système de fichiers, votre flux de travail peut commencer par n’importe quel déclencheur qui correspond le mieux à votre scénario.

    Si vous n’avez pas de ressource et de flux de travail d’application logique, consultez les articles suivants :

Ajouter un déclencheur de système de fichiers

  1. Dans le portail Azure, ouvrez votre ressource d’application logique Consommation.

  2. Dans les menus de la barre latérale des ressources, sous Outils de développement, sélectionnez le concepteur pour ouvrir votre flux de travail vide.

  3. Ajoutez le déclencheur système de fichiers souhaité pour votre scénario en suivant les étapes générales pour ajouter un déclencheur.

    Pour plus d’informations, consultez Déclencheurs de système de fichiers. Cet exemple continue avec le déclencheur nommé Lors de la création d’un fichier.

  4. Dans la zone des informations de connexion, fournissez les informations requises suivantes :

    Propriété Obligatoire Valeur Descriptif
    Nom de connexion Oui < nom-de-connexion> Nom à utiliser pour votre connexion
    Dossier racine Oui < root-folder-name> Le dossier racine de votre système de fichiers, qui est généralement le dossier parent principal et est le dossier utilisé pour les chemins relatifs avec tous les déclencheurs qui fonctionnent sur les fichiers.

    Par exemple, si vous avez installé la passerelle de données locale, utilisez le dossier local sur l’ordinateur avec l’installation de la passerelle de données. Vous pouvez également utiliser le dossier pour le partage réseau où l’ordinateur peut accéder à ce dossier, par exemple \PublicShare\MyFileSystem.
    Type d'authentification Non < type d'authentification> Type d’authentification utilisé par votre serveur de système de fichiers, soit Windows
    Nom d’utilisateur Oui < domain-and-username> Domaine et nom d’utilisateur de l’ordinateur qui héberge le système de fichiers.

    Pour le connecteur du système de fichiers managé, utilisez l’une des valeurs suivantes avec la barre oblique inverse (\) :

    - < domaine>\<username>
    - < >\<username>

    Par exemple, si le dossier de votre système de fichiers se trouve sur le même ordinateur que la passerelle de données locale, vous pouvez utiliser <local-computer>\<username>.
    Mot de passe Oui < mot de passe> Mot de passe de l'ordinateur qui héberge votre système de fichiers
    Passerelle Non - <Abonnement Azure>

    – <gateway-resource-name>
    Cette section s’applique uniquement au connecteur du système de fichiers managé :

    - Abonnement : Abonnement Azure associé à la ressource de passerelle de données
    - Passerelle de connexion : ressource de passerelle de données

    L’exemple suivant montre les informations de connexion pour le déclencheur de connecteur géré par le système de fichiers :

    Capture d’écran montrant le concepteur de workflow Consommation et les informations de connexion pour le déclencheur du connecteur managé Système de fichiers.

  5. Lorsque vous avez terminé, sélectionnez Créer nouveau.

    Azure Logic Apps crée et teste votre connexion pour vérifier son bon fonctionnement. Si la connexion est correctement configurée, les options d’installation s’affichent pour votre déclencheur sélectionné.

  6. Poursuivez l’élaboration de votre flux de travail.

    1. Fournissez les informations requises pour votre déclencheur.

      Pour cet exemple, sélectionnez le chemin du dossier sur votre serveur de système de fichiers pour rechercher un fichier nouvellement créé. Spécifiez le nombre de fichiers à retourner et la fréquence à vérifier.

      Capture d’écran montrant le concepteur de flux de travail Consommation et le déclencheur nommé Lors de la création d’un fichier.

    2. Pour tester votre flux de travail, ajoutez une action de connecteur Outlook qui vous envoie un e-mail lorsqu’un fichier est créé sur le système de fichiers dans le dossier spécifié. Entrez les destinataires, l’objet et le corps de l’e-mail. Pour tester, vous pouvez utiliser votre propre adresse e-mail.

      Capture d’écran montrant le concepteur de flux de travail Consommation, le déclencheur de connecteur managé nommé Lorsqu’un fichier est créé et l’action nommée Envoyer un e-mail.

      Conseil

      Pour ajouter des sorties des étapes précédentes du workflow, sélectionnez l’intérieur des zones d’édition du déclencheur. Lorsque la liste de contenu dynamique s’affiche, sélectionnez les sorties disponibles.

  7. Lorsque vous avez terminé, enregistrez votre flux de travail.

  8. Pour tester votre workflow, chargez un fichier, ce qui déclenche le workflow.

En cas de réussite, votre flux de travail envoie un e-mail sur le nouveau fichier.

Ajouter une action du système de fichiers

L’exemple de workflow d’application logique commence avec le déclencheur Dropbox, mais vous pouvez utiliser un autre déclencheur de votre choix.

  1. Dans le portail Azure, ouvrez votre ressource d’application logique Consommation.

  2. Dans le menu de la barre latérale des ressources, sous Outils de développement, sélectionnez le concepteur pour ouvrir votre flux de travail.

  3. Ajoutez l’action système de fichiers souhaitée pour votre scénario en suivant les étapes générales pour ajouter une action.

    Pour plus d’informations, consultez Déclencheurs de système de fichiers. Cet exemple continue avec l’action nommée Créer un fichier.

  4. Si vous y êtes invité, fournissez vos informations de connexion. Pour plus d’informations, consultez le tableau de la section précédente.

  5. Poursuivez l’élaboration de votre flux de travail.

    1. Fournissez les informations requises pour votre action.

      Pour cet exemple, sélectionnez le chemin du dossier sur votre serveur de système de fichiers à utiliser, qui est le dossier racine ici. Entrez le nom et le contenu du fichier, en fonction du fichier chargé dans Dropbox.

      Capture d’écran montrant le concepteur de flux de travail Consommation et l’action de connecteur géré par le système de fichiers nommée Créer un fichier.

      Conseil

      Pour ajouter des sorties des étapes précédentes du workflow, sélectionnez l’intérieur des zones d’édition de l’action. Lorsque la liste de contenu dynamique s’affiche, sélectionnez les sorties disponibles.

    2. Pour tester votre flux de travail, ajoutez une action Outlook qui vous envoie un e-mail lorsque l’action système de fichiers crée un fichier. Entrez les destinataires, l’objet et le corps de l’e-mail. Pour tester, vous pouvez utiliser votre propre adresse e-mail.

      Capture d’écran montrant le concepteur de workflow Consommation, l’action « Créer un fichier » du connecteur managé et l’action « Envoyer un e-mail ».

  6. Lorsque vous avez terminé, enregistrez votre flux de travail.

  7. Pour tester votre workflow, chargez un fichier, ce qui déclenche le workflow.

En cas de réussite, votre flux de travail crée un fichier sur votre serveur de système de fichiers, en fonction du fichier chargé dans DropBox et envoie un e-mail au sujet du fichier créé.