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 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.
Enums contraindre 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 Suggested values permet à d’indiquer un ensemble de valeurs recommandées pour un champ de chaîne qui ne contraignent 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 String, 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 de Schemas. 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 enum
Sélectionnez Enums and Suggested Values, puis sélectionnez Enums. 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 Add row.
Sous la Value colonne, vous devez indiquer la valeur exacte à laquelle vous souhaitez contraindre le champ. Vous pouvez éventuellement fournir un lien convivial Display Name pour la contrainte, ce qui affecte la façon dont la valeur sera représentée dans la segmentation.
Continuez à utiliser Add row 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 suggested-values
Sélectionnez Enums and Suggested Values, puis sélectionnez Suggested Values pour faire apparaître d’autres contrôles. À partir de là, sélectionnez Add row pour commencer à ajouter des valeurs suggérées.
Sous la colonne Display Name , indiquez un nom convivial pour 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 Add row 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 Apply pour appliquer les modifications au schéma.
Gé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 Add row. Pour supprimer une valeur suggérée précédemment ajoutée par votre organisation, sélectionnez
Règles d’évolution pour les énumérations et valeurs suggérées evolution
Une fois qu’un schéma avec un champ d’énumération a été utilisé pour ingérer des données dans Experience Platform, toutes les modifications ultérieures apportées à la définition du schéma doivent être conformes 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 avec les valeurs suggérées existantes.
- Vous POUVEZ ajouter de nouvelles valeurs d’énumération pour un champ d’énumération personnalisé existant.
- Vous POUVEZ basculer les valeurs d’énumération d’un champ personnalisé en valeurs suggérées uniquement, ou les convertir en une chaîne sans énumération ni valeurs suggérées. Cette permutation ne peut pas être annulée une fois qu’elle a été appliquée.
- Vous NE POUVEZ PAS supprimer les énumérations ou les 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 merging
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 :
- Toute valeur supplémentaire suggérée est AJOUTÉE 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 :
- Toute valeur supplémentaire suggérée est AJOUTÉE 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.