Documentation
Applications

Insights

Analyser les données de Dokos avec Insights 3 : classeurs, requêtes, graphiques, tableaux de bord et partage.

Insights

Insights est l'outil d'analyse de données de Frappe. Il lit les données de votre site Dokos et les affiche sous forme de graphiques et de tableaux de bord. Les sites Dokos utilisent la version 3 d'Insights.

L'interface d'Insights est en grande partie en anglais : la traduction française de la version 3 est incomplète. Cette page donne les libellés tels qu'ils s'affichent.

Comment Insights organise le travail

Insights range le travail dans des classeurs (Workbooks). Un classeur contient trois types d'éléments :

  • les requêtes (Queries) lisent une ou plusieurs tables de Dokos ;
  • les graphiques (Charts) affichent le résultat d'une requête ;
  • les tableaux de bord (Dashboards) assemblent plusieurs graphiques, des filtres et du texte.

Le menu de gauche d'Insights donne accès à Dashboards, Workbooks, Data Sources, Data Store et Settings. La base de données de votre site est la source de données par défaut.

Prérequis

  • L'application Insights est installée sur votre site. Sur Dokos Cloud, ajoutez-la depuis le tableau de bord de votre site. En auto-hébergement, voir Installer une application.
  • Vous avez le rôle Insights User pour créer des classeurs. Le rôle Insights Admin gère les sources de données et les paramètres.

Ouvrez Insights depuis l'écran des applications, ou à l'adresse https://votre-site/insights.

Créer un tableau de bord

L'exemple suit la responsable commerciale de Dokompany. Elle veut suivre le chiffre d'affaires facturé par mois. Ce classeur n'existe pas sur le site de démonstration. Pour voir un classeur complet, ouvrez-y le classeur « Order Analysis » : il a des requêtes, des graphiques et un tableau de bord, sur la source de données d'exemple demo_data.

  1. Dans le menu de gauche, cliquez sur Workbooks, puis sur New Workbook.
  2. Dans la section Queries du classeur, cliquez sur + pour ajouter une requête.
  3. Choisissez l'interface de saisie. Query Builder est l'interface visuelle. SQL Editor accepte une requête SQL.
  4. Sélectionnez la table des factures de vente (Sales Invoice). Gardez les factures validées et regroupez le total par mois de la date de facture.
  5. Dans la section Charts, cliquez sur +. Le graphique utilise la requête active. Choisissez un graphique en barres.
  6. Dans la section Dashboards, cliquez sur + pour créer le tableau de bord.
  7. Cliquez sur Edit, puis sur Chart pour ajouter le graphique. Filter ajoute un filtre et Text un bloc de texte.
  8. Enregistrez la mise en page.

Le tableau de bord affiche le chiffre d'affaires par mois. Refresh recharge les données.

Partager un tableau de bord

Le partage donne accès au tableau de bord, pas aux données. Chaque lecteur doit pouvoir lire les types de documents utilisés par les requêtes.

  1. Ouvrez le tableau de bord et cliquez sur Share.
  2. Dans General Access, choisissez qui peut voir le tableau de bord :
    • Specific people can view : seulement les personnes ajoutées à la liste ;
    • Anyone in the organization can view : tous les utilisateurs d'Insights du site ;
    • Anyone with the link can view : toute personne qui a le lien, sans connexion.
  3. Pour ajouter une personne, cherchez-la par son nom ou son e-mail, puis cliquez sur Share.
  4. Cliquez sur Terminé pour enregistrer.

Les deux boutons à côté de General Access copient le lien du tableau de bord et le code <iframe> pour l'intégrer à une autre page.

Choisissez Anyone with the link can view seulement pour des données publiques. Le lien ne demande aucune connexion.

Partager un classeur

Partagez le classeur quand un collègue doit modifier les requêtes ou les graphiques.

  1. Dans le classeur, cliquez sur le bouton de partage de la barre du haut.
  2. Dans Manage Workbook Access, ajoutez la personne. Choisissez Can View pour la lecture ou Can Edit pour la modification.
  3. Réglez l'accès de l'organisation : Disabled, Can View ou Can Edit.
  4. Cliquez sur Enregistrer.

Les droits sur les données

L'option Apply User Permissions des Settings est cochée par défaut. Chaque graphique est alors calculé avec les droits et les restrictions de la personne qui le regarde. Un Insights Admin peut décocher cette option : les requêtes lisent alors les tables sans tenir compte des droits Dokos du lecteur.

Si un collègue voit un graphique vide, voir Un tableau Insights partagé reste vide pour un collègue.

Pour aller plus loin