Documentation KSIDol > Modules KSIDol > Profils de documents
Notice du module Profils de documents
Guide d'utilisation non technique : à quoi sert le module, comment l'utiliser et comment il s'articule avec Dolibarr.
Documents concernésFactures et devis
Modèles PDF fournis1 facture, 4 devis
Remplacé à l'impressionLogo, nom affiché, e-mail
CompatibilitéDolibarr 18 à 24
1. Présentation du module
Le module Profils de documents (DocProfilesTools) permet de définir une ou plusieurs « identités de document » et de les appliquer à vos factures et à vos devis au format PDF. Un profil réunit un libellé, un nom à afficher, une adresse e-mail et un logo. Au moment d'éditer le document, le module substitue ces éléments à ceux de votre société, laisse la mise en page habituelle de Dolibarr faire son travail, puis rétablit vos coordonnées : ni la facture, ni le devis, ni la fiche de votre société ne sont modifiés.
C'est utile lorsque vous éditez des documents sous une présentation particulière — une marque, une enseigne, une entité — sans vouloir toucher aux réglages généraux de votre société. Le module ne crée aucun nouveau type de document : il ajoute des modèles PDF qui reprennent exactement la mise en page des modèles natifs de Dolibarr (Sponge pour les factures, Azur, Crabe, Cyan et Sponge pour les devis) et se contente d'y injecter l'identité du profil retenu.
Regrouper dans un profil réutilisable le nom à afficher, l'adresse e-mail et le logo qui doivent figurer sur vos documents.
Appliquer cette identité automatiquement à l'édition des factures et des devis, sans saisie supplémentaire sur le document.
Conserver la mise en page native de Dolibarr : les modèles fournis prolongent les modèles standard, ils ne les remplacent pas.
Gérer autant de profils que nécessaire, chaque société (entité) appliquant le sien.
Ne modifier aucune donnée du document ni de la fiche de votre société : la substitution ne dure que le temps de produire le fichier.
Tout régler depuis une page de configuration unique, réservée aux administrateurs.
2. Mettre le module en service
L'activation du module prépare elle-même tout ce dont il a besoin : il n'y a aucun réglage préalable à effectuer pour obtenir un premier document personnalisé.
À l'activation, le module crée son stockage de profils ainsi que ses répertoires de travail.
Il crée également un « Profil par défaut », déjà actif, pré-rempli avec le nom, l'adresse e-mail et le logo de votre société.
Les modèles PDF livrés sont installés dans le module, à l'endroit où Dolibarr va les chercher.
La page de configuration s'ouvre depuis la liste des modules, par le bouton de configuration placé en face de DocProfilesTools.
Aucun autre module n'est requis et aucune permission supplémentaire n'est à distribuer à vos utilisateurs.
Le module est prévu pour les versions 18 à 24 de Dolibarr.
3. Créer et gérer les profils de documents
Un profil décrit l'identité à faire apparaître sur les documents. La page de configuration sert à la fois à le saisir et à retrouver les profils déjà enregistrés.
Donner un libellé au profil : c'est le nom sous lequel vous le retrouverez dans la liste.
Saisir le nom à afficher sur le PDF, lorsqu'il doit différer du nom enregistré pour votre société.
Saisir un nom de société et une adresse e-mail propres au profil ; à défaut de nom à afficher, c'est le nom de société du profil qui est repris sur le document.
Marquer le profil actif ou inactif : seul un profil actif est appliqué aux documents.
Indiquer la société (entité) à laquelle le profil appartient : il ne sera appliqué que dans celle-ci.
Retrouver, sous le formulaire, la liste des profils de la société en cours, avec le nom affiché, le nom de société, l'adresse e-mail, les modèles retenus et l'état actif ou non.
Reprendre un profil existant par le bouton d'édition de la liste, ou le supprimer après confirmation ; la suppression retire également les fichiers du profil.
Un seul bouton d'enregistrement valide l'ensemble de la page.
4. Le logo du profil
Le logo est le réglage le plus visible d'un profil. Il se téléverse depuis la page de configuration, et le module se charge de le mettre à la disposition de la mise en page.
Téléverser une image depuis votre poste : la page affiche ensuite un aperçu du logo retenu et le chemin du fichier correspondant.
Si aucune image n'est fournie, le logo de votre société est recopié dans le profil : un profil n'est donc jamais sans logo.
À l'édition du document, le logo du profil est recopié sous un nom réservé dans le dossier des logos de votre société, afin que la mise en page native sache le retrouver.
Le logo d'origine de votre société reste en place : il est simplement ignoré le temps de produire le fichier.
5. Mettre les modèles DocProfiles à disposition
Le module livre cinq modèles PDF : un pour les factures et quatre pour les devis. Comme tout modèle de document dans Dolibarr, ils doivent être activés une fois pour devenir sélectionnables.
Un modèle de facture, dérivé du modèle natif Sponge.
Quatre modèles de devis, dérivés des modèles natifs Azur, Crabe, Cyan et Sponge.
Lorsque le modèle natif correspondant n'existe pas dans la version installée, le modèle du module se rabat automatiquement sur un modèle de devis disponible : aucune édition ne reste bloquée.
Les modèles s'activent dans la configuration des factures et dans celle des propositions commerciales, à la rubrique des modèles de documents, comme n'importe quel autre modèle.
Une fois activés, ils se choisissent document par document depuis la fiche de la facture ou du devis.
La case de forçage des modèles DocProfiles, sur la page de configuration, désigne en une fois le modèle de facture et le modèle de devis sélectionnés comme modèles par défaut de la société en cours.
Les deux listes déroulantes de la page n'affichent que les modèles du module réellement présents sur l'installation.
6. Ce que le profil change sur le document édité
Au moment où Dolibarr fabrique le PDF, le module intervient juste avant la mise en page, puis s'efface.
Le profil appliqué est le premier profil actif de la société en cours, dans l'ordre de création.
Le nom de l'émetteur est remplacé par le nom à afficher du profil, ou à défaut par son nom de société.
L'adresse e-mail de l'émetteur est remplacée par celle du profil.
Le logo de l'émetteur est remplacé par celui du profil.
Tout le reste du document est produit par le modèle natif : lignes, totaux, mentions, conditions de règlement et numérotation ne sont pas touchés.
Dès le fichier écrit, les informations de votre société sont rétablies : la fiche de votre société n'est jamais modifiée.
S'il n'existe aucun profil actif, le document est édité normalement, avec vos propres coordonnées.
7. Installation hébergeant plusieurs sociétés
Le module est conçu pour fonctionner sur une installation qui héberge plusieurs sociétés : chacune dispose de ses profils et ne voit que les siens.
Chaque profil porte la société (entité) à laquelle il appartient.
La liste des profils et le profil appliqué aux documents sont ceux de la société en cours.
Le forçage des modèles par défaut n'agit que sur la société en cours.
La page de configuration rappelle en clair la cible sur laquelle vous travaillez, afin qu'aucune action ne soit menée sur la mauvaise société.
8. Entretien du stockage des profils
Deux boutons, en haut de la page de configuration, servent aux rares cas où le module a besoin d'être remis d'aplomb, par exemple après une restauration de sauvegarde.
Le bouton de réparation crée le stockage des profils s'il manque, et le complète s'il est incomplet.
Le bouton d'installation des modèles recopie les modèles PDF livrés à l'endroit où Dolibarr les cherche.
Si le stockage des profils est absent, la page le signale et s'arrête là : elle n'affiche pas un formulaire qui ne pourrait rien enregistrer.
L'ouverture de la page n'écrit jamais rien : elle se contente de lire et d'afficher l'état constaté.
9. Accès et sécurité
Le module est un outil d'administration : il n'ouvre aucun écran à vos utilisateurs et n'expose aucune donnée.
La page de configuration est réservée aux administrateurs et refusée à tout utilisateur externe rattaché à un tiers.
Le module n'introduit aucune permission à régler utilisateur par utilisateur.
La page ne répond que sur les installations où le module est effectivement activé.
Les enregistrements et les suppressions n'aboutissent que sur une validation du formulaire accompagnée du jeton de sécurité de votre session : une adresse préparée à l'avance ne déclenche rien.
Aucune donnée comptable n'est modifiée : le module n'agit que sur la présentation du document édité.
10. Liaisons avec Dolibarr
Le module ne fonctionne pas en vase clos : il s'articule avec les briques natives de Dolibarr.
Factures : Le module fournit un modèle PDF de facture dérivé du modèle natif Sponge. À l'édition, l'identité du profil remplace celle de votre société le temps de produire le fichier ; la facture, ses lignes, ses totaux et sa numérotation restent inchangés.
Devis / Propositions commerciales : Quatre modèles PDF de devis sont fournis, dérivés des modèles natifs Azur, Crabe, Cyan et Sponge. Ils appliquent le profil de la même manière que le modèle de facture et se rabattent sur un modèle disponible si le modèle natif correspondant n'existe pas dans la version installée.
Modèles de documents (PDF) : Les modèles du module s'ajoutent à la liste des modèles de documents de Dolibarr : ils s'y activent, peuvent y être désignés comme modèle par défaut, et se choisissent ensuite sur la fiche du document comme n'importe quel modèle standard.
Fiche de votre société (émetteur) : Le module lit le nom, l'adresse e-mail et le logo de votre société pour pré-remplir le profil par défaut à l'activation, puis les remplace temporairement à chaque édition avant de les rétablir. La fiche elle-même n'est pas modifiée.
Sociétés (entités) : Les profils sont rattachés à une société : chacune dispose des siens, n'applique que les siens, et le choix de modèle par défaut imposé depuis la page de configuration ne vaut que pour la société en cours.
Utilisateurs et permissions : Le module n'ajoute aucune permission : sa page de configuration est réservée aux administrateurs, et les utilisateurs externes rattachés à un tiers en sont écartés.
Cookies
KSIDol utilise des cookies nécessaires pour le panier, la connexion et le paiement. Les cookies non essentiels restent désactivés tant que vous ne les acceptez pas.
Bonjour, je suis KSIAssistantIA, l’assistant intégré à votre logiciel de gestion. Je peux par exemple vous faire un résumé de la situation de votre entreprise. Voulez-vous voir ce que je sais faire ?