DocumentazioneExperience PlatformGuida di Experience Data Model (XDM)

Esportare gli schemi XDM nell’interfaccia utente export-xdm-schemas-in-the-UI

Last update: Thu Nov 20 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Sviluppatore

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, l'area di lavoro Schemas nell'interfaccia utente di Adobe Experience Platform consente di generare un payload di esportazione per qualsiasi schema all'interno di nella raccolta 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.

NOTE
È inoltre possibile utilizzare l’API Schema Registry per esportare altre risorse oltre agli schemi, tra cui classi, gruppi di campi di schema e tipi di dati. Per ulteriori informazioni, consulta la guida dell'endpoint di esportazione.

Prerequisiti

Anche se l’interfaccia utente di Experience 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 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 Experience Platform dal pannello dei dettagli nella scheda Browse o direttamente dall'area di lavoro dello schema nell'Editor di schema.

Per generare un payload di esportazione, selezionare Schemas nel menu di navigazione a sinistra. Nell'area di lavoro Schemas, selezionare la riga dello schema da esportare per visualizzare i dettagli dello schema nella barra laterale a destra.

TIP
Per informazioni dettagliate su come trovare la risorsa XDM che stai cercando, consulta la guida su esplorazione delle risorse XDM.

Selezionare quindi l'icona Copy JSON ( Copia icona ) tra le opzioni disponibili.

Area di lavoro Schemi con una riga di schema e Copy to JSON evidenziata.

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:

Seleziona per espandere un esempio di payload JSON
code language-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": [

    ]
  }
]

È inoltre possibile copiare il payload selezionando More in alto a destra nell'Editor di schema. Un menu a discesa fornisce due opzioni, Copy JSON structure e Delete schema.

NOTE
Non è possibile eliminare uno schema se è abilitato per il profilo o se a esso sono associati set di dati.

Editor schemi con More e Copy to JSON evidenziati.

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, il gruppo di campi personalizzato "Loyalty details" e lo schema "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.

Tieni presente che ogni istanza dell'ID tenant della tua 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 import-resource-with-api

Dopo aver copiato il JSON di esportazione per lo schema, puoi utilizzarlo come payload per una richiesta POST all'endpoint /rpc/import nell'API Schema Registry. Consulta la guida dell'endpoint di importazione 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à dell'interfaccia utente Schemas, vedere la panoramica dell'interfaccia utente Schemas.

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