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. Sur l’onglet Field groups , utilisez les filtres décrits à la section Métadonnées et filtrage des groupes de champs pour limiter la liste par classe et balises de secteur compatibles.

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 ( . 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, etc. Lorsque vous explorez un groupe de champs, les détails liés aux libellés du champ sélectionné peuvent également s’afficher à cet emplacement ; consultez ​ Libellés dans la vue de structure ​.

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.

Explorer les groupes de champs : utilisation et métadonnées explore-field-groups

Accédez à Schemas > Field groups pour explorer les groupes de champs. Dans l’onglet Field groups , des fonctionnalités supplémentaires vous aident à comprendre où un groupe de champs est utilisé sur l’ensemble des schémas et ce qu’il inclut, comme la compatibilité, les champs obligatoires (qui appliquent les exigences d’ingestion) et les signaux de gouvernance.

Ces fonctionnalités vous permettent d’évaluer l’impact avant d’apporter des modifications et d’identifier plus efficacement les groupes de champs pertinents lors de la conception du schéma.

Afficher l’utilisation du schéma pour les groupes de champs view-schema-usage-for-field-groups

Dans le tableau Field groups, sélectionnez un groupe de champs pour ouvrir sa vue détaillée. La zone de travail se met à jour pour afficher la structure du groupe de champs, et le rail des propriétés affiche des informations supplémentaires sur la ressource sélectionnée.

Schémas utilisant ce groupe de champs

Dans le rail de propriétés de droite, la section Schemas using this field group répertorie les schémas qui incluent actuellement le groupe de champs .

Sélectionnez un nom de schéma pour ouvrir sa vue détaillée dans un nouvel onglet et inspecter la manière dont le groupe de champs est implémenté dans ce schéma.

Afficher plus et la liste complète des schémas

S’il existe plus de schémas que ce qui peut être affiché en ligne, sélectionnez View more pour ouvrir la boîte de dialogue complète.

La boîte de dialogue Schemas using this field group s’affiche, affichant la liste complète des schémas qui utilisent le groupe de champs .

Dans la boîte de dialogue Schemas using this field group, vous pouvez effectuer les opérations suivantes :

Vous pouvez afficher les détails du schéma, tels que le nom, la classe et d’autres attributs du schéma.

Ce workflow est destiné uniquement à l’analyse et à l’exploration d’impact . Elle ne modifie pas les schémas ou les groupes de champs. Pour modifier la structure du schéma, voir Création et modification de schémas dans l’interface utilisateur.

Métadonnées et filtrage des groupes de champs field-group-metadata-and-filtering

L’onglet Field groups fournit des outils de métadonnées et de filtrage pour vous aider à localiser et à évaluer les groupes de champs avant de les sélectionner.

Parcourir le tableau et les filtres

Le tableau d’inventaire des groupes de champs comprend des colonnes supplémentaires qui exposent les métadonnées directement dans la vue Liste, telles que Compatible classes, qui indique à quelles classes un groupe de champs peut être appliqué. Les groupes de champs ne peuvent être ajoutés qu’aux schémas qui utilisent l’une des classes compatibles répertoriées, en fonction du comportement des données qu’ils représentent (par exemple, les données basées sur des enregistrements ou des séries temporelles). Le tableau peut s’afficher All lorsque le groupe de champs est compatible avec toutes les classes. Industry tags aider à catégoriser les groupes de champs pour la découverte.

Pour affiner la liste, sélectionnez l’icône de filtre ( ) pour ouvrir le panneau de filtrage dans le rail de gauche. L’image suivante montre l’ouverture du panneau de filtrage dans le rail de gauche.

Dans le panneau de filtrage, vous pouvez :

Lors de la navigation, sélectionnez une ligne dans le tableau pour mettre à jour le rail d’informations. Le rail d’informations affiche des métadonnées telles que les classes compatibles et les balises de secteur afin que vous puissiez consulter les détails clés sans ouvrir le groupe de champs.

Métadonnées des détails du groupe de champs

Lorsque vous ouvrez un groupe de champs, le rail des propriétés affiche des métadonnées supplémentaires associées à la ressource.

Le rail des propriétés peut afficher les métadonnées suivantes :

Ces informations vous aident à comprendre les contraintes et les exigences avant d’utiliser ou de modifier le groupe de champs.

Libellés dans la vue Structure

Lorsqu’un groupe de champs est ouvert dans la zone de travail, vous pouvez afficher les informations de libellé directement dans la structure. Sélectionnez l’icône des paramètres ( ) dans la barre d’outils de la zone de travail et Show labels on tree permettre d’afficher les indicateurs de libellé sur les champs de la zone de travail.

Sélectionnez un champ dans la zone de travail pour afficher les détails des libellés dans le rail de Field properties, y compris les libellés appliqués à ce champ.

Les libellés sont regroupés par catégorie (par exemple, libellés d’identité et sensibles) et offrent une visibilité sur les contraintes de gouvernance ou d’accès appliquées aux données.

Ces indicateurs sont utilisés à des fins de visibilité uniquement et ne modifient pas la structure du schéma. Pour plus d’informations, voir Gestion des libellés d’utilisation des données pour un schéma.

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