Définir des énumérations et des valeurs suggérées dans l’interface utilisateur enums-and-suggested-values

Dans le modèle de données d’expérience (XDM), un champ de chaîne peut se voir attribuer un jeu prédéfini de valeurs acceptées ou suggérées afin de mieux contrôler les valeurs ingérées dans ce champ ou leur comportement dans la segmentation.

Enumérations contraindre à un jeu prédéfini les valeurs pouvant être ingérées pour un champ de chaîne. Si vous tentez d’ingérer des données dans un champ d’énumération et que la valeur ne correspond à aucune de celles définies dans sa configuration, l’ingestion sera refusée.

Contrairement aux énumérations, la variable Valeurs proposées permet de représenter un ensemble de valeurs recommandées pour un champ de chaîne qui ne limite pas les valeurs qu’il peut ingérer. Au lieu de cela, les valeurs suggérées affectent les valeurs prédéfinies disponibles dans la variable Interface utilisateur de segmentation lors de l’inclusion du champ de chaîne en tant qu’attribut.

When définition d’un nouveau champ dans l’interface utilisateur de Adobe Experience Platform et définissez le type sur Chaîne, vous avez la possibilité de définir une enum ou valeurs suggérées pour ce champ.

Image montrant l’option Énumération et valeurs proposées activée pour un champ de chaîne dans l’interface utilisateur

Ce document explique comment définir des énumérations et des valeurs suggérées dans le Schémas Espace de travail de l’interface utilisateur. Pour un aperçu rapide des énumérations et des valeurs suggérées, y compris la manière de les configurer dans l’interface utilisateur et de leurs effets en aval, regardez la vidéo suivante :

Définition d’une énumération enum

Sélectionner Enumérations et valeurs proposées, puis sélectionnez Enumérations. Des contrôles supplémentaires s’affichent, vous permettant de spécifier les contraintes de valeur pour l’énumération. Pour ajouter une contrainte, sélectionnez Ajouter une ligne.

Image présentant l’option Enumérations sélectionnée dans l’interface utilisateur

Sous , Valeur , vous devez indiquer la valeur exacte à laquelle vous souhaitez limiter le champ. Vous pouvez éventuellement fournir une Nom d’affichage de la contrainte, qui affecte également la manière dont la valeur sera représentée dans la segmentation.

Continuer à utiliser Ajouter une ligne pour ajouter les contraintes souhaitées et les libellés facultatifs à l’énumération, ou sélectionnez l’icône de suppression ( Image de l’icône de suppression ) en regard d’une ligne précédemment ajoutée pour la supprimer. Lorsque vous avez terminé, sélectionnez Appliquer pour appliquer les modifications au schéma.

Image montrant les valeurs d’énumération et les noms d’affichage renseignés pour le champ de chaîne dans l’interface utilisateur

Le canevas se met à jour pour refléter les modifications. Lorsque vous explorez ce schéma à l’avenir, vous pouvez afficher et modifier les contraintes du champ d’énumération dans le rail de droite.

Définir les valeurs suggérées suggested-values

Sélectionner Enumérations et valeurs proposées, puis sélectionnez Valeurs proposées pour que des contrôles supplémentaires apparaissent. À partir de là, sélectionnez Ajouter une ligne pour commencer à ajouter des valeurs suggérées.

Image montrant l’option Valeurs proposées sélectionnée dans l’interface utilisateur

Sous , Nom d’affichage indiquez un nom convivial pour la valeur telle que vous souhaitez la voir apparaître dans l’interface utilisateur de segmentation. Pour ajouter d’autres valeurs suggérées, sélectionnez Ajouter une ligne et répétez le processus selon vos besoins. Pour supprimer une ligne précédemment ajoutée, sélectionnez icône de suppression à côté de la ligne en question.

Lorsque vous avez terminé, sélectionnez Appliquer pour appliquer les modifications au schéma.

Image montrant les valeurs d’énumération et les noms d’affichage renseignés pour le champ de chaîne dans l’interface utilisateur

NOTE
Il existe un délai d’environ cinq minutes pour que les valeurs suggérées d’un champ soient répercutées dans l’interface utilisateur de segmentation.

Gestion des valeurs suggérées pour les champs standard

Certains champs des composants XDM standard contiennent leurs propres valeurs suggérées, telles que eventType de la XDM ExperienceEvent class. Bien que vous puissiez créer d’autres valeurs suggérées pour un champ standard, vous ne pouvez pas modifier ni supprimer les valeurs suggérées qui ne sont pas définies par votre organisation. Lors de l’affichage d’un champ standard dans l’interface utilisateur, les valeurs proposées sont affichées, mais sont en lecture seule.

Image montrant les valeurs d’énumération et les noms d’affichage renseignés pour le champ de chaîne dans l’interface utilisateur

Pour ajouter de nouvelles valeurs suggérées pour un champ standard, sélectionnez Ajouter une ligne. Pour supprimer une valeur suggérée précédemment ajoutée par votre organisation, sélectionnez icône de suppression à côté de la ligne en question.

Image montrant les valeurs d’énumération et les noms d’affichage renseignés pour le champ de chaîne dans l’interface utilisateur

Règles d’évolution pour les énumérations et les valeurs proposées evolution

Une fois qu’un schéma avec un champ d’énumération a été utilisé pour ingérer des données dans Platform, toute modification supplémentaire apportée à la définition de schéma doit être conforme aux données déjà présentes dans le système. En règle générale, les modifications apportées à un champ existant ne peuvent que le faire. less restrictif. Un champ ne peut pas être rendu plus restrictif qu’il ne l’est déjà.

En ce qui concerne les énumérations et les valeurs proposées, les règles suivantes s’appliquent après l’ingestion :

  • You CAN ajoutez les valeurs suggérées pour les champs standard et personnalisés avec les valeurs suggérées existantes.
  • You CAN supprimez les valeurs suggérées des champs personnalisés avec les valeurs suggérées existantes.
  • You CAN ajoutez de nouvelles valeurs d’énumération pour un champ d’énumération personnalisé existant.
  • You CAN changer les valeurs d’énumération d’un champ personnalisé en valeurs suggérées uniquement ou les convertir en chaîne sans énumération ou valeurs suggérées. Une fois appliqué, ce basculement ne peut pas être annulé.
  • You CANNOT supprimer des énumérations ou des valeurs suggérées des champs standard.
  • You CANNOT ajoutez des valeurs d’énumération à un champ sans énumération existante.
  • You CANNOT supprimez moins de valeurs d’énumération existantes pour un champ personnalisé.
  • You CANNOT passer des valeurs suggérées à une énumération.

Fusion de règles pour les énumérations et les valeurs proposées merging

Si plusieurs schémas utilisent le même champ d’énumération avec des configurations différentes et que ces schémas sont inclus dans une union, certaines règles s’appliquent lorsqu’il s’agit de la manière dont les différences d’énumération sont réconciliées. Les règles exactes dépendent si les schémas référençant le même champ standard (comme eventType) ou s’ils référencent le même chemin d’accès personnalisé dans différents groupes de champs.

Si vous référencez le même champ standard :

  • Toutes les autres valeurs suggérées sont AJOUTÉ dans l’union.
  • Les mises à jour apportées aux valeurs suggérées pour la même clé d’énumération sont les suivantes : MISE À JOUR dans l’union.

Si vous référencez le même chemin de champ personnalisé dans différents groupes de champs :

  • Toutes les autres valeurs suggérées sont AJOUTÉ dans l’union.
  • Si la même valeur suggérée supplémentaire est définie dans plusieurs schémas, ces valeurs sont FUSIONNÉ dans l’union. En d’autres termes, la même valeur suggérée n’apparaîtra pas deux fois après la fusion.

Limites de validation

En raison des limitations actuelles du système, il existe deux cas où une énumération n’est pas validée par le système lors de l’ingestion :

  1. L’énumération est définie sur une champ de tableau.
  2. L’énumération est définie à plusieurs niveaux au sein de la hiérarchie des schémas.

Étapes suivantes

Ce guide explique comment définir des énumérations et des valeurs suggérées pour les champs de chaîne dans l’interface utilisateur. Pour plus d’informations sur la gestion des énumérations et des valeurs suggérées à l’aide de l’API Schema Registry, reportez-vous aux sections suivantes : tutoriel.

Pour savoir comment définir d’autres types de champ XDM dans Schema Editor, consultez la présentation sur définition des champs dans l’interface utilisateur.

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07