Creación y edición de tipos de datos mediante la interfaz de usuario ui-create-and-edit

En el modelo de datos de experiencia (XDM), los tipos de datos son campos reutilizables que contienen varios subcampos. Aunque son similares a los grupos de campos de esquema en el sentido de que permiten el uso coherente de una estructura de varios campos, los tipos de datos son más flexibles porque se pueden incluir en cualquier parte de la estructura de esquema, mientras que los grupos de campos solo se pueden añadir en el nivel raíz.

Adobe Experience Platform proporciona muchos tipos de datos estándar que se pueden utilizar para cubrir una amplia variedad de casos de uso comunes de administración de experiencias. Sin embargo, también puede definir sus propios tipos de datos personalizados para satisfacer sus necesidades comerciales únicas.

Este tutorial trata los pasos para crear y editar tipos de datos personalizados en la interfaz de usuario de 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 ver cómo los tipos de datos 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 de Schema Editor.

Abrir Schema Editor para un tipo de datos data-type

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 Tipos de datos. Se muestra una lista de los tipos de datos disponibles. La lista de tipos de datos se filtra automáticamente en función de cómo se crearon. La configuración predeterminada muestra los tipos de datos definidos por el Adobe. También puede filtrar la lista para mostrar los que ha creado su organización.

A partir de aquí, tiene las siguientes opciones:

Crear un nuevo tipo de datos create

En la ficha Tipos de datos, seleccione Crear tipo de datos.

Aparecerá Schema Editor con la estructura actual del nuevo tipo de datos en el lienzo. En el lado derecho del editor, puede proporcionar un nombre para mostrar y una descripción opcional para el tipo de datos. Asegúrese de proporcionar un nombre único y conciso para el tipo de datos, ya que así es como se identificará al agregarlo a un esquema.

Este tutorial crea un tipo de datos que describe una propiedad de restaurante, de modo que al tipo de datos se le asigna el nombre para mostrar "Restaurante".

Desde aquí, puede saltar a la sección siguiente para empezar a agregar campos al nuevo tipo de datos.

Filtrar tipos de datos filter

La lista de tipos de datos disponibles se filtra previamente en función de cómo se crearon. 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.

Editar un tipo de datos existente edit

Solo se pueden editar los tipos de datos personalizados definidos por su organización. Seleccione Personalizado para mostrar solo los tipos de datos personalizados que sean propiedad de su organización.

Seleccione el tipo de datos que desea editar de la lista para abrir el carril derecho, mostrando los detalles del tipo de datos. Desde el panel de detalles también puede descargar un archivo de muestra, copiar la estructura JSON o añadir el tipo de datos a un paquete.

Seleccione el nombre del tipo de datos en el carril derecho para abrir su estructura en Schema Editor.

Añadir campos al tipo de datos add-fields

Para empezar a agregar campos al tipo de datos, seleccione el icono más (+) junto al campo de nivel raíz en el lienzo. A continuación aparece un nuevo campo y el carril derecho se actualiza para mostrar los controles del nuevo campo.

Utilice los controles del carril derecho para configurar los detalles del nuevo campo. Consulte la guía definición de campos en la interfaz de usuario para ver pasos específicos sobre cómo configurar y agregar el campo al tipo de datos.

El tipo de datos Restaurant requiere un campo de cadena que represente el nombre del restaurante. De este modo, Field name se establece como "name" y Type se establece como "String". Seleccione Aplicar para aplicar los cambios al campo.

Siga agregando más campos al tipo de datos según sea necesario. El tipo de datos de ejemplo Restaurante ahora tiene campos adicionales para la marca, la capacidad de los asientos y la superficie.

Además de los campos básicos, también puede anidar tipos de datos adicionales dentro del tipo de datos personalizado. Por ejemplo, el tipo de datos Restaurante requiere un campo que represente la dirección física de la propiedad. En este escenario, puede agregar un nuevo campo "Dirección" al que se le asigna el tipo de datos estándar "Dirección postal".

Esto demuestra lo flexibles que pueden ser los tipos de datos a la hora de describir sus datos: los tipos de datos pueden emplear campos que también son tipos de datos, que a su vez pueden contener más tipos de datos, etc. Esto le permite abstraer y reutilizar patrones de datos comunes a través de los esquemas XDM, lo que facilita la representación de estructuras de datos complejas.

Cuando haya terminado de agregar campos al tipo de datos, seleccione Guardar para guardar los cambios y agregar el tipo de datos a Schema Library.

Añadir el tipo de datos a un esquema add-data-type

Una vez creado un tipo de datos, puede empezar a utilizarlo en los esquemas. Dado que los esquemas XDM están compuestos por una clase y cero o más grupos de campos, los campos proporcionados por un tipo de datos no se pueden añadir directamente a un esquema. En su lugar, deben incluirse en una clase o un grupo de campos.

Comience por seguir los pasos involucrados con agregar un campo a una clase o agregar un campo a un grupo de campos. Como alternativa, puede empezar a agregar un campo directamente a un esquema y elegir la clase principal o el grupo de campos desde allí. Cuando elija el Tipo para el nuevo campo, seleccione el nombre del tipo de datos en el menú desplegable.

Conversión de un objeto de varios campos en un tipo de datos convert

Cuando crea un campo de tipo de objeto con varios subcampos en Schema Editor, puede convertir ese campo en un tipo de datos para poder utilizar la misma estructura de campo en una clase o grupo de campos diferente.

Para convertir un campo de tipo de objeto en un tipo de datos, seleccione el campo en el lienzo. Antes de convertir el campo, asegúrese de que Display name es descriptivo de los datos que contendrá el objeto, ya que se convertirá en el nombre del tipo de datos. Cuando esté listo para convertir el campo, seleccione Convertir a nuevo tipo de datos en el carril derecho.

El lienzo actualiza el tipo de datos del campo de "Objeto" al nuevo tipo de datos. Esta estructura ahora se puede reutilizar en otras clases y grupos de campos seleccionando este tipo de datos de la lista desplegable Tipo al definir un nuevo campo.

Pasos siguientes next-steps

En esta guía se explica cómo crear y editar tipos de datos 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 los tipos de datos mediante la API Schema Registry, consulte la guía de extremo de tipos de datos.