Documentation Experience Platform Guide de modèle de données d’expérience (XDM)

Explorer les ressources de schéma dans l’interface utilisateur

Last update: Fri Apr 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :

Créé pour :

Développeur

Dans Adobe Experience Platform, toutes les ressources de schéma du modèle de données d’expérience (XDM) sont stockées dans le Schema Library, y compris les ressources standard fournies par Adobe et les ressources personnalisées définies par votre organisation. Dans l’interface utilisateur d’Experience Platform, vous pouvez afficher la structure et les champs de n’importe quel schéma, classe, groupe de champs ou type de données existant dans le Schema Library. Cela s’avère particulièrement utile lors de la planification et de la préparation de l’ingestion de données, car l’interface utilisateur fournit des informations sur les types de données attendus et les cas d’utilisation de chaque champ fourni par ces ressources XDM.

Ce tutoriel décrit les étapes à suivre pour explorer les schémas, classes, groupes de champs et types de données existants dans l’interface utilisateur d’Experience Platform.

Recherche d’une ressource de schéma

Dans l’interface utilisateur d’Experience Platform, sélectionnez Schémas dans le volet de navigation de gauche. L’espace de travail Schémas fournit un onglet Parcourir pour explorer tous les schémas de votre organisation, ainsi que des onglets dédiés supplémentaires pour explorer respectivement Classes, Groupes de champs, Types de données et Relations.

Espace de travail des schémas avec plusieurs onglets mis en surbrillance.

L’icône de filtre ( ) affiche des commandes dans le rail de gauche pour réduire les résultats répertoriés. Les filtres de ressources sont disponibles pour les schémas et les relations dans les onglets Parcourir et Relations respectivement.

Dans l’onglet Parcourir de l’espace de travail Schémas, vous pouvez filtrer l’inventaire des schémas. Utilisez le bouton (bascule) Inclus dans le profil pour afficher uniquement les schémas qui ont été activés pour une utilisation dans Profil client en temps réel. Utilisez le bouton (bascule) Afficher les schémas ad hoc pour filtrer la liste des schémas créés avec un espace de noms de champs à utiliser uniquement par un seul jeu de données.

Onglet Schémas de l’espace de travail Parcourir avec le panneau Filtres en surbrillance.

Dans l’onglet Relation de l’espace de travail Schémas, vous pouvez filtrer la liste des relations en fonction de quatre critères. Les filtres incluent le schéma Source, le schéma de destination, la classe Source et la classe de destination. Le tableau ci-dessous fournit une description des filtres.

Filtre

Description

Schéma Source

Pour afficher toutes les relations où le schéma sélectionné est le point de départ ou la « source », sélectionnez un schéma dans le menu déroulant Schéma Source.

Schéma destination

Pour afficher toutes les relations où le schéma sélectionné est la cible ou la « destination », sélectionnez un schéma dans le menu déroulant Schéma de destination.

classe Source

Pour filtrer les relations en fonction de la classe du schéma initiateur, sélectionnez une classe dans le menu déroulant Classe Source.

Classe de destination

Pour afficher les relations qui se terminent par des schémas d’une classe spécifique, sélectionnez une classe dans le menu déroulant Classe de destination.

Onglet Relations avec la section Filtres mise en surbrillance.

Vous pouvez également utiliser la barre de recherche pour affiner davantage les résultats.

Onglet Parcourir de l’espace de travail Schémas avec le champ de recherche en surbrillance.

Les ressources affichées dans les résultats de recherche sont d’abord classées par correspondance de titre, puis par correspondance de description. Plus il y a de correspondances de mots dans l’une de ces catégories, plus la ressource apparaît en haut de la liste.

Lorsque vous avez trouvé la ressource à explorer, sélectionnez son nom dans la liste pour afficher sa structure dans la zone de travail.

Explorer une ressource XDM dans la zone de travail

Une fois que vous avez sélectionné une ressource, sa structure s’ouvre dans la zone de travail.

Zone de travail de l’espace de travail Type de données affichant le type de données Commerce.

Tous les champs de type objet contenant des sous-propriétés sont réduits par défaut lorsqu’ils apparaissent pour la première fois dans la zone de travail. Pour afficher les sous-propriétés d’un champ, sélectionnez l’icône en regard de son nom.

Zone de travail de l’espace de travail Type de données avec les champs développés et les sous-propriétés mis en surbrillance.

Classe standard et indicateur de groupe de champs

Dans l’éditeur de schémas, les classes et les groupes de champs standard (générés par Adobe) sont indiqués par l’icône de cadenas (icône de cadenas . Le cadenas s’affiche dans le rail de gauche à côté du nom de la classe ou du groupe de champs, ainsi qu’à côté de tout champ du diagramme de schéma qui fait partie d’une ressource générée par le système.

Éditeur de schémas avec l’icône de cadenas mise en surbrillance

Consultez la documentation Ajouter des champs personnalisés aux groupes de champs standard pour obtenir des conseils. Vous ne pouvez pas modifier une classe standard.

Champs générés par le système

Certains noms de champ sont précédés d’un trait de soulignement, tels que _repo et _id. Il s’agit d’espaces réservés pour les champs que le système génère et attribue automatiquement au fur et à mesure de l’ingestion des données.

Par conséquent, la plupart de ces champs doivent être exclus de la structure de vos données lors de l’ingestion dans Experience Platform. La principale exception à cette règle est le champ _{TENANT_ID} , sous lequel tous les champs XDM créés sous votre organisation doiventun espace de noms.

Types de données

Pour chaque champ affiché dans la zone de travail, le type de données correspondant s’affiche en regard de son nom, indiquant en un coup d’œil le type de données attendu par le champ pour l’ingestion.

Type de données d’adresse postale affiché sur la zone de travail avec ses types de données associés mis en surbrillance.

Tout type de données ajouté entre crochets ([]) représente un tableau de ce type de données particulier. Par exemple, un type de données Chaîne[] indique que le champ attend un tableau de valeurs de chaîne. Un type de données Élément de paiement[] indique un tableau d’objets conformes au type de données Élément de paiement.

Si un champ de tableau est basé sur un type d’objet, vous pouvez sélectionner son icône dans la zone de travail pour afficher les attributs attendus pour chaque élément de tableau.

Un objet dans la zone de travail avec un champ de tableau en surbrillance et les attributs attendus pour chaque élément de tableau affiché.

Propriétés du champ

Lorsque vous sélectionnez le nom d’un champ de la zone de travail, le rail de droite se met à jour pour afficher les détails de ce champ sous Propriétés du champ. Vous pouvez y trouver une description du cas d’utilisation prévu du champ, des valeurs par défaut, des modèles, des formats, si le champ est obligatoire ou non, etc.

Champ sélectionné à partir du type de données Commerce avec les propriétés du champ mises en surbrillance.

Si le champ que vous inspectez est un champ d’énumération, le rail de droite affiche également les valeurs acceptables que le champ s’attend à recevoir.

Éditeur de schémas avec un champ sélectionné et des valeurs d’énumération et des noms d’affichage mis en surbrillance dans le rail des propriétés du champ.

Champs d’identité

Lors de l’inspection des schémas qui contiennent des champs d’identité, ces champs sont répertoriés dans le rail de gauche sous la classe ou le groupe de champs qui les fournit au schéma. Sélectionnez le nom du champ d’identité dans le rail de gauche pour afficher le champ dans la zone de travail, quelle que soit sa profondeur d’imbrication.

Les champs d’identité sont mis en surbrillance dans la zone de travail avec une icône d’empreinte digitale ( ). Si vous sélectionnez le nom du champ d’identité, vous pouvez afficher des informations supplémentaires telles que l’espace de noms d’identité et déterminer si le champ est l’identité principale du schéma.

Éditeur de schémas avec l’identité du schéma mise en surbrillance dans le rail de gauche, le champ mis en surbrillance dans le diagramme de schéma et l’espace de noms d’identité mis en surbrillance dans les propriétés du champ.

NOTE

Pour plus d’informations sur les champs d’identité et leur relation avec les services Experience Platform en aval🔗 consultez le guide sur la définition des champs d’identité .

Champs de relation

Si vous inspectez un schéma qui contient un champ de relation, le champ est répertorié dans le rail de gauche sous Relations. Sélectionnez le nom du champ de relation dans le rail de gauche pour afficher le champ dans la zone de travail, quelle que soit sa profondeur d’imbrication. Les champs de relation sont également mis en surbrillance de manière unique dans la zone de travail, affichant le nom du schéma de référence auquel le champ renvoie. Pour les organisations disposant de fonctionnalités B2B, des noms de relation personnalisés peuvent être écrits et s’affichent sur la zone de travail dans ces cas.

Éditeur de schémas avec le champ de relation et Modifier la relation en surbrillance.

Pour afficher l’espace de noms d’identité de l’identité principale du schéma de référence, sélectionnez le champ de relation, puis Modifier la relation dans la barre latérale Propriétés du champ. Les paramètres de la relation s’affichent dans la boîte de dialogue Modifier la relation qui s’affiche.

Boîte de dialogue Modifier la relation avec les paramètres de relation affichés.

Pour plus d’informations sur l’utilisation des relations dans les schémas XDM, consultez le tutoriel sur la création d’une relation dans l’interface utilisateur.

Étapes suivantes

Ce document explique comment explorer les ressources XDM existantes dans l’interface utilisateur d’Experience Platform. Pour plus d’informations sur les différentes fonctionnalités de l’espace de travail et des Schema Editor Schémas, consultez la présentation de l’espace de travail Schémas.

recommendation-more-help