Aller au contenu principal
Version: Any 26

Jokers et opérations

Un joker est une valeur que Any remplace au moment de l'exécution : ${core.name} produit le nom du contenu traité, ${TODAY} la date du jour. Tout ce qui entoure les jokers est repris tel quel.

La même syntaxe est utilisée partout où un texte doit être construit à partir de données : les composeurs de métadonnées, l'URL et le corps des appels REST, les notifications, les URL intelligentes. Les jokers disponibles dépendent en revanche du contexte : un composeur de contenus propose les métadonnées du contenu, un composeur de synchronisation seulement les métadonnées présentes dans le message reçu.

Dans les champs qui acceptent les jokers, la saisie de ctrl + espace après un caractère affiche l'assistance et liste les jokers réellement disponibles à cet endroit.

Insérer une valeur​

Pour insérer une métadonnée, la noter sous la forme ${aspect.metadata} :

${core.name}
${standard.title}

Pour insérer un élément précis d'une métadonnée à valeurs multiples, l'indexer à partir de 0 :

${standard.authors[0]}

Jokers indépendants du contenu​

Au-delà des métadonnées, l'assistance propose des jokers qui ne dépendent pas du contenu traité.

JokerValeur produite
${TODAY}Date et heure du moment où la valeur est produite. C'est une date : la mettre en forme avec format.
${LOCALE}Langue du contexte courant.
${APPLICATION}Nom de l'application du contexte courant.
${PUBLIC_APPLICATION_URL}URL publique du serveur, telle que définie dans les paramètres du serveur.
${TICKET}Ticket d'authentification pour l'utilisateur courant, à usage unique et à durée de vie par défaut. Les deux peuvent être changés : ${TICKET(multi, 2 hours)} produit un ticket réutilisable valable deux heures.
${COUNTER}Numéro de séquence. Disponible uniquement dans les composeurs de métadonnées, qui définissent le compteur.

Utilisateur courant​

L'utilisateur qui déclenche le traitement est décrit par une famille de jokers.

JokerValeur produite
${user.name}Nom affiché de l'utilisateur.
${user.login}Identifiant de connexion.
${user.email}Adresse e-mail.
${user.first_name}Prénom.
${user.last_name}Nom de famille.
${user.phone_number}Numéro de téléphone.
${user.groups}Groupes de l'utilisateur, sous forme de valeurs multiples.

Toute autre métadonnée de la fiche utilisateur est accessible de la même manière, sous ${user.<métadonnée>}.

Transformer la valeur​

À l'intérieur d'un joker, la valeur peut être transformée par une ou plusieurs opérations, enchaînées avec le caractère | et appliquées de gauche à droite :

${data | opération1 | opération2 | ...}
${core.creation_date | format('yyyy') | lowercase}
${standard.authors[0] | uppercase}
${COUNTER | format('00000')}

Les opérations proposées par l'assistance dépendent du type de la donnée : time, format, add et minus sur une date ou un nombre, concat sur une métadonnée à valeurs multiples, les autres sur du texte. Appliquée à une métadonnée à valeurs multiples, une opération de texte s'applique à chaque valeur.

OpérationDescription
add(count, 'field')Ajoute count à la valeur. Sur un nombre, l'addition est directe. Sur une date, count est ajouté au champ indiqué : year, month, day, hour, minute ou second.

Utilisation : ${core.creation_date | add(3, 'year')}
Si core.creation_date = '2026-07-23', on aura comme résultat '2029-07-23'.
aspectRemplace la valeur par son libellé, via le mapping de liste de données configuré sur la métadonnée dans le module Aspects.

Utilisation : ${extended.category | aspect}
Si extended.category = 'INV' et que la liste associe ce code au libellé « Facture », on aura comme résultat 'Facture'.
asjsonarrayTransforme une métadonnée à valeurs multiples en tableau JSON. Une valeur unique est renvoyée telle quelle.

Utilisation : ${standard.authors | asjsonarray}
Si standard.authors = ['Alice', 'Bob'], on aura comme résultat '["Alice","Bob"]'.
capitalizeMet la valeur en minuscules, puis met sa première lettre en majuscule.

Utilisation : ${standard.title | capitalize}
Si standard.title = 'RAPPORT ANNUEL', on aura comme résultat 'Rapport annuel'.
concat(separator[, first[, last]])Concatène les valeurs d'une liste, séparées par separator. first et last, s'ils sont fournis, encadrent le résultat non vide.

Utilisation : ${standard.authors | concat(', ')}
Si standard.authors = ['Alice', 'Bob'], on aura comme résultat 'Alice, Bob'.
default('value'[, translate])Renvoie value lorsque la valeur est vide. Avec true en second argument, value est traité comme une clé de traduction.

Utilisation : ${extended.zone | default('N/A')}
Si extended.zone est vide, on aura comme résultat 'N/A'.
escapeÉchappe les caractères spéciaux pour une requête GQL : les apostrophes sont doublées.

Utilisation : ${core.name | escape}
Si core.name = "O'Brien", on aura comme résultat "O''Brien".
format(pattern[, pattern2])Formate une date ou un nombre. Pour un nombre, filesize produit une taille lisible ; pour une date, ISO-8601 ou un style SHORT, MEDIUM, LONG, FULL sont acceptés.

Utilisation : ${core.creation_date | format('dd/MM/yyyy')}
Si core.creation_date = '2026-07-23', on aura comme résultat '23/07/2026'.
get(index)Renvoie l'élément à la position index (à partir de 0) d'une métadonnée à valeurs multiples.

Utilisation : ${standard.authors | get(0)}
Si standard.authors = ['Alice', 'Bob'], on aura comme résultat 'Alice'.
gqlÉchappe les apostrophes et joint une liste avec ',', pour l'insérer dans une clause IN d'une requête GQL.

Utilisation : core.name IN ('${standard.authors | gql}')
Si standard.authors = ['Alice', "O'Brien"], on aura comme résultat "core.name IN ('Alice','O''Brien')".
htmlencodeÉchappe les caractères spéciaux pour du HTML.

Utilisation : ${core.name | htmlencode}
Si core.name = 'Tom & Jerry', on aura comme résultat Tom &amp; Jerry.
limit(max[, 'ellipsis'])Tronque la valeur : sur un texte, aux max premiers caractères ; sur une liste, aux max premiers éléments. L'ellipse (... par défaut) n'est ajoutée que si la valeur a effectivement été tronquée.

Utilisation : ${core.name | limit(20, '…')}
Si core.name = 'Rapport annuel consolidé 2026', on aura comme résultat 'Rapport annuel conso…'.
lowercaseMet tous les caractères en minuscules.

Utilisation : ${core.name | lowercase}
Si core.name = 'RAPPORT', on aura comme résultat 'rapport'.
mapping(datalist, key_col, label_col)Remplace la valeur par le libellé correspondant dans une liste de données, désignée par son nom, sa colonne clé et sa colonne libellé.

Utilisation : ${extended.country | mapping('countries', 'code', 'label')}
Si extended.country = 'FR', on aura comme résultat 'France'.
minus(count, 'field')Identique à add, mais soustrait.

Utilisation : ${core.creation_date | minus(1, 'month')}
Si core.creation_date = '2026-07-23', on aura comme résultat '2026-06-23'.
regexp('pattern', 'replacement')Remplace toutes les occurrences correspondant à l'expression régulière pattern.

Utilisation : ${core.name | regexp('\\d+', '#')}
Si core.name = 'Facture 2026', on aura comme résultat 'Facture #'.
replace('search', 'replacement')Remplace toutes les occurrences du texte search, pris au pied de la lettre : à la différence de regexp, ce n'est pas une expression régulière.

Utilisation : ${core.name | replace('_', ' ')}
Si core.name = 'rapport_annuel', on aura comme résultat 'rapport annuel'.
replaceall('pattern', 'replacement')Remplace toutes les occurrences correspondant à l'expression régulière pattern. Équivalent de regexp.

Utilisation : ${core.name | replaceall('\\s+', '_')}
Si core.name = 'rapport annuel', on aura comme résultat 'rapport_annuel'.
replacefirst('pattern', 'replacement')Remplace la première occurrence correspondant à l'expression régulière pattern.

Utilisation : ${core.name | replacefirst('-.*', '')}
Si core.name = 'FR-2026-001', on aura comme résultat 'FR'.
time(HH:mm:ss)Fixe l'heure d'une date sans changer le jour.

Utilisation : ${core.creation_date | time(00:00:00)}
Si core.creation_date = '2026-07-23 14:30:00', on aura comme résultat '2026-07-23 00:00:00'.
translate([prefix])Traite la valeur comme une clé de traduction et renvoie le libellé traduit. Le préfixe, s'il est fourni, est ajouté devant la valeur pour former la clé. Sans traduction, la valeur est renvoyée telle quelle.

Utilisation : ${extended.status | translate}
Si extended.status = 'validated' et que la traduction de cette clé est « Validé », on aura comme résultat 'Validé'.
uppercaseMet tous les caractères en majuscules.

Utilisation : ${standard.authors[0] | uppercase}
Si standard.authors[0] = 'Alice', on aura comme résultat 'ALICE'.
urlencodeÉchappe les caractères spéciaux pour une URL.

Utilisation : ${core.name | urlencode}
Si core.name = 'rapport annuel', on aura comme résultat 'rapport%20annuel'.