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 chronologique). 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"), 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 pour votre entreprise.

Ce document fournit un aperçu de la création, de la modification et de la gestion des classes personnalisées dans l’interface utilisateur de Adobe Experience Platform.

Conditions préalables

Ce guide nécessite une bonne compréhension de XDM System. Pour une présentation du rôle de XDM dans l'écosystème Experience Platform, voir Présentation de XDM et les bases de la composition du schéma pour savoir comment les classes contribuent aux schémas de 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 diverses fonctionnalités du Schema Editor.

Création d’une nouvelle classe

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

Une boîte de dialogue s'affiche, vous permettant de choisir parmi une liste de classes disponibles. Dans la partie supérieure de la boîte de dialogue, sélectionnez Créer une nouvelle 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 va définir ("Enregistrer" ou "Série chronologique").

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

Le Schema Editor s'affiche, affichant un nouveau schéma dans la trame qui est 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 champ _id, qui représente l'identifiant unique généré par le système qui est automatiquement appliqué à toutes les ressources dans Schema Registry.

IMPORTANT

Lors de la création d’un schéma qui met en œuvre une classe définie par votre organisation, n’oubliez pas que les mixins ne peuvent être utilisés qu’avec des classes compatibles. Puisque la classe que vous avez définie est nouvelle, il n’existe aucun mixin compatible répertorié dans la boîte de dialogue Ajouter mixin. Vous devez à la place créer de nouveaux mixins pour les utiliser avec cette classe. La prochaine fois que vous composez un schéma qui implémente la nouvelle classe, les mixins que vous avez définis seront répertoriés et disponibles pour utilisation.

Vous pouvez désormais début l'ajout de champs à la classe, qui sera partagée par tous les schémas qui utilisent la classe.

Modifier une classe existante

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. Pour plus d'informations, consultez la section modification des noms d'affichage pour les champs de schéma.

Une fois qu'une classe personnalisée a été enregistrée et utilisée dans l'assimilation de données, seules des modifications supplémentaires peuvent être apportées par la suite. Pour plus d'informations, consultez les règles d'évolution des schémas.

Pour modifier une classe existante, sélectionnez l'onglet Parcourir, puis sélectionnez le nom d'un schéma qui utilise la classe à 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. Pour plus d'informations, consultez le guide exploration des ressources XDM.

Le Schema Editor apparaît, la structure du schéma étant affichée dans la trame. Vous pouvez désormais début l'ajout de champs à la classe.

Ajouter des champs à une classe

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

IMPORTANT

N'oubliez pas que tous les champs que vous ajoutez à une classe seront utilisés dans tous les schémas qui utilisent cette classe. Vous devez donc examiner attentivement 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 mixin à la place.

Un nouveau champ apparaît dans le canevas 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 connaître les étapes spécifiques de configuration et d'ajout du champ à la classe.

Continuez à ajouter autant de champs que nécessaire à la classe. Une fois 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 au cours du processus de création initial avant de l’enregistrer. Pour plus d'informations, consultez le guide Création et modification de schémas.

Étapes suivantes

Ce document décrit comment créer et modifier des classes à l’aide de l’interface utilisateur de la plate-forme. Pour plus d'informations sur les fonctionnalités de l'espace de travail Schémas, consultez la présentation de l'espace de travail Schémas.

Pour savoir comment gérer les classes à l'aide de l'API Schema Registry, consultez le guide du point de terminaison classes.

Sur cette page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free