¿Cómo se agregan campos a un esquema?
Puede agregar campos a un esquema mediante un grupo de campos de esquema. Cada grupo de campos es compatible con una o más clases, lo que permite utilizar el grupo de campos en cualquier esquema que implemente una de esas clases compatibles. Aunque Adobe Experience Platform proporciona varios grupos de campos del sector con sus propios campos predefinidos, puede agregar sus propios campos a un esquema creando grupos de campos personalizados mediante la API o la interfaz de usuario.
Para obtener más información sobre la creación de grupos de campos en la API Schema Registry, consulte la guía de extremo de grupo de campos. Si está usando la interfaz de usuario, vea el tutorial del Editor de esquemas.
¿Cuáles son los mejores usos de los grupos de campos en comparación con los tipos de datos?
Los grupos de campos son componentes que definen uno o más campos de un esquema. Los grupos de campos aplican la forma en que sus campos aparecen en la jerarquía del esquema y, por lo tanto, muestran la misma estructura en todos los esquemas en los que se incluyen. Los grupos de campos solo son compatibles con clases específicas, identificadas por su atributo meta:intendedToExtend
.
Los tipos de datos también pueden proporcionar uno o más campos para un esquema. Sin embargo, a diferencia de los grupos de campos, los tipos de datos no están restringidos a una clase en particular. Esto hace que los tipos de datos sean una opción más flexible para describir estructuras de datos comunes que se pueden reutilizar en varios esquemas con clases potencialmente diferentes.
¿Cuál es el ID único de un esquema?
Todos los recursos de Schema Registry (esquemas, grupos de campos, tipos de datos y clases) tienen un URI que actúa como un ID único a efectos de referencia y búsqueda. Al ver un esquema en la API, se puede encontrar en los atributos de nivel superior $id
y meta:altId
.
Para obtener más información, consulte la sección identificación de recursos en la guía de API Schema Registry.
¿Cuál es el tamaño máximo de un tipo de campo largo?
Un tipo de campo largo es un entero con un tamaño máximo de 53 (+1) bits, lo que le da un rango potencial entre -9007199254740992 y 9007199254740992. Esto se debe a una limitación de cómo las implementaciones de JavaScript de JSON representan enteros largos.
Para obtener más información sobre los tipos de campo, consulte el documento sobre restricciones de tipo de campo XDM.
¿Qué es meta:AltId?
meta:altId
es un identificador único para un esquema. meta:altId
proporciona un identificador fácil de hacer referencia para utilizarlo en llamadas API. Este ID evita la necesidad de codificarlo/descodificarlo cada vez que se utiliza con el formato URI JSON.
¿Cuáles son las restricciones de uso de un tipo de datos de mapa?
XDM impone las siguientes restricciones al uso de este tipo de datos:
- Los tipos de mapa DEBEN ser de tipo objeto.
- Los tipos de mapa NO DEBEN tener propiedades definidas (es decir, definen objetos "vacíos").
- Los tipos de mapa DEBEN incluir un campo additionalProperties.type que describa los valores que se pueden colocar dentro del mapa, ya sea cadena o entero.
- La segmentación de varias entidades solo se puede definir en función de las claves de asignación y no de los valores.
- Las audiencias de la cuenta no admiten mapas.
Vea las restricciones de uso para objetos de mapa para obtener más detalles.
Esquema Identity Management
Esta sección contiene respuestas a preguntas comunes sobre la definición y administración de identidades dentro de los esquemas.
¿Cómo defino las identidades de mi esquema?
En Experience Platform, las identidades se utilizan para identificar a un sujeto (normalmente, una persona individual) independientemente de las fuentes de datos que se interpreten. Se definen en esquemas marcando los campos clave como "Identidad". Los campos más utilizados para la identidad incluyen la dirección de correo electrónico, el número de teléfono, Experience Cloud ID (ECID), el ID de CRM y otros campos de ID únicos.
Los campos se pueden marcar como identidades mediante la API o la interfaz de usuario.
Definición de identidades en la API
En la API, las identidades se establecen creando descriptores de identidad. Los descriptores de identidad indican que una propiedad particular de un esquema es un identificador único.
Los descriptores de identidad se crean mediante una petición POST al extremo /descriptors. Si se ejecuta correctamente, recibirá un estado HTTP 201 (Creado) y un objeto de respuesta que contiene los detalles del nuevo descriptor.
Para obtener más información sobre la creación de descriptores de identidad en la API, consulte el documento en la sección descriptores en la guía para desarrolladores de Schema Registry.
Definición de identidades en la IU
Con el esquema abierto en el Editor de esquemas, seleccione el campo de la sección Estructura del editor que desee marcar como identidad. En Propiedades del campo, en el lado derecho, seleccione la casilla de verificación Identidad.
Para obtener más información sobre la administración de identidades en la interfaz de usuario, consulte la sección sobre definición de campos de identidad en el tutorial del Editor de esquemas.
¿Mi esquema necesita una identidad principal?
Las identidades principales son opcionales, ya que los esquemas pueden tener cero o uno de ellos. Sin embargo, un esquema debe tener una identidad principal para que se pueda usar en Real-Time Customer Profile. Consulte la sección identity del tutorial del editor de esquemas para obtener más información.
Habilitación del perfil de esquema
En esta sección se proporciona orientación sobre la activación de esquemas para utilizarlos con el Perfil del cliente en tiempo real.
¿Cómo habilito un esquema para utilizarlo en Real-Time Customer Profile?
Los esquemas están habilitados para su uso en Real-Time Customer Profile mediante la adición de una etiqueta "union" dentro del atributo meta:immutableTags
del esquema. Se puede habilitar un esquema para usarlo con Profile mediante la API o la interfaz de usuario.
Habilitando un esquema existente para Profile mediante la API
Realice una petición PATCH para actualizar el esquema y agregar el atributo meta:immutableTags
como una matriz que contenga el valor "union". Si la actualización se realiza correctamente, la respuesta mostrará el esquema actualizado que ahora contiene la etiqueta de unión.
Para obtener más información sobre cómo usar la API para habilitar un esquema para utilizarlo en Real-Time Customer Profile, consulte el documento union de la guía para desarrolladores de Schema Registry.
Habilitando un esquema existente para Profile mediante la interfaz de usuario
En Experience Platform, seleccione Esquemas en el panel de navegación izquierdo y seleccione el nombre del esquema que desea habilitar de la lista de esquemas. A continuación, en el lado derecho del editor en Propiedades del esquema, seleccione Perfil para activarlo.
Para obtener más información, consulte la sección sobre usar en Real-Time Customer Profile en el tutorial de Editor de esquemas.
Cuando los datos de Adobe Analytics se importan como origen, ¿está habilitado el esquema creado automáticamente para el perfil?
El esquema no se activa automáticamente para el perfil del cliente en tiempo real. Debe habilitar explícitamente el conjunto de datos para el perfil en función del esquema que esté habilitado para el perfil. Consulte la documentación para conocer los pasos y requisitos necesarios para habilitar un conjunto de datos para utilizarlo en el perfil del cliente en tiempo real.
¿Puedo eliminar esquemas con perfil habilitado?
No puede eliminar un esquema una vez habilitado para el Perfil del cliente en tiempo real. Una vez que un esquema está habilitado para el perfil, no se puede deshabilitar ni eliminar, y los campos no se pueden eliminar del esquema. Por lo tanto, es crucial planificar y verificar cuidadosamente la configuración del esquema antes de habilitarla para el perfil. Sin embargo, puede eliminar un conjunto de datos con perfil habilitado. Encontrará información aquí: https://experienceleague.adobe.com/es/docs/experience-platform/catalog/datasets/user-guide#delete-a-profile-enabled-dataset
Si ya no desea que se use un esquema con perfil habilitado, se recomienda cambiar el nombre del esquema para incluir No usar o Inactivo.
Modificación y restricciones del esquema
En esta sección se proporcionan aclaraciones sobre las reglas de modificación de esquemas y la prevención de cambios importantes.
¿Cuándo comienza un esquema a evitar cambios importantes?
Se pueden realizar cambios importantes en un esquema siempre y cuando no se haya utilizado nunca en la creación de un conjunto de datos o se haya habilitado para su uso en Real-Time Customer Profile. Una vez que se ha utilizado un esquema en la creación del conjunto de datos o se ha habilitado para su uso con Real-Time Customer Profile, el sistema aplica estrictamente las reglas de Evolución del esquema.
¿Puedo editar un esquema de unión directamente?
Los esquemas de unión son de solo lectura y el sistema los genera automáticamente. No se pueden editar directamente. Los esquemas de unión se crean para una clase específica cuando se agrega una etiqueta "union" al esquema que implementa esa clase.
Para obtener más información sobre las uniones en XDM, consulte la sección union en la guía de API Schema Registry.
¿Cómo debo dar formato a mi archivo de datos para introducir datos en el esquema?
Experience Platform acepta archivos de datos en formato Parquet o JSON. El contenido de estos archivos debe ajustarse al esquema al que hace referencia el conjunto de datos. Para obtener más información sobre las prácticas recomendadas para la ingesta de archivos de datos, consulte la descripción general de la ingesta por lotes.
¿Cómo puedo convertir un esquema en un esquema de solo lectura?
Actualmente, un esquema no se puede convertir en solo lectura.
Errores y solución de problemas
A continuación se muestra una lista de mensajes de error que pueden aparecer al trabajar con la API Schema Registry.
Recurso no encontrado
{
"type": "http://ns.adobe.com/aep/errors/XDM-1010-404",
"title": "Resource not found",
"status": 404,
"report": {
"registryRequestId": "a15996b5-5133-4cec-9bf7-7d1207904ae3",
"timestamp": "06-01-2021 04:11:06",
"detailed-message": "The requested class resource https://ns.adobe.com/{TENANT_ID}/classes/11447bb484d4599d2cd9b0aseefff78b463cbbde1527f498 with version 1 is not found.",
"sub-errors": []
},
"detail": "The requested class resource https://ns.adobe.com/{TENANT_ID}/classes/11447bb484d4599d2cd9b0aseefff78b463cbbde1527f498 with version 1 is not found."
}
Este error se muestra cuando el sistema no ha podido encontrar un recurso en particular. Es posible que el recurso se haya eliminado o que la ruta de la llamada de API no sea válida. Asegúrese de haber introducido una ruta válida para la llamada de API antes de intentarlo de nuevo. Es posible que desee comprobar que ha introducido el ID correcto para el recurso y que la ruta tiene el espacio de nombres correcto con el contenedor adecuado (global o inquilino).
type
:http://ns.adobe.com/aep/errors/XDM-1010-404
http://ns.adobe.com/aep/errors/XDM-1011-404
http://ns.adobe.com/aep/errors/XDM-1012-404
http://ns.adobe.com/aep/errors/XDM-1013-404
http://ns.adobe.com/aep/errors/XDM-1014-404
http://ns.adobe.com/aep/errors/XDM-1015-404
http://ns.adobe.com/aep/errors/XDM-1016-404
http://ns.adobe.com/aep/errors/XDM-1017-404
Para obtener más información sobre la construcción de rutas de búsqueda en la API, consulte las secciones contenedor e identificación de recursos en la guía para desarrolladores de Schema Registry.