Définir des énumérations et des valeurs suggérées dans l’interface utilisateur
Créé pour :
- Développeur
Dans le modèle de données d’expérience (XDM), un champ de chaîne peut recevoir un ensemble prédéfini de valeurs acceptées ou suggérées pour mieux contrôler les valeurs ingérées dans ce champ ou la manière dont il se comportera dans la segmentation.
Énumérations limitez les valeurs qui peuvent être ingérées pour un champ de chaîne à un ensemble prédéfini. Si vous tentez d’ingérer des données dans un champ d’énumération et que la valeur ne correspond à aucun de ceux définis dans sa configuration, l’ingestion est refusée.
Contrairement aux énumérations, l’option Valeurs suggérées permet à d’indiquer 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 l’interface utilisateur de segmentation lors de l’inclusion du champ de chaîne comme attribut.
Lorsque vous définissez 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 énumération ou valeurs suggérées pour ce champ.
Ce document explique comment définir des énumérations et les valeurs suggérées dans l’espace de travail de l’interface utilisateur Schémas. Pour un aperçu rapide sur les énumérations et les valeurs suggérées, y compris sur la manière de les configurer dans l’interface utilisateur et leurs effets en aval, regardez la vidéo suivante :
Définition d’une énumération
Sélectionnez Énumérations et valeurs suggérées, puis sélectionnez Énumérations. Des commandes 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.
Sous la colonne Valeur, vous devez fournir la valeur exacte à laquelle vous souhaitez contraindre le champ. Vous pouvez également fournir un Nom d’affichage convivial pour la contrainte, ce qui affecte la manière dont la valeur sera représentée dans la segmentation.
Continuez à utiliser Ajouter une ligne pour ajouter les contraintes et les libellés facultatifs de votre choix à l’énumération, ou sélectionnez l’icône de suppression (
La zone de travail se met à jour pour prendre en compte les modifications. À l’avenir, lorsque vous explorerez ce schéma, vous pourrez afficher et modifier les contraintes du champ d’énumération dans le rail de droite.
Définir les valeurs suggérées
Sélectionnez Énumérations et valeurs suggérées, puis sélectionnez Valeurs suggérées pour afficher des commandes supplémentaires. À partir de là, sélectionnez Ajouter une ligne pour commencer à ajouter les valeurs suggérées.
Sous la colonne Nom d’affichage, attribuez un nom convivial à la valeur telle que vous souhaitez qu’elle apparaisse dans l’interface utilisateur de segmentation. Pour ajouter d’autres valeurs suggérées, sélectionnez à nouveau Ajouter une ligne et répétez le processus si nécessaire. Pour supprimer une ligne ajoutée précédemment, sélectionnez
Lorsque vous avez terminé, sélectionnez Appliquer pour appliquer les modifications au schéma.
NOTEGérer les valeurs suggérées pour les champs standards
Certains champs des composants XDM standard contiennent leurs propres valeurs suggérées, telles que les eventType de la classe XDM ExperienceEvent. Bien que vous puissiez créer des valeurs suggérées supplémentaires pour un champ standard, vous ne pouvez pas modifier ni supprimer des 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 suggérées s’affichent mais sont en lecture seule.
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
Règles d’évolution des énumérations et valeurs suggérées
Après l’utilisation d’un schéma avec un champ d’énumération pour ingérer des données dans Experience Platform, toute autre modification apportée à la définition du 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 rendre ce champ moins 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 suggérées, les règles suivantes s’appliquent après l’ingestion :
- Vous POUVEZ ajouter des valeurs suggérées pour les champs standard et personnalisés avec des valeurs suggérées existantes.
- Vous POUVEZ supprimer les valeurs suggérées des champs personnalisés contenant des valeurs suggérées existantes.
- Vous POUVEZ ajouter de nouvelles valeurs d’énumération pour un champ d’énumération personnalisé existant.
- Vous POUVEZ changer les valeurs d’énumération d’un champ personnalisé en valeurs suggérées uniquement ou le convertir en une chaîne sans énumération ni valeurs suggérées. Ce changement ne peut pas être annulé une fois appliqué.
- Vous NE POUVEZ PAS supprimer des énumérations ou des valeurs suggérées des champs standard.
- Vous IMPOSSIBLE ajouter des valeurs d’énumération à un champ sans énumération existante.
- Vous NE POUVEZ PAS supprimer moins de toutes les valeurs d’énumération existantes pour un champ personnalisé.
- Vous NE POUVEZ PAS passer des valeurs suggérées à une énumération.
Règles de fusion pour les énumérations et les valeurs suggérées
Si plusieurs schémas utilisent le même champ d’énumération avec différentes configurations et que ces schémas sont inclus dans une union, certaines règles s’appliquent en ce qui concerne la manière dont les différences d’énumération sont réconciliées. Les règles exactes varient selon que les schémas référençant le même champ standard (comme eventType) ou s’ils référencent le même chemin de champ personnalisé dans différents groupes de champs.
Si vous référencez le même champ standard :
- Toutes les valeurs supplémentaires suggérées sont AJOUTÉES dans l’union.
- Les mises à jour apportées aux valeurs suggérées pour la même clé d’énumération sont MISES À JOUR dans l’union.
Si vous référencez le même chemin de champ personnalisé dans différents groupes de champs :
- Toutes les valeurs supplémentaires suggérées sont AJOUTÉES dans l’union.
- Si la même valeur suggérée supplémentaire est définie dans plusieurs schémas, ces valeurs sont MERGED 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 :
- L’énumération est définie sur un champ de tableau.
- L’énumération est définie à plusieurs niveaux de profondeur dans la hiérarchie du schéma.
Étapes suivantes
Ce guide explique comment définir des énumérations et les 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, consultez le tutoriel suivant.
Pour savoir comment définir d’autres types de champs XDM dans l’Schema Editor, consultez la présentation sur la définition de champs dans l’interface utilisateur.