Exploration des ressources XDM dans l’interface utilisateur

Dans Adobe Experience Platform, toutes les ressources du modèle de données d’expérience (XDM) sont stockées dans la balise Schema Library, y compris les ressources standard fournies par l’Adobe et les ressources personnalisées définies par votre organisation. Dans l’interface utilisateur de l’Experience Platform, vous pouvez afficher la structure et les champs de tout schéma, classe, groupe de champs de schéma ou type de données existant dans la balise Schema Library. Cela s’avère particulièrement utile lors de la planification et de la préparation de l’ingestion de données, dans la mesure où 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 de l’Experience Platform.

Recherche d’une ressource XDM

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

Dans l’onglet Parcourir, vous pouvez utiliser l’icône de filtre (Icône de filtre Image) pour afficher les commandes dans le rail de gauche afin de réduire les résultats répertoriés.

Par exemple, pour filtrer la liste afin de n’afficher que les types de données standard fournis par Adobe, sélectionnez Type de données et Adobe sous les sections Type et Propriétaire , respectivement.

Le bouton Inclus dans Profile permet de filtrer les résultats afin d’afficher uniquement les ressources utilisées dans les schémas qui ont été activés pour une utilisation dans Real-time Customer Profile.

Vous pouvez également utiliser la barre de recherche pour affiner davantage les résultats. Lorsque vous recherchez un terme, les principaux éléments représentent des ressources dont les noms correspondent à la requête. Sous ces éléments, sous Champs standard, toutes les ressources contenant des champs correspondant à la requête seront répertoriées. Cela vous permet de rechercher des ressources XDM en fonction du type de données qu’elles contiennent, sans avoir à connaître au préalable le nom de la ressource.

Les ressources affichées dans les résultats de recherche sont triées d’abord par correspondances de titre, puis par correspondances de description. En retour, plus le nombre de correspondances de mot dans l’une de ces catégories est élevé, plus la ressource apparaît dans la liste.

REMARQUE

Pour les ressources XDM standard, la fonction de recherche renvoie uniquement les champs individuels contenant un espace de noms xdm. Les champs qui se trouvent sous un autre espace de noms (tel que votre identifiant de tenant) ne sont renvoyés que s’ils sont contenus dans une ressource personnalisée.

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

Exploration d’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.

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.

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

Certains noms de champ sont précédés d’un trait de soulignement, tel 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 lors 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 Platform. L’exception principale à cette règle est le _{TENANT_ID} champ, sous lequel tous les champs XDM créés sous votre organisation doivent se trouver dans un espace de noms.

Types de données

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

Tout type de données ajouté avec des crochets ([]) représente un tableau de ce type de données particulier. Par exemple, un type de données String[] 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 afin d’afficher les attributs attendus pour chaque élément de tableau.

Propriétés du champ

Lorsque vous sélectionnez le nom d’un champ dans la zone de travail, le rail de droite se met à jour pour afficher les détails sur ce champ sous Propriétés du champ. Cela peut inclure 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.

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

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 la profondeur d’imbrication.

Les champs d’identité sont mis en surbrillance dans la zone de travail avec une icône d’empreinte digitale (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 ou non l’identité Principale du schéma.

REMARQUE

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

Champs de relation

Si vous examinez un schéma qui contient un champ de relation, le champ sera 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 la profondeur d’imbrication.

Les champs de relation sont également surlignés de manière unique dans la zone de travail, indiquant le nom du schéma de destination auquel le champ fait référence. Si vous sélectionnez le nom du champ de relation, vous pouvez afficher l’espace de noms d’identité de l’identité Principale du schéma de destination dans le rail de droite.

REMARQUE

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 Experience Platform. Pour plus d’informations sur les différentes fonctionnalités de l’espace de travail Schémas et Schema Editor, consultez la présentation des schémas de l’espace de travail.

Sur cette page