Incorporer un tableau de bord

Cet article explique comment incorporer un tableau de bord IA/BI dans un site web ou une application externe. Un administrateur d’espace de travail doit définir des surfaces d’incorporation potentielles avant que les tableaux de bord puissent être incorporés. Pour en savoir plus sur la configuration de votre espace de travail, consultez Manage dashboard embedding.

Les utilisateurs disposant au moins de l’autorisation CAN EDIT peuvent générer du code iframe pour un tableau de bord à partir de la boîte de dialogue Partager . Tous les paramètres de partage du tableau de bord publié restent en vigueur. Seuls les utilisateurs qui ont été explicitement autorisés à accéder peuvent afficher les tableaux de bord incorporés. Consultez Partager un tableau de bord pour en savoir plus sur le partage de tableaux de bord. Les tableaux de bord incorporés suivent la même cadence de cache et d’actualisation que tous les autres tableaux de bord. Consultez Mise en cache et actualisation des données.

Générer un code incorporé

Pour incorporer un tableau de bord, procédez comme suit :

1. Ouvrez un tableau de bord publié que vous souhaitez incorporer. Consultez Afficher et organiser des tableaux de bord pour découvrir comment afficher et accéder aux tableaux de bord dans votre espace de travail.

2. Cliquez sur Partager dans le coin supérieur droit.

3. Cliquez sur Incorporer un tableau de bord dans la boîte de dialogue Partage.

4. Une boîte de dialogue Copier le code incorporé s’ouvre. Si une liste de domaines d’incorporation autorisés existe, les domaines sont répertoriés. Cliquez sur le bouton Copier pour copier l’extrait de code.

   

5. Insérez le code incorporé dans n’importe quelle plateforme ou application qui prend en charge l’incorporation HTML et peut afficher du contenu iframe. Consultez Exemples.

Remarque

Si votre boîte de dialogue pour copier le code de l'incorporation inclut une liste de domaines autorisés qui n'inclut pas votre domaine cible, un administrateur de l'espace de travail peut l'ajouter. Consultez la section Gérer l’incorporation des tableaux de bord.

Exemples

Les exemples suivants incluent des instructions pas à pas pour incorporer vos tableaux de bord dans une application. Chaque ensemble d’instructions suppose que vous avez déjà copié le code incorporé décrit dans la section précédente.

Incorporer dans Confluence

Le code incorporé généré nécessite un léger ajustement pour répondre aux exigences de Confluence. Pour incorporer votre tableau de bord dans une page Confluence, procédez comme suit :

1. Modifiez le code incorporé pour inclure uniquement l’URL générée, et non les balises iframe ni les valeurs de balisage supplémentaires.

   Avant de modifier, le code incorporé inclut une balise HTML iframe, un lien vers votre tableau de bord pour utiliser une source dans l’iframe et des spécifications supplémentaires pour la hauteur, la largeur et la bordure, comme indiqué dans l’extrait de code suivant. Pour votre tableau de bord, les exemples d’espaces réservés <databricks-instance-name> et <dashboard-and-workspace-ID> contiennent les valeurs réelles associées à votre espace de travail et à votre tableau de bord. Ce sont les suivantes :

   • Votre <databricks-instance-name> est la première partie de l'URL lorsque vous vous connectez à votre espace de travail. Consultez Obtenir des identificateurs pour les objets d’espace de travail.
   • <dashboard-and-workspace-ID> est la dernière partie de l'URL qui pointe vers votre tableau de bord. Ça ressemble à quelque chose comme : a4bf23c498752e79f1a2d6b4c9087e31?o=3498561237865447.

   <iframe src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>" width="100%" height="600" frameborder="0"></iframe>
   

   Modifiez la chaîne de sorte qu’elle inclut uniquement le texte du lien, comme indiqué dans l’exemple suivant.

   https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>
   

2. Insérez un élément iframe dans votre page. Pour savoir comment insérer un iframe dans votre page, consultez la documentation de Confluence.

3. Collez l’URL incorporée modifiée dans le champ de texte URL et définissez la largeur sur 100 %.

4. Ajustez d’autres paramètres en fonction de vos préférences.

Incorporer dans Salesforce Knowledge

Pour incorporer votre tableau de bord dans une page De connaissances Salesforce, procédez comme suit :

1. Créez une page Visualforce. Pour obtenir des instructions, consultez la documentation de Salesforce.

2. À partir de l’écran Modification de la page, déplacez votre curseur dans l’éditeur de balisage Visualforce.

3. Collez le code incorporé que vous avez copié entre les deux balises <apex:page></apex:page>.

4. Ajoutez deux balises de paragraphe (<p></p>) autour du code incorporé.

   L’exemple suivant utilise l’espace réservé <dashboard-embed-code> pour illustrer l’apparence de votre balisage Visualforce. Votre instance doit inclure le code incorporé complet que vous avez copié.

   <apex:page >
   <p><dashboard-embed-code></p>
   </apex:page>
   

5. Cliquez sur Enregistrer pour enregistrer vos modifications.

6. Cliquez sur Aperçu et vérifiez que le tableau de bord s’affiche.

7. Copiez l’URL de l’aperçu du composant et créez un nouveau composant iframe. Il doit ressembler à l’extrait de code suivant. L’espace réservé <your-salesforce-domain> doit être remplacé par votre domaine Salesforce.

   <iframe src="https://<your-salesforce-domain>/apex/<component name>" width="100%" height="600" frameborder="0"></iframe>
   

8. Accédez à la page Connaissances dans laquelle vous souhaitez incorporer votre tableau de bord.

9. Cliquez sur Modifier > pour ajouter un composant multimédia.

10. Collez le code iframe de l'étape précédente dans le champ Incorporer.

Incorporer dans SharePoint

Pour incorporer votre tableau de bord dans SharePoint, vous devrez peut-être ajouter votre URL Azure Databricks à la liste des sites autorisés pour le contenu incorporé sur SharePoint. Consultez la [documentation de Microsoft] pour savoir comment autoriser l’incorporation de contenu sur des pages SharePoint. Effectuez ensuite les tâches suivantes :

1. Accédez à la page SharePoint dans laquelle vous souhaitez héberger votre tableau de bord incorporé.
2. Ajoutez un élément Embed à la page.
3. Collez le code incorporé complet dans l’adresse du site web ou incorporez le champ de code sur le côté droit de l’écran.
4. Cliquez dessus pour confirmer.

Incorporer un widget unique

Pour incorporer un widget unique à partir d’un tableau de bord, vous avez besoin du code incorporé du tableau de bord et de l’identificateur unique du widget que vous souhaitez afficher.

Copier l’identificateur unique

L’identificateur d’un widget unique est une combinaison d’une valeur de page name et d’une valeur de widget name , séparée par un tilda (~).

Remarque

La name clé apparaît dans le fichier sérialisé qui définit le tableau de bord et n’est pas accessible à partir de l’interface utilisateur Azure Databricks. Elle est distincte de la displayName valeur, qui définit le nom de page affiché dans l’interface utilisateur. Consultez Modifier un fichier de tableau de bord.

Pour copier l’identificateur unique :

1. Ouvrez votre tableau de bord publié dans l’espace de travail Azure Databricks.

2. Cliquez sur du widget que vous souhaitez incorporer.

3. Cliquez sur Afficher le lien Plein écran ou Copier vers le widget. L’URL contient les valeurs de page et de widget name pertinentes.

4. Copiez le paramètre fullscreenWidget de recherche et tout ce qui suit le signe égal (=).

   L’exemple suivant montre la dernière partie de l’URL d’un widget plein écran :

   fullscreenWidget=53eadf26~3490f286
   

Ajuster le code incorporé généré

1. Consultez Générer du code incorporé pour rechercher les étapes de génération du code incorporé du tableau de bord.
2. Ajoutez &fullscreenWidget=<ID> à l'URL incorporée, en remplaçant <ID> par la valeur combinée <page-name>~<widget-name>.

Par exemple, si votre URL incorporée de base est la suivante :

src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>&fullscreenWidget=<ID>"

L’URL incorporée mise à jour avec l’identificateur unique doit ressembler à ce qui suit :

src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>&fullscreenWidget=53eadf26~82f66691"

Afficher un tableau de bord incorporé

Les tableaux de bord incorporés offrent un moyen sécurisé aux utilisateurs d’accéder aux données du tableau de bord en dehors d’Azure Databricks. Tous les paramètres de partage existants s’appliquent. Les utilisateurs visés doivent avoir accès au tableau de bord. Consultez la section Qui peut accéder à votre tableau de bord ?. Lors de l’accès à un tableau de bord incorporé, les utilisateurs sont invités à se connecter à Azure Databricks, sauf s’ils disposent d’une session active à partir d’une connexion récente au même espace de travail.

Pour afficher un tableau de bord incorporé :

• Naviguez jusqu’à la page où le tableau de bord a été incorporé.
• Si nécessaire, connectez-vous avec les informations d’identification Azure Databricks.

Remarque

Si un utilisateur enregistré qui n’a pas reçu la permission d’accéder au tableau de bord tente de le consulter, il reçoit un message d’erreur indiquant que le tableau de bord n’est pas disponible. Consultez la section Partager un tableau de bord publié pour découvrir comment ajuster les paramètres de partage.

Actualiser un tableau de bord incorporé

Tous les utilisateurs d’un tableau de bord incorporé peuvent actualiser manuellement les tableaux de bord à la demande. Vous pouvez également programmer l’actualisation périodique des tableaux de bord.

Consultez Gérer les mises à jour planifiées du tableau de bord et les abonnements.

Dépannage des problèmes liés aux tableaux de bord incorporés

Cette section énumère les problèmes courants que vous pouvez rencontrer et propose une solution :

L’iframe incorporé est vide

Si l’iframe incorporé n’affiche pas de données, cela peut être dû au fait que vous avez désactivé les cookies tiers. L’activation des cookies tiers est nécessaire pour autoriser le contenu externe, tel que les tableaux de bord incorporés, à fonctionner correctement dans une autre page web.

Pour résoudre ce problème, vous pouvez ajuster les paramètres de votre navigateur afin d’autoriser ou de débloquer les cookies de tiers. Si vous ne souhaitez pas autoriser tous les cookies tiers, de nombreux navigateurs vous permettent d’ajouter des exceptions pour des sites spécifiques sur lesquels des cookies tiers doivent être autorisés. Reportez-vous à la documentation d’aide de votre navigateur pour obtenir des instructions détaillées sur la gestion des cookies.

Les étapes suivantes expliquent comment redémarrer votre session avec des cookies tiers activés dans le navigateur Chrome. Ce processus garantit un état propre en désactivant d’abord, puis en réactivant les cookies tiers :

1. Déconnectez-vous de toutes les sessions Azure Databricks actives.
2. Cliquez sur l’icône de curseur en regard de l’URL.
3. Cliquez sur Cookies et données de site et désactivez ou bloquez les cookies tiers. Vous êtes invité à actualiser la page.
4. Actualisez la page et cliquez sur Se connecter dans l'iframe incorporé. Un message d’erreur doit apparaître. Fermez la fenêtre du navigateur.
5. Sous Cookies et données de site, autorisez les cookies tiers.
6. Actualisez la page une fois de plus.
7. Accédez à votre tableau de bord incorporé, puis cliquez sur Se connecter.