Lógica \ Try Catch

Este comando te permite capturar errores y manejarlos de manera controlada dentro de tu flujo de trabajo de automatización.
Cuando lo usas, encierras un bloque de código que sospechas que podría encontrar un error o excepción. Si ocurren errores o excepciones dentro de ese bloque de código, en lugar de detener toda tu automatización, el comando Try Catch capturará el error y ejecutará un bloque de código separado designado en la sección Catch.

💡Nota:
Para configurar el comando Try Catch, no necesitas proporcionar ningún parámetro ni opción. Simplemente coloca el código que deseas monitorear para detectar errores dentro de la sección Try del comando.

Lógica \ Break

Este comando se utiliza para interrumpir la ejecución de un ciclo y salir completamente del ciclo. Para usar el comando Break, simplemente colócalo dentro de la estructura del ciclo en el punto donde deseas que se interrumpa el ciclo. Este comando no tiene parámetros.

💡Nota:
Cuando se ejecuta un ciclo, como For o While, continúa hasta que se cumple una cierta condición. Sin embargo, puede haber casos en los que necesites salir prematuramente del ciclo en función de una condición específica. Aquí es donde el comando Break resulta útil.

Desktop \ Mouse Scroll

Este comando se usa para simular el desplazamiento del mouse en una dirección específica. Te permite automatizar la tarea de desplazarte por una aplicación de escritorio o cualquier otro elemento desplazable.

Para usar el comando Mouse Scroll, debes proporcionar el número de clics para desplazarte como parámetro. El número de clics determina la distancia y la dirección del desplazamiento. Un valor positivo se desplazará hacia arriba, mientras que un valor negativo se desplazará hacia abajo.

💡Nota:
La distancia real desplazada por clic puede variar según la aplicación o el elemento que se está desplazando. Se recomienda probar y ajustar el número de clics según sea necesario para lograr el comportamiento de desplazamiento deseado.

Scripts \ Detener todo y Salir

Este comando se usa para detener la ejecución del bot actual y cualquier bot padre que pueda estar en ejecución de manera segura. No recibe parámetros. Es una forma sencilla de detener la ejecución del bot o cualquier proceso relacionado sin la necesidad de una lógica o declaraciones condicionales complejas.

Scripts \ Detener este robot

Este comando te permite detener la ejecución del robot actual. No recibe parámetros. Esto puede ser útil en situaciones en las que necesitas interrumpir un script que se está ejecutando durante más tiempo de lo esperado o si encuentras un error y deseas detener la ejecución.

💡Nota:
El uso de este comando detendrá solo la ejecución del robot.

Scripts \ Retornar información

Con este comando podrás enviar información de vuelta al robot padre. Se usa típicamente cuando necesitas pasar datos o resultados de una tarea o paso en el flujo de trabajo a otro. Una vez que se envía la información de vuelta, el robot padre puede recuperarla y usarla en pasos posteriores del flujo de automatización.

⚠Importante:
Este comando siempre debe ir al final del bot. Similar al return de la funciones Python.

💡Nota:
Si deseas pasar el valor de una variable llamada result al robot padre, puedes usar el siguiente comando: (command: result)

Ejecutar robot Rocketbot (expose)

Un robot con expose en Rocketbot es una herramienta poderosa que encapsula la lógica necesaria para ejecutar una acción específica. A diferencia de otros robots, este tipo de robot no hereda variables, lo que elimina posibles conflictos. El comando Ejecutar robot Rocketbot (expose) permite ejecutar un robot específico con variables expuestas donde puedes pasar parámetros y guardar el resultado de la ejecución en una variable.

💡Nota:
Para recibir el resultado de una ejecución asegúrate de agregar el comando Return Data al final del bot.

Al seleccionar un robot con variables expose se mostrarán las variables elegidas como input para que el usuario/desarrollador que vaya a usar el bot ingrese los valores, igual como los comandos de un módulo. Para indicar las variables que deseas solicitar como parámetros, utiliza el botón Expose   en la sección Variables.
Este comando tiene un campo llamado Asignar variable. Similar a un módulo, guarda el resultado de la ejecución en la variable especificada cuando el bot finaliza. A diferencia de la ejecución de un robot normal, el resultado de la ejecución se guardará en la variable escrita en ese campo, aunque exista una variable llamada exactamente igual en el bot hijo y el padre, no se asignará el resultado, evitando un conflicto de variables por herencia.

En la sección Expose se pueden personalizar las variables/input que se expondrán. Puedes indicar el tipo de input, modificar títulos o agregar instrucciones. Por ejemplo, puedes agregar un selector de archivos (file select) para un input que requiere un path.
En esta sección también encontrarás un botón de Avanzado. Al hacer clic en él, podrás modificar los inputs utilizando formato JSON. Esto te brinda mayor flexibilidad y control sobre cómo se manejan los datos de entrada.

⚠Importante:
Al utilizar este comando, el robot no heredará ninguna variable del padre ni sus ancestros. Solo asignará a cada variable expuesta configurada en la sección Expose, el valor ingresado en los inputs de este comando.

Scripts \ Ejecutar Python

Este comando te permite ejecutar código Python usando por defecto librerías básicas específicamente diseñadas para tareas de RPA (Robotic Process Automation). Si deseas usar alguna otra librería debes instalarla de forma local en la siguiente ruta: Rocketbot/modules/libs

⚠Importante:
Para ejecutar el archivo este comando usa el interprete de Python instalado en tu sistema, por lo que debes tenerlo instalado. Además usa un scope distinto al de Python tradicional, por lo que las variables y librerías que uses en funciones debes importarlas nuevamente dentro de la función.

💡Nota:
Este comando no retorna ninguna salida o resultado. Si necesitas retornar un valor a una variable de Rocketbot, puedes usar la función SetVar() que recibe dos parámetros, el primero es el nombre de la variable de Rocketbot donde obtendrás el resultado, y el segundo es el valor que deseas asignar a dicha variable. Ejemplo: SetVar(“variable_rocketbot”, variable_python)

Data Format \ Objetos – Diccionario a JSON

Este comando se utiliza para convertir un diccionario en una cadena JSON. Una vez que proporcione el diccionario como entrada, el comando lo convertirá en una representación de cadena JSON. La cadena JSON resultante se puede utilizar para diversos fines, como transmitir los datos a través de una red o almacenarlos en un archivo.

💡Nota:
JSON (Notación de objetos JavaScript) es un formato de intercambio de datos liviano que se usa comúnmente para transmitir datos entre un servidor y una aplicación web.

Data Format \ Objetos – JSON a Diccionario

Este comando se utiliza para analizar un archivo o cadena JSON y retornar un valor de tipo Diccionario.

💡Nota:
JSON (Notación de objetos JavaScript) es un formato de intercambio de datos liviano que se usa comúnmente para transmitir datos entre un servidor y una aplicación web.