JSON to Data

JSON to Data es un componente sencillo que te permite transformar cualquier dato en formato JSON en un objeto de tipo Data que puedes usar en el resto de tu flujo de trabajo dentro de Nappai. Puedes cargar un archivo, indicar la ruta de un archivo existente o pegar directamente la cadena JSON.

¿Cómo funciona?

El componente acepta exactamente una de las tres formas de entrada:

1. JSON File – Subes un archivo con extensión .json.
2. JSON File Path – Escribes la ruta completa a un archivo .json que ya existe en el sistema.
3. JSON String – Pegas una cadena JSON válida (puede ser un objeto o un array).

Internamente el componente lee el contenido, intenta analizarlo con json.loads. Si la cadena no es válida, utiliza la librería json_repair para corregirla y volver a intentar el análisis.

• Si el JSON resultante es una lista, el componente devuelve una lista de objetos Data, cada uno con un elemento de la lista.
• Si es un objeto único, devuelve un solo objeto Data con ese objeto como su contenido.

El resultado se muestra en la salida Data, que puede ser conectado a cualquier otro componente que acepte datos de tipo Data.

Entradas

• JSON File: Sube un archivo JSON para convertirlo en un objeto Data o una lista de objetos Data.
• JSON File Path: Proporciona la ruta de un archivo JSON existente en el sistema.
• JSON String: Ingresa una cadena JSON válida (objeto o array) que será convertida en un objeto Data o una lista de objetos Data.

Salidas

• Data: El objeto o la lista de objetos Data resultante de la conversión. Este dato puede ser usado en cualquier otro componente que requiera entrada de tipo Data.

Ejemplo de Uso

1. Escenario: Tienes un archivo clientes.json con la siguiente estructura:

   [
     {"id": 1, "nombre": "Ana"},
     {"id": 2, "nombre": "Luis"}
   ]

2. Pasos:

   • Arrastra el componente JSON to Data al lienzo.
   • Haz clic en el campo JSON File y sube clientes.json.
   • Conecta la salida Data a un componente que muestre datos, por ejemplo, un Table o un Data Viewer.

3. Resultado: El componente leerá el archivo, lo convertirá en una lista de objetos Data y la tabla mostrará los registros de clientes.

Componentes Relacionados

• Data to JSON – Convierte objetos Data de vuelta a formato JSON.
• Data Viewer – Muestra visualmente los objetos Data en una tabla o gráfico.
• File Input – Permite subir archivos de diferentes tipos, útil para combinar con JSON to Data.

Consejos y Mejores Prácticas

• Solo una entrada: Asegúrate de proporcionar solo una de las tres opciones de entrada; el componente lanzará un error si se usan más de una.
• Validación previa: Si trabajas con cadenas JSON generadas dinámicamente, prueba la validez antes de enviarlas para evitar reparaciones innecesarias.
• Tamaño de archivo: Evita subir archivos JSON muy grandes (más de 10 MB) directamente; considera procesarlos en lotes o usar rutas de archivos en su lugar.
• Seguridad de rutas: Cuando uses JSON File Path, verifica que la ruta no apunte a archivos sensibles o fuera del directorio permitido por Nappai.

Consideraciones de Seguridad

• Control de acceso: Los archivos subidos se almacenan temporalmente en el servidor de Nappai; asegúrate de que solo usuarios autorizados tengan acceso a la zona de carga.
• Validación de contenido: El componente intenta reparar JSON malformado, pero no valida la semántica de los datos. Si el JSON contiene información sensible, revisa su contenido antes de procesarlo.
• Rutas absolutas: Al usar JSON File Path, evita rutas que puedan exponer directorios críticos del sistema. Nappai restringe el acceso a directorios permitidos, pero siempre es buena práctica limitar la entrada a rutas conocidas.