Créer et modifier des classes dans l’interface utilisateur ui-create-and-edit

Dans Adobe Experience Platform, la classe d’un schéma définit les aspects comportementaux des données que le schéma contiendra (enregistrement ou série temporelle). En outre, les classes décrivent le plus petit de nombres de propriétés communes que tous les schémas basés sur cette classe doivent inclure et fournir une manière de fusionner plusieurs jeux de données compatibles.

Adobe fournit plusieurs classes de modèle de données d’expérience (XDM) standard (« core »), notamment XDM Individual Profile et XDM ExperienceEvent. Outre ces classes principales, vous pouvez également créer vos propres classes personnalisées pour décrire des cas d’utilisation plus spécifiques pour votre organisation.

Ce document présente la création, la modification et la gestion de classes personnalisées dans l’interface utilisateur d’Experience Platform.

Prérequis 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 de schémas afin de découvrir comment les classes contribuent aux schémas XDM.

Bien que cela ne soit pas obligatoire pour ce guide, il est recommandé de suivre également le tutoriel sur la composition d’un schéma dans l’interface utilisateur pour vous familiariser avec les différentes fonctionnalités de l’éditeur de schémas.

Commencer getting-started

Dans l’interface utilisateur d’Experience Platform, sélectionnez Schémas dans le volet de navigation de gauche pour ouvrir l’espace de travail Schémas, puis sélectionnez l’onglet Classes. Une liste des classes disponibles s’affiche.

Le des classes dans l’onglet Classes de l’espace de travail Schémas Classes et Schémas mis en surbrillance.

Classes de filtre filter

La liste des classes est automatiquement filtrée en fonction de leur mode de création. Le paramètre par défaut affiche les classes définies par Adobe. Vous pouvez également filtrer la liste pour afficher celles créées par votre organisation. Sélectionnez le bouton radio pour choisir entre les options Standard et Personnalisé. L’option Standard affiche les entités créées par Adobe et l’option Personnalisé affiche les entités créées au sein de votre organisation.

L’onglet Classes de l’espace de travail Schémas avec Standard et Personnalisé mis en surbrillance.

TIP
Utilisez les fonctionnalités de recherche pour filtrer ou rechercher une classe en fonction de son nom. Pour plus d’informations, consultez le guide sur l’exploration des ressources XDM.

Création d’une nouvelle classe create

Il existe deux méthodes pour créer une classe dans l’interface utilisateur d’Experience Platform, via Créer une classe ou Créer un schéma.

Créer une classe

Sélectionnez Créer une classe dans l’onglet Classes de l’espace de travail Schémas.

Onglet Classes de l’espace de travail Schémas avec Créer une classe en surbrillance

La boîte de dialogue Créer une classe s’affiche. Saisissez un Nom d’affichage et un Description pour votre classe, puis choisissez le comportement prévu de votre classe à l’aide des boutons radio. Les classes peuvent être du type Enregistrement ou Série temporelle. Sélectionnez Créer pour confirmer vos choix et revenir à l’onglet Classes.

La boîte de dialogue Créer une classe avec Créer mis en surbrillance.

La classe que vous avez créée est disponible et répertoriée dans la vue Classes.

Onglet Classes de l’espace de travail Schémas avec la classe récemment créée en surbrillance.

Créer un schéma

Vous pouvez également créer une classe en créant manuellement un schéma. Sélectionnez Créer un schéma dans l’onglet Classes de l’espace de travail Schémas.

L’onglet Classes de l’espace de travail Schémas avec Créer un schéma en surbrillance

Sélectionnez Manuel dans la boîte de dialogue Créer un schéma qui s’affiche.

NOTE
Si vous utilisez le workflow de création de schéma assistée par ML, vous pouvez charger un fichier et utiliser des algorithmes ML pour générer un schéma recommandé. Dans ce workflow de création de schéma, vous n’avez pas besoin de spécifier la classe de base pour votre schéma. Pour découvrir comment ML peut recommander une structure de schéma basée sur un fichier csv, consultez le guide création de schéma assistée par machine learning.

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

Le workflow de création de schéma s’affiche. Dans la section Détails du schéma, sélectionnez Autre. Une liste des classes disponibles s’affiche. Sélectionnez Créer une classe.

Le workflow Créer un schéma avec Autre mis en surbrillance dans la section Détails du schéma.

La boîte de dialogue Créer une classe s’affiche. Saisissez un Nom d’affichage et un Description pour votre classe, puis choisissez le comportement prévu de votre classe à l’aide des boutons radio. Les classes peuvent être du type Enregistrement ou Série temporelle. Sélectionnez Créer pour confirmer vos choix et revenir à l’onglet Classes.

La boîte de dialogue Créer une classe avec Créer mis en surbrillance.

La liste des classes est actualisée dans la section Détails du schéma et la classe que vous venez de créer est automatiquement sélectionnée. Sélectionnez Suivant pour continuer à créer votre schéma.

La section Détails du schéma avec la nouvelle classe sélectionnée et Suivant en surbrillance.

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.

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.

Ajouter des champs à une classe add-fields

Une fois que vous disposez d’un schéma qui utilise une classe personnalisée ouverte dans l’éditeur de schémas, vous pouvez commencer à ajouter des champs à la classe . Pour ajouter un nouveau champ, sélectionnez l’icône plus (+) à côté du nom du schéma.

IMPORTANT
Lors de la création d’un schéma qui implémente une classe définie par votre organisation, n’oubliez pas que les groupes de champs de schéma ne peuvent être utilisés qu’avec des classes compatibles. Comme la classe que vous avez définie est nouvelle, aucun groupe de champs compatible n’est répertorié dans la boîte de dialogue Ajouter un groupe de champs. À la place, vous devez créer de nouveaux groupes de champs à utiliser avec cette classe. La prochaine fois que vous composerez un schéma qui implémente la nouvelle classe, les groupes de champs que vous avez définis seront répertoriés et disponibles.

Éditeur de schémas avec le bouton d’ajout en surbrillance.

IMPORTANT
Gardez à l’esprit que tous les champs que vous ajoutez à une classe seront utilisés dans tous les schémas qui utilisent cette classe. Vous devez donc soigneusement réfléchir aux champs qui seront utiles dans tous les cas d’utilisation de schéma. Si vous envisagez d’ajouter un champ qui ne peut être utilisé que dans certains schémas sous cette classe, vous pouvez l’ajouter à ces schémas en créant un groupe de champs à la place.

Un espace réservé Champ sans titre s’affiche dans la zone de travail, et le rail de droite se met à jour pour afficher les commandes permettant de configurer les propriétés du champ. Sous Affecter à, sélectionnez Classe.

Champ sans titre dans la zone de travail de l’éditeur de schémas avec la propriété de champ Affecter à Classe sélectionnée et mise en surbrillance.

Consultez le guide sur la définition de champs dans l’interface utilisateur pour obtenir des instructions spécifiques sur la configuration et l’ajout du champ à la classe . Continuez à ajouter autant de champs que nécessaire à la classe. Lorsque vous avez terminé, sélectionnez Enregistrer pour enregistrer le schéma et la classe.

Schéma nouvellement créé dans la zone de travail de l’éditeur de schémas, avec l’option Enregistrer mise en surbrillance.

Si vous avez précédemment créé des schémas qui utilisent cette classe, les nouveaux champs ajoutés apparaîtront automatiquement dans ces schémas.

Modification d’une classe edit-a-class

NOTE
Seules les classes personnalisées définies par votre organisation peuvent être entièrement modifiées et personnalisées. Pour les classes de base définies par Adobe, seuls les noms d’affichage de leurs champs peuvent être modifiés dans le contexte des schémas individuels. Pour plus d’informations, consultez la section sur la modification des noms d’affichage des champs de schéma.
Une fois qu’une classe personnalisée a été enregistrée et utilisée dans l’ingestion de données, seules des modifications supplémentaires peuvent lui être apportées par la suite. Pour plus d’informations, consultez la section règles d’évolution des schémas .

Vous pouvez modifier une classe par le biais du workflow de schéma en modifiant un schéma existant qui étend la classe ou en créant manuellement un schéma. Il n’est pas possible de modifier directement une classe. Dans l’onglet Parcourir de l’espace de travail Schémas, sélectionnez une classe existante ou Créer un schéma.

L’éditeur de schémas avec une classe existante et l’option Créer un schéma mise en surbrillance.

Si vous choisissez de créer un schéma, consultez la section sur la création d’un schéma pour plus d’informations. Une fois que vous avez terminé de créer le schéma (ou après avoir sélectionné un schéma existant), l’éditeur de schémas s’affiche. Pour mettre à jour un champ de classe existant, sélectionnez le champ dans la structure du schéma. Les informations du champ s’affichent dans le rail de droite. Assurez-vous que l’Affecter à
L’option Classe est sélectionnée ou vos mises à jour n’affectent pas la classe.

L’éditeur de schémas avec un champ sélectionné et mis en surbrillance, et le rail de droite exposé, mettant en surbrillance Affecter à.

Apportez les modifications souhaitées au champ, en faisant défiler le rail de droite vers le bas pour sélectionner Appliquer et enregistrer vos modifications.

IMPORTANT
Toutes les mises à jour que vous apportez aux champs seront appliquées dans tous les schémas qui utilisent cette classe, conformément aux règles d’évolution des schémas.

Éditeur de schémas avec un champ sélectionné et le rail de droite exposé, avec la mention Appliquer.

Pour ajouter de nouveaux champs, suivez le guide ajouter des champs à une classe. Lorsque vous avez terminé, sélectionnez Enregistrer pour enregistrer le schéma et la classe.

Éditeur de schémas avec l’option Enregistrer mise en surbrillance.

Modification de la classe d’un schéma schema

Vous pouvez modifier la classe du schéma à tout moment au cours du processus de création initiale, avant qu’il ne soit enregistré. Toutefois, cette opération doit être effectuée avec précaution, car les groupes de champs ne sont compatibles qu’avec certaines classes. La modification de la classe réinitialise la zone de travail et tous les champs que vous avez ajoutés.
Pour plus d’informations, consultez le guide sur la création et modification de schémas.

Étapes suivantes next-steps

Ce document explique comment créer et modifier des classes à l’aide de l’interface utilisateur d’Experience Platform. 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 des classes à l’aide de l’API Schema Registry, consultez le guide de point d’entrée classes.

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07