Esta guía explica cómo usar un archivo JSON disponible mediante una ruta remota, definir dónde están los registros y sus cabeceras, agregar campos extendidos y comprobar el resultado antes de crear una vista.

Antes de comenzar

• El archivo debe contener JSON válido y ser accesible desde la plataforma.
• Necesitás conocer el protocolo y la ruta del archivo. La pantalla permite elegir HTTP, Local, FTP o S3-BLOB.
• Si el recurso está protegido, tené preparada la configuración de autenticación correspondiente.
• Identificá el objeto o arreglo que contiene los registros que querés convertir en filas.

Crear y configurar el origen

1. Seleccioná el tipo de archivo remoto

Desde Orígenes de datos, iniciá la creación de un origen y elegí Desde un archivo. Seleccioná la pestaña que corresponda al lugar donde está alojado el archivo.

• HTTP: ingresá la URL completa del archivo.
• Local, FTP o S3-BLOB: completá la ruta y las credenciales que solicite la opción elegida.

2. Configurá la lectura del JSON

Abrí Configuraciones y seleccioná json como tipo de archivo. Después indicá, mediante JSONPath, dónde se encuentra la colección que debe convertirse en filas.

El ejemplo corresponde a una estructura equivalente a esta:

{
  "headers": ["nombre", "edad"],
  "items": [["Ana", 30], ["Luis", 41]],
  "total": 2
}

• Ruta de los datos: usá $.items para obtener las filas del ejemplo.
• Evaluación adicional: activala únicamente cuando la ruta necesite el procesamiento adicional previsto por la plataforma.
• Cabeceras: indicá que no existen, tomalas de los atributos de cada objeto o especificá una ruta. En el ejemplo, las cabeceras están en $.headers.
• Campos extendidos: agregá valores ubicados fuera de la colección principal. En el ejemplo, el campo total usa la ruta $.total y la descripción Cantidad de personas.
• Origen sin filas: activá Devolver igual los campos extendidos cuando necesites conservar esos 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 del origen. También podés agregar anotaciones y definir la política de caché.

4. Guardá y verificá los datos

Seleccioná Guardar. Desde el origen creado, iniciá la creación de una vista para comprobar que las filas y cabeceras se interpretan correctamente antes de continuar con filtros, formatos o cálculos.

Resultado esperado

La previsualización muestra una tabla con las filas ubicadas por el JSONPath y las cabeceras configuradas. Los campos extendidos quedan disponibles junto con los datos del origen, incluso sin filas cuando se habilitó esa opción.

Solución de problemas

• No se muestran filas: comprobá que el archivo sea accesible, que contenga JSON válido y que el JSONPath apunte a la colección correcta.
• Las columnas no tienen el nombre esperado: revisá si las cabeceras deben tomarse de los atributos o de una ruta independiente.
• El archivo no se puede leer: verificá el protocolo, la ruta, la conectividad y la autenticación del recurso remoto.
• Falta un campo extendido: confirmá que su ruta parta desde la raíz correcta y que el nombre exista en el archivo.

Artículo relacionado

Para trabajar con un archivo guardado en tu computadora, consultá Crear un origen de datos cargando un archivo JSON local.