# Funciones JSON Funciones de [fórmula](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas) que nos permite procesar objetos [JSON](https://es.wikipedia.org/wiki/JSON) en base al estándar [RFC-4627](http://tools.ietf.org/html/rfc4627). {% hint style="info" %} No es posible establecer un orden en un objeto JSON. Es un mapa, y como tal lo ordena alfabéticamente por sus claves. {% endhint %} {% hint style="info" %} Debemos tener en cuenta que en JSON el formato numérico soportado es *double,* es decir 15-16 dígitos significativos (8 bytes), inferior [al de Velneo](https://doc.velneo.com/buenas-practicas-de-programacion/buenas-practicas-de-rendimiento/conoce-los-limites#limite-de-variables-alfabeticas-y-numericas), que tiene un soporte de un rango mayor y mayor precisión. {% endhint %} {% hint style="warning" %} Es importante, tener en cuenta que cuando se trabaja con JSON, los valores de fechas siempre se interpretan como cadenas de texto, por lo que es recomendable forzar el formato de salida para esa cadena, para que el formato de texto de conversión no sea automático y genere problemas, como puede ocurrir si la configuración de la máquina donde se está ejecutando tiene un formato de fecha corto (dd/MM/yy) por ejemplo y luego no sepa volver a convertir la fecha porque no tiene toda la información suficiente. {% endhint %} ## jsonAddToArray Añade un valor de un tipo a un array JSON. `jsonAddToArray(json, valor, [tipo])` #### Parámetros * **json** Expresión [fórmula](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas) con la cadena que contiene el array JSON al que se le quiere añadir el valor. Puede ser un valor constante, un [campo](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/tabla/campo), una [variable](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/variable), una [variable local](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/de-aplicacion-y-datos/variable-local), etc. * **valor** Expresión [fórmula](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas) con el valor a añadir al array JSON. * **tipo** En este parámetro especificaremos el tipo de dato a añadir. Debemos especificarlo mediante una cadena, que puede contener los siguientes valores: * `"string"` si el dato a añadir es alfanumérico. * `"number"` si el dato a añadir es numérico. * `"bool"` si el dato a añadir es booleano. * `"null"`, si el dato añadir es un valor nulo. * `"array"` si el dato a añadir es un *array*. * `"object"` si el dato a añadir es un objeto. #### Ejemplo Supongamos que queremos generar un array JSON con el campo NAME de todos los registros de una tabla. Para ello podríamos programar un [proceso](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/de-aplicacion-y-datos/proceso) en el que se usará una [variable local](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/de-aplicacion-y-datos/variable-local) llamada SZ\_JSON como objeto para componer dicho array JSON: ``` Set ( SZ_JSON, "" ) Cargar lista ( CONTACTOS@miproyecto, ID, , , , ) Recorrer lista solo lectura Set ( SZ_JSON, jsonAddToArray(SZ_JSON, #NAME, "string") ) ``` Ejemplo de contenido de la variable local SZ\_ARRAY al terminar el proceso: `["Carlos Fernández","María Montes","Rafael Muñoz","Fernando Fernández","Lisa Sande","Mark Short","Mery Left","Andrée Vrai","Carlos Fuentes","David Fernández"]` ## jsonAddToObject Añade/modifica una clave/valor de un tipo a un objeto JSON. Cuando no encuentra la clave la añade con el valor que se le pasa, y si la encuentra, reemplaza su valor por el actual. `jsonAddToObject(json, clave, valor, [tipo])` #### Parámetros * **json** Expresión [fórmula](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas) con la cadena que contiene el array JSON al que se le quiere añadir la clave o el valor. Puede ser un valor constante, un [campo](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/tabla/campo), una [variable](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/variable), una [variable local](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/de-aplicacion-y-datos/variable-local), etc. * **clave** Expresión fórmula que contendrá una cadena con el valor que tendrá la clave/valor del objeto JSON. * **valor** Expresión [fórmula](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas) con el valor a añadir al array JSON. * **tipo** En este parámetro especificaremos el tipo de dato a añadir. Debemos especificarlo mediante una cadena, que puede contener los siguientes valores: * `"string"` si el dato a añadir es alfanumérico. * `"number"` si el dato a añadir es numérico. * `"bool"` si el dato a añadir es booleano. * `"null"`, si el dato añadir es un valor nulo. * `"array"` si el dato a añadir es un *array*. * `"object"` si el dato a añadir es un objeto. #### Ejemplo Vamos a programar un [proceso](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/de-aplicacion-y-datos/proceso) en el que, en primer lugar compondremos un array JSON con el campo NAME de todos los registros de una tabla y luego lo añadiremos como objeto a una [variable local](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/de-aplicacion-y-datos/variable-local) alfabética llamada SZ\_ARRAY: ``` Rem ( Inicializamos variables ) Set ( SZ_JSON, "" ) Set ( SZ_NAME, "" ) Libre Rem ( Cargamos los registros de la tabla ) Cargar lista ( CONTACTOS@Json pruebas, ID, , , , ) Rem ( Recorremos la tabla y compondremos un array JSON con el campo NAME de todos los registros ) Recorrer lista solo lectura Set ( SZ_NAME, jsonAddToArray(SZ_NAME, #NAME, "string") ) Rem ( Añadimos una nueva clave al objeto JSON (variable local SZ_JSON), cuyo valor es el array generado en el paso anterior. ) Set ( SZ_JSON, jsonAddToObject(SZ_JSON, "Nombre", SZ_NAME, "array") ) ``` Ejemplo de contenido de la variable SZ\_JSON: `{"Nombre":["Carlos Fernández","María Montes","Rafael Muñoz","Fernando Fernández","Lisa Sande","Mark Short","Mery Left","Andrée Vrai","Carlos Fuentes","David Fernández"]}` ## jsonDeleteArrayItem Elimina el ítem correspondiente a la posición del JSON cuando es un array. `jsonDeleteArrayItem(json, posicion)` #### Parámetros * **json** Expresión [fórmula](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas) con la cadena que contiene el array JSON del que se quiere eliminar el ítem. Puede ser un valor constante, un [campo](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/tabla/campo), una [variable](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/variable), una [variable local](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/de-aplicacion-y-datos/variable-local), etc. * **Posición** Expresión [fórmula](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas) con la posición del ítem a eliminar. La primera posición del array es la 0. #### Ejemplo En un proceso inicializamos una variable local alfabética llamada SZ\_ID con un array JSON y luego le quitaremos la posición 3: ``` Set ( SZ_ID, "[1,2,3,4,5,6,7,8,9,10]" ) Set ( SZ_ID, jsonDeleteArrayItem(SZ_ID, 3) ) ``` El resultado sería: `[1,2,3,5,6,7,8,9,10]` ## jsonDeleteKey Elimina la clave y su valor correspondiente del json cuando es un objeto. `jsonDeleteKey(json, clave)` #### Parámetros * **json** Expresión [fórmula](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas) con la cadena que contiene el array JSON en el que se quiere eliminar la clave y su valor**.** Puede ser un valor constante, un [campo](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/tabla/campo), una [variable](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/variable), una [variable local](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/de-aplicacion-y-datos/variable-local), etc. * **clave** Expresión fórmula que contendrá una cadena que contenga el nombre de la clave a borrar del objeto JSON. #### Ejemplo En un proceso tenemos la varible local SZ\_JSON con el contenido siguiente: ``` { "ID":[1,2,3,4,5], "Nombre":["Carlos Fernández","María Montes","Rafael Muñoz","Fernando Fernández","Lisa Sande"] } ``` Y deseamos quitar la clave ID: ``` Set ( SZ_JSON, jsonDeleteKey(SZ_JSON, "ID")) ``` El resultado sería: ``` { "Nombre":["Carlos Fernández","María Montes","Rafael Muñoz","Fernando Fernández","Lisa Sande"] } ``` ## jsonFindArrayItem Devuelve la posición del primer ítem con el valor correspondiente del json cuando es un array buscando desde la posición especificada. `jsonFindArrayItem(json, valor, [posicion])` #### Parámetros * **json** Expresión [fórmula](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas) con la cadena que contiene el array JSON en el que se quiere encontrar valor**.** Puede ser un valor constante, un [campo](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/tabla/campo), una [variable](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/variable), una [variable local](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/de-aplicacion-y-datos/variable-local), etc. * **valor** Expresión [fórmula](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas) con el valor a buscar. * **posición** Posición desde la que se quiere buscar. Es opcional y su valor por defecto es 0. #### Ejemplo SZ\_ID = \[1,2,3,4,5] `jsonFindArrayItem(SZ_ID, 2, )` = 1 ## jsonFormat Formatea un JSON. `jsonFormat(json, formato)` #### Parámetros * **json** Expresión [fórmula](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas) con la cadena que contiene el array JSON en el que se quiere encontrar el valor**.** Puede ser un valor constante, un [campo](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/tabla/campo), una [variable](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/variable), una [variable local](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/de-aplicacion-y-datos/variable-local), etc. * **Formato** En este parámetro indicaremos qué formato queremos aplicar al JSON. Los valores posibles son: * 0 - Indentado. * 1 - Compacto. #### Ejemplo La variable SZ\_JSON contiene lo siguiente: ``` {"ID":[1,2,3,4,5],"Nombre":["Carlos Fernández","María Montes","Rafael Muñoz","Fernando Fernández","Lisa Sande"]} ``` `jsonFormat(SZ_JSON, 0)` = ``` { "ID": [ 1, 2, 3, 4, 5 ], "Nombre": [ "Carlos Fernández", "María Montes", "Rafael Muñoz", "Fernando Fernández", "Lisa Sande" ] } ``` ## jsonGetArrayItem Devuelve un elemento de un array JSON `jsonGetArrayItem(json, posicion)` #### Parámetros * **json** Expresión [fórmula](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas) con la cadena que contiene el array JSON en el que se quiere obtene el elemento**.** Puede ser un valor constante, un [campo](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/tabla/campo), una [variable](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/variable), una [variable local](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/de-aplicacion-y-datos/variable-local), etc. * **posición** Posición del elemento a obtener. La primera posición es 0. #### Ejemplo SZ\_ID = \[1,2,3,4,5] `jsonGetArrayItem(SZ_ID, 1)` = 2 ## jsonGetArrayLength Devuelve la longitud de un array JSON. `jsonGetArrayLength(json)` #### Parámetros * **json** Expresión [fórmula](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas) con la cadena que contiene el array JSON cuya longitud se quiere obtener. Puede ser un valor constante, un [campo](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/tabla/campo), una [variable](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/variable), una [variable local](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/de-aplicacion-y-datos/variable-local), etc. #### Ejemplo SZ\_ID = \[1,2,3,4,5] `jsonGetArrayLength(SZ_ID)` = 5 ## jsonGetKeys Devuelve las claves de un json `jsonGetKeys(json)` #### Parámetros * **json** Expresión [fórmula](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas) con la cadena que contiene el array JSON cuyas claves se quieren obtener. Puede ser un valor constante, un [campo](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/tabla/campo), una [variable](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/variable), una [variable local](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/de-aplicacion-y-datos/variable-local), etc. #### Ejemplo SZ\_JSON = ``` { "ID": [ 1, 2, 3, 4, 5 ], "Nombre": [ "Carlos Fernández", "María Montes", "Rafael Muñoz", "Fernando Fernández", "Lisa Sande" ] } ``` `jsonGetKeys( SZ_JSON )` = ID,Nombre ## jsonGetValue Devuelve un valor de un JSON correspondiente a la clave. `jsonGetValue(json, clave, [caseSensitive])` #### Parámetros * **json** Expresión [fórmula](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas) con la cadena que contiene el objeto JSON del que se quiere obtener los valores de una clave. Puede ser un valor constante, un [campo](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/tabla/campo), una [variable](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/variable), una [variable local](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/de-aplicacion-y-datos/variable-local), etc. * **Clave** Expresión [fórmula](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas) con el nombre de la clave cuyo valor se desea obtener. * **caseSensitive** Este parámetro es opcional y permite configurar si debe ser sensible a mayúsculas (1) o no (0). Si se deja vació asumirá 1. #### Ejemplo SZ\_JSON = ``` { "ID": [ 1, 2, 3, 4, 5 ], "Nombre": [ "Carlos Fernández", "María Montes", "Rafael Muñoz", "Fernando Fernández", "Lisa Sande" ] } ``` `jsonGetValue(SZ_JSON, "Nombre",)` = \["Carlos Fernández","María Montes","Rafael Muñoz","Fernando Fernández","Lisa Sande"] ## jsonIsArray Devuelve *verdadero* (1) si un JSON es un array o *falso* (0), si no lo es. `jsonIsArray(json)` #### Parámetros * **json** Expresión [fórmula](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas) con la cadena que contiene el array JSON a validar. Puede ser un valor constante, un [campo](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/tabla/campo), una [variable](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/variable), una [variable local](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/de-aplicacion-y-datos/variable-local), etc. #### Ejemplos SZ\_ID = \[1,2,3,4,5] `jsonIsArray(SZ_ID)` = 1 SZ\_JSON = ``` "ID": [ 1, 2, 3, 4, 5 ], "Nombre": [ "Carlos Fernández", "María Montes", "Rafael Muñoz", "Fernando Fernández", "Lisa Sande" ] } ``` `jsonIsArray(SZ_JSON)` = 0 ## jsonIsObject Devuelve *verdadero* (1) si un JSON es un objeto o *falso* (0) si no lo es. `jsonIsObject(json)` #### Parámetros * **json** Expresión [fórmula](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas) con la cadena que contiene el array JSON a validar. Puede ser un valor constante, un [campo](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/tabla/campo), una [variable](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/variable), una [variable local](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/de-aplicacion-y-datos/variable-local), etc. #### Ejemplos SZ\_JSON = ``` "ID": [ 1, 2, 3, 4, 5 ], "Nombre": [ "Carlos Fernández", "María Montes", "Rafael Muñoz", "Fernando Fernández", "Lisa Sande" ] } ``` `jsonIsObject(SZ_JSON)` = 1 SZ\_ID = \[1,2,3,4,5] `jsonIsObject(SZ_ID)` = 0 ## jsonIsValid Devuelve *verdadero* (1) si un JSON es válido o *falso* (0) si no lo es `jsonIsValid(json)` #### Parámetros * **json** Expresión [fórmula](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas) con la cadena que contiene el array JSON a validar. Puede ser un valor constante, un [campo](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/tabla/campo), una [variable](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/variable), una [variable local](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/de-aplicacion-y-datos/variable-local), etc. #### Ejemplos SZ\_JSON = ``` "ID": [ 1, 2, 3, 4, 5 ], "Nombre": [ "Carlos Fernández", "María Montes", "Rafael Muñoz", "Fernando Fernández", "Lisa Sande" ] } ``` `jsonIsValid(SZ_JSON)` = 1 SZ\_ID = \[1,2,3,4,5] `jsonIsValid(SZ_ID)` = 1 ## jsonKeyExists Comprueba si existe una clave dentro de un JSON. `jsonKeyExists(json, clave, [caseSensitive])` #### Parámetros * **json** Expresión [fórmula](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas) con la cadena que contiene el array JSON en el que queremos comprobar si existe la clave. Puede ser un valor constante, un [campo](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/tabla/campo), una [variable](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/variable), una [variable local](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/de-aplicacion-y-datos/variable-local), etc. * **Clave** Expresión [fórmula](https://doc.velneo.com/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas) con el nombre de la clave a buscar. * **caseSensitive** Este parámetro es opcional y permite configurar si debe ser sensible a mayúsculas (1) o no (0). Si se deja vació asumirá 1. #### Ejemplo SZ\_JSON = ``` "ID": [ 1, 2, 3, 4, 5 ], "Nombre": [ "Carlos Fernández", "María Montes", "Rafael Muñoz", "Fernando Fernández", "Lisa Sande" ] } ``` `jsonKeyExists(SZ_JSON, "Nombre", 0)` = 1