Créer et modifier les schémas dans l’interface utilisateur

Dernière mise à jour : 2024-02-07
  • Rubriques :
  • Schemas
    Afficher plus sur ce sujet
  • Créé pour :
  • Developer
    User
    Admin
    Leader

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.

IMPORTANT

Les schémas XDM sont extrêmement personnalisables. Par conséquent, les étapes de création d’un schéma peuvent varier en fonction du type de données que vous souhaitez que le schéma capture. Par conséquent, ce document couvre uniquement les interactions de base que vous pouvez effectuer avec les schémas dans l’interface utilisateur et exclut les étapes associées telles que la personnalisation des classes, des groupes de champs de schéma, des types de données et des champs.

Pour une visite complète du processus de création de schéma, suivez le tutoriel sur la création de schéma pour créer un schéma d’exemple complet et vous familiariser avec les nombreuses fonctionnalités de la variable Schema Editor.

Conditions préalables

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

REMARQUE

Cette section explique comment créer manuellement un nouveau schéma dans l’interface utilisateur. Si vous ingérez des données CSV dans Platform, vous pouvez choisir de mapper ces données à un schéma XDM créé par des recommandations générées par l’IA (actuellement en version bêta) sans avoir à créer manuellement le schéma.

Dans le Schémas espace de travail, sélectionnez Créer un schéma dans le coin supérieur droit.

L’espace de travail des schémas avec Création d’un schéma surlignée.

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.

La variable Créer un schéma workflow avec les trois options de classe et Suivant surlignée.

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 Nom et révision de la Créer un schéma avec la méthode Nom d’affichage du schéma, Description, et Terminer surlignée.

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.

L’onglet Parcourir de l’espace de travail Schémas affichant le schéma que vous avez créé récemment.

Modifier un schéma existant

REMARQUE

Une fois qu’un schéma a été enregistré et utilisé dans l’ingestion de données, seules des modifications additifs peuvent lui être apportées. Voir règles d’évolution des schémas pour plus d’informations.

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.

Espace de travail du schéma avec un schéma en surbrillance.

CONSEIL

Vous pouvez utiliser les fonctionnalités de recherche et de filtrage de l’espace de travail pour faciliter la recherche du schéma. Consultez le guide sur la exploration des ressources XDM pour plus d’informations.

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

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é.

L’éditeur de schémas avec le bouton Plus en surbrillance et les options de liste déroulante s’affichent.

Bascule du nom d’affichage

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.

REMARQUE

Le changement des noms de champ en noms d’affichage est purement cosmétique et ne modifie aucune ressource en aval.

Éditeur de schémas avec Afficher les noms d’affichage des champs surlignée.

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

REMARQUE

Cette section explique comment ajouter des groupes de champs existants à un schéma. Si vous souhaitez créer un groupe de champs personnalisé, consultez le guide sur création et modification de groupes de champs au lieu de .

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.

L’éditeur de schémas avec la méthode Ajouter de la Groupes de champs en surbrillance.

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.

La variable Ajouter des groupes de champs mise en surbrillance de la boîte de dialogue avec Popularité en surbrillance.

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.

La variable Ajouter des groupes de champs mise en surbrillance de la boîte de dialogue avec Secteur industriel les filtres et les Secteur industriel en surbrillance.

REMARQUE

Pour plus d’informations sur les bonnes pratiques relatives à la modélisation de données spécifique au secteur dans XDM, consultez la documentation sur modèles de données du secteur.

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.

La variable Ajouter des groupes de champs avec la boîte de dialogue Champs standard fonction de recherche mise en surbrillance.

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.

La variable Ajouter des groupes de champs avec la fonction de sélection de case à cocher mise en surbrillance.

CONSEIL

Pour tout groupe de champs répertorié, vous pouvez pointer ou vous concentrer sur l’icône d’informations () pour afficher une brève description du type de données que le groupe de champs capture. Vous pouvez également sélectionner l’icône d’aperçu () pour afficher la structure des champs que le groupe de champs fournit avant de décider de l’ajouter au schéma.

Une fois les groupes de champs sélectionnés, sélectionnez Ajouter des groupes de champs pour les ajouter au schéma.

La variable Ajouter des groupes de champs Boîte de dialogue avec les groupes de champs sélectionnés et Ajouter des groupes de champs surlignée.

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

La variable Schema Editor avec un exemple de schéma affiché.

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

Après avoir ajouté un groupe de champs à un schéma, vous pouvez supprimer tous les champs dont vous n’avez pas besoin.

REMARQUE

La suppression de champs d’un groupe de champs affecte uniquement le schéma en cours de traitement et n’affecte pas le groupe de champs lui-même. Si vous supprimez des champs dans un schéma, ces champs sont toujours disponibles dans tous les autres schémas qui utilisent le même groupe de champs.

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.

La variable Schema Editor avec Supprimer surlignée. Cette action supprime un seul champ.

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.

La variable Schema Editor avec Gestion des champs associés surlignée.

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.

La variable Gestion des champs associés Boîte de dialogue contenant les champs sélectionnés et Confirmer surlignée.

Le canevas réapparaît avec uniquement les champs sélectionnés présents dans la structure du schéma.

Champs ajoutés

Ajout de champs personnalisés aux groupes de champs

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

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 .

IMPORTANT

Même si l’éditeur de schémas permet fonctionnellement d’ajouter des champs individuels directement à un schéma, cela ne change pas le fait que tous les champs d’un schéma XDM doivent être fournis par sa classe ou un groupe de champs compatible avec cette classe. Comme les sections ci-dessous l’expliquent, tous les champs individuels sont toujours associés à une classe ou à un groupe de champs comme étape clé lorsqu’ils sont ajoutés à un schéma.

Ajouter des champs standard

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.

Espace réservé du 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.

Champs standard recommandés

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 (Icône Aperçu) en regard 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 (Icône Plus).

Ajouter un champ standard

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.

Champ standard ajouté

Ajouter des champ personnalisés

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.

Champ personnalisé racine

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).

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é

REMARQUE

Cette section décrit uniquement comment affecter le champ à un groupe de champs personnalisé. Si vous souhaitez étendre un groupe de champs standard avec le nouveau champ personnalisé, reportez-vous à la section sur ajout de champs personnalisés aux groupes de champs standard.

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.

Sélectionner un groupe de champs

AVERTISSEMENT

Si vous sélectionnez un groupe de champs personnalisé existant, tout autre schéma qui l’emploie héritera également du nouveau champ ajouté après avoir enregistré vos modifications. Pour cette raison, sélectionnez un groupe de champs existant uniquement si vous souhaitez ce type de propagation. Dans le cas contraire, vous devez choisir de créer un groupe de champs personnalisé.

Après avoir sélectionné le groupe de champs dans la liste, sélectionnez Appliquer.

Appliquer le champ

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.

Identifiant du client

REMARQUE

Les autres champs fournis par le groupe de champs personnalisé sélectionné sont supprimés du schéma par défaut. Si vous souhaitez ajouter certains de ces champs au schéma, sélectionnez un champ appartenant au groupe, puis sélectionnez Gestion des champs associés dans le rail de droite.

Affectation du champ à une classe personnalisée

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.

La variable Classe l’option étant sélectionnée pour la nouvelle affectation de champ.

Poursuivez la configuration du champ selon vos besoins et sélectionnez Appliquer lorsque vous avez terminé.

Appliquer sélectionné pour le nouveau champ.

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.

Le nouveau champ appliqué à la structure de la classe personnalisée, représenté dans la zone de travail.

Ajouter des champs personnalisés à la structure des groupes de champs standard

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.

AVERTISSEMENT

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 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é Reconnaissance, les ressources répertoriées sont converties en groupes de champs personnalisés.

Boîte de dialogue de confirmation pour la conversion des groupes de champs standard

Pour commencer, sélectionnez le plus (+) en regard de la racine de l’objet fourni par le groupe de champs standard.

Ajouter un champ à un objet 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.

Confirmer la conversion d’un groupe de champs

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.

Champ ajouté à l’objet standard

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.

Champ ajouté à l’objet standard

Activer un schéma pour le profil client en temps réel

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.

IMPORTANT

Pour activer un schéma pour Profile, un champ d’identité principal doit être défini pour celui-ci. Consultez le guide sur la définition des champs d’identité pour plus d’informations.

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é.

IMPORTANT

Comme le schéma n’est pas encore enregistré, il s’agit d’un point de non-retour si vous changez d’avis concernant la possibilité de laisser le schéma participer à Real-Time Customer Profile : une fois que vous avez enregistré un schéma activé, il ne peut plus être désactivé. Sélectionnez la variable Profil basculez à nouveau pour désactiver le schéma.

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

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.

REMARQUE

Gardez à l’esprit que les noms d’affichage des champs appartenant à des classes standard ou à des groupes de champs ne peuvent être modifiés que dans le contexte d’un schéma spécifique. En d’autres termes, la modification du nom d’affichage d’un champ standard dans un schéma n’affecte pas les autres schémas qui utilisent la même classe ou le même groupe de champs associé.

Une fois que vous avez apporté des modifications aux noms d’affichage des champs d’un schéma, ces modifications sont immédiatement répercutées dans tous les jeux de données existants basés sur ce schéma.

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

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é.

AVERTISSEMENT

La réattribution de la classe d’un schéma doit être effectuée avec une extrême prudence. Les groupes de champs ne sont compatibles qu’avec certaines classes. Par conséquent, la modification de la classe réinitialisera la zone de travail et tous les champs que vous avez ajoutés.

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

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.

Sur cette page