Esportare schemi XDM nell’interfaccia utente

Tutte le risorse all’interno della Libreria schema sono contenute in una sandbox specifica all’interno di un’organizzazione IMS. In alcuni casi, puoi condividere risorse Experience Data Model (XDM) tra le sandbox e le organizzazioni IMS.

Per soddisfare questa esigenza, l'area di lavoro Schemi nell'interfaccia utente di Adobe Experience Platform consente di generare un payload di esportazione per qualsiasi schema all'interno della Libreria schema. Questo payload può quindi essere utilizzato in una chiamata all’API del Registro di sistema dello schema per importare lo schema (e tutte le risorse dipendenti) in una sandbox di destinazione e nell’organizzazione IMS.

NOTA

È inoltre possibile utilizzare l’API del Registro di sistema dello schema per esportare altre risorse oltre agli schemi, tra cui classi, gruppi di campi dello schema e tipi di dati. Per ulteriori informazioni, consulta la guida sugli endpoint di esportazione/importazione .

Prerequisiti

Sebbene l’interfaccia utente di Platform consenta di esportare risorse XDM, è necessario utilizzare l’API del Registro di sistema dello schema per importare tali risorse in altre sandbox o organizzazioni IMS per completare il flusso di lavoro. Per informazioni importanti sulle intestazioni di autenticazione richieste prima di seguire questa guida, consulta la guida introduttiva all’API del Registro di sistema dello schema .

Generare un payload di esportazione

Nell’interfaccia utente di Platform, seleziona Schemi nel menu di navigazione a sinistra. Nell'area di lavoro Schemi, individua lo schema da esportare e aprilo in Schema Editor.

SUGGERIMENTO

Per informazioni dettagliate su come trovare la risorsa XDM desiderata, consulta la guida sull’ esplorazione delle risorse XDM .

Una volta aperto lo schema, seleziona l’icona Copia JSON (Copia icona) in alto a destra nell’area di lavoro.

Questo copia un payload JSON negli Appunti, generato in base alla struttura dello schema. Per lo schema "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": [
      
    ]
  }
]

Il payload si presenta come una matrice e ogni elemento della matrice è un oggetto che rappresenta una risorsa XDM personalizzata da esportare. Nell'esempio precedente, sono inclusi il gruppo di campi personalizzati "Loyalty details" e lo schema "Loyalty Members". Tutte le risorse di base utilizzate dallo schema non sono incluse nell’esportazione, in quanto sono disponibili in tutte le sandbox e le organizzazioni IMS.

Tieni presente che 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 della posizione in cui si importa 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 all’endpoint /import nell’API del Registro di sistema dello schema. Per informazioni dettagliate su come configurare la chiamata per l’invio dello schema all’organizzazione IMS e alla sandbox desiderata, consulta la sezione sull’ importazione di una risorsa XDM nell’API .

Passaggi successivi

Seguendo questa guida, hai esportato correttamente uno schema XDM in un’organizzazione IMS o sandbox diversa. Per ulteriori informazioni sulle funzionalità dell'interfaccia utente di Schemi, consulta la Panoramica dell'interfaccia utente di Schemi .

In questa pagina