Guide de l’API Schema Registry

Schema Registry est utilisé pour accéder à la bibliothèque de schémas dans Adobe Experience Platform, fournissant une interface utilisateur et une API RESTful à partir desquelles toutes les ressources de bibliothèque disponibles sont accessibles.

L’API Schema Registry fournit plusieurs points de terminaison qui vous permettent de gérer par programmation tous les schémas et toutes les ressources XDM (Experience Data Model) associées disponibles pour vous dans Platform. Cela inclut ceux définis par Adobe, Experience Platform partenaires et fournisseurs dont vous utilisez les applications.

Ces points d’entrée sont décrits ci-dessous. Consultez le guide de chaque point d’entrée pour plus de détails et reportez-vous au guide de prise en main pour obtenir des informations importantes sur les en-têtes nécessaires, la lecture des exemples d’appels d’API, etc.

IMPORTANT
XDM utilise le formatage du schéma JSON pour décrire et valider la structure des données d’expérience client ingérées. Avant d’utiliser l’API Schema Registry, il est vivement recommandé de consulter la documentation officielle du schéma JSON pour mieux comprendre cette technologie sous-jacente.

Pour afficher tous les points de terminaison disponibles et les opérations CRUD, consultez la référence de l’API Schema Registry.

Schémas

Les schémas XDM représentent et valident la structure et le format des données ingérées dans Platform. Un schéma est composé d’une classe et de zéro ou plusieurs groupes de champs de schéma. Vous pouvez créer, afficher, modifier et supprimer des schémas à l’aide du point d’entrée /schemas. Pour savoir comment utiliser ce point d’entrée, consultez le guide de point d’entrée des schémas.

Pour obtenir un guide détaillé sur la création manuelle d’un schéma complet dans l’API Schema Registry, y compris la création et l’ajout de groupes de champs et de types de données, consultez le tutoriel sur la création de schémas d’API.

Si vous ingérez des données CSV, reportez-vous à la section sur la conversion CSV vers schéma.

Comportements

Les comportements définissent la nature des données décrites par un schéma. Chaque classe XDM doit faire référence à un comportement spécifique, dont tous les schémas qui utilisent cette classe hériteront. Consultez le guide de point de terminaison de comportements pour savoir comment afficher les comportements disponibles dans l’API.

Classes

Une classe définit la structure de base des propriétés communes que tous les schémas basés sur cette classe doivent contenir et détermine les groupes de champs pouvant être utilisés dans ces schémas. Chaque classe doit être associée à un comportement existant. Pour plus d’informations sur l’utilisation des classes dans l’API, consultez le guide de point de terminaison des classes .

Groupes de champs

Les groupes de champs sont des composants réutilisables qui définissent un ou plusieurs champs qui représentent un concept particulier, comme une personne, une adresse postale ou un environnement de navigateur Web. Les groupes de champs sont destinés à être inclus dans un schéma qui met en oeuvre une classe compatible, en fonction du comportement des données qu’ils représentent (enregistrement ou série temporelle). Consultez le guide de point de terminaison de groupes de champs pour savoir comment utiliser les groupes de champs dans l’API.

Types de données

Les types de données sont utilisés comme champs de type référence dans des classes ou des groupes de champs de la même manière que les champs littéraux de base. La différence majeure réside dans le fait que les types de données peuvent définir plusieurs sous-champs. Tout comme les groupes de champs dans le fait qu’ils permettent l’utilisation cohérente d’une structure à plusieurs champs, les types de données sont plus flexibles, car ils peuvent être inclus n’importe où dans la structure du schéma, tandis que les groupes de champs ne peuvent être ajoutés qu’au niveau racine. Pour plus d’informations sur l’utilisation des types de données dans l’API, consultez le guide de point de terminaison des types de données .

NOTE
Si un champ est défini comme un type de données spécifique, vous ne pouvez pas créer le même champ avec un type de données différent dans un autre schéma. Cette contrainte s’applique à l’ensemble du client de votre entreprise.

Descripteurs

Les descripteurs sont des ensembles de métadonnées affectés à des champs spécifiques au sein d’un schéma, fournissant divers détails contextuels, y compris la manière dont ces champs (et le schéma lui-même) sont associés à d’autres schémas. Une ou plusieurs entités de descripteur peuvent être appliquées à chaque schéma, et plusieurs types de descripteurs différents peuvent servir à des fins différentes. Pour plus d’informations sur l’utilisation des descripteurs dans l’API, consultez le guide de point de terminaison des descripteurs et un aperçu des différents types de descripteurs et de leurs cas d’utilisation.

Unions

Bien que Platform vous permette de composer des schémas pour des cas d’utilisation particuliers, il vous permet également de composer une "union" de schémas appartenant à une classe spécifique. Un schéma d’union agrège les champs de tous les schémas qui partagent la même classe en une seule représentation. En activant un schéma à utiliser avec Real-Time Customer Profile, ce schéma est inclus dans l’union pour sa classe particulière. Par conséquent, les schémas d’union ne peuvent pas être modifiés directement et peuvent uniquement être affectés par l’inclusion ou l’exclusion de schémas à utiliser dans Profile.

Pour savoir comment afficher les unions dans l’API Schema Registry, consultez le guide de point de terminaison des unions.

Conversion CSV en schéma csv-to-schema

Vous pouvez générer automatiquement un schéma XDM à l’aide d’un fichier CSV comme modèle, ce qui vous permet de créer des modèles pour importer en bloc des champs de schéma et de réduire le travail manuel de l’API ou de l’interface utilisateur.

Pour plus d’informations, consultez le guide de point de terminaison de conversion CSV vers schéma .

NOTE
Vous pouvez également utiliser l’interface utilisateur pour mapper un fichier CSV à un schéma à l’aide de recommandations générées par l’IA (actuellement en version bêta).

Exporter export

L’API Schema Registry vous permet de transférer et de partager des ressources XDM entre des environnements de test et des organisations. Pour tout schéma, groupe de champs ou type de données, vous pouvez générer une payload d’exportation contenant la structure de la ressource et les ressources dépendantes. Ce payload peut ensuite être utilisé pour importer la ressource dans un environnement de test et une organisation de destination.

Pour plus d’informations sur la création d’une payload d’exportation pour une ressource XDM existante, consultez le guide de point de terminaison d’exportation .

Importer

Si vous utilisez les points de terminaison export ou CSV vers la conversion de schéma pour créer une payload d’exportation, vous pouvez envoyer cette payload à une organisation cible et un environnement de test pour importer les ressources spécifiées.

Pour plus d’informations sur la génération de ressources XDM à partir de payloads d’exportation, reportez-vous au guide de point de terminaison d’importation .

Données d’exemple

Vous pouvez générer des exemples de données pour n’importe quel schéma spécifié dans la bibliothèque de schémas. L’objet de réponse renvoyé peut ensuite être utilisé comme source d’ingestion de données.

Pour plus d’informations sur l’utilisation de ce point de terminaison, consultez le guide d’exemple de point de terminaison de données .

Journal d’audit

Le registre des schémas conserve un journal de toutes les modifications apportées à une ressource (classe, groupe de champs, type de données ou schéma) entre différentes mises à jour. Vous pouvez récupérer le journal d’une ressource particulière en fournissant ses $id ou meta:altId dans le chemin d’accès d’une requête de GET à ce point de terminaison.

Pour plus d’informations sur l’utilisation de ce point de terminaison, consultez le guide de point de terminaison du journal d’audit .

Étapes suivantes

Pour commencer à effectuer des appels à lʼaide de lʼAPI Schema Registry, consultez le guide de prise en main, puis sélectionnez lʼun des guides des points dʼentrée pour savoir comment utiliser des points dʼentrée spécifiques.

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07