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