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.

Onglet Schémas de l’espace de travail Parcourir avec Créer un schéma en surbrillance.

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.

La boîte de dialogue Créer un schéma avec les options de workflow et sélectionnez en surbrillance.

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.

Le workflow Créer un schéma avec les options Profil individuel XDM et Suivant en surbrillance.

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.

La section Nom et révision du workflow Créer un schéma avec le Nom d’affichage du schéma, Description et Terminer en surbrillance.

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.

NOTE
Vous pouvez mettre à jour le nom d’affichage et la description facultative du schéma à partir de la barre latérale Propriétés du schéma. Une fois qu’un nouveau nom est saisi, la zone de travail se met automatiquement à jour pour refléter le nouveau nom du schéma.

L’éditeur de schémas avec la classe de base et le diagramme de schéma mis en surbrillance.

NOTE
Vous pouvez modifier la classe d’un schéma à tout moment au cours du processus de composition initial avant que le schéma ne soit enregistré, mais cela doit être fait avec la plus grande 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.

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.

Éditeur de schémas avec le bouton Ajouter des groupes de champs en surbrillance.

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.

Boîte de dialogue Ajouter des groupes de champs.

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

La boîte de dialogue Ajouter des groupes de champs avec les groupes de champs du secteur mis en surbrillance.

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.

La boîte de dialogue Ajouter des groupes de champs avec l’icône d’aperçu du groupe de champs sélectionné en surbrillance.

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.

Boîte de dialogue Prévisualiser le groupe de champs avec le groupe de champs Détails démographiques prévisualisé.

Pour ce tutoriel, sélectionnez le groupe de champs Détails démographiques, puis cliquez sur Ajouter un groupe de champs.

La boîte de dialogue Ajouter des groupes de champs avec le groupe de champs Détails démographiques sélectionné et Ajouter des groupes de champs mis en surbrillance.

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.

Éditeur de schémas avec les groupes de champs Détails démographiques mis en surbrillance.

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 (icône de cadenas A). . 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.
Éditeur de schémas avec l’icône de cadenas mise en surbrillance

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.

NOTE
N’oubliez pas que les champs peuvent utiliser des types scalaires (chaîne, entier, tableau ou date), ainsi que tout type de données (un groupe de champs représentant un concept commun) défini dans Schema Registry.

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 boîte de dialogue Ajouter des groupes de champs avec deux nouveaux groupes de champs sélectionnés et Ajouter des groupes de champs en surbrillance.

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.

L’éditeur de schémas avec la nouvelle structure de schéma composite mise en surbrillance.

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 :

  1. 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.
  2. É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.

La boîte de dialogue Ajouter des groupes de champs avec Créer un groupe de champs, Nom d’affichage et Description en surbrillance.

NOTE
Comme pour les noms de classe, le nom du groupe de champs doit être court et simple, décrivant ce que le groupe de champs va apporter au schéma. Ces noms sont également uniques. Vous ne pourrez donc pas réutiliser le nom et devrez donc veiller à ce qu’il soit suffisamment spécifique.

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

Éditeur de schémas avec l’icône plus mise en surbrillance.

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.

L’éditeur de schémas avec un Champ sans titre et le schéma Propriétés du champ mis en surbrillance.

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.

L’éditeur de schémas avec l’objet Niveau de fidélité ajouté au schéma Propriétés du champ mis en surbrillance.

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

L’éditeur de schémas avec l’identifiant du client et le niveau de fidélité mis en surbrillance dans le diagramme de schéma.

NOTE
La présence de l’ID du client indique que les champs que vous ajoutez sont contenus dans l’espace de noms de votre organisation.
En d’autres termes, les champs que vous ajoutez sont propres à votre organisation et vont être enregistrés dans Schema Registry dans une zone spécifique accessible uniquement par votre organisation. Les champs que vous définissez doivent toujours être ajoutés à votre espace de noms client pour empêcher les conflits avec des noms provenant d’autres classes, groupes de champs, types de données et champs standard.

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.

L’éditeur de schémas avec l’identifiant du client et le nouveau sous-champ ajouté au niveau de fidélité dans le diagramme de schéma.

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.

L’éditeur de schémas avec les valeurs de propriété du champ du nouveau champ d’identifiant mises en surbrillance.

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.

Éditeur de schémas avec le champ d’identifiant ajouté et mis en surbrillance.