Creación y edición de esquemas en la IU ui-create-and-edit

En Adobe Experience Platform, la clase de un esquema define los aspectos de comportamiento de los datos que contendrá el esquema (registro o serie temporal). Además, las clases describen el menor número de propiedades comunes que todos los esquemas basados en esa clase necesitarían incluir y proporcionan una forma de combinar varios conjuntos de datos compatibles.

Adobe proporciona varias clases de modelo de datos de experiencia (XDM) estándar ("principales"), incluidas XDM Individual Profile y XDM ExperienceEvent. Además de estas clases principales, también puede crear sus propias clases personalizadas para describir casos de uso más específicos para su organización.

Este documento proporciona información general sobre cómo crear, editar y administrar clases personalizadas en la interfaz de usuario de Experience Platform.

Requisitos previos prerequisites

Esta guía requiere una comprensión práctica del sistema XDM. Consulte la descripción general de XDM para ver 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 conocer cómo las clases contribuyen a los esquemas XDM.

Aunque no es necesario para esta guía, se recomienda que también siga el tutorial sobre maquetar un esquema en la interfaz de usuario para familiarizarse con las diversas funcionalidades del Editor de esquemas.

Introducción getting-started

En la interfaz de usuario de Platform, seleccione Esquemas en el panel de navegación izquierdo para abrir el área de trabajo Esquemas y, a continuación, seleccione la pestaña Clases. Se muestra una lista de las clases disponibles.

Se ha resaltado el número de clases dentro de la ficha Clases del espacio de trabajo Esquemas Clases y Esquemas.

Filtrar clases filter

La lista de clases se filtra automáticamente en función de cómo se crearon. La configuración predeterminada muestra las clases definidas por el Adobe. También puede filtrar la lista para mostrar los que ha creado su organización. Seleccione el botón de opción para elegir entre las opciones Estándar y Personalizado. La opción Standard muestra las entidades creadas por Adobe y la opción Custom muestra las entidades creadas dentro de su organización.

Se ha resaltado la ficha Clases del área de trabajo Esquemas con Estándar y Personalizado.

TIP
Utilice las funcionalidades de búsqueda para filtrar o encontrar una clase según su nombre. Consulte la guía Exploración de recursos XDM para obtener más información.

Crear una nueva clase create

Existen dos métodos para crear una clase en la interfaz de usuario de Platform, mediante Crear clase o Crear esquema.

Crear clase

Seleccione Crear clase de la ficha Clases en el área de trabajo de Esquemas.

La ficha Clases del área de trabajo Esquemas con Crear clase resaltada

Aparecerá el cuadro de diálogo Crear clase. Escriba un Nombre para mostrar y una Descripción para su clase y elija el comportamiento deseado de la clase con los botones de opción. Las clases pueden ser del tipo Registro o Serie temporal. Seleccione Crear para confirmar sus opciones y volver a la ficha Clases.

Se ha resaltado el cuadro de diálogo Crear clase con Crear.

La clase que ha creado está disponible y se enumera en la vista Clases.

La ficha Clases del área de trabajo Esquemas con la clase creada recientemente resaltada.

Crear esquema

Como alternativa, puede crear una clase creando manualmente un esquema. Seleccione Crear esquema de la ficha Clases en el área de trabajo de Esquemas.

La ficha Clases del área de trabajo Esquemas con Crear esquema resaltado

Seleccione Manual en el cuadro de diálogo Crear un esquema que aparece.

NOTE
Si utiliza el flujo de trabajo de creación de esquemas asistidos por ML, puede cargar un archivo y utilizar algoritmos XML para generar un esquema recomendado. En ese flujo de trabajo de creación de esquemas, no es necesario especificar la clase base para el esquema. Para saber cómo ML puede recomendar una estructura de esquema basada en un archivo csv, consulte la guía de creación de esquemas asistida por aprendizaje automático.

El cuadro de diálogo Crear un esquema con las opciones de flujo de trabajo y la selección resaltadas.

Aparecerá el flujo de trabajo de creación de esquemas. En la sección Detalles del esquema, seleccione Otro. Aparecerá una lista de las clases disponibles. Seleccione Crear clase.

El flujo de trabajo Crear esquema con Otros resaltado en la sección Detalles del esquema.

Aparecerá el cuadro de diálogo Crear clase. Escriba un Nombre para mostrar y una Descripción para su clase y elija el comportamiento deseado de la clase con los botones de opción. Las clases pueden ser del tipo Registro o Serie temporal. Seleccione Crear para confirmar sus opciones y volver a la ficha Clases.

Se ha resaltado el cuadro de diálogo Crear clase con Crear.

La lista de clases se actualiza en la sección Detalles del esquema y la clase recién creada se selecciona automáticamente. Seleccione Siguiente para continuar creando su esquema.

La sección Detalles del esquema con la nueva clase seleccionada y Siguiente resaltada.

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. palo de golfLa 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.

Se ha resaltado la sección Nombre y revisión del flujo de trabajo Crear esquema con Nombre para mostrar esquema, Descripción y Finalizar.

Adición de campos a una clase add-fields

Una vez que tenga un esquema que emplee una clase personalizada abierta en el Editor de esquemas, puede empezar a agregar campos a la clase. Para agregar un nuevo campo, seleccione el icono más (+) junto al nombre del esquema.

IMPORTANT
Cuando genere un esquema que implemente una clase definida por su organización, recuerde que los grupos de campos de esquema solo están disponibles para su uso con clases compatibles. Dado que la clase que definió es nueva, no hay grupos de campos compatibles enumerados en el cuadro de diálogo Agregar grupo de campos. En su lugar, deberá crear nuevos grupos de campos para usarlos con esa clase. La próxima vez que cree un esquema que implemente la nueva clase, los grupos de campos que definió se enumerarán y estarán disponibles para su uso.

Editor de esquemas con el botón Agregar resaltado.

IMPORTANT
Tenga en cuenta que cualquier campo que agregue a una clase se utilizará en todos los esquemas que empleen esa clase. Por lo tanto, debe considerar cuidadosamente qué campos son útiles en todos los casos de uso del esquema. Si está pensando en agregar un campo que podría ver el uso solamente en algunos esquemas bajo esta clase, puede que desee considerar agregarlo a esos esquemas creando un grupo de campos en su lugar.

Aparece un marcador de posición Campo sin título en el lienzo, y el carril derecho se actualiza para mostrar controles para configurar las propiedades del campo. En Asignar a, seleccione Clase.

Campo sin título en el lienzo del Editor de esquemas con la propiedad de campo Asignar a Clase seleccionada y resaltada.

Consulte la guía definición de campos en la interfaz de usuario para ver los pasos específicos sobre cómo configurar y agregar el campo a la clase. Siga agregando tantos campos como sea necesario a la clase. Cuando termine, seleccione Guardar para guardar tanto el esquema como la clase.

Esquema recién creado en el lienzo del Editor de esquemas, con Guardar resaltado.

Si ha creado anteriormente esquemas que emplean esta clase, los campos recién agregados aparecerán automáticamente en esos esquemas.

Edición de una clase (#edit-a-class)

NOTE
Solo las clases personalizadas definidas por su organización se pueden editar y personalizar por completo. Para las clases principales definidas por Adobe, solo se pueden editar los nombres para mostrar de sus campos dentro del contexto de esquemas individuales. Consulte la sección sobre edición de nombres para mostrar para campos de esquema para obtener más información.
Una vez guardada una clase personalizada y utilizada en la ingesta de datos, solo se pueden realizar cambios adicionales en ella a partir de entonces. Consulte las reglas de evolución de esquema para obtener más información.

Puede editar una clase a través del flujo de trabajo del esquema editando un esquema existente que extienda la clase o creando manualmente un esquema. No es posible editar directamente una clase. Desde la ficha Examinar del área de trabajo Esquemas, seleccione una clase existente o Crear un esquema.

Se resaltó el Editor de esquemas con una clase existente y Crear un esquema.

Si decide crear un nuevo esquema, consulte la sección sobre creación de un esquema para obtener detalles. Cuando haya terminado de crear el esquema (o después de seleccionar uno existente), aparecerá el Editor de esquemas. Para actualizar un campo de clase existente, seleccione el campo de la estructura de esquema. La información del campo aparece en el carril derecho. Asegúrese de que asigne a
la opción Class está seleccionada o las actualizaciones no afectarán a la clase.

Editor de esquemas con un campo seleccionado y resaltado, y el carril derecho expuesto, resaltando Asignar a.

Realice los cambios que desee en el campo, desplácese hacia abajo en el carril derecho para seleccionar Aplicar para guardar los cambios.

IMPORTANT
Cualquier actualización que realice en los campos se aplicará en todos los esquemas que empleen esa clase, siguiendo las reglas de evolución del esquema.

Editor de esquemas con un campo seleccionado y el carril derecho expuesto, destacando Aplicar.

Para agregar nuevos campos, siga la guía agregar campos a una clase. Cuando termine, seleccione Guardar para guardar tanto el esquema como la clase.

Se resaltó el editor de esquemas con Guardar.

Cambiar la clase de un esquema schema

Puede cambiar la clase del esquema en cualquier momento durante el proceso de creación inicial antes de guardarlo. Sin embargo, esto debe hacerse con precaución, ya que los grupos de campos solo son compatibles con determinadas clases. Al cambiar la clase, se restablecen el lienzo y los campos que se hayan añadido.
Consulte la guía de creación y edición de esquemas para obtener más información.

Pasos siguientes next-steps

En este documento se explica cómo crear y editar clases mediante la interfaz de usuario de Platform. 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 obtener información sobre cómo administrar clases mediante la API de Registro de esquemas, consulte la guía de extremo de clases.

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