Conditions dans Tridion Docs

Une condition est une règle qui définit les critères de sélection pour déterminer le contenu à afficher. La construction de la règle de base consiste en un nom de condition associé à une valeur de condition. Les noms et valeurs des conditions disponibles doivent avoir été définis par votre publication ou votre gestionnaire de projet.

À propos du contenu conditionnel

Dans le cadre de la gestion du contenu, le terme contenu conditionnel désigne le contenu inclus dans la sortie uniquement lorsque des critères spécifiques, les conditions, sont remplis. Cela est comparable au filtrage des résultats de publication.

Pour rendre le contenu conditionnel possible, vous devez d’abord définir vos conditions afin de satisfaire aux exigences de filtrage propres à la visualisation ou la publication des données. Par exemple, les données qui sont sont ne appropriées que dans des circonstances particulières peuvent être balisées d’une condition qui les identifie comme telles. Lors de l’affichage ou de la publication, si une circonstance particulière s’applique, les données seront incluses. Toutefois, si les circonstances ne s’appliquent pas, les données peuvent être filtrées de manière à ce qu’aucunes données non apparentées ou inappropriées ne soient présentées au lecteur. Les conditions permettent de générer des résultats considérablement différents à partir d’un même ensemble d’objets.

@ishcondition et contexte de condition

En règle générale, dans DITA, vous rendez le contenu conditionnel en utilisant les attributs de profilage DITA, comme @product, @platform et @audience, et peut-être un fichier ditaval pour préciser les attributs à afficher ou non. Tridion Docs fonctionne un peu différemment pour offrir une plus grande souplesse.

  • Plutôt que d’utiliser les attributs de profilage DITA, les auteurs étiquettent le contenu avec l’attribut XML @ishcondition spécifique à Tridion Docs. Dans un même attribut @ishcondition, la valeur peut être une simple paire de noms-valeurs, ou une expression complexe.
  • Plutôt qu’un fichier ditaval, Tridion Docs utilise le contexte de condition d’une publication pour préciser le filtrage propre à la version et au niveau de la publication.

Types de conditions

Vous sélectionnez le type de condition lorsque vous créez le nom de la condition.

Il existe quatre types de conditions :
  • Texte
  • Date
  • Nombre
  • Version

La paire nom-valeur de la condition doit inclure une exigence minimale. Les auteurs peuvent ensuite combiner différentes conditions, le cas échéant, pour baliser les données de façon appropriée.

Caractères autorisés dans les noms de condition

Vous pouvez utiliser les caractères suivants dans les noms de condition :
  • caractères numériques
  • caractères alphabétiques, y compris caractères unicode
N’utilisez pas les caractères suivants :
  • Virgule (,)
  • Deux-points (;)
  • Espace
  • Signe inférieur à (<)
  • Signe supérieur à (>)
  • Signe égal (=)
  • Point d’exclamation (!)
  • Parenthèse ouvrante ( ( )
  • Parenthèse fermante ( ) )

Si ces caractères sont utilisés, Content Manager convertira le caractère en trait de soulignement, et la valeur contenant le trait de soulignement sera stockée dans le champ Nom interne. La valeur du champ Nom interne est utilisée lorsque le gestionnaire de contenu calcule la condition de publication.

Caractères autorisés dans les valeurs de condition

Vous pouvez utiliser les caractères suivants dans les valeurs de condition :
  • caractères numériques
  • caractères alphabétiques, y compris caractères unicode
N’utilisez pas les caractères suivants :
  • Virgule (,)
  • Deux-points (;)

Si ces caractères sont utilisés, Content Manager convertira le caractère en trait de soulignement, et la valeur contenant le trait de soulignement sera stockée dans le champ Nom interne. La valeur du champ Nom interne est utilisée lorsque le gestionnaire de contenu calcule la condition de publication.