ExtraOdt

Le module permet de créer à partir des ODTs (documents textes) natifs de Dolibarr, des documents texte personnalisés à générer depuis les fiches des éléments .

Création et utilisation des modèles ODT

ExtraOdt utilise le système de génération de documents ODT intégré à Dolibarr.

Pour comprendre comment créer et modifier un modèle ODT, utiliser les balises, gérer les lignes et les boucles, consultez la documentation officielle de Dolibarr :

https://wiki.dolibarr.org/index.php/Cr%C3%A9er_un_mod%C3%A8le_de_document_ODT_ou_ODS

Cette documentation décrit le fonctionnement général des modèles ODT. La présente page documente les fonctionnalités et balises spécifiques ajoutées par ExtraOdt.

Configuration du Module

Le module ExtraOdt s'installe comme n'importe quel module de Dolibarr, en décompressant le dossier .zip dans le dossier \htdocs.
Le module doit être activé dans la configuration de Dolibarr.

La page de configuration s’affiche en cliquant sur l'icône de configuration en bout de ligne à droite sur la page des modules .

L’onglet Configuration permet l’enregistrement des critères d’affichage des lignes et les conditions de filtrage. Le champ Nombre de ligne permet de fixer la limite des lignes à afficher. Le champ Condition de filtrage permet, à partir d'une requête SQL de sélectionner les données à afficher dans le document. Enregistrer la sélection en cliquant sur le bouton Modifier. L'onglet Readme affiche la liste des balises modifiées dans le module. L'onglet À Propos affiche la liste des champs utilisables dans les modèles de documents.

Configuration de Dolibarr

Pour rendre ExtraOdt opérationnel, il convient d’activer les modèles de documents dans les modules concernés :

Accueil > Configuration > Modules/Applications > Gestion de la relation client (GRC) > Tiers > L'onglet Divers > Modèle de documents > ODT templates > État "Activé"

Puis d’indiquer dans le champ "Odt template" l’emplacement du document texte modèle en utilisant les sauts de ligne pour séparer les différents emplacements . Enregistrer avec le bouton "Modifier" .
Une fois le nouvel emplacement indiqué, la ligne "Nombre de fichiers modèles ODT/ODS trouvés dans ce(s) répertoire(s)" indique le nombre de modèles trouvés par Dolibarr .

Par défaut dans Dolibarr, les modèles de documents sont stockés dans le dossier "\documents\doctemplates". ExtraOdt inclut un modèle disponible dans le dossier "\htdocs\extraodt\odtsample". Cet emplacement peut être utilisé en tant que chemin indiqué dans la configuration des modules dans Dolibarr. Uns fois enregistré, le nouveau modèle de document apparaitra dans la liste de sélection de documents :

Création d'un nouveau modèle de document

Document texte

A partir d’un logiciel de traitement de texte (open office, libre office,…), créer un nouveau document comprenant les informations souhaitées sous forme de balises. Les balises seront modifiées par Dolibarr au moment de la génération du document.

Il est possible de visualiser l'ensemble des ODTTag disponible en utilisant la balise {odt_show_all_tags}.

• Les balises sont entourées de {} et doivent être tapées en une seule fois (sans retour arrière ou effacement, ni par copier-coller). Dans le cas contraire, les balises risquent de ne pas être traitées dans le document généré.
  
• Il est possible de contourner cette contrainte par copier-coller des balises en passant par un éditeur de texte (bloc-note, notepad++...).
  
• Enregistrer le document dans le répertoire indiqué dans le champ "Odt templates" du module concerné.

Modèles ODT d'exemple

ExtraOdt fournit plusieurs modèles ODT d'exemple dans le répertoire odtsample.

Ces modèles peuvent être utilisés comme exemples ou comme base pour créer vos propres modèles de documents.

Les modèles sont organisés par type de document :

Par exemple, pour les fiches d'intervention : odtsample/fichinter/fichinter_summary.odt Pour utiliser ces modèles directement dans Dolibarr, le répertoire odtsample peut être ajouté dans la configuration des modèles ODT du module concerné.

Liste des Codes ODTs

Remplacer “balise” par le code de l’élément souhaité dans les tableaux ci-dessus :

balise_ref balise_ref_ext balise_ref_customer balise_ref_supplier balise_source_invoice_ref

balise_hour balise_date balise_date_rfc balise_date_limit balise_date_end balise_date_creation balise_date_modification balise_date_validation balise_date_delivery_planed balise_date_close

balise_total_ht_locale balise_total_vat_locale balise_total_localtax1_locale balise_total_localtax2_locale balise_total_ttc_locale balise_total_discount_ht_locale balise_total_ht balise_total_vat balise_total_localtax1 balise_total_localtax2 balise_total_ttc balise_total_discount_ht

balise_payment_mode_code balise_payment_mode balise_payment_term_code balise_payment_term balise_note_private balise_note balise_already_payed_locale balise_remain_to_pay_locale balise_already_payed balise_remain_to_pay

Liste des Balises Tiers

ACTION COMMERCIAL

Nombre de lignes	nbActionOnODT
Filtrage	CondActionOnODT
Balise	Companyaction
Champs	companyaction_code companyaction_label companyaction_datep companyaction_datep2 companyaction_datea companyaction_datea2 companyaction_percent companyaction_note companyaction_location companyaction_durationa companyaction_socpeople companyaction_durationp companyaction_punctual companyaction_priority companyaction_elementtype companyaction_usertodo

PROPOSITION COMMERCIALE

Nombre de lignes	nbPropaleOnODT
Filtrage	CondPropaleOnODT
Balise	companypropale

FACTURES

Nombre de lignes	nbBillOnODT
Filtrage	CondBillOnODT
Balise	companybill

COMMANDE FOURNISSEUR

Nombre de lignes	nbSupplierOrderOnODT
Filtrage	CondSupplierOrderOnODT
Balise	companysupplierorder

FACTURE FOURNISSEUR

Nombre de lignes	nbSupplierBillOnODT
Filtrage	CondSupplierBillOnODT
Balise	companysupplierbill

FICHE D'INTERVENTIONS

Nombre de lignes	nbInterventionalOnODT
Filtrage	CondInterventionalOnODT
Balise	companyinterventional

TICKETS

Nombre de lignes	nbticketOnODT
Filtrage	CondTicketOnODT
Balise	companyticket

Contribuer avec vos modèles ODT

Vous avez créé un modèle ODT personnalisé pour votre entreprise et souhaitez le partager avec la communauté ?

Vous pouvez nous transmettre vos modèles afin qu'ils puissent être ajoutés aux exemples fournis avec ExtraOdt et servir de base à d'autres utilisateurs.

Cette contribution permet de partager des exemples de modèles répondant à des besoins concrets et d'enrichir progressivement la bibliothèque de modèles disponibles.

Avant de nous transmettre un modèle, veillez à supprimer les données confidentielles ou spécifiques à votre entreprise (coordonnées, clients, produits, données commerciales, etc.).

Les modèles proposés pourront être adaptés ou anonymisés avant leur intégration dans la distribution du module.

En transmettant un modèle, vous autorisez sa redistribution avec ExtraOdt sous la licence applicable au projet.