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), y compris 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.

Onglet Classes de lespace de travail Schémas avec Standard et Personnalisé surligné.

TIP
Utilisez les fonctionnalités de recherche pour filtrer ou trouver 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 de Platform. Dans n’importe quel onglet de l’espace de travail Schémas, sélectionnez Créer un schéma ou sélectionnez Classes dans l’onglet Créer une classe.

L’onglet Classes de l’espace de travail Schémas avec Créer un schéma et Créer une classe surlignée

Si vous 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, d’une série d’enregistrements ou d’une 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 surlignée.

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

Onglet Classes de lespace de travail Schémas avec la classe récemment créée mise en surbrillance.

Création ou modification d’une classe create-or-edit

Si vous sélectionnez également Créer un schéma, le workflow Créer un schéma s’affiche. Dans la section Schéma details, sélectionnez Autre. Une liste des classes disponibles s’affiche. À partir de là, vous pouvez parcourir et filtrer les classes préexistantes sur lesquelles baser votre nouvelle classe.

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 de schémas individuels. Pour plus d’informations, reportez-vous à 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, voir les règles de l’évolution du schéma .

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

Sélectionnez un bouton radio pour filtrer les classes selon qu’elles sont personnalisées ou standard. Vous pouvez également filtrer les résultats disponibles en fonction de leur secteur d’activité ou rechercher une classe spécifique à l’aide du champ de recherche.

Le workflow Créer un schéma avec la barre de recherche, Personnalisé et Industries surlignée.

Pour vous aider à décider de la classe appropriée, il y a des informations ( Une icône d’information. ) et aperçu ( Icône Aperçu. ) pour chaque classe. L’icône d’information ouvre une boîte de dialogue qui fournit une description de la classe et du secteur auquel elle est associée. L’icône d’aperçu ouvre une boîte de dialogue d’aperçu pour la classe contenant un schéma et ses propriétés.

Aperçu de la classe sélectionnée avec le schéma de schéma et les propriétés de classe mises en surbrillance.

Sélectionnez une ligne pour choisir une classe, puis cliquez sur Suivant pour confirmer votre choix.

Le workflow Créer un schéma avec une classe sélectionnée dans la table des classes disponibles et Suivant surligné.

La section Nom et révision du workflow s’affiche. Dans cette section, 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 afin que vous puissiez examiner et vérifier la classe et la structure de schéma sélectionnés.

Saisissez un nom court, descriptif, unique et convivial pour la classe dans le champ de texte Nom d’affichage du schéma . Saisissez ensuite une description appropriée pour identifier le comportement des données que le schéma définit. Une fois la structure de votre schéma revue et vos paramètres satisfaits, 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, la Description et la Terminer mise en surbrillance.

L’éditeur de schémas s’affiche, avec la structure du schéma affichée dans la zone de travail. Vous pouvez maintenant commencer à ajouter des champs à la classe.

Éditeur de schéma avec la structure du schéma affichée dans la zone de travail.

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.

IMPORTANT
Lors de la création d’un schéma qui met en oeuvre 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. La classe que vous avez définie étant nouvelle, aucun groupe de champs compatible n’est répertorié dans la boîte de dialogue Ajouter un groupe de champs . À la place, vous devrez 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 utilisables.

L’é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 examiner les 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 envisager de 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 Attribuer à, sélectionnez Classe.

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

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.

Le nouveau schéma créé sur la zone de travail de l’éditeur de schémas, avec Enregistrer en surbrillance.

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.

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.

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