Intégrer un rapport cartographique

Remarque :

Pour utiliser ce processus, vous avez besoin des types de compte et de licence suivants :

• Licence Microsoft : vous devez posséder une licence Microsoft 365, rôle Contributeur ou supérieur, pour intégrer un rapport cartographique incluant du contenu public ou privé. Les personnes dotées des droits en consultation peuvent consulter les rapports cartographiques incluant du contenu public, mais doivent se connecter à un compte ArcGIS pour afficher le contenu privé. Ce processus est susceptible de consommer des crédits.
• Type de compte ArcGIS : vous devez vous connecter à un compte ArcGIS pour effectuer ce processus.

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 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 contributeurs 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 EsriJSON 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.
• Pour créer un rapport cartographique dans Power BI, vous devez être connecté à Microsoft Power BI avec un compte Microsoft Pro ou Premium. Les utilisateurs en consultation doivent se connecter à Microsoft Power BI pour afficher un rapport dans un environnement intégré. Si le visuel ArcGIS for Power BI contient des données privées, les utilisateurs en consultation 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.
2. Créez et enregistrez un rapport Microsoft Power BI qui inclut une carte ArcGIS for Power BI.
3. À partir des outils cartographiques, cliquez sur Settings (Paramètres) .

   La fenêtre Paramètres apparaît.

4. Dans la fenêtre Settings (Paramètres), dans la catégorie Embed and publish check (Vérification de l’intégration et de la publication), cliquez sur Validate (Valider).

   Remarque :

   Le paramètre Embed and validate check (Vérification de l’intégration et de la validation) apparaît dans la fenêtre Settings (Paramètres) uniquement si vous êtes connecté.

   La vérification permet de vérifier 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.

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 :
   • Dans la vue Reading (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.