Créer et modifier les schémas dans l’interface utilisateur create-edit-schemas-in-ui
Ce guide explique comment créer, modifier et gérer des schémas de modèle de données d’expérience (XDM) pour votre organisation dans l’interface utilisateur de Adobe Experience Platform.
Conditions préalables prerequisites
Ce guide nécessite une compréhension pratique du système XDM. Reportez-vous à la présentation XDM pour une présentation du rôle de XDM dans l’écosystème Experience Platform et aux principes de base de la composition des schémas pour une présentation de la manière dont les schémas sont construits.
Créer un schéma create
Dans l’espace de travail Schémas, sélectionnez Créer un schéma dans le coin supérieur droit.
Le workflow Créer un schéma s’affiche. Vous pouvez choisir une classe de base pour le schéma en sélectionnant Individual Profile, Experience Event ou Other, suivi de Next pour confirmer votre choix. Pour plus d’informations sur ces classes, consultez la documentation XDM Individual profile et XDM ExperienceEvent .
Une fois que vous avez sélectionné une classe, la section Nom et révision s’affiche. Dans cette section, vous fournissez un nom et une description pour identifier votre schéma. La structure de base du schéma (fournie par la classe) s’affiche dans la zone de travail afin que vous puissiez examiner et vérifier la classe et la structure de schéma sélectionnés.
Saisissez un nom d’affichage de schéma convivial dans le champ de texte. Saisissez ensuite une description appropriée pour vous aider à identifier votre schéma. Une fois la structure de votre schéma revue et vos paramètres satisfaits, sélectionnez Terminer pour créer votre schéma.
L'onglet Schéma Parcourir s'affiche. Le schéma que vous venez de créer est maintenant répertorié dans la bibliothèque de schémas et peut être modifié dans le Schema Editor.
Modifier un schéma existant edit
Pour modifier un schéma existant, sélectionnez l’onglet Parcourir, puis sélectionnez le nom du schéma à modifier. Vous pouvez également utiliser la barre de recherche pour réduire la liste des options disponibles.
Une fois que vous avez sélectionné un schéma, le Schema Editor apparaît avec la structure du schéma affichée dans la zone de travail. Vous pouvez désormais ajouter des groupes de champs au schéma (ou ajouter des champs individuels à partir de ces groupes), modifier les noms d’affichage des champs ou modifier les groupes de champs personnalisés existants si le schéma en utilise un.
Actions supplémentaires more
Dans l’éditeur de schémas, vous pouvez également exécuter des actions rapides pour copier la structure JSON du schéma ou supprimer le schéma s’il n’a pas été activé pour Real-time Customer Profile ou s’il comporte des jeux de données associés. Sélectionnez Plus en haut de la vue pour afficher une liste déroulante avec des actions rapides.
La fonctionnalité Copier la structure JSON vous permet de voir à quoi ressemblerait un exemple de payload pendant que vous créez encore le schéma et vos pipelines de données. Elle s’avère particulièrement utile dans les situations où il existe des structures de mappage d’objet complexes dans le schéma, telles qu’une carte d’identité.
Bascule du nom d’affichage display-name-toggle
Pour votre commodité, l’éditeur de schémas propose un bouton d’activation/désactivation pour modifier les noms de champ d’origine et les noms d’affichage plus lisibles. Cette flexibilité permet d’améliorer la visibilité des champs et l’édition de vos schémas. Le bouton bascule se trouve en haut à droite de la vue de l’éditeur de schémas.
Les noms d’affichage des groupes de champs standard sont générés par le système, mais peuvent être personnalisés, comme décrit dans la section noms d’affichage . Les noms d’affichage sont reflétés dans plusieurs vues d’interface utilisateur, y compris les aperçus de mappage et de jeu de données. Le paramètre par défaut est désactivé et affiche les noms des champs selon leurs valeurs d’origine.
Ajout de groupes de champs à un schéma add-field-groups
Une fois que vous avez ouvert un schéma dans Schema Editor, vous pouvez ajouter des champs au schéma à l’aide de groupes de champs. Pour commencer, sélectionnez Ajouter en regard de Groupes de champs dans le rail de gauche.
Une boîte de dialogue s’affiche, affichant la liste des groupes de champs que vous pouvez sélectionner pour le schéma. Puisque les groupes de champs ne sont compatibles qu’avec une seule classe, seuls les groupes de champs associés à la classe sélectionnée du schéma sont répertoriés. Par défaut, les groupes de champs répertoriés sont triés en fonction de leur popularité d’utilisation au sein de votre entreprise.
Si vous connaissez l’activité générale ou le domaine d’activité des champs que vous souhaitez ajouter, sélectionnez une ou plusieurs des catégories de secteur vertical dans le rail de gauche pour filtrer la liste affichée des groupes de champs.
Vous pouvez également utiliser la barre de recherche pour localiser le groupe de champs souhaité. Les groupes de champs dont le nom correspond à la requête apparaissent en haut de la liste. Sous Champs standard, des groupes de champs contenant des champs qui décrivent les attributs de données souhaités s’affichent.
Cochez la case en regard du nom du groupe de champs que vous souhaitez ajouter au schéma. Vous pouvez sélectionner plusieurs groupes de champs dans la liste, chaque groupe de champs sélectionné apparaissant dans le rail de droite.
![icône d’information](./media_11e923643f5e5da4c05aeb5a997304c0124627611.png?width=750&format=png&optimize=medium)
![icône d’aperçu](./media_19362382ce34ca48a19213ab212c9d6ae876b0fb7.png?width=750&format=png&optimize=medium)
Une fois que vous avez choisi vos groupes de champs, sélectionnez Ajouter des groupes de champs pour les ajouter au schéma.
Schema Editor réapparaît avec les champs fournis par le groupe de champs représentés dans la zone de travail.
![Icône de cadenas.](./media_14897d17936cd65d68cccb634f23c71c699ddfc5d.png?width=750&format=png&optimize=medium)
![L’éditeur de schéma avec l’icône de cadenas mise en surbrillance](./media_1d973f8ffd6b50aed643758d180f2a2cf2f3b11c1.png?width=750&format=png&optimize=medium)
Après avoir ajouté un groupe de champs à un schéma, vous pouvez éventuellement supprimer des champs existants ou ajouter de nouveaux champs personnalisés à ces groupes, en fonction de vos besoins.
Supprimer les champs ajoutés des groupes de champs remove-fields
Après avoir ajouté un groupe de champs à un schéma, vous pouvez supprimer tous les champs dont vous n’avez pas besoin.
Dans l’exemple suivant, le groupe de champs standard Demographic Details a été ajouté à un schéma. Pour supprimer un champ unique, tel que taxId
, sélectionnez le champ dans la zone de travail, puis sélectionnez Supprimer dans le rail de droite.
Si vous souhaitez supprimer plusieurs champs, vous pouvez gérer le groupe dans son ensemble. Sélectionnez un champ appartenant au groupe dans la zone de travail, puis sélectionnez Gérer les champs associés dans le rail de droite.
Une boîte de dialogue s’affiche, indiquant la structure du groupe de champs en question. À partir de là, vous pouvez utiliser les cases à cocher fournies pour sélectionner ou désélectionner les champs dont vous avez besoin. Lorsque vous êtes satisfait, sélectionnez Confirmer.
Le canevas réapparaît avec uniquement les champs sélectionnés présents dans la structure du schéma.
Ajout de champs personnalisés aux groupes de champs add-fields
Après avoir ajouté un groupe de champs à un schéma, vous pouvez définir des champs supplémentaires pour ce groupe. Cependant, tous les champs ajoutés à un groupe de champs dans un schéma apparaîtront également dans tous les autres schémas qui utilisent ce même groupe de champs.
En outre, si un champ personnalisé est ajouté à un groupe de champs standard, ce groupe sera converti en groupe de champs personnalisé et le groupe de champs standard d’origine ne sera plus disponible.
Si vous souhaitez ajouter un champ personnalisé à un groupe de champs standard, reportez-vous à la section ci-dessous pour obtenir des instructions spécifiques. Si vous ajoutez des champs à un groupe de champs personnalisé, reportez-vous à la section sur la modification des groupes de champs personnalisés du guide de l’interface utilisateur des groupes de champs.
Si vous ne souhaitez modifier aucun groupe de champs existant, vous pouvez créer un nouveau groupe de champs personnalisés pour définir des champs supplémentaires à la place.
Ajout de champs individuels à un schéma add-individual-fields
L’éditeur de schémas vous permet d’ajouter des champs individuels directement à un schéma si vous souhaitez éviter d’ajouter un groupe de champs entier pour un cas d’utilisation spécifique. Vous pouvez ajouter des champs individuels à partir de groupes de champs standard ou ajouter vos propres champs personnalisés à la place.
Ajouter des champs standard add-standard-fields
Vous pouvez ajouter directement à un schéma des champs provenant de groupes de champs standard sans avoir à connaître au préalable le groupe de champs correspondant. Pour ajouter un champ standard à un schéma, sélectionnez l’icône plus (+) en regard du nom du schéma dans la zone de travail. Un espace réservé Champ sans titre apparaît dans la structure du schéma et le rail de droite est mis à jour pour afficher les commandes permettant de configurer le champ.
Sous Nom du champ, commencez à saisir le nom du champ que vous souhaitez ajouter. Le système recherche automatiquement les champs standard correspondant à la requête et les répertorie sous Champs standard recommandés, y compris les groupes de champs auxquels ils appartiennent.
Bien que certains champs standard portent le même nom, leur structure peut varier en fonction du groupe de champs d’où ils proviennent. Si un champ standard est imbriqué dans un objet parent dans la structure du groupe de champs, le champ parent sera également inclus dans le schéma si le champ enfant est ajouté.
Sélectionnez l’icône d’aperçu (
Le canevas se met à jour pour afficher le champ standard ajouté au schéma, y compris tous les champs parents sous lesquels il est imbriqué dans la structure du groupe de champs. Le nom du groupe de champs est également répertorié sous Groupes de champs dans le rail de gauche. Si vous souhaitez ajouter d’autres champs du même groupe de champs, sélectionnez Gérer les champs associés dans le rail de droite.
Ajouter des champ personnalisés add-custom-fields
Tout comme le workflow pour les champs standard, vous pouvez également ajouter vos propres champs personnalisés directement à un schéma.
Pour ajouter des champs au niveau racine d’un schéma, sélectionnez l’icône plus (+) en regard du nom du schéma dans la zone de travail. Un espace réservé Champ sans titre apparaît dans la structure du schéma et le rail de droite est mis à jour pour afficher les commandes permettant de configurer le champ.
Commencez à saisir le nom du champ que vous souhaitez ajouter, et le système commence automatiquement à rechercher les champs standards correspondants. Pour créer un champ personnalisé à la place, sélectionnez l’option supérieure ajoutée avec (Nouveau champ).
Après avoir fourni un nom d’affichage et un type de données pour le champ, l’étape suivante consiste à attribuer le champ à une ressource XDM parente. Si votre schéma utilise une classe personnalisée, vous pouvez choisir d’ajouter le champ à la classe affectée ou un groupe de champs à la place. Cependant, si votre schéma utilise une classe standard, vous ne pouvez affecter le champ personnalisé qu’à un groupe de champs.
Affecter le champ à un groupe de champs personnalisé add-to-field-group
Sous Attribuer à, sélectionnez Groupe de champs. Si votre schéma utilise une classe standard, il s’agit de la seule option disponible et elle est sélectionnée par défaut.
Vous devez ensuite sélectionner un groupe de champs pour le nouveau champ à associer. Commencez à saisir le nom du groupe de champs dans la saisie de texte fournie. Si des groupes de champs personnalisés correspondent à l’entrée, ils s’affichent dans la liste déroulante. Vous pouvez également saisir un nom unique pour créer un groupe de champs.
Après avoir sélectionné le groupe de champs dans la liste, sélectionnez Appliquer.
Le nouveau champ est ajouté à la zone de travail et est un espace de noms situé sous votre ID de tenant pour éviter les conflits avec les champs XDM standard. Le groupe de champs auquel vous avez associé le nouveau champ apparaît également sous Groupes de champs dans le rail de gauche.
Affectation du champ à une classe personnalisée add-to-class
Sous Attribuer à, sélectionnez Classe. Le champ d’entrée ci-dessous est remplacé par le nom de la classe personnalisée du schéma actuel, indiquant que le nouveau champ sera affecté à cette classe.
Continuez à configurer le champ selon vos besoins et sélectionnez Appliquer une fois terminé.
Le nouveau champ est ajouté à la zone de travail et est un espace de noms situé sous votre ID de tenant pour éviter les conflits avec les champs XDM standard. Si vous sélectionnez le nom de la classe dans le rail de gauche, le nouveau champ s’affiche dans la structure de la classe.
Ajouter des champs personnalisés à la structure des groupes de champs standard custom-fields-for-standard-groups
Si le schéma sur lequel vous travaillez comporte un champ de type objet fourni par un groupe de champs standard, vous pouvez ajouter vos propres champs personnalisés à cet objet standard.
![Boîte de dialogue de confirmation pour convertir des groupes de champs standard](./media_1eeda5336c2fc2516a51648588a901f94faf80786.png?width=750&format=png&optimize=medium)
Pour commencer, sélectionnez l’icône plus (+) en regard de la racine de l’objet fourni par le groupe de champs standard.
Un message d’avertissement s’affiche, vous invitant à confirmer la conversion du groupe de champs standard. Sélectionnez Continuer la création du groupe de champs pour continuer.
Le canevas réapparaît avec un espace réservé sans titre pour le nouveau champ. Notez que le nom du groupe de champs standard a été ajouté à "(Extended)" pour indiquer qu’il a été modifié à partir de la version d’origine. À partir de là, utilisez les commandes du rail de droite pour définir les propriétés du champ.
Après avoir appliqué vos modifications, le nouveau champ s’affiche sous l’espace de noms de l’identifiant du client dans l’objet standard. Cet espace de noms imbriqué empêche les conflits de nom de champ dans le groupe de champs lui-même afin d’éviter de rompre les modifications dans d’autres schémas qui utilisent le même groupe de champs.
Activer un schéma pour le profil client en temps réel profile
Real-Time Customer Profile fusionne les données de sources disparates afin de construire une vue complète de chaque client. Si vous souhaitez que les données capturées par un schéma participent à ce processus, vous devez activer le schéma à utiliser dans Profile.
Pour activer le schéma, commencez par sélectionner le nom du schéma dans le rail de gauche, puis sélectionnez le bouton d’activation/désactivation Profile dans le rail de droite.
Une fenêtre contextuelle s’affiche, vous avertissant qu’une fois qu’un schéma a été activé et enregistré, il ne peut pas être désactivé. Sélectionnez Activer pour continuer.
Le canevas réapparaît avec le bouton bascule Profile activé.
Pour terminer le processus, sélectionnez Enregistrer pour enregistrer le schéma.
Le schéma est désormais activé pour une utilisation dans Real-Time Customer Profile. Lorsque Platform ingère des données dans des jeux de données en fonction de ce schéma, ces données sont intégrées à vos données de profil fusionnées.
Modification des noms d’affichage des champs de schéma display-names
Une fois que vous avez affecté une classe et ajouté des groupes de champs à un schéma, vous pouvez modifier les noms d’affichage de l’un des champs du schéma, que ces champs aient été fournis par des ressources XDM standard ou personnalisées.
Pour modifier le nom d’affichage d’un champ de schéma, sélectionnez le champ dans la zone de travail. Dans le rail de droite, indiquez le nouveau nom sous Nom d’affichage.
Sélectionnez Appliquer dans le rail de droite et les mises à jour du canevas pour afficher le nouveau nom d’affichage du champ. Sélectionnez Enregistrer pour appliquer les modifications au schéma.
Modification de la classe d’un schéma change-class
Vous pouvez modifier la classe d’un schéma à tout moment au cours du processus de composition initiale, avant que le schéma ne soit enregistré.
Pour réaffecter une classe, sélectionnez Attribuer dans la partie gauche du canevas.
Une boîte de dialogue s’affiche, qui affiche une liste de toutes les classes disponibles, y compris toutes celles définies par votre organisation (le propriétaire étant "Customer") ainsi que les classes standard définies par l’Adobe.
Sélectionnez une classe dans la liste pour afficher sa description sur le côté droit de la boîte de dialogue. Vous pouvez également sélectionner Preview class structure pour afficher les champs et les métadonnées associés à la classe. Sélectionnez Attribuer la classe pour continuer.
Une nouvelle boîte de dialogue s’ouvre, vous demandant de confirmer que vous souhaitez attribuer une nouvelle classe. Sélectionnez Attribuer pour confirmer.
Après avoir confirmé la modification de classe, le canevas est réinitialisé et toute progression de la composition est perdue.
Étapes suivantes next-steps
Ce document couvrait les principes de base de la création et de la modification de schémas dans l’interface utilisateur de Platform. Il est vivement recommandé de consulter le tutoriel de création de schéma pour obtenir un processus complet de création d’un schéma complet dans l’interface utilisateur, y compris la création de groupes de champs personnalisés et de types de données pour des cas d’utilisation uniques.
Pour plus d’informations sur les fonctionnalités de l’espace de travail Schémas, consultez la présentation des schémas de l’espace de travail.
Pour savoir comment gérer les schémas dans l’API Schema Registry, consultez le guide de point d’entrée des schémas.