Ces filtres sont utiles lorsque vous souhaitez qu’une variable récupère uniquement certaines activités, certains hébergements, transports ou certaines étapes, au lieu d’afficher tous les éléments disponibles dans le projet.
Si vous ne connaissez pas encore les variables, commencez par Bien démarrer avec les variables.
Qu’est-ce qu’une catégorie ?
Une catégorie identifie le type d’élément du programme.
Par exemple, les étapes peuvent avoir des catégories telles que :
Restaurant
Visite
Réunion
Excursion
Les transports peuvent utiliser des catégories telles que :
Train
Vol
Transfert
Les catégories sont configurées dans Ezus et peuvent ensuite être utilisées dans une variable Slides afin de récupérer uniquement les éléments appartenant à cette catégorie.
💡 Utilisez les catégories lorsque le type d’élément est important.
Par exemple, utilisez une catégorie lorsque vous souhaitez afficher uniquement les restaurants, uniquement les trains ou uniquement un type particulier d’activité.
Trouver le nom technique d’une catégorie
Lorsque vous utilisez une catégorie dans une variable, vous devez utiliser son nom technique, et non son nom d’affichage.
Pour trouver le nom technique :
Accédez à Settings.
Ouvrez Custom fields.
Sélectionnez Steps.
Recherchez la catégorie que vous souhaitez utiliser et cliquez sur le bouton de modification.
Vérifiez le nom technique affiché pour cette catégorie.
Utilisez ce nom technique exactement tel qu’il apparaît lorsque vous construisez votre variable.
⚠️ Le nom d’affichage et le nom technique ne sont pas toujours identiques.
Utilisez toujours le nom technique dans la variable.
Filtrer une variable par catégorie
Pour filtrer une variable, ajoutez le nom technique de la catégorie entre crochets :
[category]
Par exemple :
$$transp.[train].1.title$$
Cela récupère le titre du premier transport appartenant à la catégorie train.
Sans la catégorie :
$$transp.1.title$$
Ezus récupère le premier transport, quelle que soit sa catégorie.
Exemples
Ce que vous souhaitez afficher | Exemple |
Premier transport |
|
Premier train |
|
Première étape restaurant |
|
Description du premier restaurant |
|
Première image du premier restaurant |
|
Le même filtre de catégorie peut être utilisé avec les autres informations disponibles pour cet élément.
Afficher plusieurs éléments de la même catégorie
Le nombre situé après la catégorie représente la position de l’élément dans les résultats filtrés.
Par exemple :
$$steps.[restaurant].1.title$$
récupère le premier restaurant.
$$steps.[restaurant].2.title$$
récupère le deuxième restaurant.
$$steps.[restaurant].3.title$$
récupère le troisième restaurant.
Cela vous permet de créer plusieurs zones ou Slides pour les éléments appartenant à la même catégorie.
⚠️ Le nombre correspond à la position après application de la catégorie.
$$steps.[restaurant].2.title$$ signifie la deuxième étape appartenant à la catégorie restaurant, et non nécessairement la deuxième étape de l’ensemble du programme.
Utiliser plusieurs catégories
Lorsqu’une variable doit accepter plusieurs catégories, ajoutez les catégories prises en charge dans le filtre de catégorie.
Utilisez un point-virgule (;) pour séparer plusieurs catégories.
Par exemple :
[restaurant;catering]
Cela permet à la variable de récupérer les éléments appartenant à l’une ou l’autre des catégories indiquées.
⚠️ Utilisez un point-virgule (;), et non une virgule, pour séparer les catégories.
Incorrect : [restaurant,catering]
Correct : [restaurant;catering]
Exclure une catégorie
Les catégories peuvent également être utilisées pour récupérer des éléments du programme tout en excluant une ou plusieurs catégories spécifiques.
Pour exclure une catégorie, écrivez son nom technique en utilisant la syntaxe d’exclusion :
]category[
Par exemple :
]restaurant[
Cela indique à Ezus de récupérer les éléments concernés à l’exception de ceux appartenant à la catégorie restaurant.
💡 Utilisez l’inclusion lorsque vous savez précisément quelles catégories doivent apparaître.
Utilisez l’exclusion lorsque vous souhaitez afficher la plupart des éléments et supprimer uniquement quelques catégories spécifiques.
Exclure plusieurs catégories
Pour exclure plusieurs catégories, séparez leurs noms techniques par un point-virgule (;) dans la syntaxe d’exclusion.
Par exemple :
]restaurant;meeting[
Cela exclut les éléments appartenant à la catégorie restaurant ou meeting.
Ce que vous souhaitez faire | Syntaxe |
Exclure une catégorie |
|
Exclure plusieurs catégories |
|
⚠️ Lorsque vous excluez plusieurs catégories, utilisez un point-virgule (;), et non une virgule.
Correct : ]restaurant;meeting[
Incorrect : ]restaurant,meeting[
Qu’est-ce qu’un moment de la journée ?
Un moment de la journée permet d’organiser les étapes en fonction du moment où elles ont lieu au cours de la journée. Ces moments sont les mêmes que ceux configurés dans la vue planning de votre programme :
Les moments disponibles comprennent :
morninglunchafternoon
Selon les informations configurées dans le programme, ces moments peuvent être utilisés pour récupérer les étapes correspondant à une partie spécifique de la journée.
💡 Les catégories répondent à la question « De quel type d’élément s’agit-il ?»
Les moments de la journée répondent à la question « À quel moment de la journée cet élément doit-il apparaître ? »
Afficher les étapes par moment de la journée
Utilisez le moment de la journée entre crochets.
Par exemple :
$$days.1.steps.[morning].list$$
récupère les étapes associées au matin du Jour 1.
Exemples :
Ce que vous souhaitez afficher | Variable |
Toutes les étapes du Jour 1 |
|
Étapes du matin du Jour 1 |
|
Étapes du déjeuner du Jour 1 |
|
Étapes de l’après-midi du Jour 1 |
|
Modifiez le numéro du jour pour récupérer les informations d’un autre jour.
Par exemple :
$$days.3.steps.[afternoon].list$$
récupère les étapes de l’après-midi du Jour 3.
Catégories vs. moments de la journée
Les catégories et les moments de la journée répondent à des besoins différents.
Utilisation | Catégorie | Moment de la journée |
Sélectionner un type d’activité | ✅ |
|
Afficher uniquement les restaurants | ✅ |
|
Afficher uniquement les trains | ✅ |
|
Organiser une journée entre matin et après-midi |
| ✅ |
Afficher les éléments ayant lieu pendant une partie spécifique de la journée |
| ✅ |
Un élément du programme peut avoir une catégorie tout en étant associé à un moment particulier de la journée.
Erreurs fréquentes
Utiliser le nom d’affichage au lieu du nom technique
Vérifiez toujours la catégorie dans :
Settings → Custom fields → Steps
et utilisez son nom technique dans la variable.
Utiliser une virgule entre les catégories
Utilisez un point-virgule :
Correct : [restaurant;catering]
Incorrect : [restaurant,catering]
La même règle s’applique aux exclusions :
Correct : ]restaurant;meeting[
Incorrect : ]restaurant,meeting[
Modifier le nom technique directement dans la variable
La valeur entre crochets doit correspondre au nom technique configuré dans Ezus.
Si le nom technique est modifié dans les paramètres, les variables utilisant l’ancien nom technique doivent également être mises à jour.
Utiliser le mauvais numéro d’élément
N’oubliez pas que le numéro est calculé dans les résultats filtrés.
$$steps.[restaurant].2.title$$ récupère le deuxième restaurant, et non la deuxième étape dans son ensemble.
Utiliser une catégorie lorsqu’un moment de la journée est nécessaire
Si votre objectif est de diviser la journée entre matin, déjeuner et après-midi, utilisez les moments de la journée plutôt que de créer des catégories pour ces périodes.