Créer et modifier les schémas dans l’interface utilisateur create-edit-schemas-in-ui

Ce guide présente la création, la modification et la gestion 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 de XDM pour une introduction au 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 construction des schémas.

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.

La boîte de dialogue Créer un schéma s’affiche. Dans cette boîte de dialogue, vous pouvez choisir de créer manuellement un schéma en ajoutant des champs et des groupes de champs, ou de charger un fichier CSV et d’utiliser des algorithmes ML pour générer un schéma. Sélectionnez un workflow de création de schéma dans la boîte de dialogue.

[Beta]{class="badge informative"} Création manuelle ou assistée par machine learning de schéma manual-or-assisted

Pour découvrir comment utiliser un algorithme ML afin de recommander une structure de schéma basée sur un fichier csv, consultez le guide de création de schéma assisté par machine learning machine learning. Ce guide de l’interface utilisateur se concentre sur le workflow de création manuelle .

Création manuelle de schéma manual-creation

Le workflow Créer un schéma 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, suivi de Suivant pour confirmer votre choix. Consultez la documentation Profil individuel XDM et XDM ExperienceEvent pour plus d’informations sur ces classes.

Lorsque vous choisissez Autre, la liste des classes disponibles s’affiche. À partir de là, vous pouvez parcourir et filtrer les classes préexistantes.

Sélectionnez un bouton radio pour filtrer les classes selon qu’il s’agit de classes personnalisées ou standard. Vous pouvez également filtrer les résultats disponibles en fonction de leur secteur d’activité ou rechercher une classe spécifique à l’aide du champ de recherche.

Pour vous aider à choisir la classe appropriée, il existe des icônes d’informations et de prévisualisation pour chaque classe. L’icône d’informations ( ) ouvre une boîte de dialogue qui fournit une description de la classe et du secteur auquel elle est associée.

L’icône d’aperçu ( ) ouvre une boîte de dialogue de prévisualisation pour la classe qui contient un diagramme de schéma et ses propriétés.

Sélectionnez une ligne pour choisir une classe, puis sélectionnez Suivant pour confirmer votre choix.

Après avoir sélectionné une classe, la section Nom et révision s’affiche. Dans cette section, vous indiquez 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. Vous pouvez ainsi consulter et vérifier la structure de classe et de schéma sélectionnée.

Saisissez un nom d’affichage du schéma convivial dans le champ de texte. Saisissez ensuite une description appropriée pour vous aider à identifier votre schéma. Une fois que vous avez révisé votre structure de schéma et que vos paramètres vous conviennent, sélectionnez Terminer pour créer votre schéma.

L’éditeur de schémas s’affiche, avec la structure du schéma affichée dans la zone de travail. Si vous le souhaitez, vous pouvez maintenant commencer à ajouter des champs à la classe.

Modification d’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 affiner la liste des options disponibles.

Une fois que vous avez sélectionné un schéma, la Schema Editor s’affiche 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.

Actions supplémentaires more

Dans l’éditeur de schémas, vous pouvez également effectuer des actions rapides pour copier la structure JSON du schéma ou supprimer le schéma s’il n’a pas été activé pour le profil client en temps réel ou s’il est associé à des jeux de données. 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 le schéma et vos pipelines de données. Elle s’avère particulièrement utile dans les cas où le schéma contient des structures de mappage d’objets complexes, telles qu’un mappage d’identités.

Basculement du nom d’affichage display-name-toggle

Pour votre commodité, l’éditeur de schémas propose un bouton bascule pour basculer entre les noms de champ d’origine et les noms d’affichage plus lisibles. Cette flexibilité permet d’améliorer la visibilité des champs et la modification 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 de l’interface utilisateur, y compris les aperçus de mappages et de jeux de données. Le paramètre par défaut est désactivé et affiche les noms de champ 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 le Schema Editor, vous pouvez y ajouter des champs à 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 une liste de groupes de champs que vous pouvez sélectionner pour le schéma. Comme 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 seront 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 organisation.

Si vous connaissez l’activité générale ou le domaine fonctionnel des champs que vous souhaitez ajouter, sélectionnez une ou plusieurs catégories sectorielles verticales 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 de votre choix. 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.

TIP

Pour n’importe quel groupe de champs répertorié, vous pouvez pointer ou placer le focus sur l’icône d’information ( ) pour afficher une brève description du type de données capturées par le groupe de champs. Vous pouvez également sélectionner l’icône d’aperçu ( ) pour afficher la structure des champs fournis par le groupe de champs avant de décider de l’ajouter au schéma.

Une fois que vous avez choisi vos groupes de champs, sélectionnez Ajouter des groupes de champs pour les ajouter au schéma.

La Schema Editor réapparaît avec les champs fournis par le groupe de champs représentés dans la zone de travail.

NOTE

Dans l’éditeur de schémas, les classes et les groupes de champs standard (générés par Adobe) sont indiqués par l’icône de cadenas . Le cadenas s’affiche dans le rail de gauche à côté du nom de la classe ou du groupe de champs, ainsi qu’à côté de tout champ du diagramme de schéma qui fait partie d’une ressource générée par le système.

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 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, 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 de champs 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, affichant la structure du groupe de champs en question. 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.

La zone de travail réapparaît avec uniquement les champs sélectionnés présents dans la structure du schéma.

Ajouter des champs personnalisés à des 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. Toutefois, tous les champs ajoutés à un groupe de champs dans un schéma apparaissent é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 de champs est converti en groupe de champs personnalisés et le groupe de champs standard d’origine n’est 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és, reportez-vous à la section 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 à la place.

Ajout de champs individuels à un schéma add-individual-fields

L’éditeur de schémas vous permet d’ajouter directement des champs individuels à 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 des champs de groupes de champs standard à un schéma 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 se met à jour pour afficher les commandes de configuration du 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 partagent 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 est également inclus dans le schéma si le champ enfant est ajouté.

Sélectionnez l’icône d’aperçu ( ) à côté d’un champ standard pour afficher la structure de son groupe de champs et mieux comprendre comment il peut être imbriqué. Pour ajouter le champ standard au schéma, sélectionnez l’icône plus ( ).

La zone de travail se met à jour pour afficher le champ standard ajouté au schéma, y compris 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 pour le workflow des 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 (+) à côté 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 se met à jour pour afficher les commandes de configuration du champ.

Commencez à saisir le nom du champ que vous souhaitez ajouter et le système lance automatiquement la recherche des champs standard correspondants. Pour créer un champ personnalisé à la place, sélectionnez l’option supérieure avec (Nouveau champ).

Après avoir fourni un nom d’affichage et un type de données for Pour le champ , l’étape suivante consiste à affecter le champ à une ressource XDM parent. 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és add-to-field-group

Sous Affecter à, sélectionnez Groupe de champs. Si votre schéma utilise une classe standard, il s’agit de la seule option disponible ; 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 existants correspondent à l’entrée, ils s’affichent dans la liste déroulante. Vous pouvez également saisir : a nom unique pour créer un nouveau groupe de champs à la place.

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 dispose d’un espace de noms sous votre identifiant client pour éviter les conflits avec les champs XDM standard. Le groupe de champs auquel vous avez associé le nouveau champ s’affiche également sous Groupes de champs dans le rail de gauche.

Affecter le champ à une classe personnalisée add-to-class

Sous Affecter à, 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 comme vous le souhaitez et sélectionnez Appliquer lorsque vous avez terminé.

Le nouveau champ est ajouté à la zone de travail et dispose d’un espace de noms sous votre identifiant 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 type d’objet field fourni par un groupe de champs standard, vous pouvez ajouter vos propres champs personnalisés à cet objet standard.

WARNING

Tous les champs ajoutés à un groupe de champs dans un schéma apparaissent é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 de champs est converti en groupe de champs personnalisés et le groupe de champs standard d’origine n’est plus disponible.

Si vous avez participé à la version bêta de cette fonctionnalité, vous recevrez une boîte de dialogue vous informant des groupes de champs standard que vous avez précédemment personnalisés. Une fois que vous avez sélectionné Confirmer, les ressources répertoriées sont converties en groupes de champs personnalisés.

Pour commencer, sélectionnez l’icône plus (+) à côté de la racine de l’objet fourni par le groupe de champs standard.

Un message d’avertissement s’affiche, vous invitant à confirmer si vous souhaitez convertir le groupe de champs standard. Sélectionnez Continuer à créer le groupe de champs pour continuer.

La zone de travail 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 « (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 votre identifiant client dans l’objet standard. Cet espace de noms imbriqué empêche les conflits de nom de champ au sein du 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

Le profil client en temps réel fusionne des données provenant de sources disparates afin de créer une vue complète de chaque client individuel. Si vous souhaitez que les données capturées par un schéma participent à ce processus, vous devez activer le schéma pour une utilisation 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 bascule Profil 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.

La zone de travail réapparaît avec le bouton Profile activé.

Pour terminer le processus, sélectionnez Enregistrer pour enregistrer le schéma.

Le schéma peut désormais être utilisé dans le profil client en temps réel. Lorsque Platform ingère des données dans des jeux de données basés sur ce schéma, ces données sont intégrées à vos données de profil fusionnées.

Modifier les 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.

Remplacez les noms de champ par les noms d’affichage en appuyant sur Afficher les noms d’affichage des champs. 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 la zone de travail se met à jour 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 Affecter dans la partie gauche de la zone de travail.

Une boîte de dialogue s’affiche. Elle répertorie toutes les classes disponibles, y compris celles 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 dans la partie droite de la boîte de dialogue. Vous pouvez également sélectionner Prévisualiser la structure de la classe pour afficher les champs et les métadonnées associés à la classe. Sélectionnez 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électionnez Attribuer pour confirmer.

Après avoir confirmé le changement de classe, la zone de travail sera réinitialisée et toute progression de la composition sera 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 sur la création de schéma pour un workflow 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 for cas d’utilisation uniques.

Pour plus d’informations sur les fonctionnalités de l’espace de travail Schémas, consultez la présentation de l’espace de travail Schémas.

Pour savoir comment gérer les schémas dans l’API Schema Registry, consultez le guide sur les points d’entrée des schémas.