Crear un origen de datos cargando un archivo JSON local

Crear un origen de datos cargando un archivo JSON local

Esta guía explica cómo cargar un archivo JSON desde tu computadora, definir la colección que se convertirá en filas, incorporar datos ubicados fuera de esa colección y validar la tabla resultante.

Antes de comenzar

  • El archivo debe contener JSON válido.
  • Debe estar codificado como UTF-8.
  • El tamaño máximo indicado por la pantalla de carga es de 300 MB.
  • Identificá el objeto o arreglo que contiene los registros que querés convertir en filas.

Cargar y configurar el archivo

1. Cargá el archivo desde tu computadora

Desde Orígenes de datos, iniciá la creación de un origen y elegí Desde un archivo. Arrastrá el JSON al área de carga o elegí selecciona desde tu computadora.


2. Indicá dónde están los registros

Cuando finalice la carga, usá JSONPath para señalar la colección que debe transformarse en filas.

El ejemplo corresponde a una estructura equivalente a esta:

{
"actualizado": "2026-10-13",
"data": {
"productos": [
{"codigo": "A-101", "nombre": "Yerba mate 1 kg", "precio": 3200}
]
}
}
  • Ruta de los datos: usá $.data.productos para convertir cada producto en una fila.
  • Cabeceras: seleccioná que son los atributos de la ruta a los datos para usar codigo, nombre y precio como columnas.
  • Campo extendido: agregá actualizado con la ruta $.actualizado y una descripción que indique qué representa.
  • Origen sin filas: activá Devolver igual los campos extendidos cuando necesites conservar la fecha u otros valores aunque la colección esté vacía.


3. Completá la descripción del origen

Seleccioná Continuar y completá el título, la descripción y la categoría. También podés agregar anotaciones y elegir la política de caché. El archivo cargado queda identificado por su nombre y puede reemplazarse más adelante.



4. Guardá y verificá los datos

Seleccioná Guardar. Desde el origen creado, iniciá la creación de una vista y comprobá que la tabla muestre las columnas y valores esperados.


Reemplazar el archivo

Abrí el origen y seleccioná Reemplazar para cargar una versión nueva. Para evitar cambios inesperados en las vistas que dependen del origen, conservá la estructura y los nombres de los atributos o revisá nuevamente la configuración y la previsualización.

Resultado esperado

La previsualización muestra una fila por cada elemento de la colección indicada. Los atributos de cada objeto se presentan como columnas y los campos extendidos quedan disponibles junto con el origen.

Solución de problemas

  • El archivo no se carga: comprobá que no supere 300 MB, que use UTF-8 y que el formato esté permitido.
  • No se muestran filas: validá el JSON y revisá que el JSONPath apunte al arreglo correcto.
  • Las columnas no son correctas: verificá que cada elemento sea un objeto y que sus atributos representen las cabeceras esperadas.
  • Una actualización altera la vista: compará la estructura del archivo nuevo con la versión anterior y volvé a previsualizar antes de continuar.

Artículo relacionado

Para consumir un JSON disponible mediante HTTP, FTP, S3-BLOB u otra ruta configurada, consultá Crear un origen de datos desde un archivo JSON remoto.