Función encargada de retornar la información solicitada de los campos de un registro, es decir nos permite obtener datos particulares de un elemento del que conocemos su código. Por ejemplo podemos obtener el nombre, apellido, profesión y tratamiento de un tercero cuyo código sea 1053845789.
Esta función retorna información de un solo registro.
Nombre parámetro | Tipo | Descripción | Ejemplo |
dataJSON | JSON |
Json que contiene en su interior la siguiente estructura: ntabla: Nombre de la tabla de la cual se desea obtener la información. (requerido). camposderetorno: Arreglo que contiene la lista de los campos de los cuales se desea obtener información. (requerido). datosfiltro: Json que contiene el campo y el valor por el cual se desea filtrar la consulta, hay que tener en cuenta que se debe filtrar por el campo llave de la tabla. (requerido) |
{ "ntabla": "abanits", "camposderetorno": [ "ntercero", "napellido" ], "datosfiltro": { "init": "810000630" } } |
controlkey | Varchar | Corresponde al keyagente obtenido en el logueo (requerido). | "564654" |
iapp | Varchar | Código que identifica a la aplicación que interactúa con el Agente (requerido) | "1068" |
random | Varchar | Cadena aleatoria que se crea en el lado del cliente, esto con el fin de que las peticiones no sean cacheadas por el navegador Internet Explorer (para aplicaciones web). (Opcional). | "54654" |
Nombre parámetro | Tipo | Descripción |
encabezado | JSON |
Json que contiene en su interior los siguientes datos: resultado (varchar): Retorna true siempre que la petición se ejecute satisfactoriamente. |
respuesta | JSON |
Json que contiene en su interior el arreglo “datos” el cual será descrito a continuación: |
{ "result":[{ "encabezado":{"resultado":"false","imensaje":"40","mensaje":"Usuario no logueado."}, "respuesta":{"datos":""} }] }