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.

Este tutorial explica los pasos para explorar los esquemas, las clases, los grupos de campos y los tipos de datos 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 Schemas en el panel de navegación izquierdo. El espacio de trabajo Schemas proporciona una ficha Browse para explorar todos los esquemas de su organización, junto con fichas dedicadas adicionales para explorar Classes, Field groups, Data types y Relationships respectivamente.

El icono de filtro ( ) muestra los controles en el carril izquierdo para reducir los resultados de la lista. Los filtros de recursos están disponibles para esquemas y relaciones en las fichas Browse y Relationships respectivamente.

En la ficha Browse del área de trabajo Schemas, puede filtrar el inventario de esquemas. Utilice la opción Included in Profile para mostrar solo los esquemas que se han habilitado para su uso en Perfil del cliente en tiempo real. Utilice la opción Show adhoc schemas para filtrar la lista de esquemas creados con campos con espacio de nombres para su uso solamente por un único conjunto de datos.

En la ficha Relationship del área de trabajo Schemas, puede filtrar la lista de relaciones en función de cuatro criterios. Los filtros incluyen Source schema, Destination schema, Source class y Destination class. La siguiente tabla proporciona una descripción de los filtros.

También puede utilizar la barra de búsqueda para reducir aún más los resultados.

Los recursos mostrados en los resultados de búsqueda se ordenan primero por coincidencias de título y luego por coincidencias de descripción. A su vez, cuanto más coincidan las palabras en cualquiera de estas categorías, más alto aparecerá el recurso en la lista.

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

Administrar esquemas, clases, grupos de campos y tipos de datos: acciones y eliminación xdm-resource-actions

Utilice esta sección cuando necesite administrar o eliminar recursos XDM, o cuando una acción (como eliminar) no esté disponible y necesite comprender por qué.

Dónde encontrar acciones (página en línea frente a página de detalles) where-to-find-actions

Para realizar acciones como eliminar, exportar o copiar un recurso, utilice uno de los siguientes puntos de entrada:

En las fichas Browse, Classes, Field groups y Data types, las acciones de administración están disponibles en dos ubicaciones:

Estas acciones son coherentes en ambos puntos de entrada para los tipos de recursos admitidos (esquemas, clases, grupos de campos y tipos de datos).

Acciones disponibles available-actions

Según el tipo de recurso y los permisos, pueden estar disponibles las siguientes acciones:

Lo siguiente se aplica a diferentes tipos de recursos:

Eliminar comportamiento delete-behavior

Utilice la acción Delete cuando desee eliminar un recurso personalizado que ya no sea necesario.

Para eliminar un recurso:

El recurso se elimina permanentemente de su organización después de la confirmación.

Si la eliminación no está disponible para un recurso, la opción aparece deshabilitada con información del objeto que explica por qué no se puede realizar la acción.

Restricciones (conjunto de datos, perfil, RBAC, inquilino frente a global) delete-constraints

Si una acción como Delete no está disponible o está deshabilitada, normalmente se debe a una de las siguientes condiciones:

Estas restricciones se reflejan directamente en la interfaz de usuario. Cuando una acción no está disponible, aparece deshabilitada e incluye información sobre herramientas que explica la limitación específica.

Si no puede eliminar un recurso, revise las condiciones anteriores para determinar si necesita actualizar los permisos, eliminar dependencias o ajustar el modelo de datos.

Para ver flujos de trabajo adicionales de edición de esquemas en el lienzo, consulte Crear y editar esquemas en la interfaz de usuario.

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

Dentro del Editor de esquemas, las clases y los grupos de campos estándar (generados por Adobe) se indican con el icono de candado ( . El candado aparece en el carril izquierdo junto al nombre de la clase o del grupo de campos, así como junto a cualquier campo del diagrama de esquema que forme parte de un recurso generado por el sistema.

Consulte la documentación de Agregar campos personalizados a grupos de campos estándar para obtener instrucciones. No se puede editar una clase 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 String[] indica que el campo espera una matriz de valores de cadena. Un tipo de datos de Payment Item[] indica una matriz de objetos que se ajustan al tipo de datos de Payment Item.

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.

Field properties field-properties

Al seleccionar el nombre de cualquier campo en el lienzo, el carril derecho se actualiza para mostrar detalles sobre ese campo en Field properties. Esto puede incluir una descripción del caso de uso previsto del campo, los valores predeterminados, los patrones, los formatos, si el campo es obligatorio o no, y más.

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 se mostrará en el carril izquierdo bajo Relationships. 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 luego Edit relationship en la barra lateral Field properties. Los parámetros de la relación se muestran en el cuadro de diálogo Edit relationship 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.

Próximos pasos

En este documento se explica cómo explorar los recursos XDM existentes en la interfaz de usuario de Experience Platform. Para obtener más información sobre las distintas características del área de trabajo Schemas y Schema Editor, vea la descripción general del área de trabajo Schemas.