Intégrer un rapport cartographique

Remarque :

Certains processus peuvent nécessiter des privilèges spécifiques. Pour plus d’informations sur les types d’utilisateurs, les rôles et les privilèges, reportez-vous à la rubrique Comptes.

Pour utiliser les fonctions de partage de contenu dans ArcGIS for Power BI, votre compte Microsoft 365 doit inclure un plan Power BI Pro ou Premium en mesure de publier des rapports. Les utilisateurs ne possédant pas ce plan ne peuvent pas intégrer ou publier des rapports sur le Web.

Vous pouvez intégrer un rapport cartographique ArcGIS for Power BI contenant des données ArcGIS privées, sécurisées ou propriétaires dans une application ou un site Web sécurisé. Les personnes qui consultent le rapport doivent se connecter à un compte ArcGIS pour l’afficher. Pour obtenir des informations générales sur le partage du contenu ArcGIS, reportez-vous à la rubrique Partage de contenu.

Le partage de rapports contenant des données privées, sécurisées ou propriétaires exige que les personnes qui les consultent se connectent à leur compte ArcGIS. Si le rapport contient uniquement des données publiques, reportez-vous au processus Publier un rapport cartographique sur le Web.

Après avoir créé un rapport cartographique, utilisez l’option Publish to web (Publier sur le Web) pour l’intégrer dans une application ou un site Web sécurisé hors de l’environnement Microsoft Power BI. Même si les utilisateurs utilisent généralement Power BI Desktop pour créer des rapports, ce processus est également disponible dans le service Power BI (powerbi.com).

Conditions requises

Pour que vous puissiez utiliser l’option Publish to web (Publier sur le Web) afin d’intégrer un rapport cartographique, les exigences ci-dessous doivent être remplies :

• Les données Power BI employées pour créer la carte ArcGIS for Power BI doivent utiliser les coordonnées de latitude et de longitude des localisations ou Esri JSON dans le champ secondaire Location (Localisation). Si le champ secondaire Location (Localisation) contient des adresses ou des limites standard, vous ne pouvez pas procéder à la publication sur le Web.
• Vous devez être connecté à un compte ArcGIS valide avec un type d’utilisateur et un rôle à qui l’administrateur du compte a accordé les autorisations appropriées de publication du contenu.
• Votre compte Microsoft 365 doit inclure un plan Power BI Pro ou Premium en mesure de publier des rapports. Les personnes qui consultent le rapport doivent se connecter à Microsoft Power BI. Si le visuel ArcGIS for Power BI contient des données privées provenant d’ArcGIS ou d’une organisation ArcGIS, les personnes qui consultent le rapport doivent également se connecter à un compte ArcGIS.
• Une carte publiée peut contenir 30 000 emplacements maximum.
• Vous devez exécuter la vérification de publication ArcGIS for Power BI avant de générer un code d’intégration pour le rapport.

Créer et valider un rapport cartographique

Utilisez Power BI Desktop ou le service Power BI (powerbi.com) pour créer un rapport cartographique. Avant de pouvoir intégrer le rapport, exécutez la validation d’intégration et de publication dans la visualisation ArcGIS for Power BI pour vous assurer que toutes les conditions sont remplies.

Pour créer et valider un rapport cartographique à intégrer dans une application ou un site Web, procédez comme suit :

1. Connectez-vous à votre compte ArcGIS, puis créez et enregistrez un rapport Microsoft Power BI qui inclut une carte ArcGIS for Power BI.
2. Dans les outils cartographiques, cliquez sur Settings (Paramètres) .
3. Cliquez sur l’onglet Settings (Paramètres) .
4. Dans la catégorie Embed and publish to web (Intégrer et publier sur le Web), cliquez sur Validate (Valider).

   Remarque :

   Cette catégorie apparaît dans l’onglet Settings (Paramètres) uniquement si vous êtes connecté.

   La vérification permet de s’assurer que toutes les conditions pour l’intégration de la carte sont remplies, et notamment les conditions suivantes :

   • Les données de localisation Power BI sont exprimées en coordonnées de latitude et de longitude.
   • La carte contient uniquement des données accessibles publiquement depuis ArcGIS.
   • Aucune couche ne contient de contenu sécurisé ou premium.

5. Consultez le message qui s’affiche une fois la vérification terminée.

   • Une coche verte  apparaît en regard des éléments qui répondent aux exigences.
   • Une coche rouge  apparaît en regard des éléments qui ne répondent pas aux exigences.
   • Cliquez sur Show error details (Afficher les détails de l’erreur) pour afficher les informations concernant une erreur, le cas échéant.

6. Corrigez les erreurs sur la carte, enregistrez le rapport et exécutez à nouveau la validation.

   Une fois le processus terminé, un message apparaît, indiquant que la carte a été validée et qu’elle peut être intégrée dans le rapport.

Intégrer le rapport cartographique validé

Une fois que vous avez créé et validé le rapport cartographique, vous pouvez le publier sur la plateforme Power BI. Le rapport doit figurer dans le service Power BI (powerbi.com) pour pouvoir être intégré. Vous générez un lien d’intégration associé au rapport et copiez le code obtenu dans le site ou l’application.

Pour intégrer un rapport cartographique, procédez comme suit :

1. Dans le menu Power BI, cliquez sur File (Fichier) > Publish to Power BI (Publier dans Power BI) ou cliquez sur le bouton Publish (Publier) sur le ruban Power BI.

   Remarque :

   Vous pouvez également mettre à jour manuellement le fichier .pbix dans le service Power BI.

2. Dans le fenêtre Publish to Power BI (Publier dans Power BI), sélectionnez My Workspace (Mon espace de travail) et cliquez sur Select (Sélectionner).

   Lorsque le rapport est publié correctement, un message de confirmation s’affiche.

3. Fermez Power BI Desktop.
4. Ouvrez le rapport dans le service Power BI et enregistrez-le.

   Vous devez ouvrir le rapport dans le service Power BI et enregistrer le rapport avant de pouvoir le publier sur le web ou l’intégrer dans un site web, qu’il s’agisse d’un nouveau rapport ou d’un rapport existant. Cela permet à ArcGIS for Power BI de vérifier que les conditions requises pour la publication ou l’intégration sont remplies.

5. Générez un lien d’intégration sécurisé en procédant de l’une des manières suivantes :
   • En mode de lecture, sélectionnez Share (Partager) > Embed report (Intégrer le rapport) > SharePoint Online ou Website or portal (Site Web ou portail).

     

   • En mode de mise à jour, sélectionnez File (Fichier) > Embed (Intégrer) ou File (Fichier) > Embed in SharePoint Online (Intégrer à SharePoint Online).

     

   Remarque :

   Si les options Embed (Intégrer) sont masquées, contactez l’administrateur Power BI pour demander l’autorisation de créer des codes d’intégration.

6. Dans la fenêtre Secure embed code (Sécuriser le code d’intégration), cliquez sur Create embed code (Créer le code d’intégration).

   Une fois le code d’intégration généré, un message de confirmation s’affiche et indique les deux options que vous pouvez utiliser pour intégrer le rapport dans un site Web public.

7. Vous pouvez intégrer le rapport de l’une des deux manières suivantes :
   • Pour intégrer une URL dans une application, un article de blog ou un autre emplacement, copiez le lien de la première zone de texte dans l’application ou le corps de l’article.
   • Pour intégrer le rapport à une page Web ou un site SharePoint, copiez le code iframe de la seconde zone de texte sur la page Web et publiez la page. Vous pouvez redimensionner l’iframe afin qu’il s’ajuste à la page en déplaçant le curseur Resize (Redimensionner) vers la droite avant de le copier dans la page Web.

   Le rapport s’affiche sur la page web publiée.

Pour afficher le contenu intégré, les utilisateurs en consultation doivent se connecter à Power BI. Si le rapport contient du contenu sécurisé provenant d’ArcGIS, ils doivent également se connecter à un compte ArcGIS.