Modèles de courriers

  Accès fonctionnalité et localisation

  • Menu "Modèles de courriers" à partir du menu "Configuration" de l'application "Dossiers"

  Rôles : Gestionnaire de barreau (voir Utilisateurs LgoBox: rôles et sécurité).

  Pré-requis : Les modèles doivent d'abord être créés dans la gestion documentaire avec LibreOffice.

Avant de pouvoir servir à générer des courriers, un modèle de courriers créé dans la gestion documentaire doit être déclaré dans LgoBox. Cette déclaration reprend un certain nombre de champs techniques qu'il ne faut (surtout) pas modifier. En revanche, il faut donner une valeur ou changer la valeur proposée aux champs suivants:
  • Nom, le nom du modèle: le nom qui sera proposé aux utilisateurs lorsqu'il s'agira de choisir ce lmodèle pour générer des courriers
  • Format de sortie, le format de génération: les valeurs conseillées sont doc et pdf selon que l'utilisateur devra modifer le document après sa génération ou pas (pour l'impression en masse suite à une génération de masse, seul le format pdf sera accepté)
  • Procédure de recours, le chemin du modèle dans la gestion docuemntaire: il commence toujours par "/mnt/Odoo-templates/" puis le code du barreau de l'utilisateur et se termine toujours par ".odt"; la partie "[TEMPLATE-NAME]" est à remplacer par le nom effectif du modèle dans la gestion documentaire
  • Save in CMIS Prefix (onglet SAVE IN CMIS), l'expression de génération du nom du document: il s'agit d'une expression technique qu'il convient de ne pas altérer sauf pour le dernier morceau qui doit refléter le format de génération du corrier; par défaut ".doc" est proposé; si le modèle génère des pdf il faut le changer en ".pdf"
  Exceptions

Lors de la sauvegarde du nouveau modèle de courriers, si le chemin spécifié dans le champ "Procédure de recours" n'existe pas, une erreur sera présentée:

Principales caractéristiques des modèles LibreOffice

: une bonne cannaissance du logiciel LibreOffice est requise.

: il est conseillé de créer un nouveau modèle par copie d'un autre.

Fonctions Dans le modèle LibreOffice Commentaire
Remplacement d'une donnée connue Utiliser un "field" LibreOfiice en faisant CTRL-F2, puis choisir l'onglet Variables et dans la colonne Type choisir UserField. La seconde colonne propose une liste d'adresses de données connues ou ayant déjà été utilisées. Il suffit de choisir celle désirée.
Sinon, si elle n'existe pas, il faut la construire dans le bas de l'écran avec les conventions suivantes:
  • "py3o.objects" symbolise un des récipients listés dans l'assistant de génération de courrier
  • "py3o.objects.wizard_id" symbolise l'assistant de génération d'un courrier
  • "py3o.user" symbolise l'utilisateur générateur du courrier
Il faut ensuite compléter ce début d'adresse par un "chemin" permettant en finalité d'atteindre une donnée imprimable: une chaine de caractère, un nombre, une date ...
Exemples:
  • "py3o.objects.partner_id.intro_id.name" symbolise le libellé ("name") de l'introductif de courrier ("intro_id") spécifié sur la fiche du Contact/Avocat ("partner_id") repris dans un récipient ("py3o.objects") de courrier
  • "py3o.objects.wizard_id.signatory_id.name" symbolise le nom ("name") du signataire choisi ("signatory_id") dans l'assistant de génération ("py3o.objects.wizard_id")
  • "py3o.user.company_id.code" symbolise le code ("code") du barreau ("company_id") de l'utilisateur générateur ("py3o.user")
  • "py3o.<variable itérative>" symbolise la variable d'itération dans une portion répétitive (voir ci-après)

: pour connaitre le nom technique des champs, il faut insérer "?debug" dans l'url de connexion à l'application de la façon suivante:
Portion conditionnelle Utiliser un "hyperlink" LibreOfiice pour exprimer la condition et le début de la portion conditionnelle en faisant CTRL-K, conserver l'option Web. Puis utiliser un autre "hyperlink" pour exprimer la fin de la portion conditionnelle en faisant CTRL-K, conserver l'option Web.

Pour le premier hyperlink, compléter le champ Target par py3o://if="condition" et le champ Text par if="condition"

La "condition" est le plus souvent une condition d'existence ou de non existence. Exemple utilisant les mêmes conventions de nommage que les adresses de données mentionnées ci-avant mais sans le préfixe "py3o.":

  • "not objects.partner_id.intro_id": le récipient ne possède pas d'introductif de courrier spécifié sur sa fiche
  • "objects.wizard_id.include_signature": la case "Inclure une signature" a été cochée par l'utilisateur dans l'assistant de génération
  • "objects.reference": une référence courrier est associée au récipient

Pour le second hyperlink, compléter le champ Target par py3o:///if et le champ Text par /if
Portion répétitive Utiliser un "hyperlink" LibreOfiice pour exprimer la variable d'itération et le début de la portion répétitive en faisant CTRL-K, conserver l'option Web. Puis utiliser un autre "hyperlink" pour exprimer la fin de la portion itérative en faisant CTRL-K, conserver l'option Web.
Cette construction n'a de réels cas d'utilisation que dans le cas des courriers groupés en itérant sur tous les récipients.

Pour le premier hyperlink, compléter le champ Target par py3o://for="variable in collection" et le champ Text par for="variable in collection"

La "collection" est le plus souvent (quasi toujours) la liste des récipients à partir de laquelle la génération du courrier est demandée. Dans ce cas, le mieux est de choisir "recipient" comme variable d'itération:

  • "recipient in objects.wizard_id.dest_ids": à chaque itération la variable d'itération ("recipient") change et symbolise un des récipients de la collection ("dest_ids")

Pour le second hyperlink, compléter le champ Target par py3o:///for et le champ Text par /for
Remplacement de la date du jour Utiliser une double imbrication d'hyperlink spéciaux.

Les champs Target sont:

  • py3o://with="date_today=get_date_today()"
  • py3o://function="formatLang(date_today, date=True)"
  • py3o:///with

Utilser le même principe pour les champs Text que précédemment.


This is a test database. See the documentation for more information.
test