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.
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 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 Schemas dans le volet de navigation de gauche pour ouvrir l’espace de travail Schemas, puis sélectionnez l’onglet Classes . Une liste des classes disponibles s’affiche.
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 Custom. L’option Standard affiche les entités créées par Adobe et l’option Custom affiche les entités créées au sein de votre organisation.
Création d’une nouvelle classe create
Il existe deux méthodes de création d’une classe dans l’interface utilisateur d’Experience Platform, par Create class ou Create schema.
Créer une classe
Sélectionnez Create class dans l’onglet Classes de l’espace de travail Schemas.
La boîte de dialogue Create class s’affiche. Saisissez un Display name 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 Record ou Time-series. Sélectionnez Create pour confirmer vos choix et revenir à l’onglet Classes .
La classe que vous avez créée est disponible et répertoriée dans la vue Classes.
Créer un schéma
Vous pouvez également créer une classe en créant manuellement un schéma. Sélectionnez Create schema dans l’onglet Classes de l’espace de travail Schemas.
Sélectionnez Manual dans la boîte de dialogue Create a schema qui s’affiche.
Le workflow de création de schéma s’affiche. Dans la section Schema details, sélectionnez Other. Une liste des classes disponibles s’affiche. Sélectionnez Create class.
La boîte de dialogue Create class s’affiche. Saisissez un Display name 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 Record ou Time-series. Sélectionnez Create pour confirmer vos choix et revenir à l’onglet Classes .
La liste des classes est actualisée dans la section Schema details et la classe que vous venez de créer est automatiquement sélectionnée. Sélectionnez Next pour continuer à créer votre schéma.
Après avoir sélectionné une classe, la section Name and review 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 Schema display name 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 Finish pour créer votre schéma.
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.
Un espace réservé Untitled Field apparaît 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 Assign to, sélectionnez Class.
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 Save pour enregistrer le schéma et la classe.
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
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 Browse de l’espace de travail Schemas, sélectionnez une classe ou un Create a schema existant.
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 de la Assign to
l’option Class est sélectionnée ou vos mises à jour n’affectent pas la classe.
Apportez les modifications souhaitées au champ, en faisant défiler le rail de droite vers le bas pour sélectionner Apply enregistrer vos modifications.
Pour ajouter de nouveaux champs, suivez le guide ajouter des champs à une classe. Lorsque vous avez terminé, sélectionnez Save pour enregistrer le schéma et la classe.
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 Schemas, consultez la présentation de l’espace de travail Schemas.
Pour savoir comment gérer des classes à l’aide de l’API Schema Registry, consultez le guide de point d’entrée classes.