Exploración de recursos de esquema en la IU

En Adobe Experience Platform, todos los recursos de esquema del Modelo de datos de experiencia (XDM) se almacenan en Schema Library, incluidos los recursos estándar proporcionados por Adobe y los recursos personalizados definidos por su organización. En la interfaz de usuario de Experience Platform, puede ver la estructura y los campos de cualquier esquema, clase, grupo de campos o tipo de datos existente en Schema Library. Esto resulta especialmente útil a la hora de planificar y preparar la ingesta de datos, ya que la interfaz de usuario proporciona información sobre los tipos de datos esperados y los casos de uso de cada campo proporcionado por estos recursos XDM.

En esta guía se explica cómo explorar esquemas, clases, grupos de campos, tipos de datos y relaciones existentes en la interfaz de usuario de Experience Platform.

Búsqueda de un recurso de esquema lookup

En la interfaz de usuario de Experience Platform, seleccione Esquemas en el carril izquierdo. El área de trabajo Esquemas proporciona una ficha Examinar en la que puede ver todos los esquemas de su organización. También puede usar las fichas Clases, Grupos de campos, Tipos de datos y Relaciones para ver esos recursos.

Filtrar y buscar esquemas filter-search

Utilice las herramientas de filtrado y búsqueda del área de trabajo Schemas para reducir la lista de esquemas y localizar recursos específicos más rápidamente. El icono de filtro ( ) abre el panel de filtro, donde puede filtrar esquemas usando metadatos, identidad, relación, fecha y criterios de propiedad. Los filtros de recursos están disponibles en las fichas Examinar y Relaciones.

Filtros de metadatos de esquema

Filtre los esquemas por sus características fundamentales y atributos organizativos.

Filtros de atributos de esquema

Resultados estrechos basados en la estructura de esquema y la configuración de identidad.

Filtros temporales y de creador

Filtrar esquemas basados en patrones de creación y propiedad.

Filtros de la pestaña Relación

Cuando visualice relaciones de esquema en la ficha Relaciones, utilice filtros adicionales para explorar conexiones de esquema:

Combinación de varios filtros

Combine filtros para reducir la lista de esquemas y buscar recursos específicos más rápidamente. Por ejemplo, puede encontrar esquemas estándar con perfil habilitado con etiquetas personalizadas que se crearon en el último mes, o bien localizar esquemas ad hoc que utilicen una identidad principal de correo electrónico y contengan campos de relación.

Los filtros aplicados aparecen como chips extraíbles en la fila de encabezado del inventario. Para quitar un filtro, selecciona × en su chip. Para quitar todos los filtros activos a la vez, seleccione Borrar todo.

Utilice la barra de búsqueda para reducir aún más los resultados.

Los resultados de la búsqueda se clasifican según las coincidencias en los títulos y las descripciones de los recursos. Las coincidencias de título tienen prioridad sobre las coincidencias de descripción y los recursos con términos más coincidentes aparecen en una posición superior en la lista de resultados.

Cuando haya encontrado el recurso que desea explorar, seleccione su nombre en la lista para ver su estructura en el lienzo.

Examinar, organizar y administrar esquemas browse-organize-manage-schemas

Utilice el área de trabajo Esquemas para buscar, organizar y administrar esquemas. Puede filtrar el inventario de esquemas, ordenar columnas de metadatos y realizar acciones de esquema comunes directamente desde la vista de inventario.

Examen y filtrado de metadatos

El inventario de esquemas muestra los metadatos de esquema clave en una sola vista de tabla. Puede ver etiquetas, tipo de esquema, estado de habilitación de perfil, fecha de creación, fecha de última modificación, clase, identidades, relaciones, comportamiento y otros metadatos sin abrir esquemas individuales.

Para ordenar el inventario, seleccione un encabezado de columna. Vuelva a seleccionar el mismo encabezado de columna para invertir el orden.

Si el inventario contiene más resultados de los que caben en una sola página, utilice los controles de página situados en la parte inferior de la lista para desplazarse por las páginas.

Realizar acciones en línea en esquemas

Utilice el menú de los tres puntos de una fila de esquema para realizar acciones de esquema comunes directamente desde la vista de inventario.

Las acciones están disponibles tanto en la vista de inventario como en la vista de detalles de recursos. Algunas acciones solo están disponibles para recursos personalizados (definidos por el inquilino). Los recursos estándar proporcionados por Adobe pueden tener opciones de acción limitadas.

Según el tipo de recurso y los permisos, puede editar las propiedades del esquema, aplicar etiquetas de control de datos, eliminar esquemas y administrar etiquetas sin abrir el esquema. Entre las acciones adicionales se incluyen mover esquemas a carpetas, añadir esquemas a paquetes de implementación, copiar el esquema JSON y descargar archivos de muestra para realizar pruebas.

Para obtener instrucciones detalladas sobre cada acción, consulte la guía de acciones de esquema.

Navegación por esquemas utilizando etiquetas y carpetas

Utilice etiquetas y carpetas para organizar y localizar esquemas en el inventario. Las etiquetas ayudan a agrupar esquemas por proyecto, equipo, dominio de datos u otras categorías definidas por la organización. Las carpetas proporcionan una estructura jerárquica para organizar esquemas relacionados.

Para filtrar esquemas por etiqueta, seleccione el icono de filtro ( ) para abrir el panel de filtro. A continuación, seleccione una o más etiquetas de la lista desplegable Tiene alguna etiqueta.

Para examinar los esquemas por carpeta, seleccione el icono mostrar carpetas ( ). La jerarquía de carpetas aparece en el carril izquierdo. Seleccione una carpeta para ver sus esquemas asociados.

Las etiquetas y carpetas funcionan con el sistema de filtrado de inventario, lo que le permite reducir la lista de esquemas en función de sus etiquetas y ubicaciones de carpetas asignadas.

Para obtener información sobre cómo crear y administrar etiquetas en Experience Platform, consulte la guía de administración de etiquetas unificadas.

Exploración de un recurso XDM en el lienzo explore

Una vez seleccionado un recurso, su estructura se abre en el lienzo.

Todos los campos de tipo de objeto que contienen subpropiedades se contraen de forma predeterminada la primera vez que aparecen en el lienzo. Para mostrar las subpropiedades de cualquier campo, seleccione el icono junto a su nombre.

Indicador de clase y grupo de campos estándar standard-class-and-field-group-indicator

En el Editor de esquemas, las clases estándar y los grupos de campos muestran un icono de candado ( ). El icono identifica los recursos generados por Adobe que tienen restricciones de edición. Aparece en el carril izquierdo junto a los nombres de clase y grupo de campos y junto a los campos que pertenecen a recursos generados por Adobe en el diagrama de esquema.

No se puede editar una clase estándar. Para ampliar un grupo de campos estándar, consulte la documentación Agregar campos personalizados a grupos de campos estándar.

Campos generados por el sistema system-fields

Algunos nombres de campo van precedidos de un guion bajo, como _repo y _id. Representan marcadores de posición para campos que el sistema generará y asignará automáticamente a medida que se incorporen los datos.

Como tal, la mayoría de estos campos deben excluirse de la estructura de los datos al ingerirlos en Experience Platform. La principal excepción a esta regla es el campo _{TENANT_ID}, en el cual todos los campos XDM creados en su organización deben tener un espacio de nombres.

Tipos de datos data-types

Para cada campo que se muestra en el lienzo, su tipo de datos correspondiente se muestra junto a su nombre, lo que indica de un vistazo el tipo de datos que ese campo espera para la ingesta.

Cualquier tipo de datos que se agregue entre corchetes ([]) representa una matriz de ese tipo de datos en particular. Por ejemplo, un tipo de datos de Cadena[] indica que el campo espera una matriz de valores de cadena. Un tipo de datos de Elemento de pago[] indica una matriz de objetos que se ajustan al tipo de datos de Elemento de pago.

Si un campo de matriz se basa en un tipo de objeto, puede seleccionar su icono en el lienzo para mostrar los atributos esperados para cada elemento de matriz.

Propiedades de campo field-properties

Cuando selecciona el nombre de cualquier campo en el lienzo, el carril derecho se actualiza para mostrar detalles sobre ese campo en Propiedades del campo. Esto puede incluir una descripción del caso de uso previsto del campo, valor predeterminado (metadatos de esquema informativo que no se aplican durante la ingesta), patrones, formatos, si el campo es necesario, etc. Consulte propiedades de campo específicas del tipo para ver cómo difiere Valor predeterminado de la configuración de validación de la ingesta. Cuando explora un grupo de campos, los detalles relacionados con etiquetas para el campo seleccionado también pueden aparecer aquí; consulte Etiquetas en la vista de estructura.

Si el campo que está inspeccionando es un campo de enumeración, el carril derecho también mostrará los valores aceptables que el campo espera recibir.

Campos de identidad identity

Al inspeccionar esquemas que contienen campos de identidad, estos campos se enumeran en el carril izquierdo bajo la clase o el grupo de campos que los proporciona al esquema. Seleccione el nombre del campo de identidad en el carril izquierdo para mostrar el campo en el lienzo, independientemente de la profundidad con que esté anidado.

Los campos de identidad se resaltan en el lienzo con un icono de huella digital ( ). Si selecciona el nombre del campo de identidad, puede ver información adicional como el área de nombres de identidad y si el campo es o no la identidad principal del esquema.

Campos de relación relationship

Si está inspeccionando un esquema que contiene un campo de relación, el campo aparecerá en el carril izquierdo bajo Relaciones. Seleccione el nombre del campo de relación en el carril izquierdo para mostrar el campo en el lienzo, independientemente de la profundidad con que esté anidado. Los campos de relación también se resaltan de forma exclusiva en el lienzo, mostrando el nombre del esquema de referencia al que está vinculado el campo. Para las organizaciones con capacidades B2B, se pueden escribir nombres de relación personalizados que se mostrarán en el lienzo en estos casos.

Para ver el área de nombres de identidad de la identidad principal del esquema de referencia, seleccione el campo de relación y, a continuación, Editar relación en la barra lateral de Propiedades del campo. Los parámetros de la relación se muestran en el cuadro de diálogo Editar relación que aparece.

Consulte el tutorial sobre creación de una relación en la interfaz de usuario para obtener más información sobre el uso de relaciones en esquemas XDM.

Explorar grupos de campos: uso y metadatos explore-field-groups

Vaya a Esquemas > Grupos de campos para explorar los grupos de campos. En la pestaña Grupos de campos, las capacidades adicionales le ayudan a comprender dónde se utiliza un grupo de campos en los esquemas y lo que incluye, como la compatibilidad, los campos obligatorios (que aplican requisitos de ingesta) y las señales de control.

Estas funciones le ayudan a evaluar el impacto antes de realizar cambios e identificar grupos de campos relevantes de forma más eficaz durante el diseño del esquema.

Ver el uso del esquema para grupos de campos view-schema-usage-for-field-groups

En la tabla Grupos de campos, seleccione un grupo de campos para abrir su vista de detalles. El lienzo se actualiza para mostrar la estructura del grupo de campos y el carril de propiedades muestra información adicional sobre el recurso seleccionado.

Esquemas que utilizan este grupo de campos

En el carril de propiedades derecho, la sección Esquemas que utilizan este grupo de campos enumera los esquemas que actualmente incluyen el grupo de campos.

Seleccione un nombre de esquema para abrir su vista de detalles en una nueva pestaña e inspeccione cómo se implementa el grupo de campos dentro de ese esquema.

Ver más y una lista de esquemas completa

Si existen más esquemas de los que se pueden mostrar en línea, seleccione Ver más para abrir el cuadro de diálogo completo.

Aparece el cuadro de diálogo Esquemas que utilizan este grupo de campos, que muestra la lista completa de esquemas que utilizan el grupo de campos.

En el cuadro de diálogo Esquemas que utilizan este grupo de campos, puede:

Puede ver detalles del esquema, como el nombre del esquema, la clase y otros atributos.

Este flujo de trabajo está diseñado para análisis y exploración de impacto solamente. No modifica esquemas ni grupos de campos. Para cambiar la estructura del esquema, consulte Crear y editar esquemas en la interfaz de usuario.

Metadatos y filtrado de grupos de campos field-group-metadata-and-filtering

La ficha Grupos de campos proporciona herramientas de filtrado y metadatos que le ayudarán a localizar y evaluar los grupos de campos antes de seleccionarlos.

Examinar tabla y filtros

La tabla de inventario de grupos de campos incluye columnas adicionales que exponen metadatos directamente en la vista de lista, como Clases compatibles, que indica a qué clases se puede aplicar un grupo de campos. Los grupos de campos solo se pueden añadir a esquemas que utilicen una de las clases compatibles enumeradas, según el comportamiento de los datos que representan (por ejemplo, datos basados en registros o en series temporales). La tabla puede mostrar Todos cuando el grupo de campos es compatible con todas las clases. Etiquetas del sector ayudan a categorizar los grupos de campos para la detección.

Para restringir la lista, seleccione el icono de filtro ( ) para abrir el panel de filtro en el carril izquierdo. La siguiente imagen muestra el panel de filtro abierto en el carril izquierdo.

En el panel de filtro, puede:

Durante la exploración, seleccione una fila de la tabla para almacenar en déclencheur el carril de información. El carril de información muestra metadatos como clases compatibles y etiquetas del sector para que pueda revisar los detalles clave sin abrir el grupo de campos.

Metadatos de detalle de grupo de campos

Cuando se abre un grupo de campos, el carril de propiedades muestra metadatos adicionales asociados al recurso.

El carril de propiedades puede mostrar los siguientes metadatos:

Esta información le ayuda a comprender las restricciones y los requisitos antes de utilizar o modificar el grupo de campos.

Etiquetas en la vista de estructura

Cuando un grupo de campos está abierto en el lienzo, puede ver la información de las etiquetas directamente en la estructura. Seleccione el icono de configuración ( ) en la barra de herramientas del lienzo y habilite Mostrar etiquetas en el árbol para mostrar los indicadores de etiquetas en los campos del lienzo.

Seleccione un campo en el lienzo para ver los detalles de la etiqueta en el carril Propiedades del campo, incluidas las etiquetas aplicadas a ese campo.

Las etiquetas se agrupan por categoría (por ejemplo, etiquetas de identidad y confidenciales) y proporcionan visibilidad sobre la gobernanza o las restricciones relacionadas con el acceso aplicadas a los datos.

Estos indicadores solo son para visibilidad y no cambian la estructura del esquema. Para obtener más información, consulte Administrar etiquetas de uso de datos para un esquema.

Próximos pasos

Utilice los siguientes recursos para seguir trabajando con esquemas XDM y funciones de Experience Platform relacionadas: