Créer et modifier les schémas dans l’interface utilisateur
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. Voir Présentation de XDM pour une présentation du rôle de XDM dans l’écosystème Experience Platform, et la variable principes de base de la composition des schémas pour un aperçu de la création des schémas.
Créer un schéma create
Dans le Schémas espace de travail, sélectionnez Créer un schéma dans le coin supérieur droit.
La variable Créer un schéma le workflow s’affiche. Vous pouvez choisir une classe de base pour le schéma en sélectionnant Profil individuel, Événement d’expérience, ou Autre, suivie de Suivant pour confirmer votre choix. Voir Profil individuel XDM et XDM ExperienceEvent documentation pour plus d’informations sur ces classes.
Une fois que vous avez sélectionné une classe, la variable 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 du schéma 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 passés, sélectionnez Terminer pour créer votre schéma.
La variable Schéma Parcourir s’affiche. Le schéma que vous venez de créer est désormais répertorié dans la bibliothèque de schémas et peut être modifié dans la Schema Editor.
Modifier un schéma existant edit
Pour modifier un schéma existant, sélectionnez l’option 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, la variable 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 ; de ces groupes), modifier les noms d’affichage des champs, ou modifier des groupes de champs personnalisés ; 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électionner Plus dans la partie supérieure de la vue pour afficher une liste déroulante contenant 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 la fonction 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, les groupes de champs contenant les 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.
Une fois les groupes de champs sélectionnés, sélectionnez Ajouter des groupes de champs pour les ajouter au schéma.
La variable Schema Editor réapparaît avec les champs fournis par le groupe de champs représentés dans la zone de travail.
Après avoir ajouté un groupe de champs à un schéma, vous pouvez éventuellement supprimer des champs existants ou ajout 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 Détails démographiques a été ajouté à un schéma. Pour supprimer un seul champ, par exemple 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 Gestion des 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 section pour obtenir des instructions spécifiques. Si vous ajoutez des champs à un groupe de champs personnalisé, reportez-vous à la section sur modification de groupes de champs personnalisés dans le guide de l’interface utilisateur des groupes de champs.
Si vous ne souhaitez modifier aucun groupe de champs existant, vous pouvez créer un groupe de champs personnalisé pour définir des champs supplémentaires.
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 ; au lieu de .
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 le plus (+) en regard du nom du schéma dans la zone de travail. Un Champ sans titre un espace réservé 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 à 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 figure également sous Groupes de champs dans le rail de gauche. Si vous souhaitez ajouter d’autres champs à partir du même groupe de champs, sélectionnez Gestion des 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 le plus (+) en regard du nom du schéma dans la zone de travail. Un Champ sans titre un espace réservé 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 annexé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 de ajouter le champ à la classe affectée ou groupe de champs au lieu de . 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 sous votre identifiant du client 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.
Poursuivez la configuration du champ selon vos besoins et sélectionnez Appliquer lorsque vous avez terminé.
Le nouveau champ est ajouté à la zone de travail et est un espace de noms sous votre identifiant du client 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.
Pour commencer, sélectionnez le 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électionner Continuer à créer un 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é avec "(Étendu)" 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
Profil client en temps réel fusionne les données provenant de sources disparates afin de créer 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, sélectionnez d’abord le nom du schéma dans le rail de gauche, puis sélectionnez l’option Profil bascule 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électionner Activer pour continuer.
La zone de travail réapparaît avec la fonction Profil bascule 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électionner Appliquer dans le rail de droite, et la zone de travail se met à jour pour afficher le nouveau nom d’affichage du champ. Sélectionner 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 les classes définies par votre organisation (le propriétaire étant "Client") ainsi que les classes standard définies par 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 Aperçu de la structure de classe pour afficher les champs et les métadonnées associés à la classe. Sélectionner Attribuer une classe pour continuer.
Une nouvelle boîte de dialogue s’ouvre, vous demandant de confirmer que vous souhaitez attribuer une nouvelle classe. Sélectionner 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 la section tutoriel sur la création de schéma pour un processus complet de création d’un schéma complet dans l’interface utilisateur, notamment 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 la variable Schémas workspace, voir Schémas présentation de workspace.
Pour savoir comment gérer les schémas dans le Schema Registry API, voir guide de point d’entrée des schémas.