Export-Endpunkt
Alle Ressourcen innerhalb der Schema Library sind in einer bestimmten Sandbox in Adobe Experience Platform enthalten. In einigen Fällen empfiehlt es sich, Experience-Datenmodell (XDM)-Ressourcen zwischen Sandboxes und Organisationen freizugeben. Mit dem /rpc/export-Endpunkt in der Schema Registry-API können Sie eine Export-Payload für ein beliebiges Schema, eine beliebige Schemafeldgruppe oder einen beliebigen Datentyp im Schema Library generieren und diese Payload dann verwenden, um diese Ressource (und alle abhängigen Ressourcen) über den /rpc/import-Endpunkt in eine Ziel-Sandbox und Organisation zu importieren.
Erste Schritte
Der /rpc/export-Endpunkt ist Teil der Schema Registry API. Bevor Sie fortfahren, lesen Sie das Handbuch Erste Schritte mit Links zur zugehörigen Dokumentation, einer Anleitung zum Lesen der API-Beispielaufrufe in diesem Dokument und wichtigen Informationen zu den erforderlichen Kopfzeilen, die für die erfolgreiche Ausführung von Aufrufen an eine Experience Platform-API erforderlich sind.
Der /rpc/export-Endpunkt ist Teil der Remote Procedure Calls (RPCs), die vom Schema Registry unterstützt werden. Im Gegensatz zu anderen Endpunkten in der Schema Registry-API benötigen RPC-Endpunkte keine zusätzlichen Kopfzeilen wie Accept oder Content-Type und verwenden keine CONTAINER_ID. Stattdessen müssen sie den /rpc Namespace verwenden, wie in den folgenden API-Aufrufen veranschaulicht.
Export-Payload für eine Ressource generieren export
Für ein vorhandenes Schema, eine Feldergruppe oder einen Datentyp im Schema Library können Sie eine Export-Payload generieren, indem Sie eine GET-Anfrage an den /export-Endpunkt senden und im Pfad die ID der Ressource angeben.
API-Format
GET /rpc/export/{RESOURCE_ID}
{RESOURCE_ID}meta:altId oder URL-kodierte $id der XDM-Ressource, die Sie exportieren möchten.Anfrage
Die folgende Anfrage ruft eine Export-Payload für eine Restaurant Feldergruppe ab.
curl -X GET \
https://platform.adobe.io/data/foundation/schemaregistry/rpc/export/_{TENANT_ID}.mixins.922a56b58c6b4e4aeb49e577ec82752106ffe8971b23b4d9 \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Accept: application/vnd.adobe.xdm-link+json'
Antwort
Eine erfolgreiche Antwort gibt ein Array von Objekten zurück, die die XDM-Zielressource und alle ihre abhängigen Ressourcen darstellen. In diesem Beispiel ist das erste Objekt im -Array ein von einem Mandanten erstellter Property-Datentyp, den die Restaurant Feldgruppe verwendet, während das zweite Objekt die Restaurant Feldgruppe selbst ist. Diese Payload kann dann verwendet werden, um Ressource in andere Sandbox oder Organisation zu importieren.
Beachten Sie, dass alle Instanzen der Mandanten-ID der Ressource durch <XDM_TENANTID_PLACEHOLDER> ersetzt werden. Dadurch kann die Schemaregistrierung automatisch die richtige Mandanten-ID auf die Ressourcen anwenden, je nachdem, wohin sie im nachfolgenden Importaufruf gesendet werden.
[
{
"$id": "https://ns.adobe.com/<XDM_TENANTID_PLACEHOLDER>/datatypes/fc07162ee7ca8d18e074a3bb50c3938c76160bf6040e8495",
"meta:altId": "_<XDM_TENANTID_PLACEHOLDER>.datatypes.fc07162ee7ca8d18e074a3bb50c3938c76160bf6040e8495",
"meta:resourceType": "datatypes",
"version": "1.0",
"title": "Property",
"type": "object",
"description": "",
"definitions": {
"customFields": {
"properties": {
"propertyId": {
"title": "Property ID",
"description": "ID for a company-owned property.",
"type": "string",
"isRequired": false,
"meta:ui": {
"ref": [
"schema://5fbc29ec292534000055dd55",
"#/definitions/customFields"
],
"path": "{}._<XDM_TENANTID_PLACEHOLDER>{}.property{}.propertyId",
"editable": true,
"generateDate": 1606168175975
},
"meta:xdmType": "string"
},
"jurisdiction": {
"title": "Jurisdiction",
"description": "",
"type": "string",
"isRequired": false,
"enum": [
"NA",
"UK",
"EU"
],
"meta:enum": {
"NA": "North America",
"UK": "United Kingdom",
"EU": "European Union"
},
"meta:ui": {
"ref": [
"schema://5fbc29ec292534000055dd55",
"#/definitions/customFields"
],
"path": "{}._<XDM_TENANTID_PLACEHOLDER>{}.property{}.jurisdiction",
"editable": true,
"generateDate": 1606168175975
},
"meta:xdmType": "string"
}
}
}
},
"allOf": [
{
"$ref": "#/definitions/customFields",
"type": "object",
"meta:xdmType": "object"
}
],
"meta:extensible": true,
"meta:abstract": true,
"meta:xdmType": "object",
"meta:sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
"meta:sandboxType": "production"
},
{
"$id": "https://ns.adobe.com/<XDM_TENANTID_PLACEHOLDER>/mixins/922a56b58c6b4e4aeb49e577ec82752106ffe8971b23b4d9",
"meta:altId": "_<XDM_TENANTID_PLACEHOLDER>.mixins.922a56b58c6b4e4aeb49e577ec82752106ffe8971b23b4d9",
"meta:resourceType": "mixins",
"version": "1.0",
"title": "Restaurant",
"type": "object",
"description": "",
"definitions": {
"customFields": {
"type": "object",
"properties": {
"_<XDM_TENANTID_PLACEHOLDER>": {
"type": "object",
"properties": {
"capacity": {
"title": "Capacity",
"description": "Restaurant capacity",
"type": "string",
"isRequired": false,
"meta:xdmType": "string"
},
"kitchen": {
"title": "Kitchen Style",
"description": "Style of kitchen",
"type": "string",
"isRequired": false,
"meta:xdmType": "string"
},
"rating": {
"title": "Rating",
"description": "",
"type": "integer",
"isRequired": false,
"meta:xdmType": "int"
},
"property": {
"title": "Property",
"description": "",
"$ref": "https://ns.adobe.com/<XDM_TENANTID_PLACEHOLDER>/datatypes/fc07162ee7ca8d18e074a3bb50c3938c76160bf6040e8495",
"type": "object",
"meta:xdmType": "object"
}
},
"meta:xdmType": "object"
}
},
"meta:xdmType": "object"
}
},
"allOf": [
{
"$ref": "#/definitions/customFields",
"type": "object",
"meta:xdmType": "object"
}
],
"meta:extensible": true,
"meta:abstract": true,
"meta:intendedToExtend": [],
"meta:xdmType": "object",
"meta:sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
"meta:sandboxType": "production"
}
]
Ressource importieren import
Nachdem Sie die Export-Payload aus der CSV-Datei generiert haben, können Sie diese Payload an den /rpc/import-Endpunkt senden, um das Schema zu generieren.
Weitere Informationen Generieren von Schemata aus ExportPayloads finden Sie im Handbuch zum Import-Endpunkt .