Instancias

Para la asignación, creación y más detalles sobre las instancias, se recomienda leer el siguiente documento: Detalles sobre Instancias .

Herramientas de instancias

View last Screenshot

Captura de pantalla

Para poder utilizar esta herramienta se debe configurar en el archivo “.ini” de nuestro cliente
orquestador.

Una vez configurada podremos acceder a ella desde las herramientas de la instancia.
Si no tenemos ninguna captura de pantalla previa, nos saldrá el siguiente mensaje:

Para mandarle una petición al orquestador de una captura de pantalla nueva se debe
seleccionar el botón “REFRESH”.

Dicho procedimiento no es automático y puede tardar algunos segundos.

Si la instancia está conectada al cliente orquestador obtendrá una captura de pantalla y la
mostrara en el mismo modal. Pero si dicha instancia no está conectada a ningún
dispositivo/cliente orquestador, no tomara la captura.

Dicha captura de pantalla es general de la instancia y no del proceso. Por ende si tengo la
misma instancia en otro proceso, se visualizara la misma captura de pantalla.
Una vez que tengamos la captura, podremos descargarla con el icono que aparece en pantalla.

También podremos solicitar una nueva captura haciendo click en “TAKE SCREENSHOT”
nuevamente.

Webhooks

Son llamadas a APIs que realiza el orquestador bajo 3 condiciones siempre y cuando estén
habilitadas y configuradas:

1- Realiza la consulta a la API cuando se ejecuta un robot (No cuando inicia la instancia,
sino recién cuando el orquestador encuentra el robot y lo ejecuta) (Cuando la barra de
la instancia se pasa a estado amarilla).
Ej: Enviar robot en ejecución a una API para crear un listado de varios robots y sus
instancias responsables.

2- Realiza la consulta a la API cuando se termina de ejecutar un robot.
Ej: Enviar robots a una API para crear un listado de robots ya ejecutados/procesados.

3- Realiza la consulta cuando llega un mensaje personalizado (“custom log”) asociado a
dicho proceso.
Ej: Enviar los mensajes personalizados que obtenemos en nuestro proceso a una API.
Configuración:

• “Enabled”: Habilitar/Deshabilitar Webhook.
• “Method”: Seleccionar el método de envió de información:
• “Get” (Se inhabilita el cuadro “Data”, ya que se debe proporcionar la
• información en la URL)
• “Post”
• “URL”: Se debe proporcionar la URL de la API a la cual se va a consultar.
• “Headers”: Configuración de las cabeceras de dicha API.
• “Data”: Información la cual se enviara a la API, esta debe enviarse en formato Json. Algunas variables que se pueden usar: {{instance_key}} /{{instance_name}}/{{process_token}}/{{process_name}}/{{data}}

Get Log

Historial de comandos del robot:

Esta sección permite acceder al registro completo de todos los comandos que han sido enviados al robot, ya sea que estén en proceso de ejecución o que ya se hayan completado.

Estado de la conexión:

• Sin conexión:

Si el robot no ha sido ejecutado previamente o si la última ejecución falló al intentar conectarse, se mostrará un modal que indica la falta de conexión.

• Con conexión:

Una vez establecida la conexión, se desplegará información detallada sobre el estado actual del robot y los comandos ejecutados.

Información disponible cuando hay conexión:

Licencia: Muestra la licencia activa que poseemos para el uso del robot.

Robot utilizado: Indica cuál de los robots disponibles está siendo utilizado en la ejecución actual.

Lista de comandos y su estado: Presenta una lista detallada de todos los comandos enviados al robot junto con su estado (por ejemplo, ejecutado, en progreso, fallido).

Tiempo de ejecución: Muestra el tiempo total que ha tomado la ejecución de los comandos.

Remove as backup

En el caso de que tengamos una instancia como backup, podremos convertirla en una instancia normal con la herramienta “remove as backup”

Custom logs

Utilizando el módulo “Rocket Logs”, podemos enviar mensajes tanto internos al orquestador como a correos electrónicos predefinidos. Estos mensajes son útiles para recibir notificaciones y tener control sobre los comandos de nuestros robots.

Por ejemplo, un comando “Custom Log” con los mensajes “El robot comenzó” y “El robot finalizó” nos indicará el estado del robot. Además de enviar estos mensajes al orquestador, también es posible enviarlos por correo electrónico.

¿Cómo generar una API Key?

Primer método

Necesitamos dirigirnos a la sección del perfil.

Desde allí, hacemos clic en el botón “My Profile”.

En el apartado de API Key, podemos refrescar o copiar. Al hacer clic en “Refresh”, generamos una nueva API Key.

Segundo método

Nos dirigimos al menú del orquestador, al módulo de “User y Roles”, y allí hacemos clic en “Users”.

Luego, en usuarios, encontraremos el menú lateral (tres puntos) y podremos seleccionar la opción de API Key.

Una vez ahí, podremos copiar o generar una API Key.

Si está interesado en saber cuándo expira su API Key, se recomienda leer el siguiente documento: Documentación sobre la expiración de API Keys en Rocketbot.

¿Qué es un proceso?

Un proceso es donde se configurará el robot y la automatización.

¿Cómo se crea o se asigna un proceso?

Para crear un proceso sigue el paso a paso del siguiente documento: Creación de tu primer proceso.

Una vez el proceso este creado, al ingresar al mismo encontraremos lo siguiente :

Interfaz

Process

Aquí se puede definir el nombre y la descripción, y cuenta con el token, el cual se puede copiar con acceso rápido. En la parte inferior encontramos los botones para borrar proceso, editar y cerrar.

Robot

Aquí se debe asignar el nombre para identificar al robot dentro del orquestador. En Start robot name se debe asignar el nombre del robot a ejecutar, que debe coincidir exactamente con el de la base de datos; de lo contrario, no se encontrará el robot a automatizar. 

También es necesario asignarle la base de datos del robot.

Backup Instance 

Aquí podemos seleccionar una instancia de respaldo, en caso de que la principal se caiga, y los minutos a partir de los cuales deberá activarse si la principal no se reconecta.

Alerts

En esta sección, se puede configurar una notificación ante una desconexión de la instancia principal. Aquí se deben poner los correos electrónicos donde se enviarán las alertas y los minutos posteriores a la eventualidad (sin que haya reconexión) en los que se disparará la alerta. 

Cronjobs

En esta sección se podrán ver las ejecuciones programadas para cada proceso y configurar nuevas realizando click en [ Create Cron ].

Para mayor detalle, puede revisar el siguiente documento: Trabajar con Cronjobs

Launch Bot (trigger)

Esta opción permite seleccionar otro proceso para que inicie, o se dispare, cuando finalice el proceso que se esta configurando.

Xperience

Esta opción permite seleccionar un formulario Xperience para que lance la ejecución del proceso cuando se envíe dicho formulario, ya sea de manera manual o mediante API.

Data Load

Aquí encontraremos las tareas y transacciones asignadas al proceso, utilizando el módulo Orchestrator Framework desde otro robot, y su estado actual.

Si necesita mas informacion sobre Data Load puede revisar el siguiente documento :

Orquestador Rocketbot : Data Load

Asignar una instancia

Para agregar una o mas instancias donde ejecutar tu proceso sigue el paso a paso del siguiente documento: Agregar Instancia.

¿Cómo paralelizar?

Cuando hablamos de paralelizar debemos distinguir 2 escenarios:

1. Paralelizar un mismo proceso en diferentes instancias
2. Paralelizar diferentes procesos en una misma instancia

El robot de un proceso se puede ejecutar en múltiples instancias, el orquestador enviará la señal de ejecución a todas las instancias asignadas y conectadas al proceso (Salvo las de backup). Así mismo una misma instancia puede estar asignada a múltiples procesos y en la misma ejecutar el robot de cada uno de ellos, en momentos diferentes o al mismo tiempo, según el proceso lo permita o no (LINK). A su vez, cabe mencionar que no se puede ejecutar un robot varias veces al mismo tiempo en una instancia.

Para saber mas acerca de que procesos pueden paralelizarse:

Queues de un proceso

Las queues que figuran en el dashboard de procesos representan ejecuciones pendientes del mismo que se generan cuando un proceso diferente ha disparado al que contiene estas colas. Las colas o queues del proceso se generan cuando el mismo no tiene una instancia disponible para ejecutar el robot al momento en que el se produjo el “disparo”. 

En otras palabras, sólo se producen cuando un proceso tiene configurado un trigger a otro, al finalizar el primero, se ejecuta el trigger y este aguarda a tener una instancia disponible.

En el orquestador podemos usar los formularios de Xperience, podremos crear formularios, saber de su creador y cuando se creó .

Xperience en procesos

En la creacion de procesos encontraremos ya en su interfaz el siguiente menú:

En el apartado Xperience podremos seleccionar el formulario para que lance (trigger) la ejecución del proceso cuando se realice un envió del mismo. 

Para revisar los formularios de Xperience, debemos seleccionar en el menú lateral Form Xperience.

En la barra lateral nos aparecerán las tres opciones:

Forms Xperience :

Forms : 

Aquí podemos crear formularios de Xperience y también observar sus detalles en el orquestador, como su nombre, estatus, si es público, los envíos (submits), la fecha de la última modificación y el último envío (last submit).

Al lado, en los tres puntos, encontramos el menú donde podemos ver el formulario, editarlo o borrarlo.

Si deseamos crear un formulario, hacemos clic en [Create Form]. Se nos pedirá el nombre del formulario y tendremos dos opciones: comenzar con el formulario desde cero o importarlo desde un archivo.

Para la creación de formularios o para importarlos, se recomienda ver el siguiente curso de Xperience: Curso de Xperience.

Form Queues : 

Aquí podemos observar todas las form queues, utilizando un filtro para buscarlas. Abajo, veremos el nombre del formulario, su ID, el estatus, queue by, locked by, la fecha de la queue y la fecha del proceso.

En el menú lateral nos da la opción restart , finalizar y mostrar más o extra .

En “show extra” podremos visualizar la información que se envía a través de xperience.

Con el modulo “Rocketbot Xperience” podremos utilizar comandos que interactúen con los formularios xperience, por ejemplo con el comando “Return Message to Xperience” que podremos enviar un mensaje y poder visualizarlo en la sección “show extra”:

Procesamiento de las Queues (Xperience):

Estas son las entradas de datos realizadas desde los formularios. Si un proceso tiene configurado un formulario, el orquestador realiza un chequeo cada un minuto, si hay datos sin procesar de ese formulario; en caso de encontrar datos (una queue pendiente), si instancias disponibles, se ejecutará el robot de ese proceso en las instancias asignadas disponibles. Si todas están ocupadas, el orquestador repetirá la comprobación al minuto siguiente.

Form Users :

Aquí se encuentran los usuarios y sus correos electrónicos, junto con la cantidad de formularios que poseen. También podemos modificar a los usuarios.

¿Qué es un cronjob?

El cronjob de un proceso es una o más reglas que determinan la fecha, hora y periodicidad de ejecución del mismo.

¿Cómo crearlo?

Al ingresar al proceso en el orquestador, encontraremos la sección de cronjobs ubicada en el menú superior.

Cronjobs: 

En esta sección se encontrará un tablero con el listado de cronjobs definidos para el proceso y, en la esquina inferior derecha, estará el botón para crear nuevos.

Crear Cronjob:

Opciones básicas: 

• Date: Fecha de implementación
• Time: Hora de ejecución
• Timezone: Zona horaria del ambiente de ejecución
• Repeat at: Periodicidad de ejecución
• Instance: Instancia asignada de las disponibles en el proceso
• Enabled: Opción que determina si el cronjob esta habilitado o no

Opciones avanzadas:

Estas opciones nos permiten definir más específicamente:

• Cada cuanto repetir el proceso (Una vez, diariamente, semanalmente, mensualmente). A su vez, es se podra especificar en detalle cuando, por ejemplo, al seleccionar semanalmente se puede seleccionar los días de la semana en los que se deberá ejecutar.
• Durante cuánto tiempo, permite definir una fecha de expiración de la regla.
• Con que frecuencia se ejecutará, por ejemplo, ejecutar cada una hora durante 12 horas.

¿Cómo funciona un Cronjob?

Cuando llega la fecha y hora configurada en un cronjob, el orquestador comprueba si existen instancias disponibles para ejecutar el proceso. En caso afirmativo, ejecutará el robot del proceso en todas las que estén disponibles, de las asignadas a dicho proceso.

IMPORTANTE: Si no hay instancias disponibles al momento de ejecución del Cronjob, el orquestador repetirá la comprobación cuando vuelva a coincidir el día y hora, es decir, se omite.

Opciones Cronologicas de un Cronjob

Frecuencia de ejecución del proceso:

Únicamente: El cronjob se ejecuta una sola vez en la fecha y hora definidas, y no se vuelve a ejecutar.

Diariamente: Se puede configurar para repetirse cada “X” días.

Semanalmente: Se puede configurar para repetirse cada “X” semanas. Además, permite seleccionar los días de la semana en los que se desea que se ejecute el robot.

Mensualmente: Se puede configurar para ejecutarse en uno o varios meses específicos, con dos tipos de configuraciones:

• Días específicos del mes: Por ejemplo, el 1 de enero, el 3 de marzo, etc.

• Semanas específicas del mes: Permite elegir en qué semana o semanas del mes se ejecutará el robot, y además seleccionar los días de la semana para esa ejecución. Por ejemplo, que se ejecute los lunes y miércoles de la primera y tercera semana de enero y marzo.

Fecha de expiración del cronjob

Esta opción permite definir una fecha y hora en la que el cronjob dejará de ejecutarse y, por lo tanto, el robot dejará de activarse.

Bucle

Permite asignar un bucle para que el cronjob active el robot cada “X” tiempo y lo haga durante un periodo de “Y” tiempo.
Ejemplo: Que el robot se ejecute cada 1 hora durante un día completo.

¿Por qué expira?

La API Key del Orquestador de Rocketbot expira en dos años como una medida de seguridad.

Este límite de tiempo ayuda a proteger la integridad del sistema al asegurarse de que las claves de acceso no se utilicen indefinidamente, lo que podría aumentar el riesgo de exposición o uso indebido.

Al forzar la renovación periódica de las API Keys, se obliga a los administradores a revisar y actualizar las claves, asegurando que solo las personas y sistemas autorizados tengan acceso continuo. Además, esto permite implementar mejoras en la seguridad y cambios en las políticas de acceso de manera regular.

¿Dónde la encuentro?

Para saber esta informacion debemos acceder al perfil del usuario.

Hacer clic en My Profile.

En la última casilla se encontrará la fecha de expiración de su API Key.

Si está interesado en la generación de API Keys, se recomienda leer el siguiente documento: Generación de API Key en Rocketbot.

Paso 1: Proyecto

Un proyecto es una carpeta donde estarán los procesos automatizados. Su función es ordenar y agrupar los procesos.

Crear proyecto

El primer paso que se debe realizar es crear un proyecto o seleccionar uno existente, al cual se le asignara el nuevo proceso. En el dashboard de inicio podrá ver los proyectos existentes para seleccionar.
Si desea crear uno nuevo haga click en el botón [ Add Project ] ubicado abajo a la derecha.

Asigne un nombre al proyecto que contendrá sus procesos. por ej: “QA”, “Produccion”, “DEV”, etc.
Una vez creado, ábralo desde el la lista de proyectos para poder agregar procesos al mismo.

Paso 2: Proceso y Robot

Un proceso es donde se subirá y configurará el robot, triggers y demás puntos correspondientes a la automatización.

Para subir un robot, se debe crear o seleccionar un proceso existente.

Crear proceso

Para crear un proceso debe hacer click en el botón [ Add Process ] ubicado abajo a la derecha.
Al nuevo proceso, se le debe ingresar:

• Nombre de proceso
• Nombre del robot principal o robot Padre que inicia el proceso
• Ruta del archivo exportado a producción desde Rocketbot Studio (extensión .db)

Una vez creado, se puede seleccionar desde la lista de procesos para realizar las configuraciones siguientes.

Paso 3: Instancia donde corre el robot

En caso de querer asignar una nueva instancia al proceso, primero debemos agregarla y luego vincularla, por defecto no estará conectada.

¿Cómo vincular/crear instancia y conectarla?

Aquí se crean y editan los formularios de Xperience.

Form settings (propiedades del formulario)

Botones de Visualización / Guardado:

Submit settings (propiedades del completado del formulario):

Botón de agregar elemento, guardar

Pestaña de Editor

Visor de elementos:

Aquí se pueden ver y modificar todos los elementos del formulario.

Pasando el mouse por sobre cada elemento aparecerá su menú de opciones.

Desde este visor las distintas acciones que se pueden realizar sobre los elementos son:

Mover elemento: Arrastrándolo con el mouse o utilizando las flechas del menú de opciones. “->” mueve el elemento una vez hacia la derecha, “<-” mueve el elemento una vez hacia la izquierda.

Editar elemento: Al hacer clic en el ícono del lápiz en el menú de opciones. Abre el modal de edición del elemento (ver sección de crear/editar elemento).

Clonar elemento: Al hacer clic en el ícono de copiar en el menú de opciones, se clonará el elemento (ver sección de clonar elemento).

Borrar elemento: Al hacer clic en el botón rojo con el ícono de cesto de basura en el menú de opciones, el elemento será eliminado.

Crear / Editar formulario

Los formularios se crearán/editarán mediante un modal.

Al editar un elemento, se mostrará un modal similar, pero de color azul y con los campos del elemento completados con sus valores correspondientes. Tiene exactamente los mismos campos que un modal de crear elemento.

Al clonar un elemento, se abrirá un modal similar al de creación, con todos los campos llenos con los valores del objeto original, excepto el ID, que estará vacío. No se puede repetir el ID del elemento original. Al clonarlo, el clon aparecerá al lado (o abajo, si no cabe en la fila) del elemento original.

Si el elemento original tenia custom functions asignadas a eventos, su clon las tendrá asignadas de forma similar.

Atributos obligatorios:

Están marcados con un (*); el elemento no puede ser creado/editado si no están completados.

Atributos comunes a todos los elementos, no obligatorios

Atributos específicos a ciertos elementos

Events (eventos)

En los elementos tipo Input, Date, Number, Password, Textarea, Checkbox, File, Range el footer del modal tendra un botón Show Events. Clickearlo expandirá un grupo de selectores, volverlo a clickear los esconderá.

Estos eventos ocurren cuando se realiza una determinada acción en cada elemento HTML del form. Estos son: onclick, onchange, onblur, onmouseover, oninput. Para más información sobre estos eventos ver https://www.w3schools.com/tags/ref_eventattributes.asp.

Cada evento tendrá seleccionado un selector, en el se podrá elegir una custom function (función customizada) creada por el usuario, para asignarla a ese evento. No es obligatorio asignarle funciones a cada evento.

Para ver cómo funcionan los eventos, dirigirse a Events y custom functions.

Tipos de elemento disponibles

Pestaña de Javascript

Aquí se puede customizar la experiencia del usuario del formulario agregándole código Javascript.

Librerías CDN

Se puede agregar código Javascript de terceros mediante librerías CDN.

En URL to CDN (Dirección a CDN) se puede ingresar la dirección a la librería deseada. Con el botón Add (Agregar) se agrega a la lista de CDNs agregadas.

No se puede agregar la misma dirección dos veces. Si se lo intenta aparecerá un mensaje de error y no se permitirá agregar la librería.

En la tabla se listarán todas las librerías asignadas, con su dirección y su número de orden en que fueron ingresadas, de primera a última ingresada. El botón rojo con el cesto de basura eliminará la librería seleccionada de la lista.

Código manual

Aquí se puede ingresar manualmente código personalizado. A la izquierda se encuentra un menú desplegable con Global, Events y Custom functions. A la derecha se encuentra un editor de código asociado a la sección elegida en el menú. El área del menú que este en ese momento seleccionada estará resaltada en color azul en el menú.

Global

Es código Javascript que afecta a todo el formulario. Cuando se ingresa a la pestaña de Javascript está expandido y seleccionado por defecto. En caso que se quiera volver a acceder, en el menú clickear Global para expandirlo y luego clickear en Code.

Events (Eventos)

Bajo este menú se listarán, primero los eventos particulares del formulario, y luego los eventos asociados a los elementos del formulario.

Form events (Eventos del formulario):

Son los eventos ligados a todo formulario.

Clickeando en cada uno de ellos se puede acceder a su editor de código.

Events (eventos)

En este menú se listan todos los elementos creados del form cuyo tipo tenga eventos asociados (Input, Date, Number, Password, Textarea, Checkbox, File, Range). En el menú se listarán por su ID, con el tipo de elemento entre paréntesis.

Clickear cada uno de ellos los expandirá y se podrán ver listados todos los eventos asociados. Clickear cada evento accederá a su editor de código.

Custom functions (Funciones customizadas)

Aquí se listarán por nombre todas las funciones creadas. Clickeando el botón de “+” al principio de la lista abrirá el modal de creación de función.

Cada función posee un nombre, ningún o varios parámetros y su código. Las funciones no pueden tener nombres repetidos y éstas y los nombres de parámetros deben seguir las reglas de nomenclatura de Javascript.

• Deben empezar con una letra, _ o $
• No pueden contener espacios en blanco
• No pueden ser palabras reservadas.

Clickear una función en la lista accederá a su editor de código. Hacerlo en el botón de edición abrirá el modal de edición, donde se podrá editar el nombre y los parámetros de la función seleccionada. En el botón de borrado permitirá, previa confirmación, borrar la función seleccionada.

Crear/editar función

Function name (nombre de función): No puede estar vacío, debe seguir las reglas de nomenclatura de Javascript y no puede estar repetido. Si el nombre es repetido o inválido aparecerá un mensaje de error y no dejará crear/editar la función.

Function parameters (parámetros de función): Es optativo, una función puede no tener parámetros. Siguen las reglas de nomenclatura Javascript y una función no puede tener dos parámetros con el mismo nombre. Para agregar un parámetro, se escribe su nombre y luego se ingresa presionando la tecla Enter, la tecla Space o la tecla ,. Para borrar un parámetro, se clickea la x al lado de su nombre.

Si se intenta ingresar un parámetro inválido o repetido, aparecerá un mensaje de error y no se podrá agregar.

Asignación y uso de custom functions

Declarando la función en el editor de código deseado la llamará para que se ejecute.

Por ejemplo se crea una función function_1() y en su código ingresamos console.log("hello from function_1").

Se va hasta Events -> formEvents -> load y en su editor se ingresa function_1().

Cuando un usuario abra un formulario, cada vez que este cargue, se llamará a la función function_1 y se ejecutará el código asociado a esta, en este caso un console.log.

Hay dos formas de asignar custom functions. Una es ingresarlas manualmente, como se vio en el ejemplo anterior, y funciona tanto para código global, eventos del formulario y eventos de los elementos. La otra forma, que solo sirve para eventos de elementos, es asignar las funciones a través del modal de crear/editar elemento (ver sección crear/editar elemento).

Por ejemplo, en el modal de edición de un elemento tipo File, le asigno function_1 al evento onclick.

Cuando se vinculan funciones de esta manera, al ir hacia el editor de código del evento, la función se declara al final del código previamente existente y se bloquea el editor. Solo se puede ver el código, sin posibilidad de edición.

Si se quiere volver a editar manualmente el código, se puede hacer clic en Enable code editor (Habilitar editor de código). El editor volverá a estar activo, pero si se regresa al modal de edición del elemento, se puede ver que la función fue desvinculada del evento.

Pestaña de CSS style (estilos de CSS)

Aquí se puede customizar el estilo y la experiencia de usuario del formulario agregándole estilos de CSS.

Librerías CDN

Se pueden agregar hojas de estilo de terceros mediante librerías CDN.

En URL to CDN (Dirección a CDN) se puede ingresar la dirección a la librería deseada. Con el botón Add (Agregar) se agrega a la lista de CDNs agregadas.

No se puede agregar la misma dirección dos veces. Si se lo intenta aparecerá un mensaje de error y no se permitirá agregar la librería.

En la tabla se listarán todas las librerías asignadas, con su dirección y su número de orden en que fueron ingresadas, de primera a última ingresada. El botón rojo con el cesto de basura eliminará la librería seleccionada de la lista.

Editor de estilo de CSS

En este editor se pueden definir manualmente los estilos para la vista del formulario, especificando los selectores cuyos estilos de desean modificar.

En el ejemplo de la imagen superior, se definió para todos los elementos <h1> del form un tamaño de fuente de 25 píxeles, para todos los elementos con clase form-label un color rojo y para los elementos con ID first-name-input un borde sólido negro de 1 píxel de ancho.

Pestaña de code (código)

Aquí se puede ver y editar el código de los elementos del form, descargar el código .json de las variables, descargar un robot prefabricado que manipule el formulario, y descargar el código .json del formulario.

Visor/editor de código

En el visor se puede ver el código .json de todos los elementos del form en orden de primero a último, con todos sus atributos.

Presionar el botón verde a la derecha habilitará el modo de edición. En el el código se formateará de forma que su visualización y edición sea sencilla, como un elemento por bloque. Volver a clickear el botón cerrará el modo de edición, cambiará el formato a texto plano y guarda todos los cambios realizados.

Si se introduce código incorrecto, aparecerá un mensaje de error y al cerrarse el editor los cambios realizados desde la última vez que se habilitó el editor de código no se aplicarán.

Botón de Download vars (descargar variables)

Crea todas las variables necesarias para que el robot autocomplete con los datos enviados al queue, genera y descarga un archivo .json, con cada uno de los elementos del form, siendo su atributo name el ID del elemento.

Botón de Download robot prefab (Descargar robot prefabricado)

Crea y descarga un robot en formato .json para cargarlo en Rocketbot Studio.

Botón de Export form (exportar formulario)

Crea un archivo .json con el formulario y lo descarga, con sus elementos, librerías y código Javascript/CSS, eventos y funciones personalizadas.

El sistema de las licencias del orquestador consta de 2 estructuras:

• Licenses/connections: Son las conexiones que se crean vinculando distintos dispositivos al token de la licencia (con la condición de que tengan licencias disponibles).
• Licenses/logs: Historial de conexiones y desconexiones de dispositivos con las licencias.

Licenses/connections

Nos dirigiremos a la pestaña “Licenses/Connections”, en donde le aparecerá una tabla con todas las licencias que posee. (Si no tiene, la tabla estará vacia):

Para agregar una nueva licencia, nos dirigiremos al boton “Add License”, el cual abrirá un modal.

Si no posee ningúna licencia para vincular su dispositivo, le aparecerá un cartel de error:

Si cuenta con licencias disponibles, aparecerá el mismo modal donde tendremos que configurar:

• Name: El nombre al que le daremos a la licencia (No se puede repetir)
• License Type: Seleccionaremos uno de los tipos de licencias que tendremos disponibles. (Solamente tendremos los tipos de licencia que hemos pedido previamente a comercial, el cual nos lo debera cargar en nuestro cliente)

Ej: Como figura en la imagen, he solicitado a mi cuenta 4 tipos de licencia:

• Basic: Robots paralelos 1 / Conexión con 1 dispositivo.
• Standard: Robots paralelos 2 / Conexión con 1 dispositivo.
• Premium: Robots paralelos 2 / Conexión con 5 dispositivos.
• Mega: Robots paralelos 2 / Conexión con 20 dispositivos.

En este ejemplo, se me ha otorgado un limite de 1 licencia basic, 1 licencia Standard, 2 licencias Premium y 2 licencias Mega.

Para crear la licencia, luego de configurar el nombre y el tipo de licencia, le daremos click a “Add” y la nueva licencia se mostrará en la tabla:

Como vemos en la imagen, pude crear como límite 1 licencia basic y 2 licencias mega.

Si queremos crear una nueva licencia de tipo “basic” y “mega”, nos va a salir un error de que se llegó a la capacidad máxima de dicho tipo de licencia:

Status de la licencia

Luego de crear las licencias, veremos que sus “status” son desconectados. Para conectar dichas licencias con nuestros dispositivos debemos:

a. Obtener el token de la licencia:

En el menú (…) de la licencia daremos click a “License token”:

Se nos abrirá un modal en donde podremos generar nuestro token:

b. Licenciar Studio:

Ir a la carpeta de Rocketbot y ejecutar Rocketbot.exe. Esto abrirá una ventana como esta:

Dar click en Login e ingresar:

• Username:
• Password: Credenciales con la que nos logueamos al orquestador.
• Token: Token de la licencia (obtenido en el punto a).

c. Si se realiza una conexión “success”, se nos conectara el dispositivo a nuestra licencia de forma exitosa, en donde obtendrá el nombre de la maquina/dispositivo conectado:

d. En el caso de las licencias escalables (que permiten varias conexiones de dispositivos, como “mega”) los nombres de los dispositivos conectados aparecerán ordenados en la columna “status”:

Licenses/logs

Tabla en donde figura el historial de las conexiones y desconexiones de los dispositivos a las licencias, en donde:

• Event: Evento que ocurrió ( Conexión/desconexión).
• Message: Mensaje informando lo ocurrido.
• PC: Dispositivo que fue afectado.
• License: Licencia que fue afectada.
• User: Usuario cuyas credenciales realizaron la acción.
• Date: Fecha de modificación.

Y en la misma tabla podremos encontrar filtros para mejorar la búsqueda entre las páginas.

Descripción

Rocketbot Picture in Picture (PiP) es una herramienta que permite ejecutar robots cargados en el orquestador en una sesión hija de tu usuario local de Windows. Esto permite realizar ejecuciones en un entorno separado de tu sesión principal de Windows, pero a su vez ejecutándose con el mismo usuario, liberando la sesión principal para realizar cualquier otra actividad mientras se ejecuta tu robot.

💡Nota:
Para poder utilizar Rocketbot PiP, es necesario tener instalado el cliente de noc versión 2.0 o superior.

Descarga Rocketbot Picture in Picture desde aqui: #soon

Configuración NOC y PiP

Una vez descargado el cliente noc 2.0 y Rocketbot PiP, agregar a las configuraciones del archivo noc.ini (ubicado en la instalación del cliente noc) lo siguiente:

Crear la sección [PIP] y dentro asignar los siguientes valores:

[PIP]
open = true/false
path = path_to_RocketbotPiP.NET.exe
user = tour_Windows_user
password = your_Windows_password
screenshot = true/false

• open (obligatorio): indica si se ejecutarán robots del orquestador en PiP. Si se indica true al abrir noc.exe se abrirá PiP por un momento para iniciar la sesión hija.
• path (obligatorio): en este campo se debe indicar la ruta hacia el ejecutable de RocketbotPiP.
• user (opcional): indica el nombre del usuario local de Windows actual. Si no se guarda aquí se deberá iniciar sesión y en el proceso se guardará el dato en el baúl de credenciales de Windows.
• password (opcional): indica la contraseña de tu usuario local de Windows actual. Al igual que el user, si no se guarda aquí se deberá iniciar sesión y en el proceso se guardará el dato en el baúl de credenciales de Windows.
• screenshot (opcional): indica si el orquestador puede tomar capturas de pantalla en la sesión hija abierta por Rocketbot PiP.

💡Nota:
Rocketbot PiP necesita tener acceso a las credenciales de Windows para automatizar el inicio de sesión. De manera opcional se pueden cargar en el archivo .ini. Si por seguridad se prefiere hacerlo, la primera vez que se ejecute RocketbotPiP se solicitarán las credenciales. Estas serán almacenadas dentro del Administrador de Credenciales de Windows como credenciales genéricas bajo el nombre de ‘pip_localhost’.

Terminado de configurar el archivo noc.ini, se debe agregar la aplicación noc.exe dentro de la lista de aplicaciones que se abren al iniciar Windows, de esta manera tanto en el inicio de la sesión principal y de la sesión secundaria en pip, abrirán el noc automáticamente.
Los pasos son los siguientes:

1. Haz click derecho en la aplicación noc.exe y selecciona Copiar
2. Presiona Windows + R, escribe shell:startup y haz click en Aceptar. Se te abrirá la carpeta Inicio.
3. Haz click derecho sobre la carpeta y selecciona Pegar acceso directo. Si tienes Windows 11 al hacer click derecho deberás seleccionar primero Mostrar más opciones.

La primer configuración que se debe realizar al descargar Rocketbot PiP es ejecutar como administrador RocketbotPiP.NET.exe y hacer click en el botón Enable Child Session. Esto dará los permisos necesarios para poder abrir la sesión hija en Picture in Picture. Una vez realizado esto, se puede cerrar la aplicación y continuar con la configuración del servidor.

Configuración Servidor Orquestador

Para poder ejecutar diferentes procesos en PiP, se debe configurar el parámetro dentro de la línea de comandos de la instancia. Para ello hay que iniciar sesión en el servidor y dirigirse al proceso que deseamos ejecutar.

Al ingresar al proceso, en la instancia donde se ejecutará por PiP hacer click en los tres puntos para mostrar más opciones y elegir Set command Line

En el input agregar como primer parámetro --pip

Consideraciones

Rocketbot Picture in Picture está disponible solamente para sistemas operativos Windows y el usuario debe ser una cuenta local. Por limitaciones de Windows, PiP por el momento no funciona con usuarios cuya cuenta esté vinculada a una cuenta de Microsoft.

Si has decidido no guardar tus credenciales en el archivo noc.ini y no has iniciado sesión en el paso donde se debe dar click en Enable Child Session, la primera vez que se ejecute noc.exe se abrirá Rocketbot PiP y mostrará la siguiente ventana:

Al darle click a Accept se deben cargar las credenciales y luego click a connect. Esto hará que se guarden los datos de conexión en el baúl de credenciales de Windows, explicado aquí.

PiP funciona como un escritorio remoto y no permite ejecutar aplicaciones como administrador, por lo que se debe tener en cuenta antes de comenzar un desarrollo en el cual sea necesario ese nivel de privilegios.

Al ejecutar un robot en PiP que requiera de interfaz gráfica, ya sea porque se automatizan aplicaciones desktop (que interactúan con el mouse o el teclado) o bien porque se utiliza virtualización por ejemplo, se requiere tener en primer plano la aplicación. Si se desea ejecutar con PiP minimizado, se debe agregar un registro que permita mantener la interfaz. Siguiendo los pasos a continuación podrás realizarlo:

1. Cierra la aplicación de PiP
2. Presiona Win + R, escribe regedit y presiona enter
3. Ve hacia el registro que corresponda según tu sistema operativo (32 o 64 bits):

   • 32 bits: HKEY_LOCAL_MACHINE\Software\Microsoft\Terminal Server Client
   • 64 bits: HKEY_LOCAL_MACHINE\Software\Wow6432Node\Microsoft\Terminal Server Client

4. En el recuadro blanco de la derecha haz click derecho y selecciona Nuevo > Valor de DWORD. Su nombre debe ser RemoteDesktop_SuppressWhenMinimized
5. Una vez creado y nombrado, haz doble click sobre dicho registro. En el input Información del valor colocar 2. Para finalizar haz click en Aceptar para guardar los cambios.
6. Cierra la ventana del editor de registro. Con este cambio, los robots ejecutados en PiP tendrán una interfaz para poder trabajar sin problemas aún cuando la aplicación esté minimizada.