MyDolidash

De Documentations Patas-monkey
Sauter à la navigation Sauter à la recherche
Mydolidash 250x250.png myDoliDash est une solution composée d'un module Dolibarr et d'un environnement Opensearch permettant de d'intégrer dans dolibarr un Reporting BI en temps réel grâce à des tableaux dynamiques. Vous pourrez également créer vos propres reportings en plus de ceux déjà présent, sans avoir nécessairement besoin de connaitre le langage SQL.


Présentation

Liste des Dashboards par version de dolibarr

Dolibarr 13 Dolibarr 14 Dolibarr 15
DB - Bank - Account DB - Bank - Account DB - Bank - Account
DB - Contract DB - Contract DB - Contract
DB - Customer DB - Customer DB - Customer
DB - Customer - Bill DB - Customer - Bill DB - Customer - Bill
DB - Customer - Detail DB - Customer - Detail DB - Customer - Detail
DB - Customer - Order DB - Customer - Order DB - Customer - Order
DB - Customer - Proposal DB - Customer - Proposal DB - Customer - Proposal
DB - Customer - Prospect DB - Customer - Prospect DB - Customer - Prospect
DB - Expenses Report DB - Expenses Report DB - Expenses Report
DB - Holiday DB - Holiday DB - Holiday
DB - Interventional DB - Interventional DB - Interventional
DB - MRP DB - MRP DB - MRP
DB - Product - Detail DB - Product - Detail DB - Product - Detail
DB - Product - Recept DB - Product - Recept DB - Product - Recept
DB - Product - Shipping DB - Product - Shipping DB - Product - Shipping
DB - Products - Services DB - Products - Services DB - Products - Services
DB - Project DB - Project DB - Project
DB - Salary DB - Salary
DB - Supplier DB - Supplier DB - Supplier
DB - Supplier - Bill DB - Supplier - Bill DB - Supplier - Bill
DB - Supplier - Order DB - Supplier - Order DB - Supplier - Order
DB - Supplier - Proposal DB - Supplier - Proposal DB - Supplier - Proposal
DB - User Detail DB - User Detail DB - User Detail
DB - Warehouse DB - Warehouse DB - Warehouse

Paramétrage de Docker

1ére Etape : collecte des informations préalable

connaitre sa version dolibarr et les informations pour accéder à sa base de données ses information sont présente sur la page de configuration du module (en bas)

Naviguer dans votre explorateur du dossier Opensearch ou Elastisearch au dossier Dolibarr afin de récupérer la version de Dolibarr souhaitée

2ème Etape : Modification du docker-compose.yml

docker-compose.yml contient l'ensemble des services nécessaire au fonctionnement d'opensearch il n'est pas nécessaire de laisser le docker-compose.yml dans le dossier du module, ni même sur la même machine

La configuration de base fournit contient : - 2 nodes opensearch servant à stocker les données - un opensearch-dashboard permettant d'accéder par un interface web aux données présentes dans opensearch - logstash utilisé pour alimenter à partir de dolibarr les nodes openseach

Il n'est pas obligatoire de modifier les paramétrages des nodes opensearch et opensearch-dashboard mais il est nécéssaire de configurer le service logstash pour lui permettre de se connecter à aux données de dolibarr qui vous sont propres (adresseIP, mots de passe, ...)

L'ensemble de ce paramétrage s'effectue au niveau du service logstash

changement du port de connection à opensearch-dashboard

par défaut le port de connection est le 5601, il est possible de le changer au niveau du service opensearch-dashboard

   ports:
     - 5601:8637
   expose:
     - "8637"


définition des chemins

  • connecteur jdbc
     - "../../jdbc:/usr/share/logstash/jdbc"
  • fichier de log de dolibarr
     - C:\wamp64\www\dolibarr-14.0.5\documents:/usr/share/logstash/dolibarrlog/

définition des variables d'environnements

  • MYSQLCONNECTOR: "mysql-connector-java-8.0.27.jar" --> correspond au nom du fichier java (.jar) permettant la connection à la base mysql
  • DBSERVER: "host.docker.internal" --> correspond à l'adresse (IP) du serveur où est installé la base de données de votre dolibarr. si vous installer votre docker sur la même machine ou se trouve votre base de données, il faut conserver le paramétrage saisie (host.docker.internal) qui correspond pour docker à la machine ou tourne votre docker
  • DBNAME: "dolibarr" --> correspond au nom de la base de données
  • DBPREFIX: llx_ --> correspond au préffix des tables dans dolibarr
  • DBLOGIN: root --> identifiant à la base de données
  • DBPASSWORD: "##passw0rd##" --> mot de passe de la base de données
  • LANGS: FR_fr --> chemin contenant les dictionnaires de variables traduit (ici en français)
  • SCHEDULE: "* * * * *" -> planificateur de lancement de la récupération des données
  • OSLOGIN: admin identifiant d'accès à opensearch (se modifie à partir de opensearch-dashboard
  • OSPASSWORD: admin mot de passe d'accès à

3ème Etape : lancement initial du docker

Ouvrir un terminal de console ("shell" "cmd" selon votre environnement) se déplacer dans le répertoire ou se trouve le docker-compose.yml que vous avez modifier Aller dans votre terminal pour écrire la commande suivante "docker-compose up"


Pour des installations plus complexes (VM, ...), nous pouvons vous proposer un support payant.


A la fin de l'installation vous devriez pouvoir vous connecter au Opensearch-Dashboard en cliquer directement sur l'icone dans Docker.

Veuillez copie url qui s'affiche dans votre barre.

Mydolidash-recup-url.png

Paramétrage du module

Page de configuration du module

Importer les dashboards par défaut

Une fois l'installation de docker faite, il suffit de coller url précédement copiée dans l'encart ci-dessous afin d'importer les dashboards.

MyDolidash creation-liste-initiale.png

Paramètres de configuration

Vous pouvez paramétrer sur deux points pour l'application :

  • Activer le tracking des utilisateurs, cette fonction est accessible pour la version avancée de DoliDash.
  • Permet d'ajuster la taille de la fenêtre que vous souhaitez en modifier le chiffre.


MyDolidash parametre-configuration.png

Information de support

Vous trouverez en bas de la page de configuration les informations techniques liées à votre installation. Ces informations techniques seront utiles et pourront vous être demandées si vous rencontrez un bug dans l'utilisation du module :

Myfield Technical-information.png

Démarrage

Les fonctionnalités de MyDoliDash sont accessibles depuis l'onglet de menu principal Patastools. Votre menu secondaire présente alors les entrées de menu suivantes :

Myfieild.png

Personnalisations

OpenSearch DashBoard

Remarque

Le but de cette présentation n'est pas d'acquérir des compétences avec Dashboard qui est un outil à part entière mais de vous expliquer ce qu'il est de faire. Le mieux étant de s'inspirer des différents visuels et dashboard existant et inclue dans nos différents modules.

Création d'un Visuel

Myfield visualization.png

Area

Permet une visualisation avec des courbes superposées avec plusieurs champs croisés.

Controls

Permet de configurer des filtres directement dans vos dashboards comme notre date control déjà présent.

Coordinate Map

Permet de créer une carte en rentrant des coordonnées GPS.

Data Table

Permet de faire un tableau croisé dynamique.

Gantt Chart

Ce visuel ne fonctionne pour l'instant mais il permettrai de faire une visualisation de type Gantt Chart.

Gauge

Permet de faire une visualisation sur une donnée en la paramétrant pour que vous puissiez le taux ou l indice.

Goal

Permet en donnant un nombre le pourcentage atteins.

Heat Map

Permet de faire une visualisation en mode matrice avec plusieurs données croisées

Horizontal Bar

Permet une visualisation en barre sur l'horizontal.

Line

Permet une visualisation par points reliés.

Markdown

Permet d'insérer une zone de texte.

Metrics

Permet de créer des données numériques (panier moyen, max, min, médiane, totalisation...)

Pie

Permet de créer une visualisation en camembert par répartition de parts.

Region Map

Permet de créer une map (région, monde...)

TSVB

Afficher plusieurs vues dans une même visualisation.

Tag Cloud

Permet de lister en nuage en fonction de la répartition de la donnée.

Timeline

Permet de créer une visualisation en fonction d'une chronologie.

Vega

Permet une programmation de graphiques avancés

Vertical Bar

Permet une visualisation en barre sur la verticale.

Création d'un dashboard

Menus

Création d'un mydolidash

Myfield creation dashboard.png

Ajoutez vos différents visuels à partir de ceux que vous avez crées ou ceux déjà existants.

Utilisation

filtrage de base

Myfield filtrage de base.png

Vous pouvez filtrer simplement en cliquant sur les contrôles ou les différents éléments présent sur le dashboard. Ceux-ci apparaitront en haut, vous pouvez les supprimer en cliquer sur la croix.

filtrage avancé

Myfield filtrage avancé.png

Vous pouvez écrire directement sur votre code en DQL afin de créer vos filtrages avancées pour plus de documentation vous pouvez vous rendre directement sur le site Opensearch.

Fonctions Annexes

Passer d'une carte mondiale à une carte régionale

Vous devez sélectionner dans Data et choisir dans field le champs state_name.keyword



Myfield map data.png



Vous devez sélectionner dans :

  • Vector map choisir France Departements
  • Join field choisir Name (fr)



Myfield map option.png