Selector de Api para peticiones List
¿Cómo funciona?
Las Apis definidas en el diccionario de Apis poseen un check “Soporta List”, el cual habilita el solicitar un listado de todos los ítems de la entidad correspondiente.
Nota: Puedes revisar la estructura del link en la documentación correspondiente. (imagen abajo)
Previo a este desarrollo, el resultado que esta petición devolvía era una lista de todas las entidades, pero solo de sus atributos básicos (Código, Nombre, Descripción, Activo).
Con este desarrollo, ahora es posible personalizar la lista que devuelve esta petición.
Ahora la petición revisará si el diccionario de datos de la entidad posee un Selector para Apis (Estándar o custom) definido.
Este campo posee una regla propia que la Api chequea antes de ejecutar la consulta SQL, la cual es el uso de la cláusula FOR JSON PATH. Esta cláusula convierte el resultado de una consulta SQL a un formato JSON. Este resultado es compatible para enviarse como respuesta a una API.
Por ejemplo:
Aquí tenemos una consulta a BSPersona
Si agregamos la cláusula FOR JSON PATH el resultado será una única columna con todo el resultado en formato json
Nota: para lograr el agrupamiento de atributos (como los ejemplos Datos, Cuenta) en subentidades se deben utilizar prefijos comunes al momento de nombrar las columnas (ver imagen de la consulta).