Appel des paramètres dans TimeTonic : $nom_du_champ pour un champ (lien, colonne de table liée, nombre, sélection, formule, texte) ; "texte libre" entre guillemets ; pas de guillemets pour les nombres.
L'ordre des deux paramètres est libre. La fonction reconnaît le masque à sa composition : écrire la valeur en premier ou le masque en premier donne le même résultat. Par lisibilité, cette fiche place partout la valeur en premier. Le masque, lui, peut être écrit en dur entre guillemets ou provenir d'un champ, ce qui permet d'appliquer une règle différente selon la ligne : voir Masque : uniformiser des références de formats différents.
Paramètres
#ParamètreDescription
1colonne à masquerLa valeur dont les caractères sont masqués ou affichés.
2"masque"Le masque à appliquer : @ affiche un caractère, X ou x le masque. Sa longueur obéit à une règle stricte, voir ci-dessous.
La longueur du masque
C'est la cause n° 1 des résultats vides. Dès que le masque contient au moins un X, il doit compter exactement autant de caractères que la valeur à masquer. Un caractère de trop ou de moins renvoie une cellule vide, sans message d'erreur.
Le seul cas où la longueur peut différer est celui d'un masque composé uniquement de @ : il tronque alors la valeur à sa propre longueur.
Valeur
Masque
Résultat
Pourquoi
12345678
XXXX@@@@
5678
8 caractères pour 8.
12345678
xxxxX@@@
678
La casse du X n'a aucune incidence, on peut mélanger.
12345678
xxxxXX@@@
vide
9 caractères pour 8 : un de trop suffit à tout annuler.
12345678
XXX@@@@
vide
7 caractères pour 8 : un de moins produit le même effet.
12345678
@@@@
1234
Masque de @ seuls : il tronque, sans exiger l'égalité de longueur.
Tout autre caractère dans le masque, y compris un espace, un tiret ou un point, invalide la formule et renvoie une valeur vide : évitez les séparateurs à l'intérieur du masque. Un caractère masqué est omis du résultat, il n'est pas remplacé par un signe.
Dans la colonne Masque, seuls les quatre derniers caractères sont affichés. En effet, dans la formule : les 4 derniers caractères sont chacun représentés par @, les 4 premiers caractères sont représentés par X.
APPLY_MASK(Numéro CNI, "XXXX@@@@")
Exemple 2 : n'afficher que le début
Il est possible de n'afficher que les premiers caractères souhaités. Pour cela, il faut entrer autant d'arobases (@) que de caractères à conserver : « bureau » avec le masque "@@" devient « bu ». C'est le seul cas où le masque peut être plus court que la valeur.
APPLY_MASK(Code postal, "@@")
Exemple 3 : masquer une partie avec X ou x
« 0612345678 » avec le masque "XXXX@@@@@@" devient « 345678 » : les 4 premiers caractères sont masqués, les 6 derniers sont affichés. Le masque compte bien 10 caractères, comme la valeur.
APPLY_MASK("0612345678", "XXXX@@@@@@")
Exemple 4 : un masque différent selon la ligne
Le masque peut venir d'un champ plutôt que d'une chaîne écrite en dur. En le stockant dans une colonne de type Masque d'une table de référence, puis en le ramenant par une colonne d'une table liée, chaque ligne applique sa propre règle. Changer la sélection du modèle suffit à recalculer le résultat au bon format.