Créer et modifier des classes dans l’interface utilisateur ui-create-and-edit
Dans Adobe Experience Platform, une classe de 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 standard ("core") Experience Data Model (XDM), dont XDM Individual Profile et XDM ExperienceEvent. Outre ces classes de base, vous pouvez également créer vos propres classes personnalisées afin de décrire des cas d’utilisation plus spécifiques à votre organisation.
Ce document présente la création, la modification et la gestion des classes personnalisées dans l’interface utilisateur de l’Experience Platform.
Conditions préalables prerequisites
Ce guide nécessite une compréhension pratique du système XDM. Reportez-vous à la présentation XDM pour une présentation du rôle de XDM dans l’écosystème Experience Platform et aux principes de base de la composition des schémas pour apprendre comment les classes contribuent aux schémas XDM.
Bien que ce guide ne soit pas obligatoire, 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 de 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.
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ée affiche les entités créées dans votre organisation.
Création d’une nouvelle classe create
Il existe deux méthodes pour créer une classe dans l’interface utilisateur de Platform : 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.
La boîte de dialogue Créer une classe s’affiche. Saisissez un nom d’affichage et une description pour votre classe et choisissez le comportement prévu de votre classe avec les boutons radio. Les classes peuvent être du type Record ou Time-series. Sélectionnez Créer 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 Créer un schéma dans l’onglet Classes de l’espace de travail Schémas.
Sélectionnez Manuel dans la boîte de dialogue Créer un schéma qui s’affiche.
Le workflow de création de schéma s’affiche. Dans la section Schéma details, sélectionnez Autre. Une liste des classes disponibles s’affiche. Sélectionnez Créer une classe.
La boîte de dialogue Créer une classe s’affiche. Saisissez un nom d’affichage et une description pour votre classe et choisissez le comportement prévu de votre classe avec les boutons radio. Les classes peuvent être du type Record ou Time-series. Sélectionnez Créer pour confirmer vos choix et revenir à l’onglet Classes.
La liste des classes s’actualise 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 la création de votre schéma.
Une fois que vous avez sélectionné une classe, la section 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 de schéma convivial 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 satisfaits, sélectionnez Terminer pour créer votre schéma.
Ajout de 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 (+) en regard du nom du schéma.
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 Attribuer à, sélectionnez Classe.
Pour obtenir des instructions spécifiques sur la configuration et l’ajout du champ à la classe, consultez le guide sur la définition des champs dans l’interface utilisateur . 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.
Si vous avez déjà créé des schémas qui utilisent cette classe, les champs nouvellement ajoutés s’affichent automatiquement dans ces schémas.
Modifier une classe (#edit-a-class)
Vous pouvez modifier une classe par le biais du workflow de schéma en éditant 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.
Si vous choisissez de créer un nouveau schéma, reportez-vous à la section sur la création d’un schéma pour plus de détails. Une fois que vous avez créé 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 la fonction Attribuer à
L’option Classe est sélectionnée ou vos mises à jour n’affectent pas la classe.
Apportez les modifications souhaitées au champ, en faisant défiler la page vers le bas dans le rail de droite pour sélectionner Appliquer pour enregistrer vos modifications.
Pour ajouter de nouveaux champs, suivez le guide add fields to a class (Ajouter des champs à une classe). Lorsque vous avez terminé, sélectionnez Enregistrer 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 pendant le processus de création initial avant qu’il ne soit enregistré. Cela doit être fait avec précaution, car les groupes de champs ne sont compatibles qu’avec certaines classes. La modification de la classe réinitialise le canevas et tous les champs que vous avez ajoutés.
Pour plus d’informations, consultez le guide sur la création et l’édition de schémas .
Étapes suivantes next-steps
Ce document explique comment créer et modifier des classes à l’aide de l’interface utilisateur de Platform. Pour plus d’informations sur les fonctionnalités de l’espace de travail Schémas, consultez la présentation des schémas de l’espace de travail.
Pour savoir comment gérer les classes à l’aide de l’API Schema Registry, consultez le guide de point de terminaison de classes.