Créer votre première application Microsoft Graph Data Connect

Microsoft Graph Data Connect (Data Connect) enrichit les API transactionnelles avec un moyen intelligent d’accéder à des données enrichies à grande échelle. Data Connect est idéal pour les applications Big Data et le Machine Learning, car il vous permet de développer des applications pour l’analytique, l’intelligence et l’optimisation des processus métier en étendant les données Microsoft 365 à Microsoft Azure. Grâce à cette offre, vous serez en mesure de tirer parti de la vaste suite de calcul et de stockage dans Azure tout en restant conforme aux normes du secteur et en assurant la sécurité de vos données.

Data Connect utilise Microsoft Fabric, Azure Synapse ou Azure Data Factory pour copier des données Microsoft 365 dans le stockage de votre application à intervalles configurables. Il fournit également un ensemble d’outils pour simplifier la livraison de ces données à Azure, ce qui vous permet d’accéder aux outils de développement et d’hébergement les plus applicables disponibles.

La Connexion aux données autorise également un modèle de consentement et de contrôle plus granulaire : vous pouvez gérer des données, voir les utilisateurs qui y accèdent et demander les propriétés spécifiques d’une entité. Cela améliore le modèle Microsoft Graph qui autorise ou refuse l’accès aux applications à des entités entières.

En outre, vous pouvez utiliser Data Connect pour activer des scénarios de Machine Learning pour votre organization. Dans ces scénarios, vous pouvez créer des applications qui fournissent des informations précieuses aux parties prenantes, forment les modèles d’apprentissage automatique et réalisent également des prévisions basées sur de grandes quantités de données acquises.

Prise en main

Dans ce tutoriel, vous allez créer votre première application Data Connect monolocataire. Le flux général suivant explique le processus d’intégration de Data Connect.

1. Administration active Data Connect : la première étape de l’intégration consiste à permettre à votre administrateur général d’activer Data Connect.

2. Le développeur crée une application Microsoft Entra : le développeur doit d’abord créer une application Microsoft Entra.

3. Le développeur inscrit l’application auprès de Data Connect : Une fois l’application Microsoft Entra créée, le développeur doit inscrire l’application auprès de Data Connect à l’aide du nouveau portail d’inscription pour les applications Microsoft Graph Data Connect. Dans cette étape, le développeur spécifie les données dont il a besoin pour son application.

4. Administration approuve l’application : une fois que le développeur a inscrit son application auprès de Data Connect, l’administrateur général peut utiliser le nouveau portail pour le consentement de l’application Data Connect pour examiner l’application inscrite et l’approuver.

5. Le développeur exécute ses pipelines : Une fois que l’administrateur a donné son consentement à l’application, le développeur peut exécuter ses pipelines sans bloquer le consentement de l’exécution. La création et l’exécution du pipeline via Azure Data Factory ou Azure Synapse restent les mêmes.

Remarque

Si vous travaillez dans un nouveau locataire sur lequel La connexion aux données n’est pas activée, vous n’avez pas besoin d’effectuer d’action. Si vous disposez déjà d’un locataire sur lequel Microsoft Graph Data Connect est déjà activé, avant de terminer ce didacticiel, demandez à votre administrateur général de désactiver Microsoft Graph Data Connect, puis de le réactiver dans le portail d’administration.

Configuration requise

Pour suivre ce didacticiel, vous avez besoin des abonnements ou licences suivants.

• Pour ce didacticiel, nous vous recommandons vivement d’utiliser un client développeur Microsoft 365.
• Vos locataires Microsoft 365 et Azure doivent se trouver dans le même Microsoft Entra location.
• L’abonnement Azure doit se trouver dans le même locataire que le locataire Microsoft 365.
• Le rôle Administrateur général est activé pour un utilisateur de votre client Microsoft 365. À l’avenir, ce tutoriel fait référence à cet utilisateur en tant qu'« administrateur ». Seul un utilisateur « administrateur » peut approuver l’application de test.
• Un autre utilisateur dans votre locataire Microsoft 365 avec le rôle Administrateur d’application ou Développeur d’applications . À l’avenir, ce tutoriel fait référence à cet utilisateur en tant que « développeur ». L’utilisateur développeur effectue la majorité de ce didacticiel.

1. Location Microsoft 365

   • Si vous n’avez pas de locataire Microsoft 365, vous pouvez être éligible pour un client via le Programme pour les développeurs Microsoft 365 ; Pour plus d’informations, consultez la FAQ. Vous pouvez également vous inscrire à un essai gratuit de 1 mois ou acheter un plan Microsoft 365.

   Remarque

   Vous ne pouvez pas approuver votre propre application de test à l’aide du même compte. Assurez-vous que votre locataire dispose d’un autre membre (ou compte) qui agit en tant qu’administrateur.

2. Abonnement Microsoft Azure

   • Si vous n’avez pas d’abonnement Microsoft Azure, consultez le lien suivant pour en obtenir un (gratuitement) : Créer votre compte gratuit Azure.
   • Votre abonnement Azure doit se trouver dans le même locataire que votre locataire Microsoft 365 et les deux doivent se trouver dans le même Microsoft Entra location.
   • Si votre abonnement Azure n’est pas dans le même locataire que votre locataire Microsoft 365, vous pouvez associer votre abonnement à Microsoft Entra ID dans votre locataire Microsoft 365 en suivant les étapes indiquées dans Associer ou ajouter un abonnement Azure à votre locataire Microsoft Entra.

   Remarque

   Les captures d’écran et les exemples utilisés dans ce tutoriel proviennent d’un client développeur Microsoft 365 avec un exemple d’e-mail d’utilisateurs de test. Vous pouvez utiliser votre propre locataire Microsoft 365 pour effectuer les mêmes étapes. Aucune donnée n’est écrite dans Microsoft 365. Une copie des données d’e-mail est extraite de tous les utilisateurs d’un client Microsoft 365 et copiée dans un compte Stockage Blob Azure. Vous contrôlez qui a accès aux données dans le Stockage Blob Azure.

Configurer votre locataire Microsoft 365 et activer Microsoft Graph Data Connect

Avant d’utiliser Microsoft Graph Data Connect (Connexion aux données) pour la première fois, contactez votre administrateur de locataire Microsoft 365 pour activer le service Data Connect pour votre locataire.

Pour ce didacticiel, vérifiez que vous disposez d’un compte avec des privilèges d’administrateur disponibles. Vous devez effectuer cette étape pour configurer votre premier pipeline. Nous vous recommandons d’avoir au moins deux utilisateurs dans votre locataire Microsoft 365 avec le rôle d’administrateur général activé.

• Rôle intégré Administrateur général.
• Élever l’accès pour obtenir le rôle Administrateur général.

Activer Microsoft Graph Data Connect dans votre client Microsoft 365

Configurez votre client Microsoft 365 pour activer l’utilisation de Microsoft Graph Data Connect.

1. Ouvrez un navigateur, accédez à votre portail d’administration Microsoft 365 et connectez-vous avec votre utilisateur administrateur .

2. Sélectionnez Paramètres > de l’organisation. Vous devrez peut-être choisir Afficher tout avant de pouvoir afficher les paramètres.

3. Sous l’onglet Services (qui doit être la sélection par défaut), sélectionnez Connexion aux données Microsoft Graph.

4. Cochez la case Activer ou désactiver La connexion aux données Microsoft Graph pour l’ensemble de votre organization, puis choisissez Enregistrer.

   

Félicitations, vous venez d’activer Microsoft Graph Data Connect pour votre organization !

Configurer votre application Microsoft Entra

Dans cet exercice, vous allez apprendre à créer une application Microsoft Entra. Il sert de principal de sécurité pour exécuter le processus d’extraction de données avec Microsoft Graph Data Connect.

1. Connectez-vous au centre d’administration Microsoft Entra avec au moins le rôle Administrateur d’application ouDéveloppeur d’applications.

2. Développez le menu >Identité, sélectionnez Applications>inscriptions d'applications>Nouvelle inscription.

3. Utilisez les valeurs suivantes pour créer une application Microsoft Entra et sélectionnez Inscrire.

   • Nom : Transfert de données Microsoft Graph Data Connect (indiquez le nom de votre choix).
   • Types de comptes pris en charge : comptes de cet annuaire organisationnel uniquement.
   • URI de redirection : conservez les valeurs par défaut.

   

4. Recherchez l’ID d’application (client) et copiez-le comme vous en avez besoin plus loin dans ce tutoriel. À l’avenir, il s’agit de l’ID du principal de service.

5. Recherchez l’ID d’annuaire (locataire) et copiez-le comme vous en avez besoin plus loin dans ce tutoriel. À l’avenir, il s’agit de l’ID de locataire.

   

6. Dans le volet de navigation gauche, sélectionnez Certificats & secrets sous Gérer.

7. Sélectionnez le bouton Nouveau secret client. Définissez Description sur n’importe quel nom, définissez Expire sur n’importe quelle valeur dans la liste déroulante, puis choisissez Ajouter.

   

   • Une fois la clé secrète client créée, veillez à enregistrer la valeur dans un endroit sûr, car elle ne sera plus disponible ultérieurement . dans le cas contraire, vous devez en créer un.
   • À l’avenir, la clé secrète client est appelée clé du principal de service.

8. Dans le volet de navigation gauche de l’application, sélectionnez Propriétaires.

9. Vérifiez que votre compte (si vous utilisez un locataire développeur, utilisez le compte d’administrateur général) répond aux exigences suivantes pour être propriétaire d’application :

   • Votre compte d’utilisateur correspond à un utilisateur valide dans le locataire qui n’est pas un nom de principal de service.
   • Une licence Exchange Online doit être attribuée à votre compte (doit avoir une boîte aux lettres).
   • En plus de la licence Exchange Online, votre compte doit également disposer d’un abonnement/licence E5 opérationnel.

10. Vérifiez que votre compte est répertorié en tant que propriétaire d’application. Si ce n’est pas le cas, ajoutez-le à la liste.

    

Configurer votre ressource Stockage Azure

Dans cette étape, vous allez créer un compte de stockage Azure dans lequel Microsoft Graph Data Connect stockera les données extraites de Microsoft 365 pour un traitement ultérieur.

1. Ouvrez un navigateur et accédez à votre Portail Azure.

2. Connectez-vous à l’aide d’un compte avec un rôle Développeur d’applications à votre Portail Azure.

3. Dans la barre latérale de navigation, sélectionnez Créer une ressource.

4. Recherchez le type de ressource compte de stockage et utilisez les valeurs suivantes pour le configurer. Pour Performances, Redondance et l’onglet Avancé, les valeurs de ces champs sont un exemple.

   • Abonnement : sélectionnez votre abonnement Azure
   • Groupe de ressources : mgdc-app-resource (ou sélectionnez un groupe de ressources existant)
   • Nom du compte de stockage : mgdcdemoap (ou vous pouvez nommer et sélectionner votre propre compte de stockage)
   • Région : choisissez une région Azure dans la même région que votre région Microsoft 365
   • Performances : Standard
   • Redondance : stockage géoredondant
   • Onglet Avancé :
     • Niveau d’accès : Chaud

   

5. Après avoir configuré les valeurs des onglets De base et Avancé , conservez le reste des paramètres par défaut.

   Remarque

   Vérifiez que sous l’onglet Mise en réseau , l’option Activer l’accès public à partir de tous les réseaux est activée. Vous pouvez également sélectionner la deuxième option Activer l’accès public à partir de réseaux virtuels et d’adresses IP sélectionnés . Toutefois, des étapes supplémentaires en dehors de ce didacticiel doivent être effectuées, qui sont mises en surbrillance dans la section Adresses IP.

   

6. Vérifiez que les paramètres correspondent à ceux indiqués dans les étapes précédentes, puis sélectionnez Créer pour finaliser.

7. Une fois le compte stockage Azure créé, accordez à l’application Microsoft Entra précédemment créée l’accès approprié à celui-ci.

   1. Sélectionnez le compte Stockage Azure.
   2. Dans le menu de la barre latérale, sélectionnez Contrôle d’accès (IAM).
   3. Sélectionnez le bouton Ajouter dans le bloc Ajouter une attribution de rôle .
   4. Accordez le rôle Contributeur aux données Blob du stockage à l’application que vous avez créée précédemment.
      1. Sélectionnez Contributeur aux données Blob du stockage comme Rôle, puis cliquez sur Suivant.
      2. Attribuez l’accès àl’utilisateur, au groupe ou au principal de service.
      3. Cliquez sur + Sélectionner des membres, puis dans le volet droit qui s’affiche, recherchez l’application (Transfert de données de connexion de données Microsoft Graph) que vous avez créée précédemment, puis cliquez sur Sélectionner.
   5. Sélectionnez Révision + affecter.

   

8. Créez un conteneur dans le compte de stockage Azure mgdcdemoap .

   1. Sélectionnez le compte de stockage Azure mgdcdemoapp (ou le nom de votre compte à l’étape 4).

   2. Dans le menu latéral, sélectionnez Conteneurs sous la section Service de stockage de données .

   3. Sélectionnez le bouton +Conteneur en haut de la page, utilisez les valeurs suivantes, puis sélectionnez Créer.

      • Nom : m365mails
      • Niveau d’accès public : Privé (aucun accès anonyme)

      

Inscrire votre application Microsoft Entra auprès de Microsoft Graph Data Connect

En tant que prérequis, vous devez activer La connexion aux données dans votre locataire. Nous vous recommandons de créer une application Microsoft Entra et une ressource de destination de stockage. Vous pouvez également les configurer à l’aide de l’Assistant. Le processus d’inscription d’application dans Data Connect implique l’utilisation d’un Assistant avec trois onglets : Informations d’inscription, Jeux de données et Vérifier + créer.

1. Accédez à Microsoft Graph Data Connect dans le Portail Azure. Vous pouvez le trouver via la barre de recherche dans le Portail Azure

2. Choisissez Ajouter ou Ajouter une nouvelle application.

   

3. Suivez l’Assistant Ajouter pour fournir les détails du projet pour l’inscription. Une fois que vous avez rempli les champs obligatoires>, choisissez Suivant : Jeux de données

   1. Abonnement: Sélectionnez un abonnement pour filtrer les sélections suivantes :
      • Groupe de ressources : Sélectionnez le groupe de ressources que vous avez créé précédemment.
      • Type de destination : Sélectionnez Compte de stockage Azure.
      • Compte de stockage : Sélectionnez le compte de stockage que vous avez créé précédemment.
      • URI du compte de stockage : Sélectionnez l’option avec .blob.core.windows.net
   2. ID d’application : Sélectionnez un locataire Microsoft Entra existant ou créez-en un.
   3. Description: Tapez Ma première application.
   4. Type de publication :un seul locataire doit être choisi automatiquement en fonction de votre application Microsoft Entra.

   

4. Sélectionnez Suivant : Jeux de données >.

5. Sélectionnez BasicDataSet_v0.Message_v1 dans la liste déroulante Jeu de données , puis dans la liste déroulante Colonnes , choisissez All. Dans la nouvelle ligne, sélectionnez BasicDataSet_v1 dans la liste déroulante Jeu de données , puis dans la liste déroulante Colonnes , choisissez All.

   

6. Choisissez Vérifier + créer, puis Créer.

   

7. Si tous les champs obligatoires sont fournis, l’inscription de l’application s’affiche dans la page d’accueil.

   

Approuver votre application pour Microsoft Graph Data Connect

1. Ouvrez une nouvelle fenêtre de navigateur en mode privé, accédez à votre Centre d’administration Microsoft 365 et connectez-vous avec votre utilisateur administrateur.

Remarque

Si vous n’êtes pas dans votre compte administrateur , une erreur s’affiche lors de l’approbation. Vous ne pouvez pas approuver automatiquement vos applications.

1. Dans le volet de navigation gauche, sélectionnez Paramètres > De l’organisation. Vous devrez peut-être choisir Afficher tout avant de pouvoir afficher les paramètres.

2. Basculez vers l’onglet Sécurité & confidentialité et sélectionnez Applications Microsoft Graph Data Connect.

   

3. Dans le portail des applications Microsoft Graph Data Connect, recherchez l’application que vous avez inscrite précédemment auprès de Data Connect. Il doit avoir un status pré-consentement dans le tableau récapitulatif de l’application.

   

4. Sélectionnez votre application pour ouvrir la vue des détails de l’application. Passez à l’Assistant en choisissant Deux fois suivant pour passer en revue les deux jeux de données.

5. À la dernière étape, choisissez Approuver pour autoriser votre application inscrite à accéder aux données spécifiées.

   

6. Approuver le rechargement de la table récapitulative de l’application avec votre application répertoriée avec le status Approuvé.

   

Configurer votre ressource Azure avec Azure Synapse ou Azure Data Factory

Cet exercice explique comment configurer vos ressources Azure et y connecter Microsoft Graph Data Connect (Connexion aux données). Dans cette étape, vous pouvez choisir Azure Synapse, Azure Data Factory ou Microsoft Fabric pour créer un pipeline pour extraire les données de Microsoft 365 vers le compte de stockage Azure à l’aide de Data Connect.

Configuration de vos ressources Azure

Créer un pipeline Azure Synapse

1. Ouvrez un navigateur et accédez à votre Portail Azure.

2. Connectez-vous au portail à l’aide d’un compte avec un rôle Administrateur d’application ou Développeur d’applications . Vérifiez que vous êtes connecté avec votre compte de développeur qui dispose des privilèges permettant de créer des ressources Azure dans votre abonnement.

3. Dans le volet gauche, sélectionnez Créer une ressource.

4. Recherchez le type de ressource Azure Synapse Analytics, entrez les valeurs suivantes, puis sélectionnez Créer.

   • Abonnement: Sélectionnez votre abonnement Azure.

   • Groupe de ressources : Sélectionnez le groupe de ressources que vous avez créé précédemment, mgdc-app-resource.

   • Région :sélectionnez une région Azure dans la même région que votre locataire Microsoft 365.

   • Nom de l’espace de travail : m365tostorage

   • Nom du compte : synapsedatalstorage

   • Nom du système de fichiers : flsynapse

     

     

5. Sélectionnez Accéder à la ressource, ouvrez l’espace de travail synapse que vous venez de créer (par exemple, m365tostorage), puis sélectionnez la vignette Ouvrir Synapse Studio pour lancer l’éditeur plein écran Azure Synapse espace de travail.

   

6. Par défaut, Azure Synapse Analytics utilise un runtime d’intégration qui résout automatiquement la région. Dans ce tutoriel, nous vous recommandons d’utiliser l’option de résolution automatique par défaut dans le locataire développeur.

   1. Basculez vers Gérer (icône de boîte à outils) > Runtimes > d’intégration Nouveau.

   2. Sélectionnez Azure, Auto-hébergé, puis choisissez Continuer.

      

   3. Pour l’environnement réseau, sélectionnez Azure, puis choisissez Continuer.

      

   4. Utilisez les informations suivantes pour remplir le formulaire sur l’écran final, puis choisissez Créer.

      • Nom : nom de votre runtime d’intégration.
      • Région : sélectionnez la région qui correspond à votre région Microsoft 365.

7. Dans le volet gauche, sélectionnez Intégrer (icône de tube).

8. Pour créer un pipeline, sélectionnez l’icône Plus , puis choisissez Pipeline.

   

   1. Dans la zone de recherche, entrez Copier les données , puis faites glisser l’activité Copier des données de la section Déplacer & transformer vers l’aire de conception.

      

   2. Sélectionnez l’activité dans le concepteur.

   3. Sélectionnez l’onglet Général et donnez-lui un nom.

      • Nom: CopyFromM365toStorage

   4. Sélectionnez l’onglet Source , puis sélectionnez Nouveau.

      

   5. Recherchez et sélectionnez le jeu de données Microsoft 365 (Office 365), puis choisissez Continuer.

      

   6. Sous Service lié, choisissez Sélectionner, puis +Nouveau.

      

   7. Dans la boîte de dialogue, dans la liste déroulante Se connecter via le runtime d’intégration, sélectionnez le runtime d’intégration que vous avez créé, entrez respectivement l’ID d’application et la valeur de clé secrète client de l’application Microsoft Entra dans les champs ID du principal du service et Clé du principal de service, puis choisissez Créer.

      

   8. Dans le champ Nom de la table , sélectionnez BasicDataSet_v0. Message_v1, puis choisissez OK.

      

   9. Sous l’onglet Source , recherchez la section Filtre de date et utilisez les valeurs suivantes pour la configurer.

      • Nom de la colonne : CreatedDateTime

      • Heure de début (UTC) : Sélectionnez une date antérieure à la date actuelle.

      • Heure de fin (UTC) : Sélectionnez la date actuelle.

      • Dans la section Colonnes de sortie , sélectionnez Importer le schéma.

        

   10. Sélectionnez l’onglet Récepteur. Choisissez Nouveau, sélectionnez Stockage Blob Azure, puis continuer.

   

   

   1. Pour le format des données, sélectionnez Binaire, puis choisissez Continuer.

   2. Donnez au jeu de données le nom M365JsonFile et suivez les étapes suivantes pour créer un service lié s’il n’existe pas déjà.

      

      1. Sous Service lié, choisissez Sélectionner, puis +Nouveau.
      2. Dans la boîte de dialogue, définissez les valeurs suivantes, puis choisissez Créer.
         • Type d’authentification : Service Principal
         • Abonnement Azure : Sélectionnez tout.
         • Nom du compte de stockage : mgdcm365datastore. Il s’agit du compte de stockage créé précédemment dans cet exercice.
         • ID du principal de service : Entrez l’ID de l’application Microsoft Entra que vous avez créée.
         • Clé du principal de service : Entrez la clé hachée de l’application Microsoft Entra que vous avez créée.

      

   3. En regard du champ Chemin d’accès au fichier, sélectionnez Parcourir.

   4. Sélectionnez le nom du conteneur de stockage que vous avez créé précédemment, choisissez OK, puis choisissez à nouveau OK .

      

9. Une fois le pipeline créé, en haut du concepteur, choisissez Valider tout.

1. Après avoir validé (et résolu les problèmes détectés), en haut du concepteur, choisissez Publier tout.

Exécuter le pipeline Azure Synapse Analytics

Maintenant que vous avez créé le pipeline, il est temps de l’exécuter.

Remarque

L’affichage de la demande de consentement peut prendre plusieurs minutes, et il n’est pas rare que l’ensemble du processus (démarrer, demander le consentement et après avoir approuvé le consentement à la fin de l’exécution du pipeline) prenne plus de 40 minutes.

1. Dans le concepteur Azure Synapse Analytics, avec le pipeline ouvert, sélectionnez Ajouter un déclencheur > maintenant, puis choisissez OK.

   

2. Après avoir démarré le travail, dans le menu de la barre latérale, sélectionnez Surveiller pour afficher les travaux en cours d’exécution.

3. Dans le volet gauche, sélectionnez l’onglet Exécutions du pipeline . Dans la colonne Nom du pipeline , sélectionnez le pipeline pour afficher les exécutions d’activité. Ce pipeline s’affiche comme Étant en cours.

   

4. Une fois que vous êtes dans la vue Exécutions d’activité, accédez à la section Exécutions d’activité sur le côté inférieur de la page.

5. Pointez sur le nom de l’activité et sélectionnez l’option lunettes. L’onglet Détails s’ouvre.

   

6. Dans l’écran Détails, recherchez le status de l’activité du pipeline, comme mis en évidence dans l’image suivante. Le status doit passer par Initialisation, Consentement en attente, Extraction des données, Persistance des données et Réussite. Aucune action supplémentaire n’est nécessaire pour cela.

   

7. La demande est envoyée à l’administrateur général pour être approuvée. Pour le contexte de ce didacticiel, nous vous recommandons d’ouvrir un autre onglet avec vos privilèges d’administrateur activés afin de pouvoir approuver la demande de pipeline.

Créer un pipeline Azure Data Factory

1. Ouvrez un navigateur et accédez à votre Portail Azure.

2. Connectez-vous au Portail Azure avec un compte qui a le rôle Administrateur d’application ou Développeur d’applications. Vérifiez que vous utilisez votre compte de développeur , qui dispose des privilèges nécessaires pour créer des ressources Azure dans votre abonnement.

3. Dans la page d’accueil, sélectionnez Créer une ressource.

4. Recherchez le type de ressource Data Factory et utilisez les valeurs suivantes pour le créer, puis sélectionnez Créer.

   • Abonnement : sélectionnez votre abonnement Azure.
   • Groupe de ressources : sélectionnez le groupe de ressources que vous avez créé précédemment.
   • Région : choisissez une région Azure dans la même région que votre région Microsoft 365
   • Nom : dM365toBlobStorage
   • Version : V2
   • Sélectionnez Vérifier + créer, puis Créer.

5. Une fois la ressource Azure Data Factory créée, sélectionnez Accéder à la ressource, puis sélectionnez le bouton Lancer studio pour lancer l’éditeur Azure Data Factory plein écran.

   

6. Passez de la vue d’ensemble (icône d’accueil) à l’expérience Gérer (icône de boîte à outils) en la sélectionnant dans le volet de navigation gauche.

7. Par défaut, le Azure Data Factory utilise un runtime d’intégration qui résout automatiquement la région. Pour le contexte de ce didacticiel dans le locataire développeur, nous vous recommandons d’utiliser la résolution automatique par défaut.

   1. Sélectionnez Runtimes> d’intégrationNouveau.

   2. Sélectionnez Azure, Auto-hébergé , puis Continuer.

      

   3. Sélectionnez Azure pour l’environnement réseau, puis sélectionnez Continuer.

      

   4. Utilisez les informations suivantes pour remplir le formulaire sur l’écran final, puis sélectionnez Créer.

      • Nom : nom de votre runtime d’intégration.
      • Région : sélectionnez la région qui correspond à votre région Microsoft 365.
      • Configuration du réseau virtuel (préversion) : désactivé

8. Basculez de l’expérience Gérer (icône de boîte à outils) à l’expérience Auteur (icône crayon) en la sélectionnant dans le volet de navigation de gauche.

9. Créez un pipeline en sélectionnant l’icône plus , puis pipeline.

   

   1. Dans la zone de recherche, entrez Copier les données , puis faites glisser l’activité Copier des données de la section Déplacer & transformer vers l’aire de conception.

      

   2. Sélectionnez l’activité dans le concepteur.

   3. Sélectionnez l’onglet Général et donnez-lui un nom.

      • Nom : CopyFromM365toBlobStorage

   4. Dans le volet éditeur d’activité, sous le concepteur, sélectionnez l’onglet Source , puis sélectionnez Nouveau.

      

   5. Recherchez et sélectionnez le jeu de données Microsoft 365 (Office 365), puis sélectionnez Continuer.

      

   6. Dans le volet Définir les propriétés , cliquez sur la liste déroulante Service lié , puis sélectionnez Nouveau.

      

   7. Dans la boîte de dialogue qui s’affiche, sélectionnez le runtime d’intégration que vous avez créé précédemment dans la liste déroulante Se connecter via le runtime d’intégration .

   8. Entrez l’ID d’application et la valeur de clé secrète client créées précédemment de l’application Microsoft Entra dans les champs ID du principal de service et Clé du principal de service, respectivement.

   9. Cliquez sur Créer.

      

   10. Après avoir créé la connexion Microsoft 365, pour le champ Nom de la table , sélectionnez BasicDataSet_v0. Message_v1, puis sélectionnez OK.

       

   11. Sous l’onglet Source , recherchez la section Filtre de date et utilisez les valeurs suivantes pour la configurer.

       • Nom de colonne : CreatedDateTime
       • Heure de début (UTC) : sélectionnez une date antérieure à la date actuelle.
       • Heure de fin (UTC) : sélectionnez la date actuelle.
       • Sélectionnez Importer le schéma dans la section Colonnes de sortie .

   12. Sélectionnez l’onglet Récepteur .

       

       1. Cliquez sur le bouton Nouveau, sélectionnez Stockage Blob Azure, puis sélectionnez le bouton Continuer.

       2. Sélectionnez Binaire comme format pour les données, puis sélectionnez le bouton Continuer .

       3. Dans le volet Définir les propriétés, remplacez le champ Nom par M365JsonFile

       4. Cliquez sur Sélectionner sous Service lié, puis sur +Nouveau.

       5. Définissez les valeurs suivantes dans la boîte de dialogue, puis sélectionnez Créer.

          • Type d’authentification : Principal du service
          • Abonnement Azure : sélectionner tout
          • Nom du compte de stockage : sélectionnez le compte de stockage que vous avez créé précédemment
          • Locataire : entrez l’ID de votre locataire Azure.
          • ID du principal de service : entrez l’ID de l’application Microsoft Entra que vous avez créée précédemment.
          • Clé du principal de service : entrez la valeur de clé secrète client de l’application Microsoft Entra que vous avez créée précédemment.

       6. Cliquez sur Créer.

   13. Dans le volet Définir les propriétés , en regard du champ Chemin d’accès au fichier, cliquez sur l’icône de dossier pour Parcourir.

   14. Sélectionnez le conteneur de stockage m365mails que vous avez créé précédemment, choisissez OK, puis choisissez à nouveau OK .

   

10. Une fois le pipeline créé, sélectionnez le bouton Valider tout en haut du concepteur.

    

11. Après avoir validé (et résolu les problèmes détectés), sélectionnez le bouton Publier tout en haut du concepteur.

    

Exécuter le pipeline Azure Data Factory

Une fois le pipeline créé, il est maintenant temps de l’exécuter.

Remarque

L’affichage de la demande de consentement peut prendre plusieurs minutes et il n’est pas rare que l’ensemble du processus (démarrer, demander le consentement et après avoir approuvé le consentement à la fin de l’exécution du pipeline) prenne plus de 40 minutes.

1. Dans le concepteur Azure Data Factory, avec le pipeline ouvert, sélectionnez Ajouter un déclencheur > maintenant, puis ok.

   

2. Après avoir démarré le travail, dans le menu de la barre latérale, sélectionnez Surveiller pour afficher les travaux en cours d’exécution.

3. Dans la barre de navigation de gauche, recherchez l’onglet Exécutions du pipeline et sélectionnez-le. Sélectionnez le pipeline sous la colonne Nom du pipeline pour afficher les exécutions d’activité. Ce pipeline s’affiche comme En cours.

   

4. Une fois que vous êtes dans la vue Exécutions d’activité, accédez à la section Exécutions d’activité située en bas de la page.

5. Pointez sur le nom de l’activité et sélectionnez l’option lunettes. L’onglet Détails s’affiche.

   

6. Dans l’écran Détails, recherchez le status de l’activité du pipeline, comme mis en évidence dans l’image suivante. Le status doit passer par Initialisation, Consentement en attente, Extraction des données, Persistance des données et Réussite . Cette étape ne nécessite aucune autre action de votre part.

   

7. La demande est envoyée à l’administrateur général pour être approuvée. Pour le contexte de ce didacticiel, nous vous recommandons d’ouvrir un autre onglet avec vos privilèges d’administrateur activés afin de pouvoir approuver la demande de pipeline.

(Facultatif) Visualiser vos données Microsoft Graph Data Connect dans Microsoft Power BI

Cet exercice explique comment créer un rapport dans Microsoft Power BI pour visualiser vos données Microsoft 365 à partir de Microsoft Graph Data Connect.

Vérifier le fichier JSON dans stockage Azure

1. Ouvrez un navigateur et accédez à votre Portail Azure.
2. Sous Services Azure, choisissez Comptes de stockage.
3. Sélectionnez le compte stockage Azure que vous avez créé précédemment dans ce tutoriel.
4. Dans le volet de navigation gauche, choisissez Conteneurs.
5. Choisissez le conteneur m365mails que vous avez créé précédemment dans ce tutoriel.
6. Vous devez voir le fichier avec un nom GUID dans votre conteneur.

Configurer Power BI

1. Ouvrez votre application Power BI Desktop. Si vous devez télécharger Power BI, accédez à Télécharger les outils et applications Power BI.

2. Choisissez Obtenir des données, sélectionnez Azure, puis Stockage Blob Azure.

3. Choisissez Se connecter pour établir la connexion entre Power BI et votre compte Stockage Blob Azure.

   

4. Entrez le nom du compte de stockage Azure et le nom du conteneur pour le compte Stockage Blob Azure auquel vous souhaitez vous connecter, puis choisissez OK.

   

   Remarque

   Vous trouverez votre URL de stockage Azure dans le compte de stockage Azure. Recherchez dans vos conteneurs, choisissez le conteneur auquel vous souhaitez vous connecter, accédez au menu contextuel (...), sélectionnez Propriétés du conteneur, puis copiez l’URL.

5. Sélectionnez Transformer les données, puis sélectionnez la première ligne qui indique Binary.

   

6. Pour obtenir une liste avec tous les enregistrements, accédez à l’option bascule Colonne1, sélectionnez et maintenez la touche (ou cliquez avec le bouton droit) pour sélectionner Transformer, puis choisissez JSON.

   

7. Chargez toutes les colonnes, développez le bouton bascule Enregistrements à partir du bouton bascule Colonne1, puis choisissez OK.

   

8. Les résultats sont affichés sous la forme Column1.property. Pour développer les colonnes avec des données imbriquées, choisissez l’option bascule sur chaque colonne, puis choisissez OK.

   • Choisissez Fermer & Appliquer et attendez que votre requête charge toutes les colonnes.

   

9. Une fois toutes les colonnes chargées, vous pouvez créer des visuels avec vos données.

   • Sous Données, sélectionnez Requête1 pour développer les colonnes et choisir les propriétés que vous souhaitez visualiser.
   • Sous Visualisations, sélectionnez l’option Influenceurs clés pour visualiser les données.

   Remarque

   Dans cet exemple, vous pouvez déterminer si les utilisateurs lisent les messages envoyés par un service dans votre organization en analysant chaque toRecipientName et la propriété isRead.

   

10. Vous pouvez maintenant voir les données JSON du jeu de données Messages_v1 de Microsoft Graph Data Connect dans un rapport Power BI.

    Remarque

    Vous pouvez choisir le mode de connectivité des données (DirectQuery ou Importer) en fonction de la taille de vos données et des exigences de requête. Nous vous recommandons d’utiliser DirectQuery dans ce tutoriel.

Pour les modèles de solution qui utilisent Microsoft Graph Data Connect intégré à Power BI, consultez le dépôt de solutions Data Connect dans GitHub.

Contenu connexe

• Présentation de Connexion aux données Microsoft Graph