Comando ReadJSON

Descripción General #

El comando readJSON pertenece a la categoría de comandos Comandos RPA. Es útil  para extraer información valiosa desde archivos JSON, mediante la especificación de una ruta por niveles (notación de puntos):

• ¿Qué es un archivo JSON? Es una forma común de organizar datos en internet y en muchas aplicaciones.
• ¿Cómo funciona el comando? Tú le dices a STELA qué archivo JSON leer y qué parte de la información te interesa.
• ¿Qué obtienes? STELA toma el dato que pediste y lo guarda en una variable para que puedas usarlo en tu automatización.

Ejemplo de Uso Rápido #

Imagina que tienes un archivo JSON llamado configuracion.json con la siguiente información:

JSON

Imagina que quieres saber cuál es el idioma predeterminado. Con el comando ReadJSON, puedes :

1. Seleccionar el archivo JSON: Indicarle a STELA que el archivo que quieres leer es configuracion.json
2. Especificar el campo: Decirle que buscas la información que está dentro del campo llamado "idioma_predeterminado".
3. Asignar a una variable: Nombrar una variable, por ejemplo, idioma, donde STELA guardará el valor encontrado («es»).

Después de ejecutar el comando, la variable idioma contendrá el texto «es», Ahora puedes usar esa información en tu flujo de trabajo, como mostrar mensajes o configurar tu aplicación en el idioma correcto.

Parámetros y Opciones #

El comando ReadJSON necesita que le indiques algunos detalles para poder trabajar correctamente:

• Archivo JSON (Obligatorio): Aquí debes especificar la ruta completa del archivo JSON que quieres leer. Por ejemplo: /ruta/al/archivo/datos.json o C:\archivos\configuracion.json.
• Campo (Obligatorio): En este parámetro, defines la «dirección» exacta de la información que buscas dentro del archivo JSON. Por ejemplo: idioma_predeterminado.
• Variable (Obligatorio): Aquí escribes el nombre de la variable donde STELA guardará el valor que encuentre en el archivo JSON. Por ejemplo fecha_pedido

IMPORTANTE: Al trabajar con niveles jerárquicos o elementos anidados dentro de un arreglo, el parámetro campo se configura mediante la notación de puntos. Bajo este formato, utilizas un punto (.) como separador para recorrer ordenadamente cada subnivel de la estructura JSON hasta localizar el valor exacto.

Por ejemplo:

Para obtener la fecha de la orden (Nivel 2 de anidamiento):
Valor del parámetro campo: orden.fecha
Resultado obtenido: «09/07/2026»

Ejemplos de Uso Avanzado #

Extracción de datos de una API: Imagina que tu robot se conecta a una API y recibe la información en formato JSON. Si quieres el precio de una acción, puedes:

• Usar el comando ReadJSON para tomar la respuesta de la API.
• Especificar el campo donde se encuentra el precio (por ejemplo, precio).
• Guardar ese valor en una nueva variable para usarlo en reportes o para tomar decisiones.

Procesamiento de logs en formato JSON: Si tus aplicaciones guardan registros de actividad en archivos JSON, puedes usar ReadJSON para analizar estos logs de manera automatizada. Por ejemplo, podrías extraer todos los mensajes de error que tengan un campo "nivel" con el valor "error" dentro de un array de eventos en el archivo JSON.

Aplanamiento automático de subestructuras completas: Si necesitas extraer todos los datos de un bloque sin especificar campo por campo, puedes apuntar a un nodo intermedio. Por ejemplo, si el JSON contiene:

y ejecutas readJSON, configurando el parámetro «Campo»: pedido, STELA creará de forma automática las variables derivadas: id (con el valor 105) y estado (con el valor «Procesado»).

Errores Comunes y Soluciones #

• Archivo no encontrado: Si la ruta que especificaste en el parámetro «Archivo JSON» no existe o no es correcta, STELA no podrá encontrar el archivo y mostrará un error.
  • Solución: Asegúrate de que la ruta del archivo sea exactamente la correcta y que el archivo exista en esa ubicación.
• Campo no encontrado: Si el «Campo» que especificaste no existe en la estructura del archivo JSON, el comando no podrá extraer ningún valor y la variable se quedará vacía o tendrá un valor nulo, dependiendo de la configuración de STELA.
  • Solución: Revisa cuidadosamente la estructura de tu archivo JSON y asegúrate de que el camino del campo que estás buscando sea el correcto. Verifica la ortografía exacta de los niveles del JSON. Recuerda que la búsqueda distingue entre mayúsculas y minúsculas (ejemplo: cliente.nombre es diferente de cliente.Nombre)
• Error de formato JSON: Si el archivo que intentas leer no tiene un formato JSON válido, STELA mostrará un error al intentar analizarlo.
  • Solución: Verifica que tu archivo JSON esté bien formado, que no falten comas, que las llaves {} y corchetes [] estén correctamente cerrados y que todas las propiedades utilicen comillas dobles ("") según el estándar del formato.

Casos de Uso #

• Automatización de tareas repetitivas que involucran la lectura de archivos de configuración para diferentes aplicaciones o procesos.
• Captura de datos visuales o información relevante de resultados de otras herramientas o servicios que entregan su información en formato JSON.
• Integración de datos entre diferentes sistemas o aplicaciones que utilizan JSON como formato de intercambio.
• Personalización de flujos de trabajo dinámicamente leyendo opciones o parámetros desde un archivo JSON.
• Procesamiento básico de información extraída de APIs sin necesidad de conocimientos de programación.