Detener este robot

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.

Imagen de ejemplo




Retornar información

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.

Datos de entrada Descripción Ejemplo
Datos Información que se quiere retornar al robot padre (command: result)

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

Imagen de ejemplo




Ejecutar robot Rocketbot (expose)

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.

Imagen de ejemplo del comando

Datos de entrada Descripción Ejemplo
Nombre del robot en la base de datos  Nombre del robot a ejecutar test1
Asignar resultado a variable Variable donde se guardará el resultado de la ejecución del robot {res}

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.

Imagen de ejemplo de la sección Expose

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.




Ejecutar Python

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.

Datos de entrada Descripción Ejemplo
Código Python Código Python a ejecutar import random
def buscarElemento(lista, elemento):
for i in range(0
….etc

💡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)

Imagen de ejemplo

Video de Curso RPA comando Ejecutar archivo Python



Objetos – Diccionario a JSON

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.

Datos de entrada Descripción Ejemplo
Diccionario  Diccionario para convertir en JSON C:/users/user/documents/file.json
Resultado  Variable donde se almacenará el resultado {var}

💡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.

Imagen de ejemplo




Objetos – JSON a Diccionario

Data Format \ Objetos – JSON a Diccionario

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

Datos de entrada Descripción Ejemplo
Archivo JSON Ruta al archivo Json. Opcional, dejarlo en blanco si usa una cadena JSON C:/users/user/documents/file.json
JSON Cadena JSON. Opcional, dejarlo en blanco si está utilizando un archivo JSON
Resultado  Variable donde se almacenará el resultado {var}

💡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.

Imagen de ejemplo




Objetos – Buscar elemento

Data Format \ Objetos – Buscar elemento

Este comando le permite buscar un elemento específico dentro de un diccionario. El selector de ruta donde se especifica la ruta al valor deseado sigue un formato específico.

Si tiene el siguiente diccionario: {‘ruta’: {‘al’: {‘valor’: ‘resultado’}}} y desea recuperar el valor ‘resultado‘, debe proporcionar el Path Selector como ‘ruta/al/valor’.

Datos de entrada Descripción Ejemplo
Diccionario  Diccionario donde buscar el elemento {dict}
Path Selector Ruta para encontrar el elemento ruta/al/valor
Resultado  Variable donde se almacenará el resultado {var}

💡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.

Imagen de ejemplo




Objetos – Eliminar elemento

Data Format \ Objetos – Eliminar elemento

Este comando se utiliza para eliminar un par {‘clave’: ‘valor’} específico de un diccionario.

Datos de entrada Descripción Ejemplo
Diccionario  Diccionario donde eliminar el elemento {}
Clave  Clave para eliminar del diccionario nombre
Resultado  Variable donde se almacenará el resultado {dict}
Imagen de ejemplo




Objetos – Agregar elemento

Data Format \ Objetos – Agregar elemento

Este comando permite agregar un elemento a un diccionario de la forma {‘clave’: ‘valor’}

Datos de entrada Descripción Ejemplo
Diccionario  Diccionario donde agregar el elemento {}
Clave  Clave del nuevo elemento para agregar al diccionario edad
Valor  Valor asociado a la clave del nuevo elemento para agregar al diccionario 26
Resultado  Variable donde se almacenará el resultado {dict}
Imagen de ejemplo




Texto – Invertir

Data Format \ Texto – Invertir

Este comando se utiliza para invertir el orden de los caracteres en una cadena especificada. Toma una cadena como entrada y devuelve la cadena invertida como salida.

Datos de entrada Descripción Ejemplo
String Texto a invertir Lorem ipsum dolor sit amet
Variable donde almacenar resultado Variable donde se almacenará el resultado {res}
Imagen de ejemplo