Incorporation de tableau de bord de base

Cette page montre comment incorporer un tableau de bord en tant qu’iframe dans une application externe. Les visionneuses accèdent au tableau de bord à l’aide de leurs informations d’identification Azure Databricks.

Générer du code incorporé

Pour générer du code incorporé que vous pouvez coller dans des applications externes :

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 le 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 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.

Examples

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 et <databricks-instance-name> contiennent les valeurs réelles associées <dashboard-and-workspace-ID> à votre espace de travail et à votre tableau de bord. Elles sont les suivantes :

   • Il <databricks-instance-name> s’agit de 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.
   • Il <dashboard-and-workspace-ID> s’agit de la dernière partie de l’URL qui pointe vers votre tableau de bord. Il semble 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 d’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 <apex:page></apex:page> balises.

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 > un composant multimédia.

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

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. Pour obtenir des instructions, consultez la documentation de Microsoft. Effectuez ensuite les étapes 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 (~).

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 <ID> remplaçant 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 de tableau de bord en dehors d’Azure Databricks. Tous les paramètres de partage existants s’appliquent. Les visionneuses prévues doivent avoir accès au tableau de bord. Voir 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é :

• Accédez à la page dans laquelle le tableau de bord a été incorporé.
• Si nécessaire, connectez-vous avec les informations d’identification Azure Databricks.

Interroger Genie dans les tableaux de bord intégrés

Lors de l’affichage d’un tableau de bord incorporé qui a été publié avec un espace Génie associé, les utilisateurs peuvent accéder au bouton Poser au Génie pour explorer les données à l’aide de questions en langage naturel.

Pour utiliser Genie dans un tableau de bord incorporé :

1. Accédez à la page du tableau de bord incorporé.
2. Si nécessaire, connectez-vous avec les informations d’identification Databricks.
3. Cliquez sur Ask Genie dans l’interface du tableau de bord.
4. Tapez des questions en langage naturel sur les données du tableau de bord.

Genie utilise les mêmes autorisations et accès aux données que le tableau de bord publié. Pour plus d’informations sur la configuration et l’utilisation de Genie avec des tableaux de bord, consultez les espaces Genie avec des tableaux de bord.

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 configurer une planification pour actualiser régulièrement les tableaux de bord.

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

Résolution des problèmes liés aux tableaux de bord incorporés

Pour connaître les problèmes courants et les résolutions lors de l’utilisation de tableaux de bord incorporés, notamment des problèmes d’affichage de thème et des iframes vides, consultez Résolution des problèmes liés aux tableaux de bord incorporés.

Étapes suivantes

• Configurer l’incorporation pour les utilisateurs externes : voir Qu’est-ce que l’incorporation pour les utilisateurs externes ?.
• Gérer les autorisations d’incorporation : contrôler quels domaines peuvent héberger des tableaux de bord incorporés et configurer les paramètres d’incorporation au niveau de l’espace de travail. Consultez Gérer l’incorporation de tableau de bord.
• Partager des tableaux de bord publiés : configurez les paramètres de partage et les autorisations de vos tableaux de bord publiés avec différents groupes d’utilisateurs. Consultez Partager un tableau de bord.