Documentation
Quand quelque chose ne va pas
Trois écrans sont faits pour ces moments-là : la page Diagnostic qui contrôle l'installation, l'assistant de configuration qui la met en ordre, et l'onglet Support qui vous permet de nous transmettre ce dont nous avons besoin.
La page Diagnostic
Accessible depuis la configuration du module, elle vérifie en un coup d'œil ce dont le module dépend : version de Dolibarr, version de PHP, tables présentes, champs supplémentaires créés sur les produits, cohérence des fuseaux horaires entre PHP et la base.
Chaque ligne porte un état clair et, quand quelque chose ne va pas, la cause plutôt qu'un simple « erreur ».
C'est le premier écran à ouvrir après une mise à jour de Dolibarr ou une migration de serveur. Il répond en quelques secondes à des questions qui prennent autrement une demi-heure.
L'assistant de configuration
Il parcourt les réglages du module dans l'ordre où ils comptent : mode d'approvisionnement par défaut, entrepôt, délai et capacité de production, notifications. Chaque étape explique à quoi le réglage sert avant de le demander.
Il est utile à l'installation, mais aussi après coup pour revoir un choix sans chercher dans quelle page il se trouve.
L'onglet Support
C'est l'écran à ouvrir quand vous nous écrivez.
Le journal du module
Depuis la version 1.5.0, le module tient son propre journal, séparé de celui de Dolibarr.
La différence compte : le journal général d'une instance active atteint facilement plusieurs centaines de méga-octets, où les lignes du module sont noyées parmi celles du cœur et de tous les autres modules — et un fichier de cette taille ne s'envoie pas par courriel. Le journal du module, lui, ne contient que ce qui le concerne.
L'onglet Support affiche s'il est actif, le nom du fichier et sa taille, avant que vous ne tentiez de l'envoyer. Un bouton le télécharge.
Le téléchargement est réservé à un administrateur général de Dolibarr. Le journal est un fichier unique pour toutes les entités : son contenu peut porter des références de commande et des noms de tiers d'autres sociétés que la vôtre.
Les adresses électroniques y sont masquées : ce fichier est fait pour nous être envoyé, il ne doit pas transporter de données personnelles inutiles.
Régler le niveau de détail
La verbosité du journal se règle pour le module seul, depuis la configuration. En cas de diagnostic difficile, vous pouvez le passer en mode détaillé sans mettre tout Dolibarr en mode détaillé — ce qui gonflerait le journal général sans rien apporter.
Pensez à le remettre à son niveau normal une fois le diagnostic terminé.
Les informations que nous demandons
L'onglet affiche aussi la version du module, celle de Dolibarr et celle de PHP. Ce sont les trois premières questions de tout échange de support : les avoir sous les yeux évite un aller-retour.
Le module suit le thème de votre Dolibarr
Depuis la version 1.5.0, les écrans du module n'imposent plus aucune couleur : ils suivent le thème que vous avez choisi, y compris un thème sombre ou aux couleurs de votre société.
Si vous connaissiez les versions précédentes, l'aspect a changé — c'est voulu. Le module vit dans votre ERP : c'est votre identité visuelle qui y compte, pas la nôtre.