⚠️ Important

Avant d’utiliser les balises Block, nous vous conseillons de lire le tutoriel Les balises. Il vous permettra de comprendre leur rôle, leur création et l’endroit où les retrouver.

Dans ce tutoriel, les exemples utilisent des identifiants génériques. Lors de votre mise en pratique, pensez à les remplacer par les identifiants issus de votre propre formulaire.

1. À quoi servent les balises Block ?

Les balises Block permettent d’afficher ou de masquer automatiquement une partie de votre export, en fonction de ce que l’utilisateur a saisi dans le formulaire.
Elles peuvent conditionner l’affichage d’éléments tels qu’un texte, un tableau, des photos ou encore des balises.

Elles permettent notamment de :

Masquer une section si l’utilisateur ne saisit rien dans un champ.
Afficher un contenu selon la valeur choisie dans une liste (couleur, symbole...).
Afficher un contenu si une case est cochée.
Afficher ou masquer un texte selon qu’un champ est vide ou rempli.
Conditionner l’affichage d’un champ photo multiple.
Adapter l’affichage via un Champ Utilisateur Personnalisé.
Conditionner l’affichage d’un tableau.

Avant de commencer, il est donc important d’identifier précisément ce que vous souhaitez obtenir, et à partir de quel type de champ.

2 . Création et position des balises Block

La balise Block se construit à partir de la balise du champ qui va conditionner l'affichage du contenu.

2.1 Créer une balise Block simple

La balise Block simple s'utilise dans les cas suivants :

Pour masquer une partie du document quand le champ qui s'y rapporte est vide.
Pour afficher une partie du document si une case est cochée.

Il suffit d'ajouter _block: après les deux premiers # de la balise du champ concerné.

Par exemple, vous souhaitez masquer un contenu si le champ Photo n'est pas saisi.

La balise du champ Photo est ##photo##.
Ajoutez _block: après les deux premiers #.

La syntaxe de la balise Block est donc ##_block:photo##.

2.2 Créer une balise Block avec suffixe.

Il est parfois nécessaire d'ajouter un suffixe dans la balise Block. Ça peut être un opérateur de comparaison ou le code d'une liste/choix.

Voici les cas :

Pour afficher une partie du document en fonction de l'élément sélectionné dans un champ Liste ou Choix.
Pour afficher une partie du document si une case n'est pas cochée.
Pour afficher un contenu particulier si un champ est vide.
Pour afficher un contenu dans le cas où un champ est saisi.
Pour afficher un contenu en fonction de la présence ou non des photos présentes dans un champ multiple.
Pour afficher un contenu en fonction de la présence ou non d'un Champ Utilisateur Personnalisé.

Comme pour la balise Block simple, vous ajoutez _block: après les deux premiers # de la balise du champ concerné. Ensuite vous complétez avec -suffixe entre l'identifiant de la balise est les deux derniers #.

Par exemple, vous souhaitez afficher un contenu si l'élément sélectionné dans la liste est celui qui correspond au code 2.

La balise du champ Liste est ##liste##.
Ajoutez _block: après les deux premiers #.
Ajoutez -2 entre l'identifiant et les deux derniers #.

La syntaxe de la balise Block est donc ##_block:liste-2##.

⚠️ Important

Pour plus de facilité dans l'écriture de la balise Block, il est nécessaire de coder les éléments des champs Liste et Choix.

2.3 Où et comment placer les balises Block ?

Les balises Block fonctionnent toujours par deux pour encadrer le contenu à afficher/masquer et doivent être positionnées de la manière suivante :

Balise Block

Partie du document à afficher (texte, tableau, image ou balise)

Balise Block

3. Bonnes pratiques d'utilisation

Pour fonctionner correctement, les balises Block doivent respecter les règles suivantes :

Règle	Explication
Syntaxe	`##_block:identifiant##` ou `##_block:identifiant-suffixe##`
Code	Il est nécessaire de coder les éléments des Champs Liste et Choix
Toujours par 2	Une balise Block ouvre et l'autre ferme la zone conditionnée. Les deux balises doivent être strictement identiques `##_block:identifiant##` Tableau, texte, médias ... `##_block:identifiant##`
Ligne dédiée	Une balise Block doit être seule sur sa ligne
Emplacement	Utilisable uniquement dans un modèle Word ou un scénario email
Champs	Compatible avec tous les types de champs
Nom	Sans accent, sans majuscule et sans espace
Tableau	Les deux balises block doivent être toutes deux dans le tableau ou toutes deux à l’extérieur Si les blocks viennent d’un champ d'un tableau, elles doivent aussi être dans un tableau.
Saut de page/Saut de section	Les placer entre ou en dehors des balises Block, mais pas sur la même ligne
En-tête / pied de page	Interdit
Pas de Shift+Entrée	Un paragraphe normal uniquement, pas de retour chariot
Balises imbriquées	Possible, mais avec ordre précis : première ouverte = dernière fermée `##_block:identifiant1##` `##_block:identifiant2##` Tableau, texte, médias ... `##_block:identifiant2##` `##_block:identifiant1##`

⚠️Important

Le cumul de balises Block n'est pas autorisé si elles utilisent les opérateurs in ou nin.

4. Les opérateurs de comparaison

Vous pouvez conditionner l’affichage en fonction d’une valeur numérique ou alphabétique à l’aide d’opérateurs :

Opérateur	Signification	Syntaxe
`-eq:`	Egal	`##_block:identifiant_du_champ-eq:3##` Contenu à afficher si la valeur = 3 `##_block:identifiant_du_champ-eq:3##`
`-ne:`	Différent	`##_block:identifiant_du_champ-ne:3##` Contenu à afficher si la valeur ≠3 `##_block:identifiant_du_champ-ne:3##`
`-lt:`	Strictement Inférieur	`##_block:identifiant_du_champ-lt:3##` Contenu à afficher si la valeur < 3 `##_block:identifiant_du_champ-lt:3##`
`-le:`	Inférieur ou égal	`##_block:identifiant_du_champ-le:3##` Contenu à afficher si la valeur ≤ 3 `##_block:identifiant_du_champ-le:3##`
`-gt:`	Strictement supérieur	`##_block:identifiant_du_champ-gt:3##` Contenu à afficher si la valeur > 3 `##_block:identifiant_du_champ-gt:3##`
`-ge:`	Supérieur ou égal	`##_block:identifiant_du_champ-ge:3##` Contenu à afficher si la valeur ≥ 3 `##_block:identifiant_du_champ-ge:3##`

5. Récapitulatif

Contexte / usage	Autorisé	Interdit
Word personnalisé	✅
Scénario email	✅
Excel personnalisé		⛔
En-tête / Pied de page		⛔
Nouveau paragraphe (`Entrée`)	✅
Retour chariot (`Shift + Entrée`)		⛔
2 balises block dans un tableau	✅
2 balises block hors tableau	✅
1 dans un tableau et 1 à l'extérieur		⛔

💡Astuce

Pour faciliter la lecture et la modification de votre modèle d’export, vous pouvez surligner les balises block. Cette mise en évidence n’apparaîtra pas dans l’export final, mais elle vous permettra de les repérer rapidement si vous devez retravailler le modèle.

N'hésitez pas à consultez les autres tutoriels disponibles dans la section dédiée aux Balises Block

Que sont les balises Block ?