DevOps Dolibarr : Power BI Tutoriel pas à pas sans casser l’existant

Introduction : Pourquoi connecter Power BI à Dolibarr en mode DevOps ?

Dolibarr, l’ERP/CRM open source, stocke des données précieuses sur votre activité : ventes, stocks, facturation, projets. Power BI offre une visualisation avancée de ces données. Mais comment les connecter sans risque pour votre production ?

Ce tutoriel adopte une approche DevOps : automatisée, versionnée et non-invasive. Nous allons extraire les données de Dolibarr pour les charger dans Power BI sans toucher à la base de production ni modifier Dolibarr.

Étape 1 : Préparation et principes de sécurité

🛡️ Règles d’or :

  • Jamais de connexion directe à la base de production Dolibarr depuis Power BI

  • Toujours travailler sur une réplique (dump) de la base ou via l’API Dolibarr

  • Utiliser un compte utilisateur Dolibarr dédié avec permissions minimales (lecture seule)

  • Stocker les identifiants dans Power BI Data Gateway ou Azure Key Vault

📋 Prérequis :

  1. Accès administrateur à Dolibarr (pour créer l’utilisateur API)

  2. Power BI Desktop + licence Pro ou Premium

  3. Power BI Gateway (pour rafraîchissements automatisés)

  4. Connaissances basiques en requêtes SQL ou API REST

Étape 2 : Méthode recommandée – Utiliser l’API Dolibarr (sans risque)

Pourquoi l’API plutôt que la base directe ?

  • Garantit l’intégrité des données

  • Respecte les permissions Dolibarr

  • Ne dépend pas de la structure technique de la base

  • Évolue avec les versions de Dolibarr

2.1 Créer un utilisateur API dans Dolibarr

  1. Connectez-vous en admin → Utilisateurs & Groupes → Nouvel utilisateur

  2. Créez un utilisateur (ex: api_powerbi) avec mot de passe complexe

  3. Dans l’onglet Permissions :

    • Décochez tout accès à l’interface web

    • Activez uniquement "API REST" (module à activer dans Administration → Modules)

  4. Notez l’ID utilisateur et le mot de passe

2.2 Tester l’API avec Postman (optionnel mais recommandé)

GET https://votre-dolibarr.com/api/index.php/htdocs/api.php/method=login

Authentifiez-vous avec l’utilisateur API pour récupérer un token.

Étape 3 : Connexion Power BI – API Dolibarr

3.1Dans Power BI Desktop :

  1. Obtenir les données → Web

  2. URL de l’API (exemple pour récupérer les factures) : 
    https://votre-dolibarr.com/api/index.php/htdocs/api.php/invoices?sortfield=t.date&sortorder=desc&limit=100

  3. Authentification : Basique (Basic) avec login/mot de passe API

  4. Power BI détecte le format JSON → naviguez jusqu’aux données

3.2 Transformer les données

  • Utilisez Power Query Editor pour :

    • Déplier les colonnes JSON complexes

    • Convertir les types de données (dates, nombres)

    • Filtrer les colonnes utiles

  • Ne modifiez jamais la structure source dans Dolibarr

Étape 4 : Automatisation et DevOps

🔄 Versionnement du rapport

  1. Sauvegardez le fichier .pbix dans Git (avec .gitignore pour les fichiers temporaires)

  2. Documentez les transformations dans unReadme.md :

    • Source API utilisée

    • Filtres appliqués

    • Université sémantique créée

⏱️ Rafraîchissement sécurisé avec Gateway

  1. Installez Power BI Gateway sur un serveur différent du Dolibarr

  2. Dans Power BI Service : Paramètres du rapport → Sources de données

  3. Configurez les credentials API dans Gateway (stockés chiffrés)

  4. Planifiez le rafraîchissement hors heures de production (ex: 2h du matin)

Étape 5 : Alternatives selon votre contexte

Option A – Base de données clone (si API insuffisante)

  1. Créez un dump programmé de la base Dolibarr (script SQL mysqldump)

  2. Stockez-le sur un serveur intermédiaire (jamais le serveur de prod)

  3. Connectez Power BI à cette base clone via MySQL connector

  4. Mettez à jour le dump quotidiennement (cron/Task Scheduler)

Option B – Tableaux intermédiaires

  1. Dans Dolibarr, créez des vues SQL dédiées (via module TechPreserve ou administration SQL)

  2. Ces vues agrègent uniquement les données nécessaires

  3. Power BI se connecte à ces vues (moins lourdes, plus stables)

Étape 6 : Supervision et maintenance

📊 Monitoring obligatoire :

  • Alertes Power BI sur échec de rafraîchissement

  • Logs Dolibarr : surveiller les appels API ( Administrate → Outils → Journal )

  • Performance : limiter le nombre d’enregistrements par appel API (paramètre limit)

🔄 Maintenance préventive :

  • Tester les connexions après chaque mise à jour Dolibarr

  • Vérifier les changements d’API (documentation Dolibarr)

  • Archiver les anciens rapports Power BI (gestion des versions)

Bonnes pratiques récapitulatives

✅ Faire ❌ Éviter
Utiliser l’API ou un clone de base Se connecter directement à la base de prod
Créer un utilisateur dédié Utiliser le compte admin
Stocker les credentials dans Gateway Les mettre en dur dans le fichier .pbix
Limiter les volumes de données Tout importer sans filtre
Documenter chaque transformation Modifier les données sans traçabilité

Conclusion : Une intégration durable

En suivant cette approche DevOps, vous obtenez :

  • Zéro downtime sur Dolibarr

  • Traçabilité complète des données dans Power BI

  • Maintenance prévisible grâce à l’automatisation

  • Évolutivité pour ajouter de nouveaux indicateurs

La clé est la séparation des environnements : Dolibarr reste maître de ses données, Power BI en consomme une copie contrôlée. Votre ERP/CRM continue de tourner sans risque pendant que vos tableaux de bord s’enrichissent.

Ressources utiles

Prochaines étapes possibles :

  1. Créer un dataset partagé pour plusieurs rapports

  2. Déployer les rapports via Power BI App Workspaces

  3. Mettre en place l’alerte sur seuils métier (ex: chiffre d’affaires en baisse)

Vous avez maintenant un pipeline robuste pour analyser vos données Dolibarr dans Power BI, sans jamais compromettre la stabilité de votre système existant. 🚀

Publications similaires