Création et modification de classes dans l’interface utilisateur

Dans le modèle de données d’expérience (XDM), les classes définissent les aspects comportementaux des données qu’un 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 XDM standard ("core"), y compris XDM Individual Profile et XDM ExperienceEvent. Outre ces classes principales, vous pouvez créer vos propres classes personnalisées afin de décrire des cas d’utilisation plus spécifiques à votre organisation.

Ce document présente comment créer, modifier et gérer des classes personnalisées dans l’interface utilisateur de Adobe Experience Platform.

Conditions préalables

Ce guide nécessite une compréhension pratique du système XDM. Reportez-vous à la section Présentation de XDM pour une présentation du rôle de XDM dans l’écosystème Experience Platform, et de principes de base de la composition des schémas pour découvrir 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 composition d’un schéma dans l’interface utilisateur pour vous familiariser avec les différentes capacités de la fonction Schema Editor.

Création d’une nouvelle classe

Dans le Schémas espace de travail, sélectionnez Créer un schéma, puis sélectionnez Parcourir dans la liste déroulante.

Une boîte de dialogue s’affiche, vous permettant de sélectionner une classe dans la liste des classes disponibles. Dans la partie supérieure de la boîte de dialogue, sélectionnez Création d’une classe. Vous pouvez ensuite attribuer à votre nouvelle classe un nom d’affichage (un nom court, descriptif, unique et convivial pour la classe), une description et un comportement pour les données que le schéma définira ("Enregistrement" ou "Série temporelle").

Lorsque vous avez terminé, sélectionnez Attribuer une classe.

Le Schema Editor s’affiche, affichant un nouveau schéma dans la zone de travail basé sur la classe personnalisée que vous venez de créer. Comme aucun champ n’a encore été ajouté à la classe, le schéma ne contient qu’un _id qui représente l’identifiant unique généré par le système qui est automatiquement appliqué à toutes les ressources dans la variable Schema Registry.

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 variable Ajouter un groupe de champs boîte de dialogue. Au lieu de cela, vous devrez créer des 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.

Vous pouvez maintenant commencer. ajout de champs à la classe, qui sera partagé par tous les schémas qui utilisent la classe .

Modification d’une classe existante

IMPORTANT

Les classes personnalisées créées après le 30 avril 2022 ne peuvent pas être modifiées directement et un correctif est actuellement en cours de développement. Pour pallier ce problème, vous pouvez : création d’un groupe de champs personnalisé et réutilisez-le pour chaque schéma qui utilise la classe personnalisée que vous souhaitez étendre. Les classes personnalisées créées avant le 30 avril 2022 ne sont pas affectées par cette limitation.

REMARQUE

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. Voir la section sur modification des noms d’affichage des champs de schéma pour plus d’informations.

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. Voir règles d’évolution des schémas pour plus d’informations.

Pour modifier une classe existante, sélectionnez la Parcourir puis sélectionnez le nom d’un schéma qui utilise la classe que vous souhaitez modifier.

CONSEIL

Vous pouvez utiliser les fonctionnalités de recherche et de filtrage de l’espace de travail pour faciliter la recherche du schéma. Consultez le guide sur la exploration des ressources XDM pour plus d’informations.

Le Schema Editor s’affiche, avec la structure du schéma affichée dans la zone de travail. Vous pouvez maintenant commencer. ajout de champs à la classe.

Ajout de champs à une classe

IMPORTANT

Les classes personnalisées créées après le 30 avril 2022 ne peuvent pas être modifiées directement et un correctif est actuellement en cours de développement. Pour pallier ce problème, vous pouvez : création d’un groupe de champs personnalisé et réutilisez-le pour chaque schéma qui utilise la classe personnalisée que vous souhaitez étendre. Les classes personnalisées créées avant le 30 avril 2022 ne sont pas affectées par cette limitation.

Une fois que vous disposez d’un schéma qui utilise une classe personnalisée ouverte dans le Éditeur de schéma, vous pouvez commencer à ajouter des champs à la classe . Pour ajouter un nouveau champ, sélectionnez le champ plus (+) en regard du nom du schéma.

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éation d’un groupe de champs au lieu de .

A Nouveau champ 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. Consultez le guide sur la définition des 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.

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

Vous pouvez modifier la classe du schéma à tout moment pendant le processus de création initial avant qu’il ne soit enregistré. Consultez le guide sur la création et édition de schémas pour plus d’informations.

Étapes suivantes

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 la variable Schémas workspace, voir Schémas présentation de workspace.

Pour savoir comment gérer des classes à l’aide de la méthode Schema Registry API, voir guide de point de terminaison des classes.

Sur cette page