« ExtraOdt » : différence entre les versions

De Documentations Patas-monkey
Aller à la navigation Aller à la recherche
Lucycava (discussion | contributions)
Aucun résumé des modifications
 
(16 versions intermédiaires par 2 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
{| class="wikitable"  
{| class="wikitable"  
|- style="vertical-align:top;"  
|- style="vertical-align:top;"  
| [[File:MyManagement-250x250.jpeg]]
| [[File:MyManagement-250x250.jpeg |250px]]
| Le module ProjectBudget 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 .
| 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 ==
== Pré-réquis d'installation ==
Ligne 54 : Ligne 54 :
=== Liste des Balises ===
=== Liste des Balises ===
{| class="wikitable"
{| class="wikitable"
|+ ACTION COMMERCIAL
|-
|+ ACTION COMMERCIAL
|-
|-
|-
| style="width: 300pt;"| Nombre de lignes|| style="width: 300pt;" |  nbActionOnODT
| Nombre de lignes|| nbActionOnODT
|-
|-
| Filtrage  || CondActionOnODT
| Filtrage  || CondActionOnODT
Ligne 82 : Ligne 82 :
|}
|}
{| class="wikitable"
{| class="wikitable"
|- style="vertical-align:top;"
|+ PROPOSITION COMMERCIALE
|+ PROPOSITION COMMERCIALE
|-
|-
|-
|-
| Nombre de lignes|| nbPropaleOnODT
| style="width: 300pt;" | Nombre de lignes|| style="width: 300pt;" | nbPropaleOnODT
|-
|-
| Filtrage  || CondPropaleOnODT
| Filtrage  || CondPropaleOnODT
Ligne 92 : Ligne 93 :
|}
|}
{| class="wikitable"
{| class="wikitable"
|- style="vertical-align:top;"
|+ FACTURES
|+ FACTURES
|-
|-
|-
|-
| Nombre de lignes|| nbBillOnODT
| style="width: 300pt;" | Nombre de lignes|| style="width: 300pt;" | nbBillOnODT
|-
|-
| Filtrage  || CondBillOnODT
| Filtrage  || CondBillOnODT
Ligne 102 : Ligne 104 :
|}
|}
{| class="wikitable"
{| class="wikitable"
|- style="vertical-align:top;"
|+ COMMANDE FOURNISSEUR
|+ COMMANDE FOURNISSEUR
|-
|-
|-
|-
| Nombre de lignes|| nbSupplierOrderOnODT
| style="width: 300pt;" | Nombre de lignes|| style="width: 300pt;" | nbSupplierOrderOnODT
|-
|-
| Filtrage  || CondSupplierOrderOnODT
| Filtrage  || CondSupplierOrderOnODT
Ligne 111 : Ligne 114 :
| Balise || companysupplierorder
| Balise || companysupplierorder
|}
|}
{| class="wikitable"
|- style="vertical-align:top;"
|+ FACTURE FOURNISSEUR
|-
|-
| style="width: 300pt;" | Nombre de lignes|| style="width: 300pt;" | 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

Dernière version du 5 avril 2024 à 00:11

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