Exportación de esquemas XDM en la IU export-xdm-schemas-in-the-UI
Todos los recursos de la biblioteca de esquemas están contenidos en una zona protegida específica de una organización. En algunos casos, es posible que desee compartir recursos del Modelo de datos de experiencia (XDM) entre entornos limitados y organizaciones.
Para resolver esta necesidad, el área de trabajo Schemas de la interfaz de usuario de Adobe Experience Platform le permite generar una carga útil de exportación para cualquier esquema de la biblioteca de esquemas. Esta carga útil se puede utilizar en una llamada a la API de Registro de esquemas para importar el esquema (y todos los recursos dependientes) en una organización y zona protegida de destino.
Requisitos previos
Aunque la IU de Platform le permite exportar recursos XDM, debe utilizar la API de Registro de esquemas para importar esos recursos en otras zonas protegidas u organizaciones para completar el flujo de trabajo. Consulte la guía sobre introducción a la API de Registro de esquemas para obtener información importante sobre los encabezados de autenticación requeridos antes de seguir esta guía.
Generación de una carga útil de exportación generate-export-payload
Las cargas útiles de exportación se pueden generar en la interfaz de usuario de Platform desde el panel de detalles de la pestaña Examinar o directamente desde el lienzo del esquema en el Editor de esquemas.
Para generar una carga útil de exportación, seleccione Esquemas en el panel de navegación izquierdo. En el área de trabajo Esquemas, seleccione la fila del esquema que desea exportar para mostrar los detalles del esquema en la barra lateral derecha.
A continuación, seleccione el icono Copiar JSON (
Esto copia una carga útil JSON en el portapapeles, generada en función de la estructura de esquema. Para el esquema "Loyalty Members" mostrado arriba, se genera el siguiente JSON:
code language-json |
---|
|
La carga útil también se puede copiar seleccionando Más en la parte superior derecha del Editor de esquemas. Un menú desplegable proporciona dos opciones: Copiar estructura JSON y Eliminar esquema.
La carga útil adopta la forma de una matriz, y cada elemento de matriz es un objeto que representa un recurso XDM personalizado que se va a exportar. En el ejemplo anterior, se incluyen el grupo de campos personalizados Loyalty details y el esquema Loyalty Members. Los recursos principales empleados por el esquema no se incluyen en la exportación, ya que estos recursos están disponibles en todas las zonas protegidas y organizaciones.
Tenga en cuenta que cada instancia del ID de inquilino de su organización aparece como <XDM_TENANTID_PLACEHOLDER>
en la carga útil. Estos marcadores de posición se reemplazarán automáticamente con el valor de ID de inquilino adecuado según dónde importe el esquema en el siguiente paso.
Importe el recurso mediante la API import-resource-with-api
Una vez que haya copiado el JSON de exportación para el esquema, puede utilizarlo como carga para una solicitud de POST al extremo /rpc/import
en la API de Registro de esquemas. Consulte la guía de extremo de importación para obtener detalles sobre cómo configurar la llamada para enviar el esquema a la organización y zona protegida deseadas.
Pasos siguientes
Al seguir esta guía, ha exportado correctamente un esquema XDM a una organización o zona protegida diferente. Para obtener más información sobre las capacidades de la interfaz de usuario de Schemas, consulte la descripción general de la interfaz de usuario de Schemas.