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. Voir Présentation de XDM pour une présentation du rôle de XDM dans l’écosystème Experience Platform, et la variable principes de base de la composition des schémas pour savoir comment 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 composition d’un schéma dans l’interface utilisateur pour vous familiariser avec les différentes capacités de la fonction 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 la Schémas espace de travail, puis sélectionnez 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 la Types de données onglet, sélectionnez Création d’un type de données.

La variable Schema Editor affiche 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 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 à choisir parmi les Standard et Personnalisé options. La variable Standard affiche les entités créées par l’Adobe et la variable Personnalisé 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électionner 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 la variable 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. Ainsi, la variable Nom du champ est défini sur "name" et la variable Type est défini sur "Chaîne". Sélectionner 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 "adresse" auquel est affecté le type de données standard "Adresse postale".

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.

Suivez d’abord les étapes décrites dans la section ajout d’un champ à une classe ou ajouter un champ à un groupe de champs. Vous pouvez également commencer ajout direct d’un champ à un schéma et sélectionnez la classe ou le groupe de champs parent à partir de là. Lorsque vous choisissez l’option 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 la variable Schema Editor, vous pouvez convertir ce champ en type de données afin d’utiliser la même structure de champ dans une autre classe ou groupe de champs.

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 la variable 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 à partir de "Objet" au 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 le 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 la variable Schémas workspace, voir Schémas présentation de workspace.

Pour savoir comment gérer les types de données à l’aide du Schema Registry API, voir guide de point de fin des types de données.