Dolibarr ERP CRM Wiki

Créer un modèle de document ODT ou ODS: Difference between revisions

Page

Créer un modèle de document ODT ou ODS (view source)

Revision as of 15:27, 15 July 2025

4,226 bytes added ,  1 year ago
m
→‎Lignes des objets
VisualWikitext
Tag: 2017 source edit
 
(59 intermediate revisions by 8 users not shown)
Line 1: Line 1:
<!-- BEGIN interlang links -->
<!-- Do NOT edit this section
    Links below are automatically managed by PolyglotBot
    You can edit links on the English source page : Create_an_ODT_or_ODS_document_template -->
[[en:Create_an_ODT_or_ODS_document_template]]
[[es:Crear_un_modelo_de_documento_ODT_o_ODS]]
[[de:Erstellen einer ODT-Dokumentvorlage]]
<!-- END interlang links -->
[[Category:Admin fr]]
{{TemplateDocUtil}}
{{TemplateDocUtil}}
Cette page décrit comment construire un modèle de document ODT pour utiliser la génération de document ODT.
Cette page décrit comment construire un modèle de document ODT ou ODS (Format de LibreOffice, OpenOffice, ...) pour générer un document automatiquement rempli par Dolibarr.


Pour savoir comment générer un modèle de document PDF, voir la page [[Créer un modèle de document PDF]].
Pour savoir comment générer un modèle de document PDF, voir la page [[Créer un modèle de document PDF]].
Créer un modèle PDF requiert des connaissances en programmation PHP mais pas la création de modèles ODT.  
Créer un modèle PDF requiert des connaissances en programmation PHP mais pas la création de modèles ODT.  


== Prérequis ==
*ODT est le format de documents générés par LibreOffice Writer par exemple (cas le plus fréquemment utilisé pour la génération de document).
* Dolibarr: 3.1+
*ODS est le format de documents générés par LibreOffice Calc par exemple.
* OpenOffice: 3.2+, LibreOffice, ...
 
Vous pouvez utiliser l'un ou l'autre comme modèle de document dans Dolibarr...
 
==Prérequis==
 
*Dolibarr: 3.1+
*LibreOffice ou tout éditeur de fichier ODT ou ODS (OpenOffice, ...)
 
==Créer votre document==
 
*Créer un document OpenOffice ou LibreOffice en partant de rien ou en prenant un example fournis. Si vous partez d'un exemple, vous les trouverez installés dans les sous-répertoires du répertoire '''documents/doctemplates'''
*Éditer le document en utilisant toutes les fonctions de votre suite bureautique.


== Créer votre document ==
Inclure dans votre documents les tags des informations que vous voulez voir. Les tags seront remplacés automatiquement au moment de la génération du document par Dolibarr. La liste des tags disponibles est décrite dans le chapitre suivant.
* Créer un document OpenOffice ou LibreOffice en partant de rien ou en prenant un example fournis. Si vous partez d'un exemple, vous les trouverez installés dans les sous-répertoires du répertoire '''documents/doctemplates'''
* Editer le document en utilisant toutes les fonctions de votre suite bureautique.
Incluer dans votre documents les tags des informations que vous voulez voir. Les tags seront remplacés automatiquement au moment de la génération du document par Dolibarr. La liste des tags disponibles est décrite dans le chapitre suivant.


[[File:warning.png]] Attention, les tags sont entourés de {} ou [] pour les tableaux (voir plus loin) et doivent être tapés d'une traite sous la suite Office (sans retour arrière ou effacement, ni par copié-collé). Dans le cas contraire, la suite Office ajoutera des informations invisibles qui empêche le remplacement.
[[File:warning.png]] <span style="color:#FE0000">Attention, les tags sont entourés de {} ou [] pour les tableaux ou conditions (voir plus loin) et doivent être tapés d'une traite sous la suite Office (sans retour arrière ou effacement, ni par copié-collé). Dans le cas contraire, la suite Office ajoutera des informations invisibles qui empêche le remplacement. Il est également possible d'utiliser les copier-coller mais en faisant un collage spécial sans formatage (CTRL+MAJ+V)</span>.


== Tags ==
==Tags des variables de substitution==
Voici la liste des tags qui seront remplacés par les informations appropriées:
Voici la liste des tags qui seront remplacés par les informations appropriées:


===Company/foundation information===
===Company/foundation information===
<pre>
{{TagsOdtMyCompany}}
mycompany_logo = {mycompany_logo}
mycompany_name = {mycompany_name}
mycompany_address = {mycompany_address}
mycompany_zip = {mycompany_zip}
mycompany_town = {mycompany_town}
mycompany_country = {mycompany_country}
mycompany_phone = {mycompany_phone}
mycompany_fax = {mycompany_fax}
mycompany_email = {mycompany_email}
mycompany_web = {mycompany_web}
mycompany_barcode = {mycompany_barcode}
mycompany_capital= {mycompany_capital}
mycompany_juridicalstatus= {mycompany_juridicalstatus}
mycompany_idprof1 = {mycompany_idprof1}
mycompany_idprof2 = {mycompany_idprof2}
mycompany_idprof3 = {mycompany_idprof3}
mycompany_idprof4 = {mycompany_idprof4}
mycompany_vatnumber = {mycompany_vatnumber}
mycompany_note = {mycompany_note}
...
</pre>


===Customers, prospects or suppliers information===
===Customers, prospects or suppliers information===
<pre>
{{TagsOdtThirdParty}}
company_name = {company_name}
 
company_address = {company_address}
===Contacts===
company_zip = {company_zip}
Ce sont les balises pour :
company_town = {company_town}
 
company_country = {company_country}
*contact de facture pour les factures (type BILLING)
company_phone = {company_phone}
*contact d'appel d'offres (type CUSTOMER)
company_fax = {company_fax}
*contact de commande pour les commandes de vente (type CUSTOMER)
company_email = {company_email}
 
company_web = {company_web}
Il n'y a pas de tags pour le contact de livraison et les autres objets ne peuvent utiliser ces tags non plus.
company_barcode = {company_barcode}
{{TagsOdtContact}}
company_customercode = {company_customercode}
 
company_suppliercode = {company_suppliercode}
===Information utilisateur===
company_capital = {company_capital}
{{TagsOdtUser}}
company_juridicalstatus = {company_juridicalstatus}
 
company_idprof1 = {company_idprof1}
===Autres informations===
company_idprof2 = {company_idprof2}
{{TagsOdtOther}}
company_idprof3 = {company_idprof3}
 
company_idprof4 = {company_idprof4}
===Informations sur l'objet (facture, proposition commerciale, commande, ...)===
company_vatnumber = {company_vatnumber}
{{TagsOdtObjects}}
company_note = {company_note}
 
</pre>
[[File:Info.png]]


===User information===
Pour la balise {object_total..._x}, s'il n'y a pas de montant pour le taux de tva x, la clé n'est pas remplacée. Vous pouvez donc utiliser la syntaxe de condition pour afficher 0 au lieu de la clé lorsque la valeur n'est pas définie :
<pre>
<syntaxhighlight lang="bash">
myuser_lastname = {myuser_lastname}
[!-- IF {object_total..._locale_x} --]
myuser_firstname = {myuser_firstname}
0
myuser_login = {myuser_login}
[!-- ELSE {object_total..._locale_x} --]
myuser_email = {myuser_email}
{object_total_vat_locale_x}
...
[!-- ENDIF {object_total..._locale_x} --]
</pre>
</syntaxhighlight>
[[File:Warning.png]] Pour être sûr que cette partie du code ne contient pas de texte caché (ajouté silencieusement par LibreOffice à des fins de gestion de version/suivi des changements), vous devez sélectionner toute la section de code, faire un clic droit et sélectionner la fonctionnalité "Supprimer le formatage direct" (ne pas faire cela peut rendre la section de code non opérationnelle).


===Informations sur l'objet (facture, proposition commercial, commande, ...)===
===Lignes des objets===
Voici comment utiliser des tableaux pour les lignes d'objets (factures, propositions commerciales, commandes, etc.). Vous devez créer votre tableau dans le document et utiliser une balise de début et de fin pour définir une ligne du tableau. La ligne sera ensuite répétée autant de fois que nécessaire lors de la génération.
<pre>
<pre>
object_id = {object_id}
[!-- BEGIN row.lines --]
object_ref = {object_ref}
object_ref_customer = {object_ref_customer}
object_ref_supplier = {object_ref_supplier}
object_date = {object_date}
object_date_creation = {object_date_creation}
object_date_validation = {object_date_validation}
object_total_ht = {object_total_ht}
object_total_vat = {object_total_vat}
object_total_ttc = {object_total_ttc}
object_vatrate = {object_vatrate}
object_note_private = {object_note_private}
object_note = {object_note}
...
...
[!-- END row.lines --]
</pre>
</pre>


===Lignes des objets===
Si vous souhaitez l'afficher non pas dans une ligne de tableau, mais dans des lignes de bloc :
Voici comment utiliser les tableaux de lignes des objets (lignes de factures, commandes, etc...). Vous devez créer un tableau dans le document et utiliser une balise "begin" et "end" pour définir la ligne du tableau. Cette ligne sera répétée autant de fois que requis au moment de la génération.
<pre>
<pre>
[!-- BEGIN row.lines --]
[!-- BEGIN lines --]
...
...
[!-- END row.lines --]
[!-- END lines --]
</pre>
</pre>


Ensuite, ajouter les tags de votre choix dans les lignes parmi ceux-ci:
Ensuite, ajouter les tags de votre choix dans les lignes parmi ceux-ci (en plus des tags de documents également disponibles):
{{TagsOdtLines}}
{{TagsOdtLines}}


Line 108: Line 95:
[[File:Line for document generation.png|500px]]
[[File:Line for document generation.png|500px]]


=== Autres tags personnalisés ===
===Pour les documents de projet===
Si vous voulez ajouter un champ de substitution non prédéfinie, il y a une solution:
Pour les documents sur les projets et les tâches, vous avez également
* Ajouter une fichier dans htdocs/includes/modules/substitutions/functions_mymodule.lib.php
{{TagsOdtProject}}
* Dans ce fichier , écrivez juste une fonction du genre:
 
<source lang="php">
===Substitution conditionnelle===
 
Vous pouvez utiliser des '''remplacements conditionnels''', ce qui en termes simples signifie que vous pouvez décider d'imprimer quelque chose si une variable est vrai, ou imprimer autre chose si elle est fausse (ou rien du tout) - et cela marche non seulement avec du texte, mais aussi toute structure plus complexe comme les tableaux et les images.
 
Exemple:
<pre>
[!-- IF {my_var} --]
Print this text if {my_var} is true (can be any value but null/0/empty string)
[!-- ELSE {my_var} --]
Or print this if it's false (null/0/empty string)
[!-- ENDIF {my_var} --]
</pre>
 
Note: le tag ELSE est bien sûr optionnel, vous pouvez sans problème juste utiliser un IF/ENDIF si vous préférez.
 
ATTENTION: le format de cette balise spéciale est très précis et pointilleux, faire attention à '''mettre un seul espace''' entre:
 
*[!--
*IF/ELSE/ENDIF
*{my var}
*--]
 
Exemple d'utilisation :
 
[!-- IF {line_product_label} --] {line_product_label} [!-- ELSE {line_product_label} --] {line_fulldesc} [!-- ENDIF {line_product_label} --]
 
===Autres tags personnalisés===
Si vous voulez ajouter un champ de substitution non prédéfini, il y a une solution:
 
*Ajouter un fichier nommé '''htdocs/monmodule/core/substitutions/functions_mymodule.lib.php'''
*Dans ce fichier , écrivez juste une fonction du genre:
 
<syntaxhighlight lang="PHP">
/** Function called to complete substitution array (before generating on ODT, or a personalized email)
/** Function called to complete substitution array (before generating on ODT, or a personalized email)
  * functions xxx_completesubstitutionarray are called by make_substitutions() if file
  * functions xxx_completesubstitutionarray are called by make_substitutions() if file
  * is inside directory htdocs/includes/modules/substitutions
  * is inside directory htdocs/core/substitutions
  *  
  *  
  * @param array $substitutionarray Array with substitution key=>val
  * @param array $substitutionarray Array with substitution key=>val
Line 129: Line 148:
   $substitutionarray['myowntag']=$myvalue;
   $substitutionarray['myowntag']=$myvalue;
}
}
</source>
</syntaxhighlight>


La fonction sera appelée avant la génération du document afin de compléter le tableau des subtitutions afin que le tag '''myowntag''' soit remplacé par la valeur définie dans '''$myvalue'''.
La fonction sera appelée avant la génération du document afin de compléter le tableau des substitutions afin que le tag '''myowntag''' soit remplacé par la valeur définie dans '''$myvalue'''.
Vous pouvez ajouter autant de tag que désiré, et mettre le code que vous voulez pour définir les valeurs (recherche en base, en fichier, calcul, partir des variables reçues ou globales...).
Vous pouvez ajouter autant de tag que désiré, et mettre le code que vous voulez pour définir les valeurs (recherche en base, en fichier, calcul, partir des variables reçues ou globales...).


Attention: Le premier paramètre dans la déclaration de la fonction doit commencer par & car il est modifié par le code et doit être retourné modifié. De plus, la fonction ne sera appelé que si le module '''mymodule''' est activé.
Attention: Le premier paramètre dans la déclaration de la fonction doit commencer par & car il est modifié par le code et doit être retourné modifié.  
 
Pour que vote votre fonction de substitution soit bien appelée, il vous faut:
 
*Vérifier que votre fichier de substitution est bien stocké dans le répertoire '''htdocs/monmodule/core/substitutions'''
*Créer un module (Voir la page [[Développement module]]) avec son fichier descripteur de module.
*Vérifier que le fichier descripteur de module contient une entrée pour déclarer qu'il y a un fichier de substitution à appeler. Cette doit être
 
<syntaxhighlight lang="PHP">
$this->module_parts = array('substitutions' => 1)
</syntaxhighlight>
 
*Activer le module (un module doit être activé et désactivé pour prendre en compte les changement dans son fichier descripteur)
 
===Autres tags personnalisées pour les lignes===
 
Cette fonctionnalité est disponible depuis Dolibarr v3.3 (version de développement futur).
 
De manière similaire au chapitre précédent, vous devez définir une fonction de la même façon mais avec quelques différences:
 
*Créez ou modifiez le même fichier que précédemment (voir le chapitre précédent).
*Voici les différences: dans le fichier, écrire une autre fonction avec presque le même nom mais avec '_lines' en suffixe, et également ajouter une nouvelle variable $lines:
 
<syntaxhighlight lang="PHP">
/** Function called to complete substitution array for lines (before generating on ODT, or a personalized email)
* functions xxx_completesubstitutionarray_lines are called by make_substitutions() if file
* is inside directory htdocs/core/substitutions
*
* @param array $substitutionarray Array with substitution key=>val
* @param Translate $langs Output langs
* @param Object $object Object to use to get values
*              @param  Object          $line                  Current line being processed, use this object to get values
* @return void The entry parameter $substitutionarray is modified
*/
function mymodule_completesubstitutionarray_lines(&$substitutionarray,$langs,$object,$line) {
{
  global $conf,$db;
 
  $myvalue='Put here calculated value to insert';
  $substitutionarray['myowntag']=$myvalue;
}
</syntaxhighlight>
 
Contrairement à la fonction précédente qui n'est jamais appelée qu'une seule fois, cette fonction sera appelée à chaque fois qu'une ligne de produit sera traitée, en vous donnant chaque fois un objet $line différent que vous pouvez traiter. Cela vous permet de faire des substitutions de tags différentes pour chaque produit.


== Enregistrer votre document ==
==Enregistrer votre document==
Pour voir apparaitre votre modèle de document dans la liste des modèles disponibles, placer le dans le sous-répertoire adéquat qui se trouve dans le répertoire '''documents/doctemplates'''
Pour voir apparaître votre modèle de document dans la liste des modèles disponibles en allant dans la configuration du module. Dans la section Modèle ODT/ODS, il y a un petit formulaire pour téléverser le modèle.
Il est aussi possible de placer le fichier manuellement dans le sous-répertoire adéquat qui se trouve dans le répertoire '''documents/doctemplates'''
Retrieved from "https://wiki.dolibarr.org/index.php/Special:MobileDiff/24709...63749"