Créer et modifier des types de données à l’aide de l’interface utilisateur
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 qu’ils soient similaires aux groupes de champs de schéma en ce qu’ils permettent l’utilisation cohérente d’une structure à champs multiples, les types de données sont plus flexibles, car ils peuvent être inclus n’importe où dans la structure du schéma, tandis 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 aux besoins spécifiques de votre entreprise.
NOTECe tutoriel décrit les étapes à suivre pour créer et modifier des types de données personnalisés dans l’interface utilisateur d’Experience Platform.
Conditions préalables
Ce guide nécessite une compréhension pratique du système XDM. Reportez-vous à la présentation de XDM pour une introduction au rôle de XDM dans l’écosystème Experience Platform et aux principes de base de la composition des schémas pour savoir comment les types de données contribuent aux schémas XDM.
Bien que cela ne soit pas obligatoire pour ce guide, 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’Schema Editor.
Ouvrir le Schema Editor pour un type de données
Dans l’interface utilisateur d’Experience 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 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éer un nouveau type de données
Dans l’onglet Types de données, sélectionnez Créer un type de données.
La Schema Editor s’affiche, affichant la structure actuelle du nouveau type de données dans la zone de travail. Dans la partie droite de l’éditeur, vous pouvez fournir 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é de restaurant. Le nom d’affichage « Restaurant » est donc attribué au type de données.
À partir de là, vous pouvez passer à la section suivante pour commencer à ajouter des champs au nouveau type de données.
Filtrer les types de données
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é affiche les entités créées au sein de votre organisation.
Modifier un type de données existant
NOTESeuls 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 détenus par votre organisation.
Sélectionnez le type de données à modifier dans la liste pour ouvrir le rail de droite, qui affiche les détails du type de données. Dans le panneau des détails, vous pouvez également télécharger un exemple de fichier, 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
Pour commencer à ajouter des champs au type de données, sélectionnez l’icône plus (+) à côté du champ de niveau racine dans la zone de travail. Un nouveau champ s’affiche sous 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 de 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, 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 la salle et l’espace au sol.
Outre les champs de base, vous pouvez également 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.
Ajouter le type de données à un schéma
Une fois que vous avez créé un type de données, vous pouvez commencer à l’utiliser dans vos schémas. Étant donné que les schémas XDM sont 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. Au lieu de cela, ils doivent être inclus dans une classe ou un groupe de champs.
Commencez par suivre les étapes liées à l’ajout d’un champ à une classe ou l’ajout d’un champ à un groupe de champs. Vous pouvez également commencer à ajouter directement un champ à 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
Lorsque vous créez un champ de type objet avec plusieurs sous-champs dans le Schema Editor, vous pouvez convertir ce champ en un 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 un 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 décrit les données que l’objet contiendra, car il s’agira du 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.
La zone de travail met à jour le type de données du champ de « Objet » 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.
