Introduction

Ce guide détaille deux approches pour restaurer une démo CRM dans votre environnement NocoBase. Choisissez la méthode adaptée à votre édition et à votre expertise technique.

Prérequis

• Une instance NocoBase opérationnelle. Consultez la documentation officielle pour l'installation initiale.
• Les fichiers de démo téléchargés :
  • Archive de sauvegarde (environ 21 Mo) : crm_demo_20250711.nbdata – pour la méthode 1.
  • Fichier SQL (environ 9 Mo compressé) : crm_demo_20250711_sql.zip – pour la méthode 2.
• Note cruciale : La démo est conçue pour une base de données PostgreSQL.

Méthode 1 : Restauration via le gestionnaire de sauvegardes (recommandée pour les éditions Pro/Entreprise)

Cette méthode utilise le plugin intégré « Gestionnaire de sauvegardes » disponible dans les éditions Pro/Entreprise pour une restauration complète via l'interface.

Avantages et limitations

• Avantages :
  • Opération simplifiée via l'interface graphique, restaure les configurations et plugins.
  • Préservation complète des fichiers système (modèles d'impression, fichiers uploadés, etc.).
• Limites :
  • Réservé aux éditions Pro/Entreprise.
  • Exige une compatibilité stricte de l'environnement de base de données (version, sensibilité à la casse).
  • Échec si des plugins commerciaux requis sont absents de votre installation.

Étapes de procédure

1. Utiliser une image Docker complète : Pour éviter les problèmes liés aux outils de base de données manquants, privilégiez l'image full. ``` docker pull nocobase/nocobase:2.1.0-full

2. Activer le plugin : Dans NocoBase, naviguez vers Gestion des plugins et activez le plugin Gestionnaire de sauvegardes.
3. Restaurer depuis un fichier local : Après actualisation, accédez à Administration système > Gestionnaire de sauvegardes, utilisez le bouton Restaurer depuis une sauvegarde locale et téléversez l'archive fournie.

Notes importantes

• La compatibilité de la base de données (version PostgreSQL, jeu de caractères, configuration du schéma) doit correspondre exactement à l'environnement d'origine de la sauvegarde.
• Tous les plugins commerciaux utilisés dans la démo doivent être installés et activés au préalable.

Méthode 2 : Import direct du fichier SQL (polyvalente, adaptée à l'édition communautaire)

Cette approche contourne le plugin en important directement les données dans la base de données, offrant une plus grande flexibilité.

Avantages et limitations

• Avantages :
  • Compatible avec toutes les éditions, y compris la version communautaire.
  • Indépendante des outils internes de NocoBase ; nécessite uniquement un accès à la base de données.
  • Tolérante aux plugins manquants : les fonctionnalités associées seront désactivées sans affecter le démarrage global.
• Limites :
  • Requiert des compétences de base en administration de bases de données.
  • Perte des fichiers système : les modèles d'impression et les fichiers uploadés ne seront pas restaurés.

Étapes de procédure

1. Préparer une base de données vide : Créez une nouvelle base PostgreSQL dédiée à la démo.
2. Importer le fichier SQL : Chargez le contenu du fichier .sql dans la base préparée. Options possibles :
   • Via la ligne de commande Docker : Copiez le fichier dans le conteneur et exécutez la commande psql. ``` docker cp demo_data.sql my_pg_container:/tmp/ docker exec -it my_pg_container psql -U db_user -d db_name -f /tmp/demo_data.sql

   • Via un client graphique : Connectez-vous avec un outil comme DBeaver ou pgAdmin, ouvrez une fenêtre de requête et exécutez le contenu du fichier SQL.
3. Configurer et démarrer NocoBase : Modifiez les variables d'environnement (par exemple, DB_HOST, DB_NAME) pour pointer vers la base importée, puis lancez l'application.

Notes importantes

• Assurez-vous de disposer des droits d'accès suffisants pour manipuler la base de données.
• Les données des plugins commerciaux seront présentes, mais leurs fonctionnalités ne seront actives que si les plugins correspondants sont installés dans votre instance.

Comparaison des méthodes