(Re)-Bonjour à tous,

voici donc le premier post suite à mon post de préliminaires pour décrire les évolutions que j'ai introduites dans Dolibarr en ce qui concerne la génération des documents pdf. Malgré la 'stabilité' de Dolibarr et le grand travail effectué par sa communauté, sans modifications sur ce point de 'sortie documentaire' Dolibarr n'était malheureusement non exploitable (vraiment) pour l'activité de ma société. Désirant véhiculer une image de 'qualité' et de 'services' nous avions mis au point, entre autres, des propositions 'évoluées' qui, contrairement à nos concurrents, étaient à des années lumières d'une proposition style électricien (sans froisser quiconque). Une proposition contenant plusieurs "pages", en fait plusieurs 'chapitres' ('première page', 'simulation avec des images', le 'tableau des produits-services', le 'récapitulatif financier' et les 'Conditions générales') avec du texte, des images, des 'synthèses' des produits/services... Pour arriver à reproduire cela, voici les évolutions apportées au code :

--> création de nouveaux modèles de documents pour les propositions, les factures et les interventions grâce à de nouvelles classes dérivées de celles existantes (sur ce point mes modifications sont plus facilement 'récupérables' que d'autres).

--> quasi 'fusion' de certaines de ces nouvelles classes (les plus 'hautes') entre les propositions et les factures

--> addition de 'Conditions générales' en fin de proposition (soit d'un pdf déjà créé pour notre société, soit de CGs configurables avec le nom de sociétés externes car Dolibarr est 'mis à disposition' de nos revendeurs et apporteurs d'affaire)

--> construction d'un nom de fichier pdf généré en prenant en compte le nom du prospect, la ville et la date et donc conservation de versions successives de fichier aisément repérables ('aller/retour' client fréquent dans les négociations...). Mise en pièce jointe du fichier le plus récent en cas d'envoi de mail (mais j'y reviendrai).

--> addition d'images ('simulations' de commerce ou logo 'revendeur') dans la proposition

--> insertion du texte dans le pdf soit 'directement' dans le code soit 'récupération' de paragraphes 'stockés' dans des faux 'services hors vente' dans la table des produits/services

--> non génération du pdf à chaque insertion de ligne de produits/services (pas si anecdotique que ça)


NB : véritable "combat" pour utiliser la fonction writeHTMLCell qui donne des résultats aléatoires dans le pdf... mais aussi pour gérer de 'nouveaux' champs stockés non pas en base mais dans un champ déjà présent (voir le prochain post).

Au prochain post...

Romain

Un sacré travail manifestement.
Du coté de ma pitite entreprise , je peste pour mettre en œuvre ce type de documents... C'est pourquoi nous jonglons entre tableaux excel, dossier word et devis Dolibarr !
Pourrais tu m'en dire un peu plus, voir me donner quelques pistes ? Un template meme ^^
Merci d'avance.

Romain C

Un 'template' ? ce serait magique mais je n'en ai pas.

Ce qu'il faut voir ici c'est qu'il n'y pas d'autre moyen que de plonger dans le code. Comme il n'y a pas d'interface graphique pour construire son document ni de générateur de code pour indiquer les 'chemins' pour afficher telle ou telle données suivant tel ou tel paramètre, et que les documents de sortie pdf sont très 'spécifiques' à chaque entreprise, il n'est pas évident du tout de créer pour Dolibarr un environnement de création qui convienne à une majorité d'utilisateur. Il existe des logiciels spécialisés mais ils ne font que ça et ils sont payants (et sans code source).

Créer son 'Visuel d'entreprise' à travers ses documents est une tâche indispensable dès que l'on ne vend pas du 'brut' mais une valeur ajoutée plus sophistiquée. Cela demande du temps, une mise à plat de ce que l'on veut et une mise en production par étape.

Le code que j'ai modifié n'est pas 'portable' directement. Je suis d'ailleurs toujours en version Dolibarr 2.6.1 ('modifié') alors que la version 2.8.1 est disponible. Comme je n'ai pas encore atteint l'ensemble de mes objectifs internes d'évolutions et de stabilité de l'ensemble je n'ai pas commencé à intégrer mes modifications dans le code commun.

T'envoyer mon code ne te donnerait rien car même si certaines parties (de nouvelles classes pour les modèles spécifiques pdf) sont dérivées des classes existantes de Dolibarr il y a d'autres 'connexions' non plug and play. Il faut savoir que le code Dolibarr ne respecte pas du tout le modèle MVC qui sépare les accès base de données, du pilotage et de l'affichage. Sans compter les duplications de code entre les classes 'voisines' (propositions et factures par exemple). J'ai ça et là arrangé les choses mais ce n'est pas un code très lisible.

Ce que je t'encourage à faire c'est d'écrire un cahier des charges précis de ce que tu veux. Et de le faire implémenter ensuite par Régis, un des piliers de Dolibarr, ou par moi si je trouve du temps dans les prochains mois ce qui n'est pas évident du tout.

Step by step...

Bonne journée.

Romain

Merci pour ton retour rapide.
Je pense que je vais garder la méthode actuelle (divers documents à droite à gauche) car tout ceci est passionnant, mais très (trop ) chronophage pour que je m'y penche actuellement. Je verrai ceci cet été, sauf si la prochaine mise à jour intègre des modeles Ooo d'ici là.
Bonne journée, bon weekend.