Partager via


Créer un workflow Logic Apps Intelligence Documentaire

Ce contenu s’applique à  coche v4.0 (préversion) | Versions précédentes :coche-bleue v3.1 (GA) coche-bleue v3.0 (GA)

Ce contenu s’applique à : cochev2.1 | Dernière version : coche-bleuev4.0 (préversion)

Important

Ce tutoriel et le connecteur d’application logique Intelligence Documentaire ciblent l’API REST Intelligence Documentaire v3.0 et versions ultérieures.

Important

Ce tutoriel et le connecteur d’application logique Intelligence Documentaire ciblent l’API REST Intelligence Documentaire v2.1. Ils doivent être utilisés avec l’outil d’étiquetage des exemples FOTT.

Azure Logic Apps est une plateforme informatique qui peut être utilisée pour automatiser les flux de travail sans écrire une seule ligne de code. Cette plateforme vous permet d’intégrer facilement des applications Microsoft et vos propres applications à vos applications, données, services et systèmes. Une application logique est la ressource Azure que vous créez lorsque vous voulez développer un flux de travail. Voici quelques exemples de ce que vous pouvez faire avec une application logique :

  • Créer visuellement des processus métier et des flux de travail
  • Intégrer des flux de travail à des applications SaaS et d’entreprise
  • Automatiser les tâches d’intégration d’applications d’entreprise (EAI), interentreprises (B2B) et d’échange de données informatisé (EDI).

Pour plus d’informations, consultez Vue d’ensemble de Logic Apps.

Ce tutoriel décrit comment construire un flux de connecteur d’application logique pour automatiser les tâches suivantes :

  • Détecter quand une facture a été ajoutée à un dossier OneDrive.
  • Traiter la facture avec le modèle de facture prédéfini d’Intelligence Documentaire.
  • Envoyer les informations extraites de la facture à une adresse e-mail préspécifiée.

Choisissez un flux de travail à l’aide d’un fichier de votre compte Microsoft OneDrive ou de votre site Microsoft ShareDrive :

Prérequis

Pour effectuer ce didacticiel, vous avez besoin des ressources suivantes :

  • Un abonnement Azure. Vous pouvez créer un abonnement Azure gratuit.

  • Un compte de stockage OneDrive ou OneDrive for Business gratuit.

    Notes

    • OneDrive est destiné au stockage personnel.
    • OneDrive Entreprise fait partie de la suite Office 365 et est conçu pour les organisations. Il fournit un stockage cloud dans lequel vous pouvez stocker, partager et synchroniser tous les fichiers de travail.
  • Un compte e-mail Outlook en ligne ou Office 365 gratuit**.

  • Un exemple de facture pour tester votre application logique. Vous pouvez télécharger et utiliser notre exemple de facture pour ce tutoriel.

  • Une ressource Intelligence Documentaire. Une fois que vous avez votre abonnement Azure, créez une ressource Intelligence Documentaire dans le portail Azure pour obtenir votre clé et votre point de terminaison. Si vous disposez déjà d’une ressource Intelligence Documentaire, accédez directement à la page de la ressource. Vous pouvez utiliser le niveau tarifaire Gratuit (F0) pour tester le service, puis passer par la suite à un niveau payant pour la production.

    • Une fois la ressource déployée, sélectionnez Accéder à la ressource. Copiez les valeurs Clés et point de terminaison depuis vos ressources sur le portail Azure et collez-les à un emplacement commode, par exemple le Bloc-notes Microsoft. Vous avez besoin des valeurs de la clé et du point de terminaison pour connecter votre application à l’API Intelligence Documentaire. Pour plus d’informations, consultez Créer une ressource Intelligence documentaire.

      Capture d’écran représentant comment accéder à la clé et à l’URL du point de terminaison de la ressource.

Créer un dossier OneDrive

Avant de nous lancer dans la création de l’application logique, nous devons configurer un dossier OneDrive.

  1. Allez sur votre page d’accueil OneDrive ou OneDrive Entreprise.

  2. Sélectionnez le bouton ➕ Nouveau dans la barre latérale supérieure gauche, puis sélectionnez Dossier.

    Capture d’écran du bouton Nouveau.

  3. Attribuez un nom à votre nouveau dossier et sélectionnez Créer.

    Capture d’écran de la fenêtre pour créer et nommer un dossier.

  4. Le nouveau dossier doit apparaître dans vos fichiers.

    Capture d’écran du nouveau dossier.

  5. Nous en avons terminé avec OneDrive pour l’instant.

Créer une ressource d’application logique

À ce stade, vous devez disposer d’une ressource Intelligence Documentaire et d’un dossier OneDrive. Il est maintenant temps de créer une ressource d’application logique.

  1. Accédez au portail Azure.

  2. Sélectionnez ➕ Créer une ressource sur la page d’accueil d’Azure.

    Capture d’écran de « Créer une ressource » sur le Portail Azure.

  3. Recherchez et sélectionnez Application logique dans la barre de recherche.

  4. Sélectionnez le bouton Créer.

    Capture d’écran de la page « Créer une application logique ».

  5. Ensuite, vous allez remplir les champs de la page Créer une application logique avec les valeurs suivantes :

    • Abonnement. Sélectionnez votre abonnement actuel.
    • Groupe de ressources. Le Groupe de ressources Azure qui contient votre ressource. Choisissez le même groupe de ressources que celui de la ressource Intelligence Documentaire.
    • Type. Sélectionnez Consommation. Le type de ressource Consommation s’exécute dans les applications logiques Azure mondiales et multilocataires et utilise le modèle de facturation Consommation.
    • Nom de l’application logique. Entrez un nom pour votre ressource. Nous vous recommandons d’utiliser un nom explicite, par exemple YourNameLogicApp.
    • Publication. Sélectionnez Workflow.
    • Région. Sélectionnez votre région locale.
    • Activer l’analytique des journaux d’activité. Pour ce projet, sélectionnez Non.
    • Type de plan. Sélectionnez Consommation. Le type de ressource Consommation s’exécute dans les applications logiques Azure mondiales et multilocataires et utilise le modèle de facturation Consommation.
    • Redondance de zone. Sélectionnez Désactivée.
  6. Une fois terminé, le résultat doit s’apparenter à l’image ci-dessous (le groupe de ressources, le nom de l’application logique et la région peuvent être différents). Après avoir vérifié ces valeurs, sélectionnez Vérifier + créer dans le coin inférieur gauche.

    Capture d’écran représentant les valeurs pour créer une ressource d’application logique.

  7. Un rapide contrôle de validation doit s’exécuter. Une fois l’opération terminée, sélectionnez Créer dans le coin inférieur gauche.

  8. Vous êtes ensuite redirigé vers un écran qui indique Déploiement en cours. Laissez à Azure le temps de se déployer ; cela peut prendre quelques minutes. Une fois le déploiement terminé, une bannière indiquant « Votre déploiement est terminé » doit s’afficher. Quand vous atteignez cet écran, sélectionnez Accéder à la ressource.

  9. Vous êtes alors redirigé vers la page du Concepteur d’application logique. Une courte vidéo présentant rapidement Azure Logic Apps est disponible sur l’écran d’accueil. Lorsque vous êtes prêt à démarrer la conception de votre application logique, sélectionnez le bouton Application logique vide dans la section Modèles.

    Capture d’écran représentant comment entrer dans le concepteur d’application logique.

  10. Un écran semblable à l’image suivante doit s’afficher. Vous êtes maintenant prêt à commencer à concevoir et à implémenter votre application logique.

    Capture d’écran de la page de démarrage du concepteur d’application logique.

Créer un flux d’automatisation

Maintenant que la ressource du connecteur d’applications logiques est installée et configurée, vous devez créer le flux d’automatisation et le tester.

  1. Recherchez et sélectionnez OneDrive ou OneDrive Entreprise dans la barre de recherche. Sélectionnez alors le déclencheur Quand un fichier est créé.

    Capture d’écran de la page du connecteur et du déclencheur OneDrive.

  2. Ensuite, une fenêtre contextuelle s’affiche et vous invite à vous connecter à votre compte OneDrive. Sélectionnez Se connecter et suivez les invites pour vous connecter à votre compte.

    Conseil

    Si vous essayez de vous connecter au connecteur OneDrive en utilisant un compte Office 365, vous pouvez recevoir l’erreur suivante : Désolé, nous ne pouvons pas vous connecter ici avec votre compte @MICROSOFT.COM.

    • Cette erreur se produit parce que OneDrive est un stockage informatique à usage personnel auquel on peut accéder avec un compte Outlook.com ou Microsoft Live, mais pas avec un compte Office 365.
    • Vous pouvez utiliser le connecteur OneDrive Entreprise si vous souhaitez utiliser un compte Office 365. Assurez-vous que vous avez créé un dossier OneDrive pour ce projet dans votre compte OneDrive Entreprise.
  3. Une fois votre compte connecté, sélectionnez le dossier que vous avez créé précédemment dans votre compte OneDrive ou OneDrive Entreprise. Conservez les autres valeurs par défaut.

    Capture d’écran de la fenêtre « Quand un fichier est créé ».

  1. Ensuite, nous allons ajouter une nouvelle étape au flux de travail. Sélectionnez le bouton ➕ Nouvelle étape sous le nœud OneDrive récemment créé.

    Capture d’écran de la configuration du déclencheur OneDrive.

  2. Un nouveau nœud doit s’ajouter à la vue du concepteur d’application logique. Recherchez Form Recognizer (prochainement Intelligence documentaire) dans la barre de recherche Choisir une opération, puis sélectionnez Analyser le document pour les modèles prédéfinis ou personnalisés (API v3.0) dans la liste.

    Capture d’écran du bouton « Analyser le document pour les modèles prédéfinis ou personnalisés (API v3.0) ».

  3. Une fenêtre permettant de créer votre connexion s’affiche alors. Plus précisément, vous allez connecter votre ressource Intelligence Documentaire au concepteur d’application logique :

    • Entrez un nom de connexion. Il doit être facile à mémoriser.

    • Entrez l’URL du point de terminaison et la clé de compte de la ressource Intelligence Documentaire que vous avez copiées précédemment. Si vous avez ignoré cette étape précédemment ou si vous avez perdu les chaînes, vous pouvez revenir à la ressource Intelligence Documentaire pour les copier de nouveau. Sélectionnez Créer lorsque vous avez terminé.

      Capture d’écran de la fenêtre de dialogue du connecteur d’application logique.

    Notes

    Si vous êtes déjà connecté avec vos informations d’identification, l’étape précédente est ignorée.

  4. Ensuite, la fenêtre des paramètres de sélection s’affiche pour le connecteur Analyser le document pour les modèles prédéfinis ou personnalisés (API v3.0).

    Capture d’écran de la fenêtre de sélection du modèle prédéfini.

  5. Renseignez les champs comme suit :

    • Identificateur du modèle. Indiquez le modèle que vous souhaitez appeler. Dans notre cas, nous appelons le modèle de facture prédéfini. Entrez prebuilt-invoice.

    • Contenu du fichier document/image. Sélectionnez ce champ. Une fenêtre contextuelle de contenu dynamique apparaît. Dans le cas contraire, sélectionnez le bouton Ajouter du contenu dynamique sous le champ et choisissez Contenu du fichier. Cette étape consiste essentiellement à envoyer le ou les fichiers à analyser vers le modèle de facture prédéfini d’Intelligence Documentaire. Si le badge Contenu du fichier s’affiche dans le champ Contenu du document ou de l’image, cela signifie que vous avez correctement effectué cette étape.

    • URL du document/de l’image. Ignorez ce champ pour ce projet (le dossier OneDrive pointe déjà directement vers le contenu du fichier).

    • Ajouter un nouveau paramètre. Ignorez ce champ pour ce projet.

      Capture d’écran de la fenêtre « Ajouter un contenu de fichier ».

  6. Nous devons ajouter plusieurs étapes supplémentaires. Une fois encore, sélectionnez le bouton ➕ Nouvelle étape pour ajouter une autre action.

  7. Dans la barre de recherche Choisir une opération,saisissez Contrôle et sélectionnez la vignette Contrôle.

    Capture d’écran de la vignette de contrôle dans le menu Choisir une opération.

  8. Faites défiler la fenêtre vers le bas et sélectionnez la vignette Pour chaque – Contrôle dans la liste Contrôle.

    Capture d’écran de la vignette Pour chaque contrôle dans le menu Contrôle.

  9. La fenêtre de l’étape Pour chaque comporte un champ intitulé Sélectionnez un résultat à partir des étapes précédentes. Sélectionnez ce champ. Une fenêtre contextuelle de contenu dynamique apparaît. Dans le cas contraire, sélectionnez le bouton Ajouter du contenu dynamique sous le champ et choisissez Documents.

    Capture d’écran de la liste des contenus dynamiques.

  10. À présent, sélectionnez Ajouter une action dans la fenêtre de l’étape Pour chaque.

  11. Dans la barre de recherche Choisir une opération, saisissez Outlook et sélectionnez Outlook.com (personnel) ou Office 365 Outlook (professionnel).

  12. Faites défiler la liste des actions vers le bas jusqu’à trouver Envoyer un e-mail (V2) et sélectionnez cette action.

    Capture d’écran du bouton d’action « Envoyer un e-mail (V2) »

  13. Comme avec OneDrive, vous êtes invité à vous connecter à votre compte Outlook ou Office 365 Outlook. Une fois connecté, une fenêtre s’affiche pour vous permettre de mettre en forme l’e-mail avec le contenu dynamique extrait de la facture par Intelligence documentaire.

  14. Nous allons utiliser l’expression suivante pour compléter certains des champs :

    
      items('For_each')?['fields']?['FIELD-NAME']?['content']
    
  15. Pour accéder à un champ spécifique, sélectionnez le bouton Ajouter du contenu dynamique, puis l’onglet Expression.

    Capture d’écran du champ de fonction « Expression ».

  16. Dans la zone ƒx, copiez-collez la formule ci-dessus et remplacez FIELD-NAME par le nom du champ à extraire. Pour obtenir une liste complète des champs disponibles, reportez-vous à la page de concept de l’API en question. Dans ce cas, vous devez utiliser les valeurs d’extraction de champ du modèle de facture prédéfini.

  17. Nous avons presque terminé ! Apportez les modifications suivantes aux champs suivants :

    • À. Entrez votre adresse e-mail personnelle ou professionnelle ou toute autre adresse e-mail à laquelle vous avez accès.

    • Objet. Entrez Facture reçue de : puis ajoutez l’expression suivante :

      
        items('For_each')?['fields']?['VendorName']?['content']
      
    • Corps. Nous allons ajouter des informations spécifiques sur la facture :

      • Saisissez ID de facture : et ajoutez l’expression suivante à l’aide de la méthode précédente :

        
        items('For_each')?['fields']?['InvoiceId']?['content']
        
      • Sur une nouvelle ligne, saisissez Échéance : et ajoutez l’expression suivante :

        
          items('For_each')?['fields']?['DueDate']?['content']
        
      • Saisissez Montant dû : et ajoutez l’expression suivante :

        
          items('For_each')?['fields']?['AmountDue']?['content']
        
      • Enfin, comme le montant dû est un nombre important, nous souhaitons également envoyer le score de confiance pour cette extraction dans l’e-mail. Pour ce faire, saisissez Montant dû (garanti) : et ajoutez l’expression suivante :

        
          items('For_each')?['fields']?['AmountDue']?['confidence']
        
    • Lorsque vous avez terminé, l’action ressemble à l’image suivante :

      Capture d’écran de la fenêtre « Envoyer un e-mail (V2) » avec les champs renseignés.

  18. Sélectionnez Enregistrer dans le coin supérieur gauche.

    Capture d’écran du bouton « Enregistrer » du concepteur d’application logique.

Remarque

  • La version actuelle ne renvoie qu’une seule facture par fichier PDF.
  • À l’avenir, pour activer un format de sortie capable de retourner plusieurs factures à partir de fichiers PDF, vous devez utiliser la boucle « Pour chaque » avec l’action « Envoyer un e-mail ».
  1. Ensuite, nous allons ajouter une nouvelle étape au flux de travail. Sélectionnez le bouton ➕ Nouvelle étape sous le nœud OneDrive récemment créé.

  2. Un nouveau nœud doit s’ajouter à la vue du concepteur d’application logique. Recherchez « Form Recognizer (prochainement Intelligence documentaire) » dans la barre de recherche Choisir une opération, puis sélectionnez Analyser la facture dans la liste.

    Capture d’écran de l’action « Analyser une facture ».

  3. Une fenêtre permettant de créer votre connexion s’affiche alors. Plus précisément, vous allez connecter votre ressource Form Recognizer à Logic Apps Designer Studio :

    • Entrez un nom de connexion. Il doit être facile à mémoriser.
    • Entrez l’URL du point de terminaison et la clé de compte de la ressource Form Recognizer que vous avez copiées précédemment. Si vous avez ignoré cette étape précédemment ou perdu les chaînes, vous pouvez revenir à votre ressource Form Recognizer et les copier de nouveau. Sélectionnez Créer lorsque vous avez terminé.

    Capture d’écran de la fenêtre de dialogue du connecteur d’application logique.

    Notes

    Si vous êtes déjà connecté avec vos informations d’identification, l’étape précédente est ignorée. Continuez en définissant les paramètres Analyser la facture.

  4. La fenêtre des paramètres de sélection s’affiche pour le connecteur Analyser une facture.

    Capture d’écran représentant les champs de la fenêtre « Analyser une facture ».

  5. Renseignez les champs comme suit :

    • Contenu du fichier document/image. Sélectionnez ce champ. Une fenêtre contextuelle de contenu dynamique apparaît. Dans le cas contraire, sélectionnez le bouton Ajouter du contenu dynamique sous le champ et choisissez Contenu du fichier. Cette étape consiste essentiellement à envoyer le ou les fichiers à analyser vers le modèle de facture prédéfini d’Intelligence Documentaire. Si le badge Contenu du fichier s’affiche dans le champ Contenu du document ou de l’image, cela signifie que vous avez correctement effectué cette étape.
    • URL du document/de l’image. Ignorez ce champ pour ce projet (le dossier OneDrive pointe déjà directement vers le contenu du fichier).
    • Inclure les détails du texte. Sélectionnez Oui.
    • Ajouter un nouveau paramètre. Ignorez ce champ pour ce projet.
  6. Nous devons ajouter la dernière étape. Une fois encore, sélectionnez le bouton ➕ Nouvelle étape pour ajouter une autre action.

  7. Dans la barre de recherche Choisir une opération, saisissez Outlook et sélectionnez Outlook.com (personnel) ou Office 365 Outlook (professionnel).

  8. Faites défiler la liste des actions vers le bas jusqu’à trouver Envoyer un e-mail (V2) et sélectionnez cette action.

  9. Connectez-vous à votre compte Outlook ou Office 365 Outlook. Ensuite, une fenêtre s’affiche pour vous permettre de mettre en forme l’e-mail à envoyer avec le contenu dynamique extrait de la facture.

    Capture d’écran du bouton d’action « Envoyer un e-mail (V2) »

  10. Nous avons presque terminé ! Saisissez les entrées suivantes dans les champs :

    • À. Entrez votre adresse e-mail personnelle ou professionnelle ou toute autre adresse e-mail à laquelle vous avez accès.

    • Objet. Entrez Facture reçue de : puis ajoutez le contenu dynamique Vendor name field Vendor name.

    • Corps. Nous allons ajouter des informations spécifiques sur la facture :

      • Saisissez ID de facture : et ajoutez le contenu dynamique Invoice ID field Invoice ID.

      • Sur une nouvelle ligne, tapez Date d’échéance de la facture : et ajoutez le contenu dynamique Invoice date field invoice date (date).

      • Tapez Montant dû : et ajoutez le contenu dynamique Amount due field Amount due (number).

      • Enfin, comme le montant dû est un nombre important, nous souhaitons également envoyer le score de confiance pour cette extraction dans l’e-mail. Pour ce faire, tapez Montant dû (confiance) : et ajoutez le contenu dynamique Amount due field confidence of amount due. Lorsque vous avez terminé, la fenêtre est semblable à l’image suivante.

      Capture d’écran des champs Outlook renseignées.

      Conseil

      Si le contenu dynamique ne s’affiche pas automatiquement, utilisez la barre Rechercher du contenu dynamique pour accéder aux entrées de champ.

  11. Sélectionnez Enregistrer dans le coin supérieur gauche.

    Capture d’écran du bouton « Enregistrer » du concepteur d’application logique.

    Remarque

    • La version actuelle ne renvoie qu’une seule facture par fichier PDF.
    • À l’avenir, vous devez utiliser la boucle « Pour chaque » avec l’action « Envoyer un e-mail » pour activer un format de sortie capable de retourner plusieurs factures à partir de fichiers PDF.

Prérequis

Pour effectuer ce didacticiel, vous avez besoin des ressources suivantes :

  • Un abonnement Azure. Vous pouvez créer un abonnement Azure gratuit.

  • Un accès à un site SharePoint.

  • Un compte e-mail Outlook en ligne ou Office 365 gratuit.

  • Un exemple de facture pour tester votre application logique. Vous pouvez télécharger et utiliser notre exemple de facture pour ce tutoriel.

  • Une ressource Intelligence Documentaire. Une fois que vous avez votre abonnement Azure, créez une ressource Intelligence Documentaire dans le portail Azure pour obtenir votre clé et votre point de terminaison. Si vous disposez déjà d’une ressource Intelligence Documentaire, accédez directement à la page de la ressource. Vous pouvez utiliser le niveau tarifaire Gratuit (F0) pour tester le service, puis passer par la suite à un niveau payant pour la production.

    • Une fois la ressource déployée, sélectionnez Accéder à la ressource. Copiez les valeurs Clés et point de terminaison depuis vos ressources sur le portail Azure et collez-les à un emplacement commode, par exemple le Bloc-notes Microsoft. Vous avez besoin des valeurs de la clé et du point de terminaison pour connecter votre application à l’API Intelligence Documentaire. Pour plus d’informations, consultez Créer une ressource Intelligence documentaire.

      Capture d’écran représentant comment accéder à la clé et à l’URL du point de terminaison de la ressource.

Créer un dossier SharePoint

Avant de nous lancer dans la création de l’application logique, nous devons configurer un dossier SharePoint.

  1. Connectez-vous à la page d’accueil de votre site SharePoint.

  2. Sélectionnez Documents, le bouton ➕ Nouveau situé dans le coin supérieur gauche de la fenêtre de site, puis choisissez Dossier.

    Capture d’écran du bouton « Nouveau ».

  3. Attribuez un nom à votre nouveau dossier et sélectionnez Créer.

    Capture d’écran de la fenêtre pour créer et nommer un dossier.

  4. Votre nouveau dossier se trouve dans votre bibliothèque de site.

    Capture d’écran du nouveau dossier créé.

  5. Nous en avons terminé avec SharePoint pour le moment.

Créer une ressource Application logique

À ce stade, vous devez disposer d’une ressource Intelligence documentaire et d’un dossier SharePoint. Il est maintenant temps de créer une ressource d’application logique.

  1. Accédez au portail Azure.

  2. Sélectionnez ➕ Créer une ressource sur la page d’accueil d’Azure.

    Capture d’écran de « Créer une ressource » sur le Portail Azure.

  3. Recherchez et sélectionnez Application logique dans la barre de recherche.

  4. Sélectionnez le bouton Créer.

    Capture d’écran de la page « Créer une application logique ».

  5. Ensuite, vous allez remplir les champs de la page Créer une application logique avec les valeurs suivantes :

    • Abonnement. Sélectionnez votre abonnement actuel.
    • Groupe de ressources. Le Groupe de ressources Azure qui contient votre ressource. Choisissez le même groupe de ressources que celui de la ressource Intelligence Documentaire.
    • Type. Sélectionnez Consommation. Le type de ressource Consommation s’exécute dans les applications logiques Azure mondiales et multilocataires et utilise le modèle de facturation Consommation.
    • Nom de l’application logique. Entrez un nom pour votre ressource. Nous vous recommandons d’utiliser un nom explicite, par exemple YourNameLogicApp.
    • Publication. Sélectionnez Workflow.
    • Région. Sélectionnez votre région locale.
    • Activer l’analytique des journaux d’activité. Pour ce projet, sélectionnez Non.
    • Type de plan. Sélectionnez Consommation. Le type de ressource Consommation s’exécute dans les applications logiques Azure mondiales et multilocataires et utilise le modèle de facturation Consommation.
    • Redondance de zone. Sélectionnez Désactivée.
  6. Une fois terminé, le résultat doit s’apparenter à l’image ci-dessous (le groupe de ressources, le nom de l’application logique et la région peuvent être différents). Après avoir vérifié ces valeurs, sélectionnez Vérifier + créer dans le coin inférieur gauche.

    Capture d’écran représentant les valeurs pour créer une ressource d’application logique.

  7. Un rapide contrôle de validation doit s’exécuter. Une fois l’opération terminée, sélectionnez Créer dans le coin inférieur gauche.

  8. Vous êtes ensuite redirigé vers un écran qui indique Déploiement en cours. Laissez à Azure le temps de se déployer ; cela peut prendre quelques minutes. Une fois le déploiement terminé, une bannière indiquant « Votre déploiement est terminé » doit s’afficher. Quand vous atteignez cet écran, sélectionnez Accéder à la ressource.

  9. Vous êtes alors redirigé vers la page du Concepteur d’application logique. Une courte vidéo présentant rapidement Azure Logic Apps est disponible sur l’écran d’accueil. Lorsque vous êtes prêt à démarrer la conception de votre application logique, sélectionnez le bouton Application logique vide dans la section Modèles.

    Capture d’écran représentant comment entrer dans le concepteur d’application logique.

  10. Un écran semblable à l’image suivante doit s’afficher. Vous êtes maintenant prêt à commencer à concevoir et à implémenter votre application logique.

    Capture d’écran de la page de démarrage du concepteur d’application logique.

  11. Recherchez et sélectionnez SharePoint dans la barre de recherche. Sélectionnez ensuite le déclencheur Quand un fichier est créé (propriétés uniquement).

    Capture d’écran de la page de sélection du connecteur et du déclencheur SharePoint.

  12. Logic Apps vous connecte automatiquement à votre compte SharePoint.

  13. Une fois votre compte connecté, renseignez les champs Adresse du site et Nom de la bibliothèque. Sélectionnez le champ Ajouter un nouveau paramètre, puis sélectionnez Dossier.

    Capture d’écran de la fenêtre Quand un fichier est créé avec un paramètre ajouté.

  14. Sélectionnez le chemin du répertoire, y compris le dossier que vous avez créé précédemment.

    Capture d’écran du champ de paramètre ajouté.

    Conseil

    Sélectionnez la flèche à la fin de chaque dossier répertorié pour accéder au dossier suivant dans le chemin : Capture d’écran de navigation dans le chemin de dossiers.

  1. Ensuite, nous allons ajouter une autre étape au flux de travail. Sélectionnez le bouton ➕ Nouvelle étape sous le nouveau nœud SharePoint créé.

  2. Recherchez et sélectionnez à nouveau SharePoint dans la barre de recherche. Ensuite, sélectionnez l’action Obtenir le contenu du fichier.

  3. Renseignez les champs comme suit :

    • Adresse du site. Sélectionnez votre site SharePoint.
    • Identificateur du fichier. Sélectionnez ce champ. Une fenêtre contextuelle de contenu dynamique apparaît. Dans le cas contraire, sélectionnez le bouton Ajouter du contenu dynamique sous le champ, puis choisissez Identificateur.
    • Déduisez le type de contenu. Sélectionnez Oui.

    Capture d’écran du nœud Obtenir le contenu du fichier.

  4. Nous allons ajouter une autre étape au flux de travail. Sélectionnez le bouton ➕ Nouvelle étape sous le nouveau nœud SharePoint créé.

  5. Un nouveau nœud doit s’ajouter à la vue du concepteur d’application logique. Recherchez Form Recognizer (prochainement Intelligence documentaire) dans la barre de recherche Choisir une opération, puis sélectionnez Analyser le document pour les modèles prédéfinis ou personnalisés (API v3.0) dans la liste.

    Capture d’écran du bouton « Analyser le document pour les modèles prédéfinis ou personnalisés (API v3.0) ».

  6. Une fenêtre permettant de créer votre connexion s’affiche alors. Plus précisément, vous allez connecter votre ressource Intelligence Documentaire au concepteur d’application logique :

    • Entrez un nom de connexion. Il doit être facile à mémoriser.

    • Entrez l’URL du point de terminaison et la clé de compte de la ressource Intelligence Documentaire que vous avez copiées précédemment. Si vous avez ignoré cette étape précédemment ou si vous avez perdu les chaînes, vous pouvez revenir à la ressource Intelligence Documentaire pour les copier de nouveau. Sélectionnez Créer lorsque vous avez terminé.

      Capture d’écran de la fenêtre de dialogue du connecteur d’application logique.

    Notes

    Si vous êtes déjà connecté avec vos informations d’identification, l’étape précédente est ignorée.

  7. Ensuite, la fenêtre des paramètres de sélection s’affiche pour le connecteur Analyser le document pour les modèles prédéfinis ou personnalisés (API v3.0).

    Capture d’écran de la fenêtre de sélection du modèle prédéfini.

  8. Renseignez les champs comme suit :

    • Identificateur du modèle. Indiquez le modèle que vous souhaitez appeler. Dans notre cas, nous appelons le modèle de facture prédéfini. Entrez prebuilt-invoice.
    • Contenu du fichier document/image. Sélectionnez ce champ. Une fenêtre contextuelle de contenu dynamique apparaît. Dans le cas contraire, sélectionnez le bouton Ajouter du contenu dynamique sous le champ et choisissez Contenu du fichier. Cette étape consiste essentiellement à envoyer le ou les fichiers à analyser vers le modèle de facture prédéfini d’Intelligence Documentaire. Si le badge Contenu du fichier s’affiche dans le champ Contenu du document ou de l’image, cela signifie que vous avez correctement effectué cette étape.
    • URL du document/de l’image. Ignorez ce champ pour ce projet (le dossier OneDrive pointe déjà directement vers le contenu du fichier).
    • Ajouter un nouveau paramètre. Ignorez ce champ pour ce projet.
  9. Nous devons ajouter plusieurs étapes supplémentaires. Une fois encore, sélectionnez le bouton ➕ Nouvelle étape pour ajouter une autre action.

  10. Contrôle et sélectionnez la vignette Contrôle.

    Capture d’écran de la vignette de contrôle. Dans la barre de recherche **Choisir une opération**, entrez un menu Opération.

  11. Faites défiler la fenêtre vers le bas et sélectionnez la vignette Pour chaque – Contrôle dans la liste Contrôle.

    Capture d’écran de la vignette Pour chaque contrôle dans le menu Contrôle.

  12. La fenêtre de l’étape Pour chaque comporte un champ intitulé Sélectionnez un résultat à partir des étapes précédentes. Sélectionnez ce champ. Une fenêtre contextuelle de contenu dynamique apparaît. Dans le cas contraire, sélectionnez le bouton Ajouter du contenu dynamique sous le champ et choisissez Documents.

    Capture d’écran de la liste des contenus dynamiques.

  13. À présent, sélectionnez Ajouter une actiondans la fenêtre de l’étape Pour chaque.

  14. Dans la barre de recherche Choisir une opération, saisissez Outlook et sélectionnez Outlook.com (personnel) ou Office 365 Outlook (professionnel).

  15. Faites défiler la liste des actions vers le bas jusqu’à trouver Envoyer un e-mail (V2) et sélectionnez cette action.

    Capture d’écran du bouton d’action « Envoyer un e-mail (V2) »

  16. Connectez-vous à votre compte Outlook ou Office 365 Outlook. Ensuite, une fenêtre s’affiche pour vous permettre de mettre en forme l’e-mail avec le contenu dynamique extrait de la facture par Intelligence documentaire.

  17. Nous allons utiliser l’expression suivante pour compléter certains des champs :

    
      items('For_each')?['fields']?['FIELD-NAME']?['content']
    
  18. Pour accéder à un champ spécifique, sélectionnez le bouton Ajouter du contenu dynamique, puis l’onglet Expression.

    Capture d’écran du champ de fonction « Expression ».

  19. Dans la zone ƒx, copiez-collez la formule ci-dessus et remplacez FIELD-NAME par le nom du champ à extraire. Pour obtenir une liste complète des champs disponibles, reportez-vous à la page de concept de l’API en question. Dans ce cas, vous devez utiliser les valeurs d’extraction de champ du modèle de facture prédéfini.

  20. Nous avons presque terminé ! Apportez les modifications suivantes aux champs suivants :

    • À. Entrez votre adresse e-mail personnelle ou professionnelle ou toute autre adresse e-mail à laquelle vous avez accès.

    • Objet. Entrez Facture reçue de : et laissez votre curseur positionné après les deux-points.

    • Entrez l’expression suivante dans le champ Expression, puis sélectionnez OK :

      
        items('For_each')?['fields']?['VendorName']?['content']
      
      • Après avoir entré l’expression dans le champ, sélectionnez le bouton OK et le badge de formule s’affiche là où vous avez laissé le curseur :

      Capture d’écran du champ d’expression de formule.

      Capture d’écran du badge d’expression de formule.

    • Corps. Nous allons ajouter des informations spécifiques sur la facture :

      • Tapez ID de facture : puis, en employant la même méthode que précédemment : positionnez le curseur, copiez l’expression suivante dans le champ d’expression, puis sélectionnez OK :

        
        items('For_each')?['fields']?['InvoiceId']?['content']
        
      • Sur une nouvelle ligne, saisissez Échéance : et ajoutez l’expression suivante :

        
          items('For_each')?['fields']?['DueDate']?['content']
        
      • Saisissez Montant dû : et ajoutez l’expression suivante :

        
          items('For_each')?['fields']?['AmountDue']?['content']
        
      • Enfin, comme le montant dû est un nombre important, nous souhaitons également envoyer le score de confiance pour cette extraction dans l’e-mail. Pour ce faire, saisissez Montant dû (garanti) : et ajoutez l’expression suivante :

        
          items('For_each')?['fields']?['AmountDue']?['confidence']
        
    • Lorsque vous avez terminé, l’action ressemble à l’image suivante :

      Capture d’écran de la fenêtre « Envoyer un e-mail (V2) » avec les champs renseignés.

  21. Sélectionnez Enregistrer dans le coin supérieur gauche.

    Capture d’écran du bouton « Enregistrer » du concepteur d’application logique.

Remarque

  • La version actuelle ne renvoie qu’une seule facture par fichier PDF.
  • À l’avenir, pour activer un format de sortie capable de retourner plusieurs factures à partir de fichiers PDF, vous devez utiliser la boucle « Pour chaque » avec l’action « Envoyer un e-mail ».

Après avoir enregistré votre application logique, si vous devez effectuer une mise à jour ou modifier votre nœud Pour chaque, le nœud se présente comme dans l’image suivante :

Capture d’écran du nœud Pour chaque après l’enregistrement de l’application.

  1. Recherchez et sélectionnez à nouveau SharePoint dans la barre de recherche. Ensuite, sélectionnez l’action Obtenir le contenu du fichier.

  2. Renseignez les champs comme suit :

    • Adresse du site. Sélectionnez votre site SharePoint.
    • Identificateur du fichier. Sélectionnez ce champ. Une fenêtre contextuelle de contenu dynamique apparaît. Dans le cas contraire, sélectionnez le bouton Ajouter du contenu dynamique sous le champ, puis choisissez Identificateur.
    • Déduisez le type de contenu. Sélectionnez Oui.

    Capture d’écran du nœud Obtenir le contenu du fichier.

  3. Ensuite, nous allons ajouter une nouvelle étape au flux de travail. Sélectionnez le bouton ➕ Nouvelle étape sous le nouveau nœud SharePoint créé.

  4. Un nouveau nœud doit s’ajouter à la vue du concepteur d’application logique. Recherchez « Form Recognizer (prochainement Intelligence Documentaire) » dans la barre de recherche Choisir une opération, puis sélectionnez Analyser la facture dans la liste.

    Capture d’écran de l’action « Analyser une facture ».

  5. Une fenêtre permettant de créer votre connexion s’affiche alors. Plus précisément, vous allez connecter votre ressource Form Recognizer à Logic Apps Designer Studio :

    • Entrez un nom de connexion. Il doit être facile à mémoriser.
    • Entrez l’URL du point de terminaison et la clé de compte de la ressource Form Recognizer que vous avez copiées précédemment. Si vous avez ignoré cette étape précédemment ou perdu les chaînes, vous pouvez revenir à votre ressource Form Recognizer et les copier de nouveau. Sélectionnez Créer lorsque vous avez terminé.

    Capture d’écran de la fenêtre de dialogue du connecteur d’application logique.

    Notes

    Si vous êtes déjà connecté avec vos informations d’identification, l’étape précédente est ignorée. Continuez en définissant les paramètres Analyser la facture.

  6. La fenêtre des paramètres de sélection s’affiche pour le connecteur Analyser une facture.

    Capture d’écran montrant la fenêtre Analyser une facture.

  7. Renseignez les champs comme suit :

    • Contenu du fichier document/image. Sélectionnez ce champ. Une fenêtre contextuelle de contenu dynamique apparaît. Dans le cas contraire, sélectionnez le bouton Ajouter du contenu dynamique sous le champ et choisissez Contenu du fichier. Cette étape consiste essentiellement à envoyer le ou les fichiers à analyser vers le modèle de facture prédéfini d’Intelligence Documentaire. Si le badge Contenu du fichier s’affiche dans le champ Contenu du document ou de l’image, cela signifie que vous avez correctement effectué cette étape.
    • URL du document/de l’image. Ignorez ce champ pour ce projet (le dossier OneDrive pointe déjà directement vers le contenu du fichier).
    • Inclure les détails du texte. Sélectionnez Oui.
    • Ajouter un nouveau paramètre. Ignorez ce champ pour ce projet.

    Capture d’écran représentant les champs de la fenêtre « Analyser une facture ».

  8. Nous devons ajouter la dernière étape. Une fois encore, sélectionnez le bouton ➕ Nouvelle étape pour ajouter une autre action.

  9. Dans la barre de recherche Choisir une opération, saisissez Outlook et sélectionnez Outlook.com (personnel) ou Office 365 Outlook (professionnel).

  10. Faites défiler la liste des actions vers le bas jusqu’à trouver Envoyer un e-mail (V2) et sélectionnez cette action.

  11. Connectez-vous à votre compte Outlook ou Office 365 Outlook. Ensuite, une fenêtre s’affiche pour vous permettre de mettre en forme l’e-mail à envoyer avec le contenu dynamique extrait de la facture.

    Capture d’écran du bouton d’action « Envoyer un e-mail (V2) »

  12. Nous avons presque terminé ! Saisissez les entrées suivantes dans les champs :

    • À. Entrez votre adresse e-mail personnelle ou professionnelle ou toute autre adresse e-mail à laquelle vous avez accès.

    • Objet. Entrez Facture reçue de : puis ajoutez le contenu dynamique Vendor name field Vendor name.

    • Corps. Nous allons ajouter des informations spécifiques sur la facture :

      • Saisissez ID de facture : et ajoutez le contenu dynamique Invoice ID field Invoice ID.

      • Sur une nouvelle ligne, tapez Date d’échéance de la facture : et ajoutez le contenu dynamique Invoice date field invoice date (date).

      • Tapez Montant dû : et ajoutez le contenu dynamique Amount due field Amount due (number).

      • Enfin, comme le montant dû est un nombre important, nous souhaitons également envoyer le score de confiance pour cette extraction dans l’e-mail. Pour ce faire, tapez Montant dû (confiance) : et ajoutez le contenu dynamique Amount due field confidence of amount due. Lorsque vous avez terminé, la fenêtre est semblable à l’image suivante.

      Capture d’écran des champs Outlook renseignées.

      Conseil

      Si le contenu dynamique ne s’affiche pas automatiquement, utilisez la barre Rechercher du contenu dynamique pour accéder aux entrées de champ.

  13. Sélectionnez Enregistrer dans le coin supérieur gauche.

    Capture d’écran du bouton « Enregistrer » du concepteur d’application logique.

    Remarque

    • La version actuelle ne renvoie qu’une seule facture par fichier PDF.
    • À l’avenir, vous devez utiliser la boucle « Pour chaque » avec l’action « Envoyer un e-mail » pour activer un format de sortie capable de retourner plusieurs factures à partir de fichiers PDF.

Tester le flux d’automatisation

Passons rapidement en revue ce que nous avons fait avant de tester notre flux :

  • Dans ce scénario, nous avons créé un déclencheur. Celui-ci s’active lorsqu’un fichier est créé dans un dossier prédéfini du compte OneDrive.
  • Nous avons ajouté une action Intelligence Documentaire au flux. Dans ce scénario, nous avons décidé d’utiliser l’API de facturation pour analyser automatiquement les factures du dossier OneDrive.
  • Nous avons ajouté une action Outlook.com au flux. Nous avons envoyé certaines données de la facture analysée à une adresse e-mail prédéfinie.

Maintenant que nous avons créé le flux, la dernière chose à faire est de le tester et de vérifier que nous obtenons le comportement attendu.

  1. Pour tester l’application logique, ouvrez un nouvel onglet, puis accédez au dossier OneDrive que vous avez configuré au début de ce tutoriel. Ajoutez ce fichier au dossier OneDrive Exemple de facture.

  2. Revenez à l’onglet Concepteur d’applications logiques et sélectionnez le bouton Exécuter le déclencheur, puis sélectionnez Exécuter dans le menu déroulant.

    Capture d’écran du déclencheur et du bouton « Exécuter ».

  3. Un message indiquant que le déclencheur a aboutit s’affiche dans l’angle supérieur droit :

    Capture d’écran du message de réussite du déclencheur.

  4. Accédez à la page de présentation de l’application logique en sélectionnant le lien du nom de votre application dans l’angle supérieur gauche.

    Capture d’écran de la navigation pour accéder au lien vers la page de présentation.

  5. Vérifiez le statuts, afin de déterminer si l’exécution a réussi ou échoué. Vous pouvez sélectionner l’indicateur « Statut » pour déterminer quelles étapes ont abouti.

    Capture d’écran représentant le statut « Réussite » ou « Échec ».

  6. En cas d’échec de l’exécution, contrôlez l’étape en échec afin de vérifier que les informations saisies sont correctes.

    Capture d’écran de l’étape en échec.

  7. Après la réussite d’un workflow, vérifiez votre e-mail. Vous avez un nouvel e-mail avec les informations définies.

    Capture d’écran de l’e-mail reçu.

  8. Une fois terminé, désactivez ou supprimez votre application logique pour mettre fin à l’utilisation.

    Capture d’écran des boutons « Désactiver » et « Supprimer ».

Félicitations ! Vous avez terminé ce tutoriel.

Étapes suivantes