Dans eSignature RH de Bitrix24, vous pouvez utiliser des modificateurs pour contrôler l’affichage des données dans un document.

Les modificateurs sont des codes spéciaux ajoutés aux codes symboliques. Ils permettent par exemple :

• de modifier le format d’une date ;
• d’afficher un numéro de téléphone dans un format précis ;
• de changer la casse du texte ;
• d’afficher une ou plusieurs valeurs d’un champ.

Types de modificateurs

Plusieurs types de modificateurs sont disponibles dans eSignature RH :

• date et heure,
• téléphone,
• adresse,
• casse du texte.

Les modificateurs s’ajoutent directement au code symbolique à l’aide du symbole (~).

Exemple : {Ext.Emp.Date~d.m.Y H:i:s}

Dans cet exemple :

• Ext.Emp.Date est le code du champ,
• d.m.Y H:i:s est le modificateur.

Chaque lettre correspond à un élément de la date ou de l’heure :

• d → jour
• m → mois
• Y → année

Vous pouvez utiliser deux types de modificateurs :

• Modificateurs simples
  Ils définissent directement le format.
  Exemple : d.m.Y


• Modificateurs avec paramètres
  Ils utilisent paramètre=valeur.
  Exemple : format=E.164.

Si vous utilisez plusieurs paramètres, séparez-les par des virgules : {...~Format=1,Separator=3}.

Modificateurs de date et d’heure

Utilisez ces modificateurs pour afficher les dates et heures dans le format souhaité. Par exemple, vous pouvez afficher la date de création d’un document au format 28 mars 2026.
Liste des modificateurs de date et d’heure

Modificateurs de date

• d.m.y → 28.03.26
• d.m.Y → 28.03.2026
• j, n, Y → 28, 3, 2026
• j F, Y → 28 mars, 2026

Modificateurs d’heure

• H:i:s → 10:24:18

Modificateurs combinés de date et d’heure

• Y-m-d H:i:s → 2026-03-28 10:24:18

Exemple

Pour afficher la date de création d’un document au format 28.03.2026 10:24:18, ajoutez le modificateur ~d.m.Y H:i:s au code symbolique {Ext.Emp.Date}.

Vous obtiendrez le code suivant : {Ext.Emp.Date~d.m.Y H:i:s}.

Modificateurs de téléphone

Les modificateurs de téléphone permettent de modifier le format d’un numéro. Utilisez le paramètre ~format=.

Formats disponibles

• E.164 → +33XXXXXXXXX
• International → +33 X XX XX XX XX
• National → 0X XX XX XX XX

Saisissez les valeurs exactement comme indiqué, en respectant la casse.

Exemple

Pour afficher le numéro de téléphone d’une entreprise au format international sans espaces, ajoutez le modificateur ~format=E.164 au code symbolique {Com.Rep.Phone}.

Vous obtiendrez le code suivant : {Com.Rep.Phone~format=E.164}.

Dans le document, le numéro sera affiché au format +33XXXXXXXXX.

Modificateurs d’adresse

Les modificateurs d’adresse permettent de définir le format de l’adresse et de choisir le séparateur entre les éléments.

Champs d’adresse disponibles

• ADDRESS_1 → rue, numéro, bâtiment
• ADDRESS_2 → appartement ou bureau
• CITY → ville
• REGION → district
• PROVINCE → région
• POSTAL_CODE → code postal
• COUNTRY → pays

Pour définir le format de l’adresse, utilisez le paramètre ~Format=.

Formats disponibles

• 1 → format Europe ; rue, code postal, ville, région et province sur une ligne, puis pays.
  Exemple : Friedrichstraße 123, 10117 Berlin, Brandenburg, Germany.


• 2 → format Royaume-Uni ; chaque élément sur une ligne distincte, avec ville et code postal en majuscules.
  Exemple :
  221B Baker Street
  LONDON
  NW1 6XE
  UNITED KINGDOM


• 3 → format Amérique du Nord ; rue, ville, région et code postal sur une ligne, pays en majuscules.
  Exemple :
  1600 Pennsylvania Avenue, Washington DC 20500
  UNITED STATES

Pour définir le séparateur entre les parties de l’adresse, utilisez le paramètre ~Separator=.

Valeurs disponibles

• 1 → virgule
• 2 → saut de ligne (\n)
• 3 → saut de ligne HTML <br />

Exemple

Pour afficher l’adresse d’une entreprise au format Europe avec chaque élément sur une ligne distincte, ajoutez les paramètres Format=1 et Separator=3 au code symbolique {Com.Rep.AddrPrim}.

Vous obtiendrez le code suivant : {Com.Rep.AddrPrim~Format=1,Separator=3}.

Dans le document, l’adresse sera affichée au format suivant :

10 rue de Rivoli
75001 Paris
Île-de-France
France

Modificateurs de casse du texte

Les modificateurs de casse permettent de changer l’affichage du texte dans un document. Par exemple, dans un titre, la date peut être affichée en minuscules : 25 avril 2026 au lieu de 25 Avril 2026.

Pour définir la casse, utilisez le paramètre ~letterCase=.

Valeurs disponibles

• upper → MAJUSCULES
• lower → minuscules
• title → Première Lettre De Chaque Mot En Majuscule

Exemple

Pour afficher le nom de famille d’un employé en majuscules, ajoutez le modificateur ~letterCase=upper au code symbolique {User.Emp.LastName}.

Vous obtiendrez le code suivant : {User.Emp.LastName~letterCase=upper}.

Dans le document, le nom de famille sera affiché en majuscules. Par exemple, DUPONT au lieu de Dupont.

Comment afficher une ou plusieurs valeurs d’un champ

Dans eSignature RH de Bitrix24, certains champs peuvent contenir plusieurs valeurs. Par exemple, un employé peut avoir plusieurs numéros de téléphone ou plusieurs documents.

Les modificateurs permettent d’afficher :

• uniquement la première valeur ;
• une valeur spécifique ;
• toutes les valeurs.

Afficher la première valeur

Utilisez le paramètre ~mfirst=y.

Par exemple, pour afficher uniquement le premier numéro de téléphone d’un employé, utilisez le code {User.Emp.Str1731454357238~mfirst=y,mseparator=2}.

Dans le document, seul le premier numéro de la liste sera affiché.

Afficher une valeur spécifique

Utilisez le paramètre ~index= :

Valeurs disponibles :

• 0 → premier élément
• 1 → deuxième élément
• 2 → troisième élément

Par exemple, pour afficher la première valeur du champ Nombre d’employés : {Com.Rep.Employees~index=0}.

Dans le document, seule la première valeur de la liste sera affichée.

Afficher toutes les valeurs

Utilisez le paramètre ~all=y.

Par exemple, le code {User.Emp.Str1731454357238~all=y} affichera tous les numéros de téléphone de l’employé.

Les codes de champ peuvent varier selon votre Bitrix24. Consultez les codes disponibles dans le panneau des codes symboliques dans la section eSignature RH.
Codes symboliques dans eSignature RH