Editeur de courriers - Champs de fusion¶
Prérequis¶
Conventions :
- Les mots en italique signalent une référence à un élément existant dans l'interface utilisateur (de ce document ou de clicmap)
- Les mots en rouge alertent sur l'importance de respecter ce qui est écrit
- Le mot balise correspond à une suite de caractères représentée par <> (ex. <MaBaliseDeDébut>) ou <⁄> (ex. </MaBaliseDeFin>)
Eléments de langage que vous rencontrerez :
| Libellé | Représentation | Commentaire |
|---|---|---|
| Types de données principaux | ||
| Texte | 'Favorable' '' (Texte vide) |
Tout texte entre guillemets simples (NB : un Texte vide est représenté uniquement par des guillemets simples) |
| Numérique | -1 0 3 150.99 |
Tout nombre sans guillemets |
| Date | '10/01/2014' | Date au format JJ/MM/AAAA entre guillemets simples |
| Champs de fusion | ||
| Attribut | {DATE_DU_JOUR} | Nom de l'attribut entre accolades |
| Elément de Bible | {BIBLE1} | Nom de l'élément entre accolades |
| Opérateurs principaux | ||
| Egal à | == | Est VRAI si 2 nombres ou 2 textes sont identiques sinon FAUX (NB : Attention aux textes en minuscules ou en majuscules) |
| Différent de | != | Est VRAI si 2 nombres ou 2 textes sont différents sinon FAUX |
| Inférieur à | < | Est VRAI si le premier nombre est plus petit que le deuxième sinon FAUX |
| Inférieur ou égal à | <= | Est VRAI si le premier nombre est plus petit ou égal au deuxième sinon FAUX |
| Supérieur à | > | Est VRAI si le premier nombre est plus grand que le deuxième sinon FAUX |
| Supérieur ou égal à | >= | Est VRAI si le premier nombre est plus grand ou égal au deuxième sinon FAUX |
| Négation (n'est pas, ne contient pas, etc.) | ! | |
| Formules principales | ||
| Tester si un texte est égal à un autre | 'Favorable'.egalA('Défavorable') | Est VRAI si 2 textes sont identiques sinon FAUX (NB : ne tient pas compte des minuscules ni des majuscules) |
| Tester si un texte débute par un autre | 'Favorable'.commencePar('Défavorable') | Donne VRAI ou FAUX |
| Tester si un texte fini par un autre | 'Favorable'.finiPar('Défavorable') | Donne VRAI ou FAUX |
| Tester si un texte en contient un autre | 'Favorable'.contient('Défavorable') | Donne VRAI ou FAUX |
| Comparer1 2 textes | compareTextes('Favorable', 'Défavorable') | Donne VRAI ou FAUX |
| Comparer1 2 dates | compareDates('10/01/2014', '>', '01/01/2014') | Donne VRAI ou FAUX |
| Transformer1 une date texte en date | date('10/01/2014') date('2014-01-10', 'Y/m/d') |
Donne une date valide pour réaliser des comparaisons |
| Champs conditionnés (templates) | ||
| Condition SI - Balise de début | <tpl if="DELAI_EN_MOIS > 1"> |
Début de la condition :<tpl if=: Ouverture de la balise"DELAI_EN_MOIS > 1": Condition entre guillemets doubles avec nom du champ sans les accolades ! >: Fermeture de la balise |
| Condition SI - Afficher le texte si VRAI | Délai supérieur à 1 mois | Est affiché que si la condition définie dans la Balise de début est vraie |
| Condition SI - Balise de fin | </tpl> |
Fin de la condition |
1 Noter que les expressions de la formule sont séparées par une virgule
Règles essentielles à respecter pour éviter tout désagrément :
- Encadrer les éléments de fusion (nom d'attribut, nom de bible) avec des accolades sauf dans les Balises de début des Champs conditionnés
- Encadrer de guillemets simples tous les textes utilisés dans les Balises de début des Champs conditionnés
- Veiller aux espaces dans les Balises de début des Champs conditionnés avant et après :
- un champ de fusion ( DELAI_EN MOIS )
- un opérateur ( > )
- une valeur ( 'Favorable' )
- Respecter la casse (minuscules / majuscules).
- Pour les formules nécessitant plus d'une expression (ex. compareTextes('Favorable','Défavorable)), penser à séparer les expressions par une virgule
¶
Formatage des champs¶
| Résultats souhaités | Codage | Commentaire |
|---|---|---|
| Date1 | ||
| 01/01/14 | {[fm.date("01/01/2014").format("d/m/y")]} |
Utilisation de la formule format() |
| 01/01/2014 | {[fm.date("01/01/2014").format("d/m/Y")]} |
Utilisation de la formule format() |
| Le Lundi 5 Janvier 2014 | {[fm.date("01/01/2014").format("\\Le l j F Y")]} |
Utilisation de la formule format() |
| Le 1er Janvier 2014 | {[fm.date("01/01/2014").format("\\Le l j\\er F Y")]} |
Le "er" n'est pas automatique ! Utilisation de la formule format() |
| Année1 | ||
| 2014 | {[fm.date("01/01/2014").format("Y")]} |
Utilisation de la formule format() |
| Heure | ||
| 1h10 et 13h10 | {[]} |
|
| 1:10 et 13 :10 | {[]} |
|
| 01:10 et 13:10 | {[]} |
|
| Téléphone | ||
| 01 23 45 67 89 | {[]} |
A voir |
| 01.23.45.67.89 | {[]} |
A voir |
| 01/23/45/67/89 | {[]} |
A voir |
| Surface | ||
| 64 m² | {[]} |
A voir |
| 64.00 m² | {[]} |
A voir |
| Montant | ||
| 1 234 567.89 € | {[]} |
A voir |
| mille deux cent trente-quatre euros | {[]} |
A voir |
| Douze Millions Trois Cent Quarante-Cinq Mille Six Cent Soixante-Dix-Huit | {[]} |
A voir |
1 fm.date remplace l'utilisation de Date.parseDate("01/01/2014", "d/m/Y")
Conditions¶
| Type de réponse à traiter | Codage (utilisant un champ de fusion) |
Commentaire |
|---|---|---|
| Texte | ||
| Si aucune réponse,... | <tpl if="COMMUNE_LIBELLE.egalA('')">Aucune réponse</tpl> |
Utilisation de la formule egalA() et de l'expression "Texte vide" |
| Si réponse,... | <tpl if="!COMMUNE_LIBELLE.egalA('')">Une réponse</tpl> |
Utilisation de la négation (!) avec formule egalA() et de l'expression "Texte vide" |
| Numérique | ||
| Si positif,... | <tpl if="DELAI_EN_MOIS > 0">Positif</tpl> |
Utilisation de l'opérateur supérieur à (>) |
| Si négatif,... | <tpl if="DELAI_EN_MOIS < 0">Négatif</tpl> |
Utilisation de l'opérateur inférieur à (>) |
| Date | ||
| Si avant 2013,... | <tpl if="Date.parseDate(DATE_DEPOT, 'd/m/Y').format('Y') < Date.parseDate('01/01/2013', 'd/m/Y').format('Y')"</tpl>Déposé avant 2013 |
|
| Si après 2013,... | <tpl if="Date.parseDate(DATE_DEPOT, 'd/m/Y').format('Y') > Date.parseDate('01/01/2013', 'd/m/Y').format('Y')"</tpl>Déposé après 2013 |
|
| Oui / Non | ||
| Si oui,... | <tpl if="pc_dpp_b.egalA('t')">Le propriétaire est le demandeur</tpl> |
Utilisation de la formule egalA() et de l'expression 't' |
| Si non,... | <tpl if="!pc_dpp_b.egalA('t')">Le propriétaire n'est pas le demandeur</tpl> |
Utilisation de la négation (!) avec formule egalA() et de l'expression 't' |
| Eléments de listes prédéfinies | ||
| Si réponse 1,... Si réponse 2,... Si réponse 3,... Si réponse 4,... |
<tpl if="COMMUNE_LIBELLE.contient('dax')">Informations sur Dax</tpl><tpl if="COMMUNE_LIBELLE.contient('bayonne')">Informations sur Bayonne</tpl><tpl if="COMMUNE_LIBELLE.contient('anglet')">Informations sur Anglet</tpl><tpl if="COMMUNE_LIBELLE.contient('biarritz')">Informations sur Biarritz</tpl> |
Utilisation de la formule contient() |
| Images | ||
| Case à cocher cochée Accord Case à cocher décochée Accord |
<tpl if="pc_tsg_b.egalA('t')">[IMAGE_CASE_A_COCHER_COCHEE]Accord</tpl><tpl if="!pc_tsg_b.egalA('t')">[IMAGE_CASE_A_COCHER_DECOCHEE]Accord</tpl> |
Utilisation de la formule egalA() et de l'expression 't' pour afficher les images |
Assistant d'insertion de conditions¶
- Pour afficher l'assistant, cliquer droit sur un attribut puis sur Insérer une condition... du menu contextuel
Menu contextuel "Liste d'insertions"
- Sélectionner un modèle dans la liste de conditions et de compléter le contenu dans l'éditeur à l'aide des exemples données ci-dessus
- Cliquer sur Tester pour obtenir un aperçu du résultat de la condition
- Cliquer sur Valider pour insérer la condition dans le modèle de courrier
Assistant d'insertion de conditions