Créer et modifier des types de données à l’aide de l’interface utilisateur ui-create-and-edit

Dans le modèle de données d’expérience (XDM), les types de données sont des champs réutilisables qui contiennent plusieurs sous-champs. Bien que semblables aux groupes de champs de schéma dans le sens où ils permettent l’utilisation cohérente d’une structure à plusieurs champs, les types de données sont plus flexibles car ils peuvent être inclus n’importe où dans la structure de schéma alors que les groupes de champs ne peuvent être ajoutés qu’au niveau racine.

Adobe Experience Platform fournit de nombreux types de données standard qui peuvent être utilisés pour couvrir un large éventail de cas d’utilisation courants de la gestion de l’expérience. Cependant, vous pouvez également définir vos propres types de données personnalisés afin de répondre à vos besoins professionnels uniques.

Ce tutoriel décrit les étapes de création et de modification des types de données personnalisés dans l’interface utilisateur de 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 la manière dont les types de données 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 Schema Editor.

Ouvrez le Schema Editor pour un type de données. data-type

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 Types de données . Une liste des types de données disponibles s’affiche. La liste des types de données est automatiquement filtrée en fonction de leur mode de création. Le paramètre par défaut affiche les types de données définis par Adobe. Vous pouvez également filtrer la liste pour afficher celles créées par votre organisation.

À partir de là, vous disposez des options suivantes :

Création d’un type de données create

Dans l'onglet Types de données, sélectionnez Créer un type de données.

Le Schema Editor apparaît, indiquant la structure actuelle du nouveau type de données dans la zone de travail. Dans la partie droite de l’éditeur, vous pouvez indiquer un nom d’affichage et une description facultative du type de données. Veillez à fournir un nom unique et concis pour votre type de données, car c’est ainsi qu’il sera identifié lors de son ajout à un schéma.

Ce tutoriel crée un type de données qui décrit une propriété "restaurant", de sorte que le type de données se voit attribuer un nom d’affichage "Restaurant".

À partir de là, vous pouvez passer à la section suivante pour commencer à ajouter des champs au nouveau type de données.

Filtrage des types de données filter

La liste des types de données disponibles est préfiltrée en fonction de la manière dont ils ont été créés. 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.

Modifier un type de données existant edit

Seuls les types de données personnalisés définis par votre organisation peuvent être modifiés. Sélectionnez Personnalisé pour afficher uniquement les types de données personnalisés appartenant à votre organisation.

Sélectionnez le type de données à modifier dans la liste pour ouvrir le rail de droite, en affichant les détails du type de données. Dans le panneau Détails, vous pouvez également télécharger un fichier d’exemple, copier la structure JSON ou ajouter le type de données à un package.

Sélectionnez le nom du type de données dans le rail de droite pour ouvrir sa structure dans le Schema Editor.

Ajouter des champs au type de données add-fields

Pour commencer à ajouter des champs au type de données, sélectionnez l’icône plus (+) en regard du champ de niveau racine dans la zone de travail. Un nouveau champ s’affiche en dessous et le rail de droite se met à jour pour afficher les commandes du nouveau champ.

Utilisez les commandes du rail de droite pour configurer les détails du nouveau 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 au type de données.

Le type de données Restaurant nécessite un champ de chaîne pour représenter le nom du restaurant. Par conséquent, le nom du champ est défini comme "nom" et le type est défini comme "chaîne". Sélectionnez Appliquer pour appliquer les modifications au champ.

Continuez à ajouter d’autres champs au type de données selon vos besoins. L’exemple de type de données Restaurant comporte désormais des champs supplémentaires pour la marque, la capacité de sièges et l’espace de plancher.

Outre les champs de base, vous pouvez imbriquer des types de données supplémentaires dans votre type de données personnalisé. Par exemple, le type de données Restaurant nécessite un champ qui représente l’adresse physique de la propriété. Dans ce scénario, vous pouvez ajouter un nouveau champ "address" auquel est affecté le type de données standard "Postal address".

Cela montre à quel point les types de données peuvent être flexibles pour décrire vos données : les types de données peuvent utiliser des champs qui sont également des types de données, qui peuvent eux-mêmes contenir d’autres types de données, etc. Vous pouvez ainsi abstraire et réutiliser des modèles de données courants dans vos schémas XDM, ce qui facilite la représentation de structures de données complexes.

Une fois que vous avez terminé d’ajouter des champs au type de données, sélectionnez Enregistrer pour enregistrer vos modifications et ajouter le type de données au Schema Library.

Ajout du type de données à un schéma add-data-type

Une fois que vous avez créé un type de données, vous pouvez commencer à l’utiliser dans vos schémas. Les schémas XDM étant composés d’une classe et de zéro ou plusieurs groupes de champs, les champs fournis par un type de données ne peuvent pas être ajoutés directement à un schéma. Ils doivent être inclus dans une classe ou un groupe de champs.

Commencez par suivre les étapes impliquées par l’ajout d’un champ à une classe ou l’ajout d’un champ à un groupe de champs. Vous pouvez également commencer à ajouter un champ directement à un schéma et choisir la classe ou le groupe de champs parent à partir de là. Lorsque vous choisissez le Type pour le nouveau champ, sélectionnez le nom de votre type de données dans le menu déroulant.

Conversion d’un objet à plusieurs champs en un type de données convert

Lorsque vous créez un champ de type objet avec plusieurs sous-champs dans le Schema Editor, vous pouvez convertir ce champ en type de données afin d’utiliser la même structure de champ dans une classe ou un groupe de champs différent.

Pour convertir un champ de type objet en type de données, sélectionnez le champ dans la zone de travail. Avant de convertir le champ, assurez-vous que le nom d’affichage est descriptif des données que l’objet contiendra, car il deviendra le nom du type de données. Lorsque vous êtes prêt à convertir le champ, sélectionnez Convertir en nouveau type de données dans le rail de droite.

Le canevas met à jour le type de données du champ de "Object" vers le nouveau type de données. Cette structure peut désormais être réutilisée dans d’autres classes et groupes de champs en sélectionnant ce type de données dans la liste déroulante Type lors de la définition d’un nouveau champ.

Étapes suivantes next-steps

Ce guide explique comment créer et modifier des types de données à 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 types de données à l’aide de l’API Schema Registry, consultez le guide de point de terminaison des types de données.