Apéndice de la guía de API del Registro de Esquemas

Este documento proporciona información complementaria relacionada con el trabajo con la variable Schema Registry API.

Uso de parámetros de consulta

La variable Schema Registry admite el uso de parámetros de consulta en los resultados de filtro y página al enumerar recursos.

NOTA

Cuando se combinan varios parámetros de consulta, deben separarse con el símbolo & (&).

Paginación

Los parámetros de consulta más comunes para la paginación incluyen:

Parámetro Descripción
orderby Ordene los resultados por una propiedad específica. Ejemplo: orderby=title ordenará los resultados por título en orden ascendente (A-Z). Adición de un - antes del valor del parámetro (orderby=-title) ordenará los elementos por título en orden descendente (Z-A).
limit Cuando se usa junto con un orderby parámetro, limit restringe el número máximo de elementos que deben devolverse para una solicitud determinada. Este parámetro no se puede usar sin un orderby presente.

La variable limit especifica un entero positivo (entre 0 y 500) como un sugerencia en cuanto al número máximo de elementos que deben devolverse. Por ejemplo, limit=5 devuelve solo cinco recursos en la lista. Sin embargo, este valor no se respeta estrictamente. El tamaño real de la respuesta puede ser menor o mayor, ya que está limitado por la necesidad de proporcionar el funcionamiento fiable de la variable start , si se proporciona uno.
start Cuando se usa junto con un orderby parámetro, start especifica dónde debe comenzar la lista de elementos de la subconfiguración. Este parámetro no se puede usar sin un orderby presente. Este valor se puede obtener de la variable _page.next de una respuesta de lista y se utiliza para acceder a la siguiente página de resultados. Si la variable _page.next es nulo y no hay ninguna página adicional disponible.

Normalmente, este parámetro se omite para obtener la primera página de resultados. Después de eso, start debe establecerse en el valor máximo de la propiedad de ordenación principal de la variable orderby campo recibido en la página anterior. A continuación, la respuesta de API devuelve entradas que comienzan con las que tienen una propiedad de ordenación principal de orderby estrictamente bueno (para ascendente) o estrictamente menor que (para descendente) el valor especificado.

Por ejemplo, si la variable orderby se establece en orderby=name,firstname, el start contendría un valor para name propiedad. En este caso, si desea mostrar las 20 entradas siguientes de un recurso inmediatamente después del nombre "Miller", debe utilizar: ?orderby=name,firstname&start=Miller&limit=20.

Filtro

Puede filtrar los resultados utilizando la variable property , que se utiliza para aplicar un operador específico a una propiedad JSON determinada dentro de los recursos recuperados. Los operadores admitidos son:

Operador Descripción Ejemplo
== Filtra si la propiedad es igual al valor proporcionado. property=title==test
!= Filtra si la propiedad no es igual al valor proporcionado. property=title!=test
< Filtra si la propiedad es menor que el valor proporcionado. property=version<5
> Filtra si la propiedad es buena que el valor proporcionado. property=version>5
<= Filtra si la propiedad es menor o igual que el valor proporcionado. property=version<=5
>= Filtra por si la propiedad es buena o igual al valor proporcionado. property=version>=5
~ Filtra si la propiedad coincide con una expresión regular proporcionada. property=title~test$
(Ninguna) Al indicar solo el nombre de propiedad, solo se devuelven las entradas en las que existe la propiedad. property=title
SUGERENCIA

Puede usar la variable property para filtrar grupos de campos de esquema por su clase compatible. Por ejemplo, property=meta:intendedToExtend==https://ns.adobe.com/xdm/context/profile solo devuelve grupos de campos compatibles con la variable XDM Individual Profile Clase .

Modo de compatibilidad

Experience Data Model (XDM) es una especificación públicamente documentada, impulsada por el Adobe para mejorar la interoperabilidad, la expresividad y el poder de las experiencias digitales. Adobe mantiene el código fuente y las definiciones XDM formales en un proyecto de código abierto en GitHub. Estas definiciones se escriben en la Notación estándar XDM, utilizando JSON-LD (Notación de objetos JavaScript para datos vinculados) y Esquema JSON como gramática para definir esquemas XDM.

Al consultar las definiciones formales de XDM en el repositorio público, puede ver que el XDM estándar difiere de lo que ve en Adobe Experience Platform. Qué está viendo en Experience Platform se denomina Modo de compatibilidad y proporciona una asignación sencilla entre el XDM estándar y la forma en que se utiliza en Platform.

Funcionamiento del modo de compatibilidad

El modo de compatibilidad permite que el modelo JSON-LD de XDM funcione con la infraestructura de datos existente al modificar los valores dentro del XDM estándar y mantener la semántica igual. Utiliza una estructura JSON anidada, que muestra los esquemas en un formato de árbol.

La principal diferencia que notará entre el XDM estándar y el Modo de compatibilidad es la eliminación del prefijo "xdm:" para los nombres de campo.

A continuación se muestra una comparación en paralelo que muestra los campos relacionados con el cumpleaños (con los atributos de "descripción" eliminados) tanto en el XDM estándar como en el modo de compatibilidad. Observe que los campos Modo de compatibilidad incluyen una referencia al campo XDM y su tipo de datos en los atributos "meta:xdmField" y "meta:xdmType".

XDM estándar Modo de compatibilidad
{ "xdm:birthDate": { "title": "Fecha de nacimiento", "tipo": "string", "format": "date" }, "xdm:birthDayAndMonth": { "title": "Fecha de nacimiento", "tipo": "cadena", "patrón": "[0-1][0-9]-[0-9][0-9]" }, "xdm:birthYear": { "title": "Año de nacimiento", "tipo": "integer", "Minimum": 1, "máximo": 32767 } }
  
{ "birthDate": { "title": "Fecha de nacimiento", "tipo": "string", "format": "date", "meta:xdmField": "xdm:birthDate", "meta:xdmType": "date" }, "birthDayAndMonth": { "title": "Fecha de nacimiento", "tipo": "cadena", "patrón": "[0-1][0-9]-[0-9][0-9]", "meta:xdmField": "xdm:birthDayAndMonth", "meta:xdmType": "string" }, "birthYear": { "title": "Año de nacimiento", "tipo": "integer", "Minimum": 1, "máximo": 32767, "meta:xdmField": "xdm:birthYear", "meta:xdmType": "short" } }
      

¿Por qué es necesario el modo de compatibilidad?

Adobe Experience Platform está diseñado para trabajar con múltiples soluciones y servicios, cada uno con sus propios desafíos y limitaciones técnicos (por ejemplo, cómo ciertas tecnologías manejan caracteres especiales). Para superar estas limitaciones, se desarrolló el Modo de compatibilidad.

Más Experience Platform servicios incluidos Catalog, Data Lakey Real-Time Customer Profile use Compatibility Mode en lugar del XDM estándar. La variable Schema Registry La API también utiliza Compatibility Mode, y los ejemplos de este documento se muestran utilizando Compatibility Mode.

Vale la pena saber que se realiza una asignación entre el XDM estándar y la forma en que se opera en Experience Platform, pero no debe afectar a su uso de Platform servicios.

El proyecto de código abierto está disponible para usted, pero cuando se trata de interactuar con los recursos a través del Schema Registry, los ejemplos de API de este documento proporcionan las prácticas recomendadas que debe conocer y seguir.

En esta página