Explorer les 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 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 lookup

Dans l’interface utilisateur d’Experience Platform, sélectionnez Schemas dans le volet de navigation de gauche. L’espace de travail Schemas propose un onglet Browse pour explorer tous les schémas de votre organisation, ainsi que des onglets dédiés supplémentaires pour explorer respectivement Classes, Field groups, Data types et Relationships.

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 Browse et Relationships, respectivement.

Dans l’onglet Browse de l’espace de travail Schemas, vous pouvez filtrer l’inventaire des schémas. Utilisez le bouton Included in Profile pour afficher uniquement les schémas qui ont été activés pour une utilisation dans Real-Time Customer Profile. Utilisez le bouton Show adhoc schemas 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.

Dans l’onglet Relationship de l’espace de travail Schemas, vous pouvez filtrer la liste des relations en fonction de quatre critères. Les filtres incluent Source schema, Destination schema, Source class et le Destination class. Le tableau ci-dessous fournit une description des filtres.

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

Gérer les schémas, les classes, les groupes de champs et les types de données : actions et suppression xdm-resource-actions

Utilisez cette section lorsque vous devez gérer ou supprimer des ressources XDM ou lorsqu’une action (telle que la suppression) n’est pas disponible et que vous devez en comprendre la raison.

Où trouver les actions (page en ligne ou page de détails) where-to-find-actions

Pour effectuer des actions telles que la suppression, l’exportation ou la copie d’une ressource, utilisez l’un des points d’entrée suivants :

Sur les onglets Browse, Classes, Field groups et Data types, les actions de gestion sont disponibles à deux emplacements :

Ces actions sont cohérentes sur les deux points d’entrée pour les types de ressources pris en charge (schémas, classes, groupes de champs et types de données).

Actions disponibles available-actions

Selon le type de ressource et vos autorisations, les actions suivantes peuvent être disponibles :

Ce qui suit s’applique à différents types de ressources :

Comportement de suppression delete-behavior

Utilisez l’action Delete lorsque vous souhaitez supprimer une ressource personnalisée qui n’est plus nécessaire.

Pour supprimer une ressource :

La ressource est définitivement supprimée de votre organisation après confirmation.

Si la suppression n’est pas disponible pour une ressource, l’option apparaît désactivée avec une info-bulle expliquant pourquoi l’action ne peut pas être effectuée.

Contraintes (jeu de données, profil, RBAC, client par rapport au global) delete-constraints

Si une action telle que Delete n’est pas disponible ou est désactivée, cela est généralement dû à l’une des conditions suivantes :

Ces contraintes sont directement reflétées dans l’interface utilisateur. Lorsqu’une action n’est pas disponible, elle apparaît désactivée et comprend une info-bulle expliquant la limitation spécifique.

Si vous ne pouvez pas supprimer une ressource, consultez les conditions ci-dessus pour déterminer si vous devez mettre à jour les autorisations, supprimer les dépendances ou ajuster votre modèle de données.

Pour d’autres workflows de modification de schéma dans la zone de travail, consultez Création et modification de schémas dans l’interface utilisateur.

Explorer une ressource XDM dans la zone de travail explore

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.

Classe standard et indicateur de groupe de champs standard-class-and-field-group-indicator

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.

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 system-fields

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 doivent ​ un espace de noms.

Types de données data-types

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.

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 String[] indique que le champ attend un tableau de valeurs de chaîne. Un type de données Payment Item[] indique un tableau d’objets conformes au type de données Payment Item.

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.

Field properties field-properties

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 Field properties. 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.

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.

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

Champs de relation relationship

Si vous inspectez un schéma contenant un champ de relation, le champ est 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 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.

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 Edit relationship dans la barre latérale Field properties. Les paramètres de la relation s’affichent dans la boîte de dialogue Edit relationship qui s’affiche.

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