Modèle de courrier pour créer vos PDF/Documentation utilisateur : Différence entre versions
Sauter à la navigation
Sauter à la recherche
| (14 révisions intermédiaires par le même utilisateur non affichées) | |||
| Ligne 1 : | Ligne 1 : | ||
== Présentation du module == | == Présentation du module == | ||
| − | Modèle de courrier est un module pour Dolibarr destiné la création de documents PDF à partir d'une trame modifiable, de balises qui seront remplacées par les données correspondant à l'élément source et des options de | + | Modèle de courrier est un module pour Dolibarr destiné à la création de documents PDF à partir d'une trame modifiable, de balises qui seront remplacées par les données correspondant à l'élément source et des options de formatage de texte offerte par l'éditeur de texte enrichi natif. |
Modèles de courrier permet l'édition de PDF depuis les tiers et contacts, propositions, commerciales, factures et contrats. | Modèles de courrier permet l'édition de PDF depuis les tiers et contacts, propositions, commerciales, factures et contrats. | ||
== Informations pratiques == | == Informations pratiques == | ||
| − | + | '''Ce module fonctionne à partir de la version 3.7 et s'arrête à la version 6.0. Le module [http://wiki.atm-consulting.fr/index.php/DocEdit/Documentation_utilisateur DocEdit] prend la suite de ce module en incluant de nouvelles fonctionnalités.''' | |
| + | '''Il existe par ailleurs une version spécifique incluant la gestion de documents avec Agefodd : [http://wiki.atm-consulting.fr/index.php/DocEdit_pour_Agefodd/Documentation_utilisateur Doc Edit Agefodd]''' | ||
* [http://dolibarr.atm-consulting.fr Plateforme de test] | * [http://dolibarr.atm-consulting.fr Plateforme de test] | ||
* Disponible sur [https://www.dolistore.com/fr/modules/658-Mod--le-de-courrier-pour-cr--er-vos-PDF-3-7---3-9.html?search_query=modele&results=22 Dolistore] | * Disponible sur [https://www.dolistore.com/fr/modules/658-Mod--le-de-courrier-pour-cr--er-vos-PDF-3-7---3-9.html?search_query=modele&results=22 Dolistore] | ||
| + | * Retrouvez également le [http://wiki.atm-consulting.fr/index.php/Guide_installation_de_module/Guide_installation_de_module Guide d'installation de module] | ||
== Configuration du module == | == Configuration du module == | ||
* Pour configurer ce nouveau module, il faut aller dans "'''Accueil'''", puis dans le menu de gauche "'''Configuration'''" -> "'''Modules complémentaires'''"; recherchez alors le module "''Modèle de courrier pour créer vos PDF''". | * Pour configurer ce nouveau module, il faut aller dans "'''Accueil'''", puis dans le menu de gauche "'''Configuration'''" -> "'''Modules complémentaires'''"; recherchez alors le module "''Modèle de courrier pour créer vos PDF''". | ||
| − | |||
[[Image:MCPDF.png|center|thumb|1300px|Modèle de courriers pour créer vos PDF]] | [[Image:MCPDF.png|center|thumb|1300px|Modèle de courriers pour créer vos PDF]] | ||
| − | |||
* Pour une utilisation optimale du module, il est recommandé d'activer le module éditeur WYSIWYG natif de Dolibarr. | * Pour une utilisation optimale du module, il est recommandé d'activer le module éditeur WYSIWYG natif de Dolibarr. | ||
* Pensez également à gérer les droits de vos utilisateurs pour qu'ils aient accès à la consultation/modification/suppression ou l'utilisation des modèles de courrier. | * Pensez également à gérer les droits de vos utilisateurs pour qu'ils aient accès à la consultation/modification/suppression ou l'utilisation des modèles de courrier. | ||
| − | |||
== Utilisation du module == | == Utilisation du module == | ||
| Ligne 28 : | Ligne 27 : | ||
* Le menu principal affiche un tableau de bord de l’utilisation des différents modèles de documents avec une liste des modèles de courrier et une liste des courriers générés. | * Le menu principal affiche un tableau de bord de l’utilisation des différents modèles de documents avec une liste des modèles de courrier et une liste des courriers générés. | ||
| − | |||
[[Image:MC1.png|center|thumb|1300px|Modèle de courrier pour vos PDF]] | [[Image:MC1.png|center|thumb|1300px|Modèle de courrier pour vos PDF]] | ||
| Ligne 34 : | Ligne 32 : | ||
*' Dans le menu secondaire visible à gauche de votre écran, on retrouve trois fonctions : un accès à la '''liste des modèles de courrier''', la possibilité de créer un '''nouveau modèle de courrier''' et la ''liste des courriers''' qui ont été générés. | *' Dans le menu secondaire visible à gauche de votre écran, on retrouve trois fonctions : un accès à la '''liste des modèles de courrier''', la possibilité de créer un '''nouveau modèle de courrier''' et la ''liste des courriers''' qui ont été générés. | ||
| − | |||
=== Création d'un modèle de courrier === | === Création d'un modèle de courrier === | ||
| − | |||
* Pour créer un nouveau modèle de courrier, cliquez sur l'entrée de menu secondaire "'''Nouveau modèle de courrier'''". | * Pour créer un nouveau modèle de courrier, cliquez sur l'entrée de menu secondaire "'''Nouveau modèle de courrier'''". | ||
* Saisissez alors le titre du futur document et sélectionnez dans la liste déroulante le type d'objet (contrat, client,...) auquel il sera relié, et depuis lequel vous pourrez l'éditer; puis cliquez sur le bouton "''Créer''". | * Saisissez alors le titre du futur document et sélectionnez dans la liste déroulante le type d'objet (contrat, client,...) auquel il sera relié, et depuis lequel vous pourrez l'éditer; puis cliquez sur le bouton "''Créer''". | ||
| − | |||
[[Image:Modele.png|center|thumb|1300px|Modèle de courrier pour vos PDF]] | [[Image:Modele.png|center|thumb|1300px|Modèle de courrier pour vos PDF]] | ||
=== Création des chapitres === | === Création des chapitres === | ||
| − | |||
* Un modèle de courrier est une succession de « chapitres ». Chaque chapitre pouvant contenir des balises et être complété d'options. Chaque chapitre peut aussi être formaté à votre convenance en utilisant les fonctionnalités de l'éditeur de texte (Gras, souligné, couleur...). | * Un modèle de courrier est une succession de « chapitres ». Chaque chapitre pouvant contenir des balises et être complété d'options. Chaque chapitre peut aussi être formaté à votre convenance en utilisant les fonctionnalités de l'éditeur de texte (Gras, souligné, couleur...). | ||
* À partir d'un modèle de document, cliquez sur le bouton "'''Nouveau chapitre'''" : | * À partir d'un modèle de document, cliquez sur le bouton "'''Nouveau chapitre'''" : | ||
| − | |||
[[Image:MC3.png|center|thumb|1300px|Modèle de courrier pour vos PDF]] | [[Image:MC3.png|center|thumb|1300px|Modèle de courrier pour vos PDF]] | ||
| − | |||
La création d'un nouveau chapitre ouvre une page permettant : | La création d'un nouveau chapitre ouvre une page permettant : | ||
| Ligne 63 : | Ligne 55 : | ||
* de saisir le texte contenu dans le chapitre | * de saisir le texte contenu dans le chapitre | ||
* et de saisir les options. | * et de saisir les options. | ||
| − | |||
'''''Les Tags et options''''' | '''''Les Tags et options''''' | ||
| − | ''Les tags (ou balises) présents dans le texte modèle seront remplacés au moment de l'édition du document par les valeurs | + | ''Les tags (ou balises) présents dans le texte modèle seront remplacés au moment de l'édition du document par les valeurs présentes dans Dolibarr. Par exemple, la balise '''{mycompany_name}''' générera la valeur enregistrée dans le champs nom/enseigne/raison sociale/ de votre société/institution dans Dolibarr''. |
| − | |||
[[Image:MC4.png|center|thumb|1300px|Modèle de courrier pour vos PDF]] | [[Image:MC4.png|center|thumb|1300px|Modèle de courrier pour vos PDF]] | ||
| − | |||
* Terminez la création du chapitre en cliquant sur le bouton '''''Créer'''''. | * Terminez la création du chapitre en cliquant sur le bouton '''''Créer'''''. | ||
* Il est toujours possible de modifier ou supprimer le chapitre via les boutons disponibles. | * Il est toujours possible de modifier ou supprimer le chapitre via les boutons disponibles. | ||
| − | |||
[[Image:Mc5.png|center|thumb|1300px|Modèle de courrier pour vos PDF]] | [[Image:Mc5.png|center|thumb|1300px|Modèle de courrier pour vos PDF]] | ||
| − | |||
* Répétez l'opération de création de chapitre autant de fois que nécessaire pour compléter le modèle de votre document. Plus votre document sera détaillé, plus les modifications et sa personnalisation seront faciles. | * Répétez l'opération de création de chapitre autant de fois que nécessaire pour compléter le modèle de votre document. Plus votre document sera détaillé, plus les modifications et sa personnalisation seront faciles. | ||
| − | |||
=== Autres options === | === Autres options === | ||
* Il est aussi possible , suite à chacun des chapitres, d'insérer des sauts de page qui seront pris en compte lors de l'édition du document. | * Il est aussi possible , suite à chacun des chapitres, d'insérer des sauts de page qui seront pris en compte lors de l'édition du document. | ||
| − | |||
[[Image:MC8.png|center|thumb|1300px|Modèle de courrier pour vos PDF]] | [[Image:MC8.png|center|thumb|1300px|Modèle de courrier pour vos PDF]] | ||
| − | |||
* Les modèles complets peuvent être clonés, c'est-à-dire copiés depuis leur élément d'origine. Le nom du nouveau modèle de document précisera qu'il est issu d'un clonage jusqu'à sa modification. | * Les modèles complets peuvent être clonés, c'est-à-dire copiés depuis leur élément d'origine. Le nom du nouveau modèle de document précisera qu'il est issu d'un clonage jusqu'à sa modification. | ||
| − | |||
[[Image:MC7.png|center|thumb|1300px|Modèle de courrier pour vos PDF]] | [[Image:MC7.png|center|thumb|1300px|Modèle de courrier pour vos PDF]] | ||
| − | |||
== Édition du courrier == | == Édition du courrier == | ||
| Ligne 101 : | Ligne 83 : | ||
=== Personnalisation === | === Personnalisation === | ||
| − | |||
* Dans l'exemple, depuis la fiche d'un contrat, dans l'onglet ''Modèle de courrier'', sélectionnez le modèle à éditer dans la liste déroulante : | * Dans l'exemple, depuis la fiche d'un contrat, dans l'onglet ''Modèle de courrier'', sélectionnez le modèle à éditer dans la liste déroulante : | ||
| − | |||
[[Image:Mc9.png|center|thumb|1300px|Modèle de courrier pour vos PDF]] | [[Image:Mc9.png|center|thumb|1300px|Modèle de courrier pour vos PDF]] | ||
| − | |||
* La page d'édition s'affiche. | * La page d'édition s'affiche. | ||
* Les chapitres créés dans le modèle ont chacun leur éditeur permettant leur modification pour les adapter au contexte, et la sélection ou non des options prévues avec les cases à cocher : | * Les chapitres créés dans le modèle ont chacun leur éditeur permettant leur modification pour les adapter au contexte, et la sélection ou non des options prévues avec les cases à cocher : | ||
| − | |||
[[Image:MC1.png|center|thumb|1300px|Modèle de courrier pour vos PDF]] | [[Image:MC1.png|center|thumb|1300px|Modèle de courrier pour vos PDF]] | ||
| − | |||
* Une fois votre personnalisation terminée, vous pouvez '''Créer la lettre''' avec le bouton en bas de page. | * Une fois votre personnalisation terminée, vous pouvez '''Créer la lettre''' avec le bouton en bas de page. | ||
=== Création du PDF === | === Création du PDF === | ||
| − | |||
* Le document créé est accessible depuis la liste des ''Lettres existantes''. | * Le document créé est accessible depuis la liste des ''Lettres existantes''. | ||
[[Image:Mc11.png|center|thumb|1300px|Modèle de courrier pour vos PDF]] | [[Image:Mc11.png|center|thumb|1300px|Modèle de courrier pour vos PDF]] | ||
| − | |||
* Il est possible de générer le document en format PDF, les balises sont bien remplacées par leurs valeurs, et le texte modifié lors de la personnalisation a été pris en charge. | * Il est possible de générer le document en format PDF, les balises sont bien remplacées par leurs valeurs, et le texte modifié lors de la personnalisation a été pris en charge. | ||
| Ligne 131 : | Ligne 106 : | ||
== Historique et mise à jour == | == Historique et mise à jour == | ||
| − | * | + | * Dernière mise à jour en Février 2018 - version 1.0 |
Version actuelle datée du 27 juillet 2018 à 10:27
Sommaire
Présentation du module
Modèle de courrier est un module pour Dolibarr destiné à la création de documents PDF à partir d'une trame modifiable, de balises qui seront remplacées par les données correspondant à l'élément source et des options de formatage de texte offerte par l'éditeur de texte enrichi natif. Modèles de courrier permet l'édition de PDF depuis les tiers et contacts, propositions, commerciales, factures et contrats.
Informations pratiques
Ce module fonctionne à partir de la version 3.7 et s'arrête à la version 6.0. Le module DocEdit prend la suite de ce module en incluant de nouvelles fonctionnalités. Il existe par ailleurs une version spécifique incluant la gestion de documents avec Agefodd : Doc Edit Agefodd
- Plateforme de test
- Disponible sur Dolistore
- Retrouvez également le Guide d'installation de module
Configuration du module
- Pour configurer ce nouveau module, il faut aller dans "Accueil", puis dans le menu de gauche "Configuration" -> "Modules complémentaires"; recherchez alors le module "Modèle de courrier pour créer vos PDF".
- Pour une utilisation optimale du module, il est recommandé d'activer le module éditeur WYSIWYG natif de Dolibarr.
- Pensez également à gérer les droits de vos utilisateurs pour qu'ils aient accès à la consultation/modification/suppression ou l'utilisation des modèles de courrier.
Utilisation du module
- Les fonctionnalités du module Modèle de documents sont accessibles depuis le menu principal de Dolibarr par l'onglet "Modèle de courrier" :
- Le menu principal affiche un tableau de bord de l’utilisation des différents modèles de documents avec une liste des modèles de courrier et une liste des courriers générés.
- ' Dans le menu secondaire visible à gauche de votre écran, on retrouve trois fonctions : un accès à la liste des modèles de courrier', la possibilité de créer un nouveau modèle de courrier et la liste des courriers qui ont été générés.
Création d'un modèle de courrier
- Pour créer un nouveau modèle de courrier, cliquez sur l'entrée de menu secondaire "Nouveau modèle de courrier".
- Saisissez alors le titre du futur document et sélectionnez dans la liste déroulante le type d'objet (contrat, client,...) auquel il sera relié, et depuis lequel vous pourrez l'éditer; puis cliquez sur le bouton "Créer".
Création des chapitres
- Un modèle de courrier est une succession de « chapitres ». Chaque chapitre pouvant contenir des balises et être complété d'options. Chaque chapitre peut aussi être formaté à votre convenance en utilisant les fonctionnalités de l'éditeur de texte (Gras, souligné, couleur...).
- À partir d'un modèle de document, cliquez sur le bouton "Nouveau chapitre" :
La création d'un nouveau chapitre ouvre une page permettant :
- de saisir le numéro d'ordre du chapitre dans la future édition
- d'afficher la liste des tags qui pourront être copiés/collés dans le document avec le "+"
- d'enregistrer le titre du chapitre
- de saisir le texte contenu dans le chapitre
- et de saisir les options.
Les Tags et options Les tags (ou balises) présents dans le texte modèle seront remplacés au moment de l'édition du document par les valeurs présentes dans Dolibarr. Par exemple, la balise {mycompany_name} générera la valeur enregistrée dans le champs nom/enseigne/raison sociale/ de votre société/institution dans Dolibarr.
- Terminez la création du chapitre en cliquant sur le bouton Créer.
- Il est toujours possible de modifier ou supprimer le chapitre via les boutons disponibles.
- Répétez l'opération de création de chapitre autant de fois que nécessaire pour compléter le modèle de votre document. Plus votre document sera détaillé, plus les modifications et sa personnalisation seront faciles.
Autres options
- Il est aussi possible , suite à chacun des chapitres, d'insérer des sauts de page qui seront pris en compte lors de l'édition du document.
- Les modèles complets peuvent être clonés, c'est-à-dire copiés depuis leur élément d'origine. Le nom du nouveau modèle de document précisera qu'il est issu d'un clonage jusqu'à sa modification.
Édition du courrier
- Une fois le modèle terminé, vous pourrez l'éditer depuis l'élément que vous avez indiqué à sa création.
Personnalisation
- Dans l'exemple, depuis la fiche d'un contrat, dans l'onglet Modèle de courrier, sélectionnez le modèle à éditer dans la liste déroulante :
- La page d'édition s'affiche.
- Les chapitres créés dans le modèle ont chacun leur éditeur permettant leur modification pour les adapter au contexte, et la sélection ou non des options prévues avec les cases à cocher :
- Une fois votre personnalisation terminée, vous pouvez Créer la lettre avec le bouton en bas de page.
Création du PDF
- Le document créé est accessible depuis la liste des Lettres existantes.
- Il est possible de générer le document en format PDF, les balises sont bien remplacées par leurs valeurs, et le texte modifié lors de la personnalisation a été pris en charge.
Historique et mise à jour
- Dernière mise à jour en Février 2018 - version 1.0
