Isi-APP Docs fonctionnelles
Toutes les docs
Markdown brut
Placeholders (variables dynamiques de l'éditeur riche)
Actif wiki functional Revu le 2026-07-20 wiki/placeholders.md

Placeholders (variables dynamiques de l'éditeur riche)

Insérer des variables {{…}} dans un contenu rédigé à l'éditeur riche, remplacées automatiquement par la donnée réelle au moment de l'affichage.

Description

Dans l'éditeur riche (onglet Insertion → Variables, bouton {{}}), l'utilisateur peut insérer un placeholder : un jeton qui pointe vers une donnée de l'application (nom d'une entité, email d'un utilisateur, matériel, application, adresse, question du référentiel…).

Le jeton est stocké tel quel dans le contenu. À chaque affichage, il est remplacé par la valeur courante de la donnée. Exemple : {{ENTITY:42[lbname]}} s'affiche « Clinique du Parc », et suit automatiquement un éventuel renommage de l'entité.

Familles disponibles

Famille Contenu Exemple de syntaxe
ENTITY Entités / clients {{ENTITY:42[lbname]}}
USER Utilisateurs {{USER:12[email]}}
ADDR Adresses {{ADDR:42[txaddr]}}
APP Applications (DSI) {{APP:42[lbapp]}}
HW Matériels (DSI) {{HW:42[lbhw]}}
CORE Référentiel / questions {{CORE:23[current]}}

Chaque famille expose une liste de champs (nom, email, téléphone…). La modale d'insertion guide le choix : famille → champ → enregistrement.

Où les placeholders sont résolus

La résolution est live (à l'affichage, jamais figée) et active partout où un contenu de l'éditeur riche est présenté à un lecteur : fiche d'un schéma, actualités et événements du portail, wikis et livrets, réponses de tickets, messagerie, suivis CRM, widgets de texte du portail…

Un contenu sans placeholder n'est jamais modifié.

Contenu propre vs contenu partagé

  • Contenu propre (rédigé et lu dans la même structure) : les placeholders sont résolus sur les données de la structure du lecteur.
  • Contenu partagé (un schéma / wiki / actualité partagé à un partenaire) : les placeholders sont résolus sur les données de la structure auteur. Un partenaire voit donc la valeur voulue par l'auteur, sans risque d'afficher par erreur une donnée d'une autre structure.

Valeur introuvable

Si un placeholder pointe vers une donnée supprimée, inaccessible ou d'une autre structure, il est remplacé à l'affichage par [Donnée non résolue] (jamais le jeton brut).

Limites connues

La résolution n'est pas encore branchée sur :

  • les écrans rendus par le moteur de formulaire legacy (/mod via hooks) ;
  • les colonnes de tableaux rendues côté navigateur (DataTables) ;
  • l'export Word / PDF interne de l'éditeur ;
  • les emails.

Dans ces contextes, un placeholder reste affiché sous sa forme brute.

Documentation technique

Voir .claude/technical-docs/wiki/placeholders.md (architecture du moteur, primitif d'affichage, resolvers, points de branchement).