Partage de cartes en dehors de Domo à l'aide de Domo Embed

Introduction

Grâce à la fonctionnalité "Domo Everywhere: Domo Embed", vous pouvez incorporer des cartes Domo...

• de façon privée dans les sites Web SSO, les portails ou les applications, ou

• de façon publique sur les sites Web publics, les blogs ou les plateformes de réseaux sociaux telles que Facebook et Twitter.

Pour ce faire, copiez une chaîne HTML générée automatiquement depuis Domo et collez-la à l'emplacement nécessaire dans le site Web, le blog, etc. comme iFrame ou via une API JavaScript. Cette fonctionnalité vous permet de partager des données relatives à votre activité de façon consommable, interactive et accessible.

Vous pouvez choisir d'inclure ou non les fonctionnalités des cartes régulièrement disponibles dans l'affichage des détails, notamment toutes les fonctionnalités suivantes :

• Titre de la carte

• Capacité d'avoir une exploration détaillée dans la carte

• Capacité d'accès au tableau de données (cartes privées uniquement)

• Numéro de résumé

• Capacité d'application et de modification des filtres (cartes privées uniquement)

• Capacité de modification du type de graphique à l'aide du sélecteur de graphique

Vous pouvez également définir la taille des cartes incorporées, soit en choisissant une taille prédéfinie, soit en entrant une largeur et une hauteur personnalisées.

Domo Everywhere: Domo Embed est compatible avec les PDP, mais uniquement pour les cartes incorporées de façon privée.  

Vous pouvez obtenir un affichage administratif de contenu incorporé à l'aide du Journal d'activités.

Vidéo de formation - Incorporation d'une carte Domo

Découvrez un aperçu rapide des fonctionnalités de base de Domo Embed. 

Vidéo de formation - Rendre des cartes publiques dans votre instance

Apprenez à rendre des cartes publiques dans votre instance, afin de pouvoir les incorporer de façon interne ou externe.

Notifications

Pour incorporer des cartes de façon privée, toutes les conditions suivantes doivent être remplies :

• SSO (Single Sign-On) doit être activé dans Domo et sur le site Web, le portail ou l'application.

  • Si l'option Seules les personnes invitées peuvent accéder à Domo est activée dans Paramètres d'administrateur > SSO, tout utilisateur non-Domo essayant d'accéder à la carte sera refusé. Si cette option est désactivée, un utilisateur non-Domo sera autorisé automatiquement en fonction des droits d'accès définis pour les utilisateurs par défaut. Le paramètre par défaut est "Privilégié".

  • Pour plus d'informations sur les droits d'accès, consultez Contrôle des accès dans Domo.

• Actuellement, les cookies tiers doivent être activés dans le site Web, le portail ou l'application.

• Les utilisateurs des réseaux sociaux ne peuvent pas incorporer ou afficher de contenu incorporé de façon privée. Les participants ne peuvent pas incorporer, mais ils peuvent afficher du contenu incorporé de façon privée.

Notez également les points suivants :

• Si, pour des raisons de sécurité, vous ne souhaitez pas que vos employés puissent incorporer des cartes de façon publique, vous pouvez désactiver cette fonctionnalité dans Paramètres d'administrateur > Paramètres de la société > Présentation de la société en décochant la case "Incorporer les cartes publiquement".

• L'incorporation privée est disponible pour tous les types de cartes à l'exception des tableaux croisés dynamiques Sumo, tandis que l'incorporation publique est actuellement disponible uniquement pour les cartes KPI et les applications personnalisées. Actuellement, il n'est pas possible d'incorporer d'autres types de cartes tels que les cartes de bloc-notes, les cartes de document, etc.

• Les titres, les explorations détaillées, le numéro de résumé et le sélecteur de graphique sont tous disponibles lors de l'incorporation publique des cartes ; cependant, les filtres ne sont pas encore disponibles.Pour des raisons de sécurité, la vue du tableau de données de fin de carte n'est pas disponible avec cette fonctionnalité.

• Même si vous pouvez incorporer plusieurs cartes sur une même page, vous devrez générer le code pour chacune d'elles.

• Actuellement, vous ne pouvez pas incorporer une page de cartes comme une iFrame.

• Il est déconseillé d'incorporer plus de 10 cartes sur une même page, car cela nuit aux performances. 

• Les tableaux croisés dynamiques Sumo ne sont pas pris en charge.

Utilisation de Domo Everywhere: Domo Embed

Domo Everywhere: Domo Embed est disponible pour n'importe quelle carte. Vous pouvez accéder à l'option pour la carte soit sur la page, soit dans l'affichage des détails de la carte, en accédant au menu Clé à molette et en sélectionnant Domo Everywhere.

L'image suivante montre les composants de la boîte de dialogue Domo Everywhere: Domo Embed :

Pour en savoir plus sur les différentes parties de cette boîte de dialogue, vous pouvez utiliser le tableau suivant :

Pour incorporer une carte de façon privée en dehors de Domo,

1. Naviguez soit vers la page dans laquelle se trouve la carte, soit vers la page Détails de la carte.

2. Dans le menu Clé à molette de la carte, sélectionnez Domo Everywhere.

3. Sélectionnez une taille prédéfinie pour la carte incorporée dans le menu Taille par défaut ou sélectionnez Personnalisé et entrez les dimensions souhaitées dans les champs Largeur et Hauteur.

4. Cochez les cases de toutes les options d'affichage que vous souhaitez inclure dans la carte incorporée.

5. Dans le menu Incorporer avec, sélectionnez si vous souhaitez incorporer la carte dans un iFrame ou utiliser une API JavaScript.
   Pour plus d'informations sur l'API JavaScript, consultez la section suivante.

6. Cliquez sur l'icône pour copier le code HTML à incorporer.

7. Collez le code HTML dans le site Web, le portail ou l'application, à l'emplacement où vous souhaitez que la carte s'affiche. Les instructions spécifiques pour cette opération varient en fonction du site Web, du portail ou de l'application. Consultez votre documentation pour plus d'informations.

Pour incorporer une carte de façon publique en dehors de Domo,

1. Naviguez soit vers la page dans laquelle se trouve la carte, soit vers la page Détails de la carte.

2. Dans le menu Clé à molette de la carte, sélectionnez Domo Everywhere.

3. Sélectionnez une taille prédéfinie pour la carte incorporée dans le menu Taille par défaut ou sélectionnez Personnalisé et entrez les dimensions souhaitées dans les champs Largeur et Hauteur.

4. Cochez les cases de toutes les options d'affichage que vous souhaitez inclure dans la carte incorporée.Les options
   Autoriser la vue en tableau et Autoriser les modifications de filtre ne sont pas disponibles actuellement pour les cartes incorporées publiquement. 

5. Sélectionnez Disponible publiquement dans le menu Options de confidentialité.

6. Cliquez sur Rendre public.

7. Cliquez sur l'icône de presse-papiers pour copier l'URL générée automatiquement. 

8. (Conditionnel) Pour incorporer la carte sur l'une des 5 plateformes de réseaux sociaux listées, cliquez sur l'icône de la plateforme souhaitée, connectez-vous si nécessaire, et collez l'URL comme requis par la plateforme. Autrement, ouvrez votre site Web, votre blog, etc., et collez l'URL comme souhaité.

Utilisation de l'API JavaScript

Pour incorporer une carte à l'aide de l'API JavaScript, procédez comme suit :

1. Dans la section <head> de votre document HTML, ajoutez le code HTML suivant, en remplaçant “yourinstance” par votre URL et “yourkey" par votre clé API.
   
   <script src="http://yourinstance.domo.com/embed/yourkey/domo.js"></script>

2. Dans la section <body> du code HTML, insérez une balise <div> à l'emplacement où vous souhaitez incorporer la carte Domo.

3. Utilisez Domo.embed pour incorporer une carte dans la chaîne DIV.
C'est actuellement la seule fonction que vous pouvez utiliser. Vous pouvez utiliser Domo.embed pour incorporer une carte dans une balise <div> par ID, classe ou élément DOM.

Exemples :

  Domo.embed(…).intoElementWithId(‘divid’);

 Domo.embed(…).intoElementWithClass(‘class’);

 Domo.embed(…).intoElement(document.body);

Exemple HTML entier :

<html>

<head>

  <script

    src="http://domo.domo.com/embed/eyJhbGciOiJIUzI1NiJ9.eyJjdXN0b21lciI6IioiLCJhbGxvd2VkRG9tYWlucyI6IioiLCJleHBpcmVzIjoibmV2ZXIifQ.30NufBEghPEJMCFf2TwKMAHT6arvgPZ-badTqI49Q8I/domo.js"></script>

</head>

<body>

<div id=“my-chart” style="width: 600px; height: 600px;"></div>

<script>

  Domo.embed({

    type: "card",

    id: 1491996447,

    viewId: 1123,

    options: {

      showTitle: false,

      showSummaryNumber: true,

      allowDrill: true,

      allowTableView: true,

      allowFilters: true,

      allowChartPicker: true

    }

  }).intoElementWithId(“my - chart”);

</script>

</body>

</html>

Suivi des cartes incorporées publiquement

Vous pouvez suivre toutes les cartes incorporées publiquement dans votre instance Domo sous Paramètres d'administrateur > Domo Everywhere. Vous y trouverez des informations telles que le créateur de l'incorporation, l'état actuel du lien d'incorporation (public ou désactivé), le nombre de vues publiques, etc. Vous devez avoir un profil de sécurité "Admin" pour voir cet onglet. Pour plus d'informations, consultez Topologie des Paramètres d'administrateur - Onglet Domo Everywhere.  

Comment y accéder ?

Pour activer cette fonctionnalité, un utilisateur Administrateur doit ouvrir Paramètres d'administrateur > Paramètres de la société > Aperçu de la société, puis cocher la case "Insérer des cartes publiquement".