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"), entre las que se incluyen 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 obtener una introducción del 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 Experience Platform, seleccione Schemas en el panel de navegación izquierdo para abrir el área de trabajo Schemas y, a continuación, seleccione la pestaña Classes. Se muestra una lista de las clases disponibles.

Se ha resaltado el número de clases dentro de la ficha Classes del área de trabajo Schemas Classes y Schemas.

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 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 Standard y Custom. La opción Standard muestra las entidades creadas por Adobe y la opción Custom muestra las entidades creadas dentro de su organización.

La ficha Classes del área de trabajo Schemas con Standard y Custom resaltados.

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 Experience Platform, mediante Create class o Create schema.

Crear clase

Seleccione Create class de la ficha Classes en el área de trabajo Schemas.

La ficha Classes del área de trabajo Schemas con Create class resaltado

Aparecerá el cuadro de diálogo Create class. Escriba Display name y Description para la clase y elija el comportamiento deseado de la clase con los botones de opción. Las clases pueden ser del tipo Record o Time-series. Seleccione Create esta opción para confirmar sus Classes opciones y volver al pestaña.

El Create class cuadro de diálogo con Create resaltado.

La clase que ha creado está disponible y aparece en el Classes vista.

La ficha Classes del área de trabajo Schemas con la clase creada recientemente resaltada.

Crear esquema

Como alternativa, puede crear una clase creando manualmente un esquema. Seleccione Create schema una de las Classes pestaña del Schemas espacio de trabajo.

El Classes pestaña del Schemas espacio de trabajo con Create schema resaltado

Seleccione Manual en el cuadro de Create a schema diálogo que aparece.

NOTE
Si usa el flujo de trabajo de creación de esquema asistido por ML, puede cargar un archivo y usar algoritmos de ML para generar un esquema recomendado. En ese flujo de trabajo de creación de esquema, no es necesario especificar la clase base para el esquema. Para obtener información sobre cómo ML puede recomendar una estructura esquema basada en un archivo csv, consulte el guía de creación de esquema asistido por aprendizaje automático.

La Crear un cuadro de diálogo esquema con las opciones de flujo de trabajo y seleccione resaltado.

Aparecerá el flujo de trabajo de creación de esquemas. En la sección Schema details, seleccione Other. Aparecerá una lista de las clases disponibles. Seleccione Create class.

El flujo de trabajo Create schema con Other resaltado en la sección Schema details.

Aparecerá el cuadro de diálogo Create class. Escriba Display name y Description para la clase y elija el comportamiento deseado de la clase con los botones de opción. Las clases pueden ser del tipo Record o Time-series. Seleccione Create para confirmar sus opciones y volver a la ficha Classes.

El Create class cuadro de diálogo con Create resaltado.

La clase lista se actualiza en la Schema details sección y la clase recién creada se selecciona automáticamente. Seleccione Next esta opción para continuar creando la esquema.

Sección Schema details con la nueva clase seleccionada y Next resaltada.

Después de seleccionar una clase, aparecerá la Name and review sección. En esta sección, proporcionará un nombre y una descripción para identificar a su esquema.La estructura base del esquema (proporcionada por la clase) se muestra en el lienzo para que pueda revisar y verificar la clase seleccionada y esquema estructura.

Introduzca un lenguaje práctico Schema display name en el campo de texto. Siguiente, escriba una descripción adecuada para ayudar a identificar su esquema. Cuando haya revisado la estructura esquema y esté satisfecho con la configuración, seleccione Finish crear su esquema.

La Name and review sección del Create schema flujo de trabajo con , Schema display nameDescriptiony Finish resaltado.

añadir campos a una clase add-fields

Una vez que tenga una esquema que emplea una clase personalizada abierta en el Editor de esquemas, puede inicio 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 Add field group. 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 Untitled Field en el lienzo y el carril derecho se actualiza para mostrar controles para configurar las propiedades del campo. En Assign to, seleccione Class.

Campo sin título en el lienzo del Editor de esquemas con la propiedad de campo Asignar a Class 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 Save para guardar el esquema y la clase.

Esquema recién creado en el lienzo del Editor de esquemas, con Save 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. En la ficha Browse del área de trabajo Schemas, seleccione una clase existente o Create a schema.

El Editor de esquemas con una clase existente y Create a schema resaltado.

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 Assign to
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 Assign to.

Realice los cambios que desee en el campo, desplazándose hacia abajo en el carril derecho para seleccionar Apply y 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 la derecha carril expuesto, resaltando Apply.

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

Editor de esquemas con Save resaltado.

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.

Próximos pasos next-steps

En este documento se explica cómo crear y editar clases mediante la interfaz de usuario de Experience Platform. Para obtener más información sobre las capacidades del área de trabajo Schemas, vea la descripción general del área de trabajo Schemas.

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