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.

Nombre de 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é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 : 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.

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

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

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é 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 de votre schéma. Pour savoir comment ML peut recommander une structure de schéma basée sur un fichier csv, consultez le guide de création de schémas assisté par l’apprentissage automatique.

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

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.

Le workflow Créer un schéma avec Autre surligné 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 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 boîte de dialogue Créer une classe avec Créer surlignée.

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.

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

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.

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.

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

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

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.

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

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.

L’éditeur de schémas avec un champ sélectionné et mis en surbrillance, ainsi que le rail de droite affiché, surlignant Attribuer à.

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.

IMPORTANT
Toutes les mises à jour apportées aux champs seront appliquées à tous les schémas qui utilisent cette classe, en suivant les règles de l’évolution des schémas.

Éditeur de schéma avec un champ sélectionné et le rail droit exposé, surlignant Appliquer.

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.

L’éditeur de schémas avec Enregistrer surligné.

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