Ouvrez l’espace de travail des schémas
L’espace de travail des schémas dans l’interface utilisateur de Experience Platform offre une visualisation de la Schema Library, ce qui vous permet d’afficher et de gérer les schémas disponibles pour votre organisation. L’espace de travail comprend également l’Schema Editor, la zone de travail sur laquelle vous allez composer un schéma tout au long de ce tutoriel.
Connectez-vous à Experience Platform et sélectionnez Schémas dans le volet de navigation de gauche pour ouvrir l’espace de travail des schémas. L’onglet Parcourir affiche une liste des schémas (une représentation du Schema Library) que vous pouvez afficher et personnaliser. La liste comprend le nom, le type, la classe et le comportement (enregistrement ou série chronologique) sur lesquels repose le schéma, ainsi que la date et l’heure de la dernière modification du schéma.
Reportez-vous au guide sur l’exploration des ressources XDM existantes dans l’interface utilisateur pour plus d’informations.
Création et attribution d’un nom à un schéma
Pour commencer à composer un schéma, sélectionnez Créer un schéma dans le coin supérieur droit de l’espace de travail Schémas.
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 création manuelle ou assistée par machine learning de schéma
Pour découvrir comment utiliser un algorithme ML afin de recommander une structure de schéma basée sur un fichier chargé, 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 .
Choisir une classe de base
Le workflow Créer un schéma s’affiche. Choisissez ensuite une classe de base pour le schéma. Vous pouvez choisir entre les classes principales XDM Individual Profile et XDM ExperienceEvent ou Other si ces classes ne répondent pas à vos besoins. L’option Autres classes vous permet de créer une classe ou de choisir parmi d’autres classes préexistantes.
Consultez la documentation Profil individuel XDM et XDM ExperienceEvent pour plus d’informations sur ces classes. Pour les besoins de ce tutoriel, sélectionnez Profil individuel XDM suivi de Suivant.
Nom et révision
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. Plusieurs éléments importants doivent être pris en compte lors du choix d’un nom pour votre schéma :
- Le nom d’un schéma doit être court et descriptif afin qu’il puisse être facilement retrouvé par la suite.
- Le nom d’un schéma doit être unique, ce qui signifie qu’il doit également être suffisamment précis pour ne pas être réutilisé à l’avenir. Par exemple, si votre organisation dispose de programmes de fidélité distincts pour différentes marques, nous vous conseillons de nommer votre schéma « Brand A Loyalty Members » pour faciliter la distinction avec d’autres schémas relatifs à la fidélité que vous pourriez définir ultérieurement.
- Vous pouvez également utiliser la description du schéma pour fournir toute information contextuelle supplémentaire le concernant.
Ce tutoriel décrit la composition d’un schéma pour ingérer les données relatives aux membres d’un programme de fidélité, c’est pourquoi le schéma est nommé « Loyalty Members ».
La structure de base du schéma (fournie par la classe ) s’affiche dans la zone de travail pour que vous puissiez 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.
Composer le schéma
L’Schema Editor apparaît. C’est la zone de travail sur laquelle vous allez composer votre schéma. Le schéma doté d’un titre est automatiquement créé dans la section Structure de la zone de travail lorsque vous accédez à l’éditeur, avec les champs standard inclus dans la classe de base que vous avez sélectionnée. La classe affectée pour le schéma est également répertoriée sous Classe dans la section Composition.
Ajouter un groupe de champs
Vous pouvez maintenant commencer à ajouter des champs à votre schéma grâce à l’ajout de groupes de schémas. Un groupe de champs est un groupe d’un ou de plusieurs champs souvent utilisés conjointement pour décrire un concept particulier. Ce tutoriel utilise des groupes de champs pour décrire les membres du programme de fidélité et recueillir des informations clés telles que le nom, la date d’anniversaire, le numéro de téléphone, l’adresse, etc.
Pour ajouter un groupe de champs, cliquez sur Ajouter dans la sous-section Groupes de champs.
Une nouvelle boîte de dialogue apparait. Elle présente la liste des groupes de champs disponibles. Chaque groupe de champs est uniquement destiné à une utilisation avec une classe spécifique. Par conséquent, la boîte de dialogue ne répertorie que les groupes de champs compatibles avec la classe que vous avez sélectionnée (dans ce cas, la classe XDM Individual Profile). Si vous utilisez une classe XDM standard, la liste des groupes de champs sera triée intelligemment en fonction de la popularité de l’utilisation.
Vous pouvez utiliser l’un des filtres dans le rail de gauche pour limiter la liste des groupes de champs standard à des secteurs comme la vente au détail, les services financiers et les services de santé.
Lorsqu’un groupe de champs est sélectionné dans la liste, il s’affiche dans le rail de droite. Si vous le souhaitez, vous pouvez sélectionner plusieurs groupes de champs en les ajoutant chacun à la liste dans le rail de droite avant de confirmer la sélection. En outre, l’icône qui s’affiche sur le côté droit du groupe de champs sélectionné vous permet de prévisualiser la structure des champs qu’il présente.
Lors de la prévisualisation d’un groupe de champs, une description détaillée du schéma du groupe de champs est fournie dans le rail droit. Vous pouvez également parcourir les champs du groupe de champs dans la zone de travail. Lorsque vous sélectionnez différents champs, le rail de droite se met à jour pour afficher les détails du champ en question. Sélectionnez Retour lorsque vous avez terminé la prévisualisation pour retourner à la boîte de dialogue de sélection du groupe de champs.
Pour ce tutoriel, sélectionnez le groupe de champs Détails démographiques, puis cliquez sur Ajouter un groupe de champs.
La zone de travail du schéma réapparaît. La section Groupes de champs répertorie désormais« Détails démographiques » et la section Structure inclut les champs fournis par le groupe de champs. Vous pouvez sélectionner le nom du groupe de champs sous la section Groupes de champs pour mettre en surbrillance les champs spécifiques qu’il fournit dans la zone de travail.


Ce groupe de champs fournit plusieurs champs sous le nom de niveau supérieur person
avec le type de données « Personne ». Ce groupe de champs décrit les informations sur un individu, notamment son nom, sa date de naissance et son genre.
Notez que le champ name
possède un type de données « Nom complet », ce qui signifie qu’il décrit lui aussi un concept commun et contient des sous-champs liés au nom, tels que le prénom, le nom de famille, le titre de courtoisie et le suffixe.
Sélectionnez les différents champs dans la zone de travail pour afficher les champs supplémentaires contribuant à la structure du schéma.
Ajouter d’autres groupes de champs
Vous pouvez maintenant répéter les mêmes étapes pour ajouter un autre groupe de champs. Lorsque la boîte de dialogue Ajouter un groupe de champs s’affiche cette fois-ci, vous remarquerez que les « Details démographiques » sont grisés et que la case à cocher adjacente ne peut pas être sélectionnée. Cela vous évite de dupliquer accidentellement des groupes de champs que vous avez déjà inclus dans le schéma actuel.
Pour ce tutoriel, sélectionnez les groupes de champs standard Coordonnées personnelles et Détails de fidélité dans la liste, puis sélectionnez Ajouter des groupes de champs pour les ajouter au schéma.
La zone de travail réapparaît avec les groupes de champs ajoutés sous Groupes de champs dans la section Composition et leurs champs composites ajoutés à la structure du schéma.
Définir un groupe de champs personnalisé
Le schéma Membres du programme de fidélité est destiné à capturer des données relatives aux membres d’un programme de fidélité. Le groupe de champs standard Détails de fidélité que vous avez ajouté au schéma fournit la plupart de ces informations, notamment le type de programme, les points, la date d’inscription, etc.
Cependant, il peut arriver que vous souhaitiez inclure d’autres champs personnalisés non couverts par des groupes de champs standard afin d’atteindre vos cas d’utilisation. Dans le cas de l’ajout de champs de fidélité personnalisés, vous disposez de deux options :
- Créer un groupe de champs personnalisé pour capturer ces champs. Il s’agit de la méthode qui sera abordée dans ce tutoriel.
- Étendre le groupe de champs standard Détails de fidélité avec des champs personnalisés. Cela entraîne la conversion de Détails de fidélité en un groupe de champs personnalisés et le groupe de champs standard d’origine ne sera plus disponible. Consultez le Guide de l’interface utilisateur des Schémas pour plus d’informations sur l’ajout de champs personnalisés à la structure des groupes de champs standard.
Pour créer un groupe de champs, sélectionnez Ajouter dans la sous-section Groupes de champs comme avant, mais cette fois, sélectionnez Créer un nouveau groupe de champs dans la partie supérieure de la boîte de dialogue qui s’affiche. Vous êtes alors invité à fournir un nom d’affichage et une description pour le nouveau groupe de champs. Pour ce tutoriel, nommez le nouveau groupe de champs « Custom Loyalty Details », puis sélectionnez Ajouter des groupes de champs.
« Custom Loyalty Details » devrait maintenant apparaître sous Groupes de champs sur le côté gauche de la zone de travail, mais aucun champ n’y est encore associé et, par conséquent, aucun nouveau champ n’apparaît sous Structure.
Ajouter des champs au groupe de champs
Maintenant que vous avez créé le groupe de champs « Custom Loyalty Details », il est temps de définir les champs que le groupe de champs va ajouter au schéma.
Pour commencer, sélectionnez l’icône plus (+) située à côté du nom du schéma dans la zone de travail.
Un espace reservé « Champ sans titre » apparaît dans la zone de travail, et le rail de droite se met à jour pour afficher les options de configuration du champ.
Dans ce scénario, le schéma doit comporter un champ de type objet qui décrit en détail le niveau de fidélité actuel de la personne. À l’aide des commandes du rail de droite, commencez à créer un champ loyaltyTier
de type « Objet » qui sera utilisé pour contenir vos champs associés.
Sous Attribuer à, vous devez sélectionner un groupe de champs auquel affecter le champ. N’oubliez pas que tous les champs de schéma appartiennent à une classe ou à un groupe de champs. Comme ce schéma utilise une classe standard, votre seule option est de sélectionner un groupe de champs. Commencez à saisir le nom « Custom Loyalty Details », puis sélectionnez le groupe de champs dans la liste.
Lorsque vous avez terminé, sélectionnez Appliquer.
Les modifications sont appliquées et le nouvel objet « loyaltyTier
» s’affiche. Puisqu’il s’agit d’un champ personnalisé, il est automatiquement imbriqué dans un espace de noms d’objet associé à l’identifiant du client de votre organisation, précédé d’un trait de soulignement (_tenantId
dans cet exemple).
Sélectionnez l’icône plus (+) à côté de l’objet loyaltyTier
pour commencer à ajouter des sous-champs. Un espace reservé au nouveau champ apparaît et la section Propriétés du champ est visible sur le côté droit de la zone de travail.
Chaque champ nécessite les informations suivantes :
- Nom du champ : le nom du champ, écrit de façon à ce que les mots soient liés sans espace ni ponctuation, et en mettant en capitale la première lettre de chaque mot (Camel Case). Aucune espace n’est autorisé. Il s’agit du nom utilisé pour référencer le champ dans le code et dans d’autres applications en aval.
- Exemple : loyaltyLevel
- Nom d’affichage : le nom du champ, écrit avec la première lettre de chaque mot important en majuscule (Title Case). Il s’agit du nom qui s’affiche dans la zone de travail lors de l’affichage ou de la modification du schéma.
- Exemple : Loyalty Level
- Type : le type de données du champ. Cela inclut les types scalaires de base et tous les types de données définis dans Schema Registry. Exemples : chaîne, entier, booléen, personne, adresse, numéro de téléphone, etc.
- Description : une description facultative du champ doit être incluse avec un maximum de 200 caractères.
Le premier champ de l’objet loyaltyTier
sera une chaîne de caractères appelée id
, représentant l’ID du niveau actuel du membre du programme de fidélité. L’ID de niveau sera unique pour chaque membre du programme de fidélité, car cette entreprise définit différents seuils de point de niveau de fidélité pour chaque client en fonction de différents facteurs. Définissez le type du nouveau champ sur « Chaîne » et la section Propriétés du champ se remplit de plusieurs options pour l’application de contraintes, y compris la valeur par défaut, le format et la longueur maximale. Pour en savoir plus, consultez la documentation sur les bonnes pratiques relatives aux champs de validation des données.
Comme id
est une chaîne à structure libre générée de manière aléatoire, aucune autre contrainte n’est nécessaire. Sélectionnez Appliquer pour appliquer vos modifications.