Automatiser les exportations de données de requête vers Azure

Avec l’ID Microsoft Entra, vous pouvez automatiser l’exportation des données de requête à partir de Microsoft Viva Insights dans Workplace Analytique. Pour ce faire, utilisez un lien de requête OData dans Workplace Analytique pour vous connecter et actualiser automatiquement un magasin de données Azure de votre choix, par exemple via Azure Data Factory ou Azure Synapse Analytique.

Choisir un chemin d’installation

Pour configurer la connexion OData automatisée entre les données de requête et un magasin de données Azure, utilisez l’un des chemins suivants pour créer et configurer une application Azure analytique, qui a besoin d’informations spécifiques à l’entreprise (secrets) sur votre réseau privé et le magasin de données de votre choix.

• Configurer avec l’interface utilisateur d’Azure Data Factory : ce chemin vous guide tout au long de la création et de l’inscription d’une application et de la création d’une fabrique de données pour l’exportation de données via l’interface utilisateur Azure Data Factory.
• Configurer avec Azure Synapse Analytique : ce chemin vous guide tout au long de la création et de l’inscription d’une application et de la création d’un pipeline OData pour l’exportation de données de requête via le Analytique Azure Synapse.
• Configurer avec Azure PowerShell : ce chemin automatise le processus de bout en bout via PowerShell avec des scripts prédéfinis qui créent et inscrivent l’application, demandent les paramètres spécifiques de votre organisation et créent et déploient la fabrique de données.

Configuration requise

• Analyste Viva Insights ou Workplace Analytique : doit se voir attribuer une licence et un rôle d’analyste pour Viva Insights ou Workplace Analytique et avoir des résultats de requête avec les données que vous souhaitez exporter.
• Abonnement Microsoft Azure : si vous n’avez pas d’abonnement Azure, créez un compte gratuit maintenant. Vous allez utiliser l’ID Microsoft Entra, le connecteur OData et Data Factory pour cette configuration.
• Magasin de données Azure : votre magasin de données doit être pris en charge par le connecteur OData.
• Administrateur Azure : vous avez besoin de privilèges d’administrateur Azure pour créer et inscrire l’application dans Azure. Vous devez également demander à l’administrateur général Azure de vous accorder des autorisations dans Azure Data Factory pour connecter votre nouvelle application au magasin de données Azure.

Pour configurer l’interface utilisateur d’Azure Data Factory

Les étapes suivantes vous expliquent comment automatiser l’exportation de Workplace Analytique interroger des données vers le magasin de données Azure de votre choix avec l’interface utilisateur Azure Data Factory. Utilisez les étapes suivantes conjointement avec la documentation Azure pour effectuer cette configuration.

1. Suivez les étapes décrites dans Inscrire une application à l’aide du portail Azure pour créer et inscrire une application analytique dans l’ID Microsoft Entra.

2. Dans Inscriptions d’applications Microsoft Entra, sélectionnez l’application à l’étape 1, puis accordez-lui des autorisations pour accéder à Workplace Analytique en sélectionnant Afficher les autorisations de l’API, puis ajouter une autorisation.

3. Entrez et recherchez le nom ou l’ID de l’application Workplace Analytique, puis sélectionnez le nom applicable dans la liste.

   

   Pour rechercher l’ID d’application (client) :

   • Dans Active Directory, sélectionnez toutes les applications, puis entrez Workplace Analytique pour l’application d’entreprise que vous souhaitez utiliser.

   • Sélectionnez-la dans la liste.

   • Dans ID d’application, copiez l’ID et collez-le dans le champ de recherche API que mon organisation utilise .

     

4. Dans Demander des autorisations d’API, sélectionnez Autorisations d’application, Analyste, puis Ajouter des autorisations.

5. Dans Autorisations d’API, l’administrateur général doit sélectionner Accorder le consentement administrateur pour [Workplace Analytique...] avant de pouvoir passer à l’étape suivante.

   

6. Suivez les étapes décrites dans Créer une fabrique de données pour créer une fabrique de données analytique dans l’ID Microsoft Entra.

7. Dans la vue d’ensemble d’Azure Data Factory, sélectionnez Créer & Monitor pour ouvrir Azure Data Factory.

   Remarque

   Gardez toutes les fenêtres de navigateur ouvertes, car vous devez basculer entre elles pour effectuer les étapes suivantes.

8. Dans Azure Data Factory, sélectionnez Créer un pipeline.

9. Sélectionnez les points de suspension (...) jeux de données suivants, puis sélectionnez Nouveau jeu de données. Pour plus d’informations, consultez Jeux de données dans Azure Data Factory.

10. Dans Sélectionner un magasin de données, entrez odata, puis sélectionnez OData.

11. Dans Général, entrez un nom et une description pour les données de requête vers lesquelles vous établissez un lien.

12. Sélectionnez Connexion, Nouveau, puis entrez un nom et une description pour le lien OData, par exemple WPA_Odata_Collab.

13. Dans Se connecter via le runtime d’intégration, sélectionnez AutoResolveIntegrationRuntime.

14. Dans Workplace Analytique, sélectionnez Analyser les>résultats duConcepteur> de requêtes, puis copiez le lien OData pour les données de requête que vous souhaitez connecter à Azure.

    Importante

    Pour les données actualisées automatiquement, vous devez créer un lien vers une requête qui utilise l’option Actualisation automatique dans Workplace Analytique. Pour les résultats de requête statique, vous devez entrer un nouveau lien OData à chaque fois pour mettre à jour les données de requête dans le magasin de données Azure connecté.

    

15. Dans URL du service, collez le lien OData de requête que vous avez copié à l’étape précédente.

16. Dans ressource Microsoft Entra, entrez https://workplaceanalytics.office.com.

17. Dans Active Directory, sélectionnez Vue d’ensemble de la nouvelle application, puis copiez l’ID d’application (client).

    

18. Dans Azure Data Factory>ID du nouveau service> lié, copiez l’ID client. Pour plus d’informations, consultez Capture d’écran montrant les propriétés du service lié.

    

19. Dans Type d’authentification, sélectionnez Principal de service Microsoft Entra avec clé ou Principal de service Microsoft Entra avec Cert. Laissez le nouveau service lié (OData) ouvert dans une fenêtre de navigateur distincte. Pour plus d’informations sur ces options, consultez Utiliser des secrets Azure Key Vault dans les activités de pipeline.

20. Dans Microsoft Entra ID>de votre application analytique nouvellement inscrite, sélectionnez Certificats & secrets, puis effectuez l’une des opérations suivantes.

    • Pour Authentification par clé, sélectionnez Nouvelle clé secrète client , puis dans Ajouter une clé secrète client, entrez une description, sélectionnez quand elle expire, puis sélectionnez Ajouter. Dans Clés secrètes client, sélectionnez le nouveau secret, puis sélectionnez l’icône Copier pour le copier.
    • Pour Authentification par certificat (par défaut pour une sécurité plus élevée), sélectionnez un certificat et copiez-le.

21. Dans Azure Data Factory, procédez comme suit pour le type d’authentification applicable :

    • Pour Clé de principal de service, collez la nouvelle clé secrète client copiée à l’étape précédente dans Clé du principal de service.
    • Pour Azure Key Vault, copiez et collez le certificat et les autres informations requises. Pour plus d’informations, consultez Définir et récupérer un secret à partir d’Azure Key Vault .

22. Sélectionnez Tester la connexion pour tester le service lié OData.

23. Une fois que la connexion a réussi, sélectionnez Créer.

24. Dans Servicelié deconnexion> pour le nouveau service lié OData, sélectionnez le nouveau jeu de données que vous venez de créer aux étapes précédentes.

25. DansCheminde connexion>, sélectionnez Modifier, puis entrez le nom du jeu d’entités. Pour le trouver, copiez le lien de requête OData à partir de >Analyser les>résultats duconcepteur> de requêtes, puis ouvrez le lien de requête dans une nouvelle fenêtre de navigateur. Recherchez les métadonnées pour rechercher le nom de l’entité, qui s’affiche après $metadata#. Par exemple, le nom du jeu d’entités indiqué dans ce graphique est Personnes :

    

26. Sélectionnez Aperçu des données pour le chemin d’accès pour confirmer que vous avez entré l’entité correcte.

27. DansPropriétésd’Azure Data Factory>, vérifiez le nom et la description de ce nouveau jeu de données.

28. Sélectionnez Publier tout en haut, puis Sélectionnez Publier.

29. Dans Pipelines, créez un pipeline qui peut utiliser le nouveau jeu de données OData pour copier les données de requête vers la ressource externe. Pour plus d’informations, consultez Créer un pipeline.

30. Pour le nouveau pipeline, sélectionnez Source, puis, dans Jeu de données source, sélectionnez le nom du nouveau jeu de données OData, puis dans Utiliser la requête, sélectionnez Table.

31. Créez un service lié pour le magasin de données vers lequel vous souhaitez exporter. Pour plus d’informations, consultez Services liés.

32. Dans Auteur Azure Data Factory>, sélectionnez le nouveau pipeline, puis Sélectionnez Ajouter un déclencheur>maintenant pour exécuter manuellement le dernier pipeline publié, comme illustré dans le graphique suivant. Vous pouvez également planifier un déclencheur pour ce nouveau pipeline en sélectionnant Ajouter un nouveau déclencheur>/Modifier>nouveau, puis renseigner les informations requises pour celui-ci. Pour plus d’informations, consultez Exécution de pipeline et déclencheurs dans Azure Data Factory .

    

33. Dans Le jeu>de données récepteur, sélectionnez le nom du service lié que vous avez créé à l’étape précédente.

Vous pouvez ensuite utiliser cette nouvelle fabrique de données pour accéder aux données de requête à partir de Workplace Analytique et les copier dans le magasin de données de votre choix (stockage d’objets blob) à l’aide du modèle Azure Resource Manager. Vous pouvez réutiliser cette nouvelle application au fil du temps pour plusieurs projets sans avoir à répéter ces étapes. Vous pouvez également réutiliser la fabrique de données que vous avez créée pour les nouveaux pipelines.

Pour configurer Azure Synapse Analytique

Les étapes suivantes vous expliquent comment automatiser l’exportation de Workplace Analytique interroger des données vers le magasin de données Azure de votre choix avec le Analytique Azure Synapse. Utilisez les étapes suivantes conjointement avec la documentation Azure pour effectuer cette configuration.

1. Suivez les étapes décrites dans Inscrire une application à l’aide du portail Azure pour créer et inscrire une application analytique dans l’ID Microsoft Entra.

2. Dans Inscriptions d’applications Microsoft Entra, sélectionnez l’application à l’étape 1, puis accordez-lui des autorisations pour accéder à Workplace Analytique en sélectionnant Afficher les autorisations de l’API, puis ajouter une autorisation.

3. Entrez et recherchez le nom ou l’ID de l’application Workplace Analytique ou Viva Insights, puis sélectionnez le nom applicable dans la liste.

   

   Pour rechercher l’ID d’application (client) :

   • Dans Active Directory, sélectionnez toutes les applications, puis entrez Workplace Analytique ou Viva Insights pour l’application d’entreprise que vous souhaitez utiliser.

   • Sélectionnez-la dans la liste.

   • Dans ID d’application, copiez l’ID et collez-le dans le champ de recherche API que mon organisation utilise .

     

4. Dans Demander des autorisations d’API, sélectionnez Autorisations d’application, Analyste, puis Ajouter des autorisations.

5. Dans Autorisations d’API, l’administrateur général doit sélectionner Accorder le consentement administrateur pour [Workplace Analytique...] avant de pouvoir passer à l’étape suivante.

   

6. Suivez les étapes décrites dans Créer un espace de travail Synapse pour créer un espace de travail Synapse dans votre portail Azure.

7. Dans la ressource Azure Synapse dans le portail, sélectionnez Ouvrir Synapse Studio pour ouvrir l’espace de travail Azure Synapse.

   Remarque

   Gardez toutes les fenêtres de navigateur ouvertes, car vous devez basculer entre elles pour effectuer les étapes suivantes.

8. Dans Azure Synapse Studio, sélectionnez Intégrer, puis ajoutez un pipeline.

   

9. Dans le menu Nouvelles activités de pipeline, sélectionnez Déplacer et transformer, puis faites glisser un élément Copier des données dans votre espace de travail de pipeline.

10. Sélectionnez les points de suspension (...) jeux de données suivants, puis sélectionnez Nouveau jeu de données.

11. Dans la section Source , ajoutez une nouvelle source.

    

12. Dans Nouveau jeu de données d’intégration, entrez odata, puis sélectionnez OData.

13. Dans Définir les propriétés, entrez un nom et créez un service lié.

14. Dans Nouveau service lié (Odata), entrez un nom et une description pour les données de requête que vous créez.

15. Dans Se connecter via le runtime d’intégration, sélectionnez AutoResolveIntegrationRuntime.

16. Dans Viva Insights dans Workplace Analytique, sélectionnez Analyser les>résultats duconcepteur> de requêtes, puis copiez le lien OData pour les données de requête que vous souhaitez connecter à Azure.

    Importante

    Pour les données actualisées automatiquement, vous devez établir un lien vers une requête qui utilise l’option Actualisation automatique. Pour les résultats de requête statique, vous devez entrer un nouveau lien OData à chaque fois pour mettre à jour les données de requête dans le magasin de données Azure connecté.

    

17. Dans l’URL du nouveau service lié Azure Synapse, collez le lien OData de requête que vous avez copié à l’étape précédente.

18. Dans ressource Microsoft Entra, entrez https://workplaceanalytics.office.com.

19. Dans Active Directory, sélectionnez Vue d’ensemble de la nouvelle application, puis copiez l’ID d’application (client).

    

20. Dans Azure Synapse Studio> Nouvel ID de principal deservice lié (Odata),> copiez l’ID client. Pour plus d’informations, consultez Propriétés du service lié.

21. Dans Type d’authentification, sélectionnez Principal de service Microsoft Entra avec clé ou Principal de service Microsoft Entra avec Cert. Laissez le nouveau service lié (OData) ouvert dans une fenêtre de navigateur distincte. Pour plus d’informations sur ces options, consultez Utiliser des secrets Azure Key Vault dans les activités de pipeline.

22. Dans Microsoft Entra ID>de votre application analytique nouvellement inscrite, sélectionnez Certificats & secrets, puis effectuez l’une des opérations suivantes.

    • Pour Authentification par clé, sélectionnez Nouvelle clé secrète client, puis dans Ajouter une clé secrète client, entrez une description, sélectionnez quand elle expire, puis sélectionnez Ajouter. Dans Clés secrètes client, sélectionnez le nouveau secret, puis sélectionnez l’icône Copier pour le copier.
    • Pour Authentification par certificat (par défaut pour une sécurité plus élevée), sélectionnez un certificat et copiez-le.

23. Dans Azure Synapse Studio, procédez comme suit pour le type d’authentification applicable :

    • Pour Clé de principal de service, collez la nouvelle clé secrète client copiée à l’étape précédente dans Clé du principal de service.
    • Pour Azure Key Vault, copiez et collez le certificat et les autres informations requises. Pour plus d’informations, consultez Définir et récupérer un secret à partir d’Azure Key Vault .

24. Sélectionnez Tester la connexion pour tester le service lié OData.

25. Une fois que la connexion a réussi, sélectionnez Créer.

26. Dans Définir les propriétés>Service lié pour le nouveau service lié OData, sélectionnez le nouveau service lié que vous venez de créer dans les étapes précédentes.

27. Dans Chemin d’accès source>, sélectionnez Modifier, puis entrez le nom du jeu d’entités. Pour le trouver, copiez le lien de requête OData à partir de Workplace Analytique >Analyser les>résultats duconcepteur> de requêtes, puis ouvrez le lien de requête dans une nouvelle fenêtre de navigateur. Recherchez ensuite les métadonnées pour rechercher le nom de l’entité, qui s’affiche après $metadata#. Par exemple, le nom du jeu d’entités indiqué dans ce graphique est Personnes :

    

28. Sélectionnez Aperçu des données pour le chemin d’accès pour confirmer que vous avez entré l’entité correcte.

29. Dans la section Récepteur , ajoutez un nouveau jeu de données récepteur et, dans Le nouveau jeu de données d’intégration, sélectionnez Azure Data Lake Storage Gen2, puis sélectionnez Continuer.

30. Pour Sélectionner le format, sélectionnez Texte délimité, puis Sélectionnez Continuer.

31. Dans Définir les propriétés, entrez un nom, sélectionnez Première ligne comme en-tête, puis sélectionnez votre compte de stockage Synapse par défaut (qui est déjà lié) ou créez un service lié.

32. Entrez un chemin d’accès pour la destination du fichier copié dans le stockage. Si vous laissez Fichier vide, le pipeline de copie génère automatiquement un nom pour le fichier dans le répertoire de destination.

    

33. Validez et si vous réussissez, sélectionnez Publier tout en haut.

    

34. Une fois la publication réussie, sélectionnez Ajouter un déclencheur, puis Déclencher maintenant ou sélectionnez le déclencheur.

35. Une fois l’exécution réussie, accédez à votre service lié Azure Data Lake pour localiser les données transférées. Sélectionnez Plus>d’actualisation pour afficher les dernières données disponibles.

Voir aussi

• Automatiser l’exportation de données de requête avec PowerShell