Definición de campos XDM en la interfaz de usuario

La variable Schema Editor en la interfaz de usuario de Adobe Experience Platform, puede definir sus propios campos dentro de las clases personalizadas del Modelo de datos de experiencia (XDM) y los grupos de campos de esquema. Esta guía trata los pasos para definir los campos XDM en la interfaz de usuario, incluidas las opciones de configuración disponibles para cada tipo de campo.

Requisitos previos

Esta guía requiere una comprensión práctica del sistema XDM. Consulte la Información general de XDM para una introducción al papel de XDM dentro del ecosistema del Experience Platform, y conceptos básicos de la composición del esquema para aprender cómo las clases y los grupos de campos contribuyen a los campos en los esquemas XDM.

Aunque no es necesario para esta guía, se recomienda seguir también el tutorial de composición de un esquema en la interfaz de usuario para familiarizarse con las diversas capacidades de la Schema Editor.

Seleccionar un recurso al que añadir campos

Para definir nuevos campos XDM en la interfaz de usuario, primero debe abrir un esquema en la Schema Editor. Según los esquemas que estén disponibles actualmente para usted en la variable Schema Library, puede elegir crear un nuevo esquema o seleccionar un esquema existente para editar.

Una vez que tenga la variable Schema Editor abra, los controles para añadir o editar campos aparecerán en el lienzo. Estos controles aparecen junto al nombre del esquema, así como cualquier campo de tipo de objeto que se haya definido en la clase o grupo de campos seleccionados.

ADVERTENCIA

Si intenta agregar un campo a un objeto proporcionado por un grupo de campos estándar, ese grupo de campos se convertirá en un grupo de campos personalizado y el grupo de campos original dejará de estar disponible. Consulte la sección sobre adición de campos a grupos de campos estándar en la guía de la interfaz de usuario de esquemas para obtener más información.

Para agregar un nuevo campo al recurso, seleccione la opción plus (+) junto al nombre del esquema en el lienzo o junto al campo de tipo de objeto en el que desea definir el campo.

Dependiendo de si va a añadir un campo directamente a un esquema o a sus clases y grupos de campos constituyentes, los pasos necesarios para añadir el campo variarán. El resto de este documento se centra en cómo configurar las propiedades de un campo independientemente de dónde aparezca ese campo en el esquema. Para obtener más información sobre las distintas formas en que se pueden añadir campos a un esquema, consulte las siguientes secciones en la guía de interfaz de usuario de esquemas:

Definición de las propiedades de un campo

Después de seleccionar la variable plus (+) icono, un Campo nuevo aparece en el lienzo, ubicado dentro de un objeto con espacio de nombres para su ID de inquilino único (se muestra como _tenantId en el ejemplo siguiente). Todos los campos personalizados que se agregan a un esquema se colocan automáticamente dentro de este espacio de nombres para evitar conflictos con otros campos de clases y grupos de campos proporcionados por Adobe.

En el carril derecho debajo de Propiedades del campo, puede configurar los detalles del nuevo campo. Se requiere la siguiente información para cada campo:

Propiedad Field Descripción
Nombre del campo Un nombre único y descriptivo para el campo. Tenga en cuenta que el nombre del campo no se puede cambiar una vez guardado el esquema.

El nombre debería escribirse idealmente en camelCase. Puede contener caracteres alfanuméricos, guiones o guiones bajos, pero no podrá empiece con un guion bajo.
  • Correcto: fieldName
  • Aceptable: field_name2, Field-Name, field-name_3
  • Incorrecto: _fieldName
Nombre para mostrar Nombre reconocible para el campo.
Tipo Tipo de datos que contendrá el campo. En este menú desplegable, puede seleccionar una de las tipos escalares estándar compatible con XDM, o con uno de los campos múltiples tipos de datos que se han definido previamente en la variable Schema Registry.

También puede seleccionar Búsqueda avanzada de tipo para buscar y filtrar tipos de datos existentes y localizar el tipo deseado con mayor facilidad.

También puede proporcionar un Descripción al campo para proporcionar más contexto en cuanto al caso de uso previsto del campo.

NOTA

Según el Tipo Si ha seleccionado para el campo, es posible que aparezcan controles de configuración adicionales en el carril derecho. Consulte la sección sobre propiedades de campo específicas del tipo para obtener más información sobre estos controles.

El carril derecho también proporciona casillas de verificación para designar tipos de campo especiales. Consulte la sección sobre tipos de campos especiales para obtener más información.

Una vez que haya terminado de configurar el campo, seleccione Aplicar.

El lienzo se actualiza para mostrar el nombre y el tipo del campo, y el carril derecho muestra ahora la ruta del campo, además de sus otras propiedades.

Puede seguir los pasos anteriores para añadir más campos al esquema. Una vez guardado el esquema, sus grupos de clases base y de campos también se guardan si se han realizado cambios en ellos.

NOTA

Los cambios que realice en los grupos de campos o en la clase de un esquema se reflejarán en todos los demás esquemas que los empleen.

Propiedades de campo específicas del tipo

Al definir un nuevo campo, pueden aparecer opciones de configuración adicionales en el carril derecho en función de la variable Tipo seleccione para el campo . La siguiente tabla describe estas propiedades de campo adicionales junto con sus tipos compatibles:

Propiedad Field Tipos compatibles Descripción
Valor predeterminado Cadena, Duplicado, Largo, Número entero, Corto, Byte, Booleano Valor predeterminado que se asigna a este campo si no se proporciona ningún otro valor durante la ingesta. Este valor debe ajustarse al tipo seleccionado del campo.
Patrón Cadena A expresión regular que el valor de este campo debe cumplir para que se acepte durante la ingesta.
Formato Cadena Seleccione entre una lista de formatos predefinidos para cadenas a las que debe ajustarse el valor. Los formatos disponibles incluyen:
Longitud mínima Cadena El número mínimo de caracteres que debe contener la cadena para que el valor se acepte durante la ingesta.
Longitud máxima Cadena El número máximo de caracteres que debe contener la cadena para que se acepte el valor durante la ingesta.
Valor mínimo Duplicada El valor mínimo para que se acepte el valor Double durante la ingesta. Si el valor introducido coincide exactamente con el introducido aquí, se acepta el valor . Al utilizar esta restricción, la variable "Valor mínimo exclusivo" debe dejarse en blanco.
Valor máximo Duplicada El valor máximo para el Double que se va a aceptar durante la ingesta. Si el valor introducido coincide exactamente con el introducido aquí, se acepta el valor . Al utilizar esta restricción, la variable "Valor máximo exclusivo" debe dejarse en blanco.
Valor mínimo exclusivo Duplicada El valor máximo para el Double que se va a aceptar durante la ingesta. Si el valor introducido coincide exactamente con el introducido aquí, se rechaza el valor. Al utilizar esta restricción, la variable "Valor mínimo" (no exclusiva) debe dejarse en blanco.
Valor máximo exclusivo Duplicada El valor máximo para el Double que se va a aceptar durante la ingesta. Si el valor introducido coincide exactamente con el introducido aquí, se rechaza el valor. Al utilizar esta restricción, la variable "Valor máximo" (no exclusiva) debe dejarse en blanco.

Tipos de campos especiales

El carril derecho proporciona varias casillas de verificación para designar funciones especiales para el campo seleccionado. Los casos de uso de algunas de estas opciones implican consideraciones importantes con respecto a su estrategia de modelado de datos y a cómo pretende utilizar los servicios de Platform descendentes.

Para obtener más información sobre estos tipos especiales, consulte la siguiente documentación:

Aunque técnicamente no es un tipo de campo especial, también se recomienda visitar la guía de definición de campos de tipo de objeto para obtener más información sobre la definición de subcampos anidados si sus estructuras de esquema.

Pasos siguientes

Esta guía proporciona información general sobre cómo definir campos XDM en la interfaz de usuario. Recuerde que los campos solo se pueden agregar a esquemas mediante el uso de clases y grupos de campos. Para obtener más información sobre cómo administrar estos recursos en la interfaz de usuario, consulte las guías sobre la creación y edición clases y grupos de campos.

Para obtener más información sobre las capacidades de la variable Esquemas espacio de trabajo, consulte Esquemas información general del espacio de trabajo.

En esta página