Creación y edición de esquemas en la IU create-edit-schemas-in-ui
Utilice la interfaz de usuario de Adobe Experience Platform para crear, editar y administrar esquemas del Modelo de datos de experiencia (XDM) para su organización. Esta guía muestra cómo crear esquemas estándar y relacionales, personalizar estructuras de esquema, administrar esquemas desde el espacio de trabajo Examinar y preparar esquemas para el uso de producción.
Requisitos previos prerequisites
Esta guía requiere una comprensión práctica del sistema XDM. Consulte la descripción general de XDM para obtener una introducción al papel de XDM en el ecosistema de Experience Platform y los conceptos básicos de la composición de esquemas para obtener una descripción general de cómo se construyen los esquemas.
Creación de un nuevo esquema create
En el área de trabajo Esquemas, seleccione Crear esquema en la esquina superior derecha. Aparecerá el menú desplegable “Seleccionar tipo de esquema” con opciones para Estándar o Relacional esquemas.
Crear un esquema relacional create-relational-schema
Seleccione Relacional para definir esquemas estructurados de estilo relacional con un control preciso de los registros. Los esquemas relacionales admiten la aplicación de claves principales, el control de versiones en el nivel de registro y las relaciones en el nivel de esquema a través de claves principales y externas. También están optimizados para la ingesta incremental mediante la captura de datos de cambio y admiten varios modelos de datos utilizados en implementaciones de Campaign Orchestration, Data Distiller y B2B.
Para obtener más información, consulte la descripción general de Data Mirror o esquema relacional.
Crear manualmente create-manually
Aparecerá el cuadro de diálogo Crear un esquema relacional. Puede elegir Crear manualmente o Cargar archivo DDL para definir la estructura del esquema.
En el cuadro de diálogo Crear un esquema relacional, seleccione Crear manualmente y luego seleccione Siguiente.
Aparecerá la página Detalles del esquema relacional. Escriba un nombre para mostrar en el esquema y una descripción opcional y, a continuación, seleccione Finalizar para crear el esquema.
El Editor de esquemas se abre con un lienzo vacío para definir la estructura del esquema. Puede agregar campos como de costumbre.
Agregar un campo de identificador de versión add-version-identifier
Para habilitar el seguimiento de versiones y admitir la captura de datos de cambio, debe designar un campo de identificador de versión en el esquema. En el Editor de esquemas, seleccione el icono más (
Escriba un nombre de campo como updateSequence y elija un tipo de datos de DateTime o Number.
En el carril derecho, active la casilla de verificación Identificador de versión y, a continuación, seleccione Aplicar para confirmar el campo.
Para definir relaciones, seleccione Agregar relación en el Editor de esquemas para crear relaciones de clave principal/externa de nivel de esquema. Consulte el tutorial sobre agregar relaciones de nivel de esquema para obtener más información.
A continuación, continúe con definir claves principales y agregue campos adicionales según sea necesario. Para obtener instrucciones sobre cómo habilitar la captura de datos modificados en las fuentes de Experience Platform, consulte la guía de ingesta de captura de datos modificados.
Cargar un archivo DDL upload-ddl-file
Utilice este flujo de trabajo para definir el esquema cargando un archivo DDL. En el cuadro de diálogo Crear un esquema relacional, seleccione Cargar archivo DDL y, a continuación, arrastre un archivo DDL local desde el sistema o seleccione Elegir archivos. Experience Platform valida el esquema y muestra una marca de verificación verde si la carga del archivo se realiza correctamente. Seleccione Siguiente para confirmar la carga.
Aparecerá el cuadro de diálogo Seleccionar entidades y campos para importar, que le permitirá obtener una vista previa del esquema. Revise la estructura del esquema y utilice los botones de opción y las casillas de verificación para asegurarse de que cada entidad tiene una clave principal y un identificador de versión especificados.
updateSequence de tipo datetime o number._change_request_type de tipo Cadena para habilitar el procesamiento incremental. Este campo indica el tipo de cambio de datos (por ejemplo, u (actualización) o d (eliminación)).Aunque es necesario durante la ingesta, las columnas de control como _change_request_type no se almacenan en el esquema y no aparecen en la estructura de esquema final. Si todo parece correcto, seleccione Listo para crear el esquema.
El esquema se abre en el Editor de esquemas, donde puede ajustar la estructura antes de guardarlo.
A continuación, continúe con agregar campos adicionales y agregue relaciones de nivel de esquema adicionales según sea necesario.
Para obtener instrucciones sobre cómo habilitar la captura de datos modificados en las fuentes de Experience Platform, consulte la guía de ingesta de captura de datos modificados.
Creación de un esquema estándar create-standard-schema
Seleccione Estándar en el menú de tipo de esquema. Aparecerá el cuadro de diálogo Crear un esquema. En este cuadro de diálogo, elija un flujo de trabajo de creación de esquemas. Puede crear manualmente un esquema añadiendo campos y grupos de campos, o cargar un archivo CSV para generar un esquema automáticamente.
[Beta]{class="badge informative"} Creación manual o de esquemas asistidos por ML manual-or-assisted
Para obtener información sobre cómo utilizar un algoritmo XML para recomendar una estructura de esquema basada en un archivo csv, consulte la guía de creación de esquemas asistida por aprendizaje automático. Esta guía de la interfaz de usuario se centra en el flujo de trabajo de creación manual.
Creación manual de esquemas manual-creation
Aparece el flujo de trabajo Crear esquema. Puede elegir una clase base para el esquema seleccionando Perfil individual, Evento de experiencia o Otro, seguido de Siguiente para confirmar su elección. Consulte la documentación de XDM individual profile y XDM ExperienceEvent para obtener más información sobre estas clases.
Al elegir Otros, aparece una lista de clases disponibles. Desde aquí puede examinar y filtrar clases preexistentes.
Seleccione un botón de opción para filtrar las clases en función de si son clases personalizadas o estándar. También puede filtrar los resultados disponibles según su sector o buscar una clase específica utilizando el campo de búsqueda.
Para ayudarle a decidir la clase adecuada, hay iconos de información y vista previa para cada clase. El icono de información (
El icono de vista previa (
Seleccione cualquier fila para elegir una clase y, a continuación, seleccione Siguiente para confirmar su elección.
Después de seleccionar una clase, aparece la sección Nombre y revisión. En esta sección, proporcione un nombre y una descripción para identificar el esquema. La estructura base del esquema (proporcionada por la clase ) se muestra en el lienzo para que revise y compruebe la clase y la estructura de esquema seleccionadas.
Escriba un nombre para mostrar del esquema descriptivo en el campo de texto. A continuación, introduzca una descripción adecuada para ayudar a identificar el esquema. Cuando haya revisado la estructura de esquema y esté satisfecho con la configuración, seleccione Finalizar para crear el esquema.
Aparecerá el Editor de esquemas con la estructura del esquema mostrada en el lienzo. Si lo desea, ahora puede iniciar agregando campos a la clase.
Editar un esquema existente edit
Para editar un esquema existente, seleccione la ficha Examinar y, a continuación, seleccione el nombre del esquema que desee editar. También puede utilizar la barra de búsqueda para reducir la lista de opciones disponibles.
Una vez seleccionado un esquema, Schema Editor aparece con la estructura del esquema mostrada en el lienzo. Ahora puede personalizar el esquema con las herramientas y opciones descritas en la siguiente sección.
Personalizar un esquema customize-schema
Una vez que tenga un esquema abierto en el Editor de esquemas, puede personalizar su estructura, campos y propiedades de visualización. Esta sección describe las principales opciones de personalización disponibles para adaptar los esquemas a sus necesidades específicas.
Utilice los siguientes vínculos para desplazarse directamente a las tareas de personalización clave dentro de esta sección:
Alternar nombre para mostrar display-name-toggle
Para su comodidad, el Editor de esquemas proporciona un conmutador para cambiar entre los nombres de campo originales y los nombres para mostrar más legibles en lenguaje natural. Esta flexibilidad permite mejorar la capacidad de detección de campos y la edición de los esquemas. La opción se encuentra en la parte superior derecha de la vista Editor de esquemas.
Los nombres para mostrar de los grupos de campos estándar se generan en el sistema, pero se pueden personalizar, tal como se describe en la sección nombres para mostrar. Los nombres para mostrar se reflejan en varias vistas de interfaz de usuario, incluidas las vistas previas de asignaciones y conjuntos de datos. La configuración predeterminada está desactivada y muestra los nombres de campo según sus valores originales.
Adición de grupos de campos a un esquema add-field-groups
Una vez que haya abierto un esquema dentro de Schema Editor, puede agregar campos al esquema mediante el uso de grupos de campos. Para empezar, seleccione Agregar junto a Grupos de campos en el carril izquierdo.
Aparece un cuadro de diálogo que muestra una lista de grupos de campos que puede seleccionar para el esquema. Dado que los grupos de campos solo son compatibles con una clase, solo se enumerarán los grupos de campos asociados con la clase seleccionada del esquema. De forma predeterminada, los grupos de campos enumerados se ordenan según su popularidad de uso dentro de la organización.
Si conoce la actividad general o el área empresarial de los campos que desea agregar, seleccione una o más de las categorías verticales del sector en el carril izquierdo para filtrar la lista mostrada de grupos de campos.
También puede utilizar la barra de búsqueda para localizar el grupo de campos deseado. Los grupos de campos cuyo nombre coincida con la consulta aparecen en la parte superior de la lista. En Campos estándar, se muestran los grupos de campos que contienen campos que describen atributos de datos deseados.
Seleccione la casilla de verificación situada junto al nombre del grupo de campos que desea agregar al esquema. Puede seleccionar varios grupos de campos en la lista, y cada grupo de campos seleccionado aparecerá en el carril derecho.
Una vez que haya elegido los grupos de campos, seleccione Agregar grupos de campos para agregarlos al esquema.
Schema Editor vuelve a aparecer con los campos proporcionados por grupos de campos representados en el lienzo.
Después de agregar un grupo de campos a un esquema, puede quitar campos existentes o agregar nuevos campos personalizados a esos grupos, según sus necesidades.
Quitar campos agregados de grupos de campos remove-fields
Una vez agregado un grupo de campos a un esquema, puede quitar los campos globalmente del grupo de campos u ocultarlos localmente del esquema actual. Comprender la diferencia entre estas acciones es fundamental para evitar cambios no deseados en el esquema.
No utilice esta opción a menos que desee quitar el campo de todos los esquemas que incluyan el grupo de campos.
Para eliminar un campo del grupo de campos, selecciónelo en el lienzo y seleccione Quitar en el carril derecho. Este ejemplo muestra el campo taxId del grupo Detalles demográficos.
Para ocultar varios campos de un esquema sin quitarlos del propio grupo de campos, use la opción Administrar campos relacionados. Seleccione cualquier campo del grupo en el lienzo y, a continuación, seleccione Administrar campos relacionados en el carril derecho.
Aparecerá un cuadro de diálogo que muestra la estructura del grupo de campos. Utilice las casillas de verificación para seleccionar o anular la selección de los campos que desee incluir.
Seleccione Confirmar para actualizar el lienzo y reflejar los campos seleccionados.
Comportamiento del campo al eliminar o dejar de utilizar campos field-removal-deprecation-behavior
Utilice la tabla siguiente para comprender el ámbito de cada acción.
Agregar campos personalizados a grupos de campos add-fields
Después de agregar un grupo de campos a un esquema, puede definir campos adicionales para ese grupo. Sin embargo, cualquier campo agregado a un grupo de campos en un esquema también aparecerá en todos los demás esquemas que empleen el mismo grupo de campos.
Además, si se agrega un campo personalizado a un grupo de campos estándar, ese grupo de campos se convertirá en un grupo de campos personalizados y el grupo de campos estándar original dejará de estar disponible.
Si desea agregar un campo personalizado a un grupo de campos estándar, consulte la sección debajo de para obtener instrucciones específicas. Si está agregando campos a un grupo de campos personalizados, consulte la sección sobre edición de grupos de campos personalizados en la guía de IU de grupos de campos.
Si no desea modificar ningún grupo de campos existente, puede crear un nuevo grupo de campos personalizados para definir campos adicionales en su lugar.
Adición de campos a un esquema add-fields-to-schema
El Editor de esquemas proporciona varias formas de agregar campos a la estructura de esquema. Elija el método que mejor se adapte a sus necesidades específicas.
Utilice los siguientes vínculos para leer acerca de métodos específicos para agregar campos a un esquema:
Añadir campos individuales a un esquema add-individual-fields
El Editor de esquemas permite agregar campos individuales directamente a un esquema si desea evitar agregar un grupo de campos completo para un caso de uso específico. Puede agregar campos individuales de grupos de campos estándar o agregar sus propios campos personalizados en su lugar.
Añadir campos estándar a un esquema add-standard-fields
Puede añadir campos de grupos de campos estándar directamente a un esquema sin necesidad de conocer previamente su grupo de campos correspondiente. Para agregar un campo estándar a un esquema, seleccione el icono más (+) junto al nombre del esquema en el lienzo. Aparece un marcador de posición Campo sin título en la estructura de esquema y el carril derecho se actualiza para mostrar los controles y configurar el campo.
En Nombre de campo, empiece a escribir el nombre del campo que desea agregar. El sistema busca automáticamente los campos estándar que coinciden con la consulta y los enumera en Campos estándar recomendados, incluidos los grupos de campos a los que pertenecen.
Aunque algunos campos estándar comparten el mismo nombre, su estructura puede variar según el grupo de campos del que procedan. Si un campo estándar está anidado en un objeto principal en la estructura de grupo de campos, el campo principal también se incluye en el esquema si se agrega el campo secundario.
Seleccione el icono de vista previa (
El lienzo se actualiza para mostrar el campo estándar agregado al esquema, incluidos los campos principales en los que está anidado dentro de la estructura de grupo de campos. El nombre del grupo de campos también se enumera en Grupos de campos en el carril izquierdo. Si desea agregar más campos del mismo grupo de campos, seleccione Administrar campos relacionados en el carril derecho.
Añadir campos personalizados a un esquema add-custom-fields
Al igual que el flujo de trabajo para los campos estándar, también puede agregar sus propios campos personalizados directamente a un esquema.
Para agregar campos al nivel raíz de un esquema, seleccione el icono de signo más (+) junto al nombre del esquema en el lienzo. Aparece un marcador de posición Campo sin título en la estructura de esquema y el carril derecho se actualiza para mostrar los controles y configurar el campo.
Empiece a escribir el nombre del campo que desea añadir y el sistema comenzará automáticamente a buscar los campos estándar coincidentes. Para crear un nuevo campo personalizado, seleccione la opción superior anexada con (Nuevo campo).
Después de proporcionar un nombre para mostrar y un tipo de datos para el campo, el siguiente paso es asignar el campo a un recurso XDM principal. Si el esquema usa una clase personalizada, puede elegir agregar el campo a la clase asignada o a un grupo de campos en su lugar. Sin embargo, si el esquema utiliza una clase estándar, solo puede asignar el campo personalizado a un grupo de campos.
Asignar el campo a un grupo de campos personalizados add-to-field-group
En Asignar a, seleccione Grupo de campos. Si el esquema utiliza una clase estándar, esta es la única opción disponible y está seleccionada de forma predeterminada.
A continuación, debe seleccionar un grupo de campos al que asociarse el nuevo campo. Empiece a escribir el nombre del grupo de campos en la entrada de texto proporcionada. Si tiene algún grupo de campos personalizados existente que coincida con la entrada, aparecerán en la lista desplegable. También puede escribir un nombre único para crear un nuevo grupo de campos.
Después de seleccionar el grupo de campos de la lista, seleccione Aplicar.
El nuevo campo se agrega al lienzo y tiene un espacio de nombres bajo su ID de inquilino para evitar conflictos con los campos XDM estándar. El grupo de campos con el que asoció el nuevo campo también aparece en Grupos de campos en el carril izquierdo.
Asignar el campo a una clase personalizada add-to-class
En Asignar a, seleccione Clase. El campo de entrada siguiente se reemplaza con el nombre de la clase personalizada del esquema actual, lo que indica que el nuevo campo se asignará a esta clase.
Continúe configurando el campo como desee y seleccione Aplicar cuando termine.
El nuevo campo se agrega al lienzo y tiene un espacio de nombres bajo su ID de inquilino para evitar conflictos con los campos XDM estándar. Al seleccionar el nombre de clase en el carril izquierdo, se muestra el nuevo campo como parte de la estructura de la clase.
Agregar campos personalizados a grupos de campos estándar custom-fields-for-standard-groups
Si el esquema en el que está trabajando tiene un campo de tipo de objeto proporcionado por un grupo de campos estándar, puede agregar sus propios campos personalizados a ese objeto estándar.
Para empezar, seleccione el icono más (+) junto a la raíz del objeto proporcionado por el grupo de campos estándar.
Aparece un mensaje de advertencia que le solicita que confirme si desea convertir el grupo de campos estándar. Seleccione Continuar creando grupo de campos para continuar.
El lienzo vuelve a aparecer con un marcador de posición sin título para el nuevo campo. Tenga en cuenta que el nombre del grupo de campos estándar se ha anexado con “(Extended)” para indicar que se ha modificado desde la versión original. Desde aquí, utilice los controles del carril derecho para definir las propiedades del campo.
Después de aplicar los cambios, el nuevo campo aparece en el área de nombres de ID de inquilino dentro del objeto estándar. Este área de nombres anidada evita conflictos de nombre de campo dentro del propio grupo de campos para evitar cambios importantes en otros esquemas que utilizan el mismo grupo de campos.
Editar nombres para mostrar para campos de esquema display-names
Una vez que haya asignado una clase y agregado grupos de campos a un esquema, puede editar los nombres para mostrar de cualquiera de los campos del esquema, independientemente de si esos campos los han proporcionado recursos XDM estándar o personalizados.
Cambie los nombres de campo a los nombres para mostrar activando Mostrar nombres para mostrar para los campos. Para editar el nombre para mostrar de un campo de esquema, seleccione el campo en el lienzo. En el carril derecho, proporcione el nuevo nombre en Nombre para mostrar.
Seleccione Aplicar en el carril derecho y el lienzo se actualizará para mostrar el nuevo nombre para mostrar del campo. Seleccione Guardar para aplicar los cambios al esquema.
Administrar esquemas manage-schemas
Las tareas de administración de esquemas están disponibles en dos ubicaciones principales de la interfaz de usuario de Experience Platform. Elija el flujo de trabajo adecuado en función de dónde esté trabajando con los esquemas.
Administrar esquemas desde la vista Examinar manage-from-browse
Esta sección describe las acciones de esquema disponibles en la pestaña Examinar; para obtener información sobre la detección de esquemas, el filtrado y la organización, consulte explorar recursos XDM.
Las secciones siguientes describen las acciones de administración de esquemas disponibles en la ficha Examinar. Se puede acceder a estas acciones a través del menú de los tres puntos (…) situado junto a cada fila de esquema.
Editar propiedades del esquema edit-schema-properties
Le lleva directamente al Editor de esquemas con el esquema rellenado previamente.
Eliminar esquema delete-schema
Quita el esquema de su organización. La eliminación solo está disponible para esquemas que no se han habilitado para el perfil del cliente en tiempo real y no tienen conjuntos de datos asociados. Una vez eliminado, el esquema no se puede recuperar.
Aplicar etiquetas de gobernanza de datos apply-data-governance-labels
Lo lleva directamente a la ficha Etiqueta del área de trabajo de esquemas. Para obtener instrucciones completas, consulte la documentación de Administrar etiquetas de uso de datos para un esquema.
Crear conjunto de datos create-dataset
Abre el cuadro de diálogo Crear conjunto de datos a partir del esquema con el nombre de esquema de origen previamente rellenado. Escriba un conjunto de datos Name y, opcionalmente, una Descripción, y luego seleccione Crear conjunto de datos para crear el conjunto de datos.
Una vez creado el conjunto de datos, se abrirá en el área de trabajo Conjuntos de datos.
Administrar etiquetas manage-tags
Abre el cuadro de diálogo Agregar o quitar etiquetas, donde puede asignar o quitar etiquetas definidas por el usuario del esquema. Las etiquetas asignadas a un esquema aparecen en el inventario de esquemas y se pueden utilizar para el filtrado. Para obtener más información sobre la organización basada en etiquetas, consulte explorar recursos XDM.
Mover a carpeta move-to-folder
Abre el cuadro de diálogo Mover, donde puede seleccionar una carpeta de destino o crear una nueva. Los esquemas organizados en carpetas aparecen en la jerarquía de carpetas en el carril izquierdo. Para obtener más información sobre la organización basada en carpetas, consulte explorar recursos XDM.
Añadir al paquete add-to-package
Incluye el esquema en un paquete de herramientas de zona protegida para su implementación en entornos. El esquema debe cumplir los requisitos de idoneidad del paquete. Los paquetes que contienen esquemas se pueden exportar e importar entre entornos limitados.
Copiar estructura JSON copy-json-structure
Copia la representación JSON completa del esquema en el portapapeles. El resultado coincide con la estructura de esquema almacenada en el Registro de esquemas y se puede utilizar para operaciones de API o uso compartido de esquemas.
Descargar archivo de muestra download-sample-file
Genera y descarga un archivo de datos de ejemplo que se ajusta a la estructura de esquema. El archivo contiene valores de ejemplo para cada campo definido en el esquema. Los archivos de muestra están destinados únicamente a probar la estructura de esquema y no deben contener datos de producción.
Administrar esquemas desde el Editor de esquemas manage-from-editor
En el Editor de esquemas, puede realizar acciones rápidas para copiar la estructura JSON del esquema o eliminar el esquema si no se ha habilitado para el perfil del cliente en tiempo real y no tiene conjuntos de datos asociados. Seleccione Más en la parte superior de la vista para mostrar un menú desplegable con acciones rápidas.
La funcionalidad Copiar estructura JSON le permite ver el aspecto que tendría una carga útil de ejemplo mientras sigue creando el esquema y las canalizaciones de datos. Resulta especialmente útil en situaciones en las que hay estructuras de mapa de objetos complejas en el esquema, como un mapa de identidad.
Finalizar un esquema finalize-schema
Una vez que haya terminado de personalizar la estructura de esquema y los campos, es posible que tenga que realizar pasos adicionales para prepararlos para su uso en producción. Estos pasos de configuración finales garantizan que su esquema esté correctamente integrado con los servicios de Experience Platform.
Habilitación de un esquema para el perfil del cliente en tiempo real profile
Perfil del cliente en tiempo real combina datos de diferentes fuentes para crear una vista completa de cada cliente individual. Si desea que los datos capturados por un esquema participen en este proceso, debe habilitar el esquema para su uso en Profile.
Para habilitar el esquema, comience seleccionando el nombre del esquema en el carril izquierdo y, a continuación, seleccione la opción Perfil en el carril derecho.
Aparece una ventana emergente que le advierte de que, una vez activado y guardado un esquema, no se puede desactivar. Seleccione Habilitar para continuar.
El lienzo vuelve a aparecer con la opción Perfil habilitada.
Para finalizar el proceso, seleccione Guardar para guardar el esquema.
El esquema ahora está habilitado para su uso en el Perfil del cliente en tiempo real. Cuando Experience Platform ingiere datos en conjuntos de datos basados en este esquema, esos datos se incorporarán a los datos del perfil amalgamados.
Cambiar la clase de un esquema change-class
Puede cambiar la clase de un esquema en cualquier momento durante el proceso inicial de maquetación antes de guardar el esquema.
Para reasignar una clase, seleccione Assign en el lado izquierdo del lienzo.
Aparece un cuadro de diálogo que muestra una lista de todas las clases disponibles, incluidas las definidas por su organización (el propietario es “Customer”) y las clases estándar definidas por Adobe.
Seleccione una clase de la lista para mostrar su descripción en el lado derecho del cuadro de diálogo. También puede seleccionar Previsualizar estructura de clase para ver los campos y metadatos asociados con la clase. Seleccione Asignar clase para continuar.
Se abre un nuevo cuadro de diálogo en el que se le pide que confirme que desea asignar una nueva clase. Seleccione Asignar para confirmar.
Después de confirmar el cambio de clase, el lienzo se restablecerá y se perderá todo el progreso de la composición.
Próximos pasos next-steps
Este documento cubre los conceptos básicos de la creación y edición de esquemas en la IU de Experience Platform. Se recomienda revisar el tutorial de creación de esquemas para obtener un flujo de trabajo completo que permita crear un esquema completo en la interfaz de usuario, incluida la creación de grupos de campos personalizados y tipos de datos para casos de uso únicos.
Para obtener más información sobre las capacidades del área de trabajo Esquemas, consulte la descripción general del área de trabajo Esquemas.
Para aprender a administrar esquemas en la API Schema Registry, consulte la guía de extremo de esquemas.