Exploration des ressources de schéma dans l’interface utilisateur

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 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 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, 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 de schéma lookup

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 tous les schémas de votre organisation, ainsi que des onglets dédiés supplémentaires pour explorer respectivement les Classes, les Groupes de champs et les Types de données.

L’icône de filtre ( ) affiche les commandes dans le rail de gauche pour réduire les résultats répertoriés. Les contrôles affichés diffèrent selon le type de ressource répertoriée.

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

Le bouton d’activation Inclus dans le profil vous permet de filtrer les résultats de manière à n’afficher que les ressources utilisées dans les schémas qui ont été activées pour une utilisation dans Real-Time Customer Profile. Le bouton d’activation/désactivation Afficher les schémas ad hoc filtre la liste des schémas créés avec des champs dont l’espace de noms est réservé à un seul jeu de données.

Lors de la liste des ressources sur les onglets Classes, Groupes de champs ou Types de données, vous pouvez sélectionner Adobe pour n’afficher que les ressources standard ou Client pour n’afficher que les ressources créées par votre organisation.

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

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.

Une fois que vous avez trouvé la ressource que vous souhaitez 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 explore

Lorsque vous sélectionnez 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.

Indicateur de classe standard et de groupe de champs standard-class-and-field-group-indicator

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

Pour plus d’informations, reportez-vous à la documentation Ajouter des champs personnalisés aux groupes de champs standard . Vous ne pouvez pas modifier une classe standard.

Champs générés par le système system-fields

Certains noms de champ sont précédés d’un trait de soulignement, comme _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 l’espace de noms.

Types de données data-types

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 Article de paiement[] indique un tableau d’objets conformes au type de données Article 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 field-properties

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é identity

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 ( ). 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.

Champs de relation relationship

Si vous examinez un schéma qui contient un champ de relation, le champ sera répertorié dans le rail de gauche sous Relationships. 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 référence auquel le champ est lié. 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 référence dans le rail de droite.

É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 Schemas et Schema Editor, consultez la présentation des schémas de l’espace de travail.