Esportare gli schemi XDM nell’interfaccia utente
Tutte le risorse all’interno della Libreria schemi sono contenute in una sandbox specifica all’interno di un’organizzazione. In alcuni casi, potrebbe essere utile condividere risorse Experience Data Model (XDM) tra sandbox e organizzazioni.
Per soddisfare questa esigenza, Schemi Nell’interfaccia utente di Adobe Experience Platform, Workspace consente di generare un payload di esportazione per qualsiasi schema in nella Libreria schemi. Questo payload può quindi essere utilizzato in una chiamata all’API Schema Registry per importare lo schema (e tutte le risorse dipendenti) in una sandbox e un’organizzazione di destinazione.
Prerequisiti
Anche se l’interfaccia utente di Platform consente di esportare risorse XDM, è necessario utilizzare l’API Schema Registry per importare tali risorse in altre sandbox o organizzazioni per completare il flusso di lavoro. Consulta la guida su guida introduttiva all’API Schema Registry per informazioni importanti sulle intestazioni di autenticazione richieste prima di seguire questa guida.
Generare un payload di esportazione generate-export-payload
I payload di esportazione possono essere generati nell’interfaccia utente di Platform dal pannello dei dettagli in Sfoglia o direttamente dall’area di lavoro dello schema nell’Editor di schema.
Per generare un payload di esportazione, seleziona Schemi nel menu di navigazione a sinistra. All'interno del Schemi nell’area di lavoro, seleziona la riga dello schema da esportare per visualizzare i dettagli dello schema nella barra laterale a destra.
Quindi, seleziona la Copia JSON icona (
Questo copia un payload JSON negli Appunti, generato in base alla struttura dello schema. Per il "Loyalty Members" mostrato sopra, viene generato il seguente JSON:
[
{
"$id": "https://ns.adobe.com/<XDM_TENANTID_PLACEHOLDER>/mixins/9ecfd881d0053568d277b792e4d24c6b70ffa7782bd31265",
"meta:altId": "_<XDM_TENANTID_PLACEHOLDER>.mixins.9ecfd881d0053568d277b792e4d24c6b70ffa7782bd31265",
"meta:resourceType": "mixins",
"version": "1.0",
"title": "Loyalty details",
"type": "object",
"description": "",
"definitions": {
"customFields": {
"type": "object",
"properties": {
"_<XDM_TENANTID_PLACEHOLDER>": {
"type": "object",
"properties": {
"loyalty": {
"title": "Loyalty",
"description": "",
"type": "object",
"isRequired": false,
"required": [
],
"properties": {
"loyaltyId": {
"title": "Loyalty ID",
"description": "",
"type": "string",
"isRequired": false,
"required": [
],
"meta:xdmType": "string"
},
"memberSince": {
"title": "Member Since",
"description": "",
"type": "string",
"isRequired": false,
"required": [
],
"format": "date",
"meta:xdmType": "date"
},
"points": {
"title": "Points",
"description": "",
"type": "integer",
"isRequired": false,
"required": [
],
"meta:xdmType": "int"
},
"loyaltyLevel": {
"title": "Loyalty Level",
"description": "",
"type": "string",
"isRequired": false,
"required": [
],
"enum": [
"platinum",
"gold",
"silver",
"bronze"
],
"meta:enum": {
"platinum": "Platinum",
"gold": "Gold",
"silver": "Silver",
"bronze": "Bronze"
},
"meta:xdmType": "string"
}
},
"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": "1bd86660-c5da-11e9-93d4-6d5fc3a66a8e",
"meta:sandboxType": "production"
},
{
"$id": "https://ns.adobe.com/<XDM_TENANTID_PLACEHOLDER>/schemas/1e5a739ded8fd1d766a0e06e881a38031874dddd1c7020ad",
"meta:altId": "_<XDM_TENANTID_PLACEHOLDER>.schemas.1e5a739ded8fd1d766a0e06e881a38031874dddd1c7020ad",
"meta:resourceType": "schemas",
"version": "1.4",
"title": "Loyalty Members",
"type": "object",
"description": "Describes customers who are members of a loyalty program.",
"allOf": [
{
"$ref": "https://ns.adobe.com/xdm/context/profile",
"type": "object",
"meta:xdmType": "object"
},
{
"$ref": "https://ns.adobe.com/xdm/context/profile-person-details",
"type": "object",
"meta:xdmType": "object"
},
{
"$ref": "https://ns.adobe.com/xdm/context/profile-personal-details",
"type": "object",
"meta:xdmType": "object"
},
{
"$ref": "https://ns.adobe.com/<XDM_TENANTID_PLACEHOLDER>/mixins/9ecfd881d0053568d277b792e4d24c6b70ffa7782bd31265",
"type": "object",
"meta:xdmType": "object"
},
{
"$ref": "https://ns.adobe.com/xdm/mixins/profile-consents",
"type": "object",
"meta:xdmType": "object"
}
],
"meta:extensible": false,
"meta:abstract": false,
"meta:extends": [
"https://ns.adobe.com/xdm/context/profile-person-details",
"https://ns.adobe.com/xdm/context/profile-personal-details",
"https://ns.adobe.com/xdm/common/auditable",
"https://ns.adobe.com/xdm/data/record",
"https://ns.adobe.com/xdm/context/profile",
"https://ns.adobe.com/<XDM_TENANTID_PLACEHOLDER>/mixins/9ecfd881d0053568d277b792e4d24c6b70ffa7782bd31265",
"https://ns.adobe.com/xdm/mixins/profile-consents"
],
"meta:xdmType": "object",
"meta:class": "https://ns.adobe.com/xdm/context/profile",
"meta:sandboxId": "1bd86660-c5da-11e9-93d4-6d5fc3a66a8e",
"meta:sandboxType": "production",
"meta:immutableTags": [
]
}
]
Puoi copiare il payload anche selezionando Altro in alto a destra nell’Editor di schema. Un menu a discesa fornisce due opzioni: Copia struttura JSON e Elimina schema.
Il payload assume la forma di un array; ogni elemento dell’array è un oggetto che rappresenta una risorsa XDM personalizzata da esportare. Nell’esempio precedente, l’opzione "Loyalty details" gruppo di campi personalizzato e "Loyalty Members"sono inclusi. Tutte le risorse core utilizzate dallo schema non vengono incluse nell’esportazione, in quanto sono disponibili in tutte le sandbox e le organizzazioni.
Ogni istanza dell’ID tenant dell’organizzazione viene visualizzata come <XDM_TENANTID_PLACEHOLDER> nel payload. Questi segnaposto verranno sostituiti automaticamente con il valore ID tenant appropriato a seconda di dove importi lo schema nel passaggio successivo.
Importare la risorsa utilizzando l’API
Dopo aver copiato il JSON di esportazione per lo schema, puoi utilizzarlo come payload per una richiesta POST al /rpc/import nell’API Schema Registry. Consulta la importa guida dell’endpoint per informazioni dettagliate su come configurare la chiamata per inviare lo schema all’organizzazione e alla sandbox desiderate.
Passaggi successivi
Seguendo questa guida, hai esportato correttamente uno schema XDM in un’organizzazione o sandbox diversa. Per ulteriori informazioni sulle funzionalità di Schemi interfaccia utente, fare riferimento a Schemi Panoramica dell’interfaccia utente.