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 .

Pré-réquis d'installation

Le module ExtraOdt fonctionne avec Dolibarr à partir de la version 3.6.1 .
Pour les versions inférieures, un patch est nécessaire :
Le patch est présent dans le fichier "/htdocs/extraodt/core_update/include/odtphp". Il doit être placé dans le fichier "/htdocs/include/odtphp".

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 .

Note >

• 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.
Note >

• 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é.

Liste des Balises

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

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_payment_mode_code
• balise_payment_mode
• balise_payment_term_code
• balise_payment_term
• 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_note_private
• balise_note
• balise_already_payed_locale
• balise_remain_to_pay_locale
• balise_already_payed
• balise_remain_to_pay