Read JSON

Tipo: read-json · Paquete: JSON Activities v1.0.4 · Salida: object

Lee un archivo JSON y devuelve su contenido ya estructurado: un diccionario (objeto) o una lista (arreglo), navegable por sus claves e índices. No necesitas interpretar texto: el resultado está listo para usar.

Cómo funciona

Lee el archivo de path, interpreta su JSON y devuelve la estructura. Luego accedes a los datos con expresiones: dato["clave"], lista[0], dato["items"][0]["nombre"].

Formato estricto: el archivo debe ser JSON válido. No se admiten comentarios (//), comas finales ni comillas simples.
Codificación: UTF-8 (también reconoce UTF-16/UTF-32 si el archivo tiene marca BOM).
Conversión de valores: objetos → diccionario, arreglos → lista, enteros → long, decimales → double. Ver cómo se convierten los valores.
Solo lectura: no modifica el archivo. Lo carga completo en memoria.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`path`	`string`	—	Ruta del archivo JSON.

Parámetros opcionales

Ninguno.

Salida

Devuelve un object cuyo tipo depende de la raíz del JSON:

{ … } → diccionario (Dictionary) con claves de texto.
[ … ] → lista (List).
Un valor suelto ("texto", 42, true) → ese valor.

Leer una clave que no existe devuelve un valor vacío, no un error: compruébalo con isNull(config["clave"]).

Errores comunes

Mensaje	Causa y solución
`No se encontró el archivo.`	`path` no existe. Compruébalo con File Exists.
`'…' is an invalid start of a value. LineNumber: … \| BytePositionInLine: ….` (u otro error de JSON del sistema)	El contenido no es JSON válido: comentarios, comas finales, comillas simples o texto que no es JSON. El mensaje indica la línea y la posición. Corrige el archivo.
`The input does not contain any JSON tokens…`	El archivo está vacío.
`El archivo no contiene un JSON válido.`	El archivo contiene solo `null`.
`'path' es obligatorio.`	La expresión de `path` dio nulo.

Ejemplo

Read JSON   path = asset("config.json")   → output: config
Set Variable   name = carpetaSalida   value = config["carpetaSalida"]
Log   message = "Primer item: " + str(config["items"][0]["nombre"])

For Each   items = config["items"]   itemVariable = item
 └─ activities:
      Log   message = "Procesando " + item["nombre"]

Actividades relacionadas

Write JSON — guardar un valor como JSON.
HTTP GET — recibir JSON de una API.