Network Orchestrator Client (NOC)

El Network Orchestrator Client es la herramienta encargada de vincular la capacidad de ejecución de su equipo local con el servidor del Orquestador. Esta nueva actualización permite visualizar la versión actual del NOC e integra herramientas avanzadas para la gestión de reconexiones, notificaciones y modos de ejecución.

Conectar instancia al cliente

De forma predeterminada, asignar un nombre a la instancia no la vincula automáticamente con el equipo. Para establecer la conexión, siga este procedimiento:

1. Haga clic en el menú de la instancia (icono de los tres puntos).
2. Seleccione el botón [Connect to Client].

Para una guía detallada paso a paso, consulte la documentación oficial: Configuración de Instancias.

Nueva Actualización y Herramientas

La versión más reciente del cliente (NOC)) introduce mejoras significativas en la visibilidad y el control del entorno de ejecución:

• Visualización de Versión: Ahora el sistema muestra de forma directa la versión actual del NOC instalada en el equipo.
• No limit reconnections: Al habilitarse, el cliente intentará restablecer la conexión tras una caída de red de forma indefinida, sin un límite máximo de peticiones.
• Show notifications when assistants start working: Esta función muestra una notificación visual con el nombre y la imagen del asistente cuando la instancia ejecuta un robot configurado en modalidad “asistente”.
• Use Shell Mode: Permite la ejecución de robots empaquetados en formato .ZIP (consulte la documentación).

Configuración General del Cliente

Estas opciones permiten definir el comportamiento inicial del software y las preferencias de conectividad:

Parámetro	Función
Run when Windows starts	Si está habilitado, el cliente se ejecutará automáticamente al iniciar el sistema operativo.
Login automatically (Only API KEY)	Permite iniciar sesión de forma automática al abrir el software si se utiliza una API KEY.
Run minimized	Ejecuta el cliente de forma minimizada en la bandeja del sistema.
No limit reconnections	Ante una pérdida de conexión, el NOC intentará reconectarse de forma indefinida sin límite de peticiones.
Show notifications when assistants start working	Muestra el nombre y la imagen del asistente cuando la instancia ejecuta un robot configurado bajo esa modalidad.
Use Shell Mode	Habilita la utilización de robots en formato tipo .ZIP.
Proxy	Configuración de red para filtros de seguridad. Requiere el protocolo http, seguido de la dirección de salida y el puerto.
Reset	Restablece todos los valores a la configuración original de fábrica.

Parámetros de Instancia

Opciones específicas para la gestión de la instancia seleccionada y el rastro de ejecución:

• Select instance: Menú desplegable para elegir la instancia que se desea vincular al equipo actual.
• Allow take screenshot: Permite capturar imágenes de la pantalla durante la ejecución para verificar procesos o errores visuales.(Ver screenshot en herramientas de instancias).
• Send logs to Orchestrator: Envía el registro de los comandos ejecutados por el robot hacia el Orquestador para su posterior consulta vía getlogs.(Ver “getlogs” en herramientas de instancias).
• Rocketbot path: Ruta del directorio donde se encuentra el ejecutable de Rocketbot Studio.
• Extra arguments: Campo para ingresar comandos adicionales, como instalación de módulos o actualización de drivers.

1° Ir al editor del formulario en la seccion JS.

2° Crear la “clave recaptcha” en la pagina de recaptcha google(https://developers.google.com/recaptcha?hl=es-419).

3° Ir a “comenzar”, nos llevará a la guía para desarrolladores, y ahi tambien daremos en “comenzar”.

4° Registrar el formulario que quieres utilizar. (En dominio y en etiqueta coloque “forms.myrb.io”.

5° Configurar v3 (Verifica las solicitudes mediante una puntuación) o V2 (Verifica las solicitudes con un desafío).

Luego ir a “enviar” y nos redirigira a nuestra nueva “clave de sitio”.

6° En nuestro formumario ir a la pestaña “js” , agregar un nuevo CDN con “https://www.google.com/recaptcha/api.js?render= + nuestra clave de sitio”

7° En la terminal js -> Events/FormEvents/load tendremos que cargar el recapcha:

const siteKey = ‘nuestroCodigoSiteKey’;
// Verificamos si ya se cargó el script
if (typeof grecaptcha === ‘undefined’) {
const script = document.createElement(‘script’);
script.src = `https://www.google.com/recaptcha/api.js?render=${siteKey}`;
script.async = true;
script.defer = true;
document.head.appendChild(script);
}

8° En la terminal js -> Events/FormEvents/submit tendremos que ejecutar el recapcha:

event.preventDefault();
const siteKey = ‘nuestroCodigoSiteKey’;
grecaptcha.ready(() => {
grecaptcha
.execute(siteKey, { action: ‘submit’ })
.then(token => {
console.log(‘✅ Token generado:’, token);
// Inyectar el token en el form
const form = document.getElementsByTagName(‘form’)[0];
let input = form.querySelector(‘input[name=”g-recaptcha-response”]’);
if (!input) {
input = document.createElement(‘input’);
input.type = ‘hidden’;
input.name = ‘g-recaptcha-response’;
form.appendChild(input);
}
input.value = token;
// (Opcional) si tenés una función que controla validaciones / horario:
// enviarFormulario({ target: form, preventDefault: ()=>{} });
// y dentro de enviarFormulario llamás form.submit() al final.
// Disparar el envío final del form
form.submit();
});
});

Asi podremos ingresar a nuestro propio recaptcha para que podamos ver la informacion de nuestra cuenta de google de los envios de informacion de nuestros formularios.

Un Cronjob es una tarea programada que permite ejecutar procesos de forma automática en fechas y horas específicas. Una vez que has creado un proyecto y asignado un proceso en el Orquestador, puedes configurar su periodicidad mediante esta herramienta.

Gestión de Cronjobs

Desde la interfaz de Cronjobs, tienes el control total sobre la automatización:

• Habilitar/Deshabilitar: Permite activar o pausar todos los cronjobs de forma masiva o individual.
• Visualización Detallada: Muestra la información técnica de cada tarea programada, como la instancia de ejecución y la zona horaria.
• Creación: Botón dedicado para configurar nuevas tareas programadas.

Modos de Configuración

Rocketbot ofrece dos niveles de personalización dependiendo de la complejidad de la tarea:

1. Basic Mode (Modo Básico)

Diseñado para asignaciones rápidas y eficaces donde la periodicidad es estándar. En este modo se configuran los siguientes parámetros:

• Initial Date: Define el día, mes y año en que el proceso comenzará a ejecutarse.
• Initial Hour: Establece la hora exacta del primer arranque.
• Timezone: Parámetro crítico para asegurar que el robot se ejecute en el horario correcto según la región geográfica.
• Repeat: Permite elegir frecuencias predefinidas: diario, semanal, mensual, cada 5 o 10 minutos, o ejecución única (no repetir).
• Instance: Determina en qué instancia (computadora o servidor) se disparará la tarea.
• Cron data: En este apartado pueden ingresarse parámetros adicionales que serán enviados al robot cuando se ejecute a partir de su línea de comandos. Para obtener estos parámetros se puede usar el comando Command line parameters del módulo System nativo, o en caso de tener una versión anterior de Rocketbot, el módulo SystemAdvanced (Get arguments), asignando una variable para capturar la información. Command line también se une a cron data.

2. Advanced Mode (Modo Avanzado)

Este modo proporciona un control granular para escenarios donde la repetición requiere detalles específicos de tiempo.

• Will activate every…: Configuración personalizada para activaciones por intervalos de tiempo, días específicos de la semana o fechas mensuales.
• This cronjob will execute one time on at: Permite programar una ejecución única detallando con precisión absoluta la fecha y hora.
• Set date of expiration: Establece una fecha de “caducidad” para el cronjob, tras la cual dejará de ejecutarse automáticamente.
• Set frequency of execution: Control exhaustivo para definir la frecuencia de ejecución minuto a minuto.

En caso de querer mas detalles puede visitar la siguiente Documentación: Trabajar con cronjobs

¿Qué es control room?

Control Room es tu panel central para que tus clientes o compañeros puedan interactuar con determinados robots, los cuales te pertenecen.

Para poder hacer eso, y con los permisos necesarios, debemos vincular un email con dichos procesos.

Vincular email a control room

Nos debemos dirigir a nuestros procesos.

Seleccionamos el proceso que queremos vincular y nos dirigimos a la herramienta control room.

Nos saldrá el siguiente modal con el listado de emails que ya están vinculados (controlando) dicho proceso. Los cuales podremos eliminar o editar tanto el email como sus permisos.

También un input para agregar un email nuevo. Este email no se debe repetir y podremos asignarle los permisos que deseamos. Una vez que configuremos todo, debemos agregar dicho email con el botón “+” (agregar). Dicho email se agregara al listado y para concluir daremos a “Save”.

• Stop process: Permiso para detener el proceso.
• Run process: Permiso para iniciar el proceso.
• View custom logs: Permiso para ver los mensajes internos (custom logs).

Y listo! El nuevo email ya podrá interactuar con el robot.

Permisos

Para que los usuarios puedan configurar nuevos emails en Control Room, deberan poseer permisos especiales en la consola de Roles.

¿Cómo subir los archivos?

En el modal de creación/edición de proceso, además de poderse subir archivos con extensión .db, se podrán subir archivos con extensión .zip.

Para subir archivos con extensión .zip debemos dirigirnos al modal de creación/edición de robot.

Donde se debera ingresar el “start robot name” el cual debe ser el nombre con el que queremos llamar al nuevo zip subido. Y luego en “upload DB” debemos subir el archivo en formato .zip

El zip que se suba debe tener un archivo llamado manifest.json con el siguiente contenido:

• {
•     “name”: “nombre del archivo”,
•     “version”: “versión del archivo”,
•     “description”: “Descripción del archivo”,
•     “main”: “Método que se utilizara y corresponde al comando principal “
•     “arguments”: “parámetros que se utilizaran”
• }

Deben asegurar que lo que van a ejecutar esté instalado en la instancia, de lo contrario en los logs de la ejecución en el orquestador aparecerá un error.

Ejemplos:

Ip config

• {
•     “name”: “script name”,
•     “version”: “1.0”,
•     “description”: “script description”,
•     “main”: “ipconfig”
•     “arguments”: [“/all”]
• }

Y dará como resultado:

Python

• {
•     “name”: “python print”,
•     “version”: “1.0”,
•     “description”: “Prints a message in the console”,
•     “main”: “python”
•     “arguments”: [“print.py”, “–version”]
• }

Esto hará que el NOC ejecute un script python que estará en la misma carpeta que el manifest.json

Y dará como resultado:

Node

• {
•     “name”: “python print”,
•     “version”: “1.0”,
•     “description”: “Prints a message in the console”,
•     “main”: “node”,
•     “arguments”: [“print.js”]
• }

Y dará como resultado:

Ping a google

• {
•     “name”: “ping google”,
•     “version”: “1.0”,
•     “description”: “Sends a ping to Google”,
•     “main”: “ping”,
•     “arguments”: [“google.com”]
• }

Y dará como resultado:

Usuarios

Para poder acceder a estas pestañas debemos dirigirnos a la sección “Users & roles”.

En esta pestaña podremos visualizar la lista de los usuarios de la cuenta con su respectiva información.

• “Name”: Nombre del usuario.
• “Email”: Email con el cual está registrado.
• “Active”: Si el usuario está o no activado.  En el caso de estar desactivado, el usuario no podrá ingresar al orquestador.
• “ApiKey”: Si la ApiKey del usuario esta generada o no.
• “ApiKey expiration”: Fecha en la cual la ApiKey expirará.
• “Role”: Rol en el cual esta asignado el usuario.

¿Cómo crear un usuario?

Para crear un usuario debemos dirigirnos al botón inferior derecho o al botón superior izquierdo.

Se nos abrirá un modal en el cual debemos ingresar la información del nuevo usuario:

¿Qué formato debe tener la contraseña?

• Un mínimo de 10 caracteres.
• Un mínimo de 6 caracteres alfanuméricos.
• Al menos 1 letra mayúscula.
• Al menos 2 números.
• Al menos 2 caracteres especiales. (!@#$%^&*_)

Herramientas de usuarios:

API Key

Se abrirá un modal para la generación o actualización de la Api Key.

Disable

Opción para deshabilitar/habilitar un usuario.

Editar usuario

Se abrirá el modal en el que ingresamos la información del usuario, para modificar la información que nosotros queramos.

Eliminar usuario

Nos saldrá un cartel para confirmar la eliminación del usuario.

Roles

En esta pestaña podremos visualizar la lista de los roles de la cuenta.

Para crear un nuevo rol debemos ir a “Add role” y seleccionar los permisos que deseamos asignar al usuario que contendrá el rol.

¿Qué permisos podemos asignar?

Checkbox generales

• “view”: Permisos de solo lectura de los checkbox asignados.
• “add”: Permisos para crear elementos nuevos según los checkbox asignados.
• “Delete”: Permisos para eliminar los elementos de los checkbox asignados.
• “Modify”: Permisos para modificar los elementos de los checkbox asignados.

Los elementos que se pueden asignar (checkbox) a los permisos del rol en la sección “general” son:

• Proyectos
• Procesos
• Usuarios
• Roles
• Instancias
• Assets (variables)
• Formularios
• Configuración

Checkbox extras

De procesos

• “set Cron”: Permiso para configurar y crear los cronjobs.
• “Charge robot”: Permiso para subir o editar robots nuevos en el proceso.
• “Link instances”: Permiso para vincular instancias a los procesos.
• “Unlink instances”: Permiso para desvincular instancias a los procesos.
• “Run individual instances”: Permiso para correr instancias de forma individual (botón “play” en procesos).
• “Run all instances”: Permiso para correr instancias de forma masiva (botón “run” en las herramientas de procesos).
• “View process execution”: Permiso para visualizar la pestaña process execution.
• “Modify members of process”: Permiso para privatizar un proceso y agregar miembros para habilitarlos a entrar al proceso privado.
• “Delete custom logs”: Permiso para eliminar los mensajes de forma individual del “custom logs”.
• “Delete all custom logs”: Permiso para eliminar los mensajes del “custom logs” de forma pasiva.

De formularios

• “View queues”: Permiso para visualizar la tabla de queues (envíos de información).
• “Modify queues”: Permiso para modificar los queues (envíos de información).
• “View user forms”: Permiso para visualizar la tabla de “usuarios de formularios” (para formularios privados)
• “Modify user forms”: Permiso para modificar la tabla de “usuarios de formularios” (para formularios privados) Agregarles formularios o cantidad de envíos de información.

De Configuración

• “Change company name”: Permiso para cambiar el nombre de la empresa.
• “View logs”: Permiso para ver el registro del orquestador.
• “View company storage”: Permiso para ver el espacio utilizado en los formularios de la empresa.
• “Clear company storage”: Permiso para borrar el espacio utilizado en los formularios de la empresa.

De usuarios

• “Generate Api key”: Permiso para generar api key.
• “Disable user”: Permiso para deshabilitar o habilitar usuarios.

¿Cómo editar o eliminar un rol?

Podremos editarlos o eliminarlos yendo a las herramientas del rol y luego a “Edit role” o  “Delete role”.

¿Cómo asignamos el nuevo rol a los usuarios?

Una vez creado el rol, debemos ir a la lista de los usuarios y editar el usuario al que deseamos colocar el nuevo rol. Nos abrirá el modal de edición (visto al principio) y ahí podremos seleccionar el rol que acabamos de crear.

Y nos quedaría el usuario en la lista con el rol nuevo.

¿Qué es un Asset?

Son variables ya sea globales o de entorno, las cuales podemos utilizar para pasar valores desde el orquestador a un robot de Rocketbot Studio.

Listado

Para ver el listado de Assets nos deberemos dirigir a la pestaña “Assets”.

• “Name”: Nombre del Asset.
• “Type”: General (Se puede visualizar el valor) o Password (el valor aparece como asteriscos para no mostrar el valor).
• “Value”: Valor alfanumérico que le podremos proporcionar al Asset para enviar al robot.
• “Process”: Si es una variable global el proceso seria all (Embarca todos los procesos) (imagen A). Caso contrario el asset correspondería a un proceso en específico que elijamos (Imagen B).
• “Instance”: Si es una variable global la instancia seria all (Embarca todas las instancias) (imagen A). Caso contrario el asset correspondería a una instancia en específico que elijamos (Imagen B).

Asset global:

Asset de entorno:

Editar Asset

“Edit asset”: Podremos editar el Asset.

Eliminar Asset

“Delete asset”: Podremos eliminar el Asset.

¿Cómo pasar el valor del Asset a mi robot?

Instalar el modulo “Assets_NOC”

Utilizar el comando “Get an Specific Asset”

• “Asset Name”: Nombre del Asset.
• “Process token”: Token único del proceso. (En caso de ser un Asset global “all” dejar en blanco)
• “Instance key”: Llave única de la instancia. (En caso de ser un Asset global “all” dejar en blanco)
• “Assign result to variable”: Variable que crearemos en el robot para obtener el valor del asset.

Una vez configurado todo, cuando el robot ejecute dicho comando (Con las credenciales adecuadas), la variable que hemos asignado (asset1) obtendrá el valor de nuestro asset.

Orden de prioridad de Assets

Importante: Si varios assets predominan en la misma instancia, el orden de prioridad de los assets se tomará desde el nivel con más detalle en la integración de la misma.

Ejemplo: El orden de prioridad siendo 1 más importante y 3 menos importante:

1. Un asset está configurado en un proceso determinado y en una de sus instancias determinadas.
2. Un asset configurado en un proceso determinado y todas sus instancias.
3. Un asset configurado en todos los procesos y todas las instancias.

Índice

• SEGURIDAD:

  • Infraestructura.
  • Autentificación.
  • Conexión.

• LOGIN:

  • Obtener credenciales de acceso entregadas por Rocketbot o por su administrador.
  • Ingresar a Rocketbot Orquestador.
  • Inicio de sesión incorrecto.
  • Restaurar Contraseña.
  • Bloqueo de sesión por intentos fallidos.

• CONFIGURACION DE PERFIL:

  • Mi perfil.

    • Change Password.
    • Edit profile.

  • Storage y envíos disponibles.
  • Company Name.
  • Mi licencia.
  • Autentificación de 2 Pasos.
  • Expiración User ApiKey.

• DASHBOARD:

  • Crear proyecto.
  • Crear proceso.

• PROCESS:

  • Procesos.
  • Interfaz.

    • Process.
    • Robot.
    • Backup.
    • Alerts.
    • Cronjobs.
    • Launch Bot.
    • Xperience.
    • Data Load.

  • Procesos Privados.

• INSTANCES:

  • Crear una instancia.
  • Lista.

    • Connect to client.

      • Herramientas de una Intancia dentro del proceso.

    • Detalles.
    • Eliminar.

• Licenses:
• INSIGHT:

  • Detalles.
  • Schedules for instance.
  • Execution chart.

• PROCESS EXECUTION:

  • Ver ejecuciones en tiempo real de nuestros procesos.

• ASSETS:

  • Lista de Assets.
  • Crear Assets.
  • Editar Assets.
  • Eliminar Assets.
  • ¿Cómo pasar el valor del Asset a mi robot?

• FORMS XPERIENCE:

  • Listado de formularios.

    • Crear un formulario.
    • Editar un formulario.
    • Eliminar un formulario.

  • Configurar un formulario xperience.

    • Propiedades del formulario.
    • Propiedades del completado del formulario.
    • Pestaña de Editor.
    • Pestaña JS.

      • Funciones y eventos.

    • Pestaña CSS.
    • Pestaña del código.

  • Utilizar xperience con un robot.
  • APIs Xperience.

• QUEUES:

  • Lista de Queues.
  • ¿Que son las Queues y como se utilizan?

• USER FORMS:

  • Lista de User forms.
  • Crear User form.
  • Editar user form.

• USERS & ROLES:

  • Lista de usuarios.

    • Crear usuario.
    • Eliminar usuario.
    • Generacion de Api Key.
    • Deshabilitar/habilitar usuario.
    • Editar/asignar Rol.

  • Lista de roles.

    • Crear rol.
    • Eliminar rol.

• LOGS:

  • Logs de usuarios.
  • Exportar registro.

• CONFIG:

  • Zona horaria.
  • Deshabilitar usuario por inactividad.

Este sistema permite convertir procesos públicos en privados y viceversa.

Diferencias entre procesos públicos y privados:

• En un proceso público, cualquier usuario registrado en la cuenta del cliente (es decir, cualquier usuario que figure en la tabla “users”) puede ingresar.

• En un proceso privado, solo pueden acceder los usuarios que estén incluidos en la lista de “miembros” específica para ese proceso.

Pasos para privatizar un proceso:

Verificar permisos necesarios

Antes de privatizar un proceso, es esencial contar con los permisos adecuados, incluyendo la capacidad de agregar “miembros”. 

Para esto, dirígete a la lista de users y roles , busca el rol asignado a tu usuario ( para saber qué rol tienes, revisa la tabla )

En el menú lateral (tres puntos), se mostrarán las opciones para visualizar los permisos del rol. También podrás editar o eliminar el rol, siempre que tengas los permisos adecuados para realizar estas acciones.

Al ingresar a la vista de permisos, podrás verificar si tienes habilitadas las siguientes acciones.

Asegúrate de que tu rol tenga habilitado el permiso “Modify members of process”. 

Si no cuentas con este permiso, aparecerá el siguiente mensaje de advertencia:

Seleccionar el proceso

Una vez confirmados los permisos, dirígete a la lista de procesos o navega hasta el proceso del proyecto que deseas privatizar.

Privatizar el proceso

Identifica el proceso que deseas privatizar, accede a su menú de herramientas (…), y selecciona la opción “Lock process”.

Esta acción cambiará el estado del proceso a privado.

Convertirse en administrador del proceso

Al privatizar un proceso, automáticamente te conviertes en el “organizador” o “administrador” del mismo. 

Esto te otorga acceso total al proceso y la capacidad de agregar miembros.

Agregar miembros al proceso

Una vez dentro del proceso, aparecerá una nueva herramienta llamada “Members”. 

Al hacer clic en ella, se abrirá un modal con la lista completa de usuarios. Aquí podrás seleccionar a los usuarios que deseas agregar como miembros del proceso.

¿Dónde lo encuentro?

Lo puedes ubicar en el menú lateral, con un ícono de reloj.

Función

En esta sección podremos observar las ejecuciones en tiempo real de nuestros procesos.

Se nos visualizarán los siguientes ítems:

1. Nombre del proceso.
2. Nombre de la instancia.
3. Nombre del robot.
4. Fecha y hora de inicio del robot.
5. Fecha y hora de final del robot.
6. Duración que tuvo el robot.

Filtro de Búsqueda

De ser necesaria una búsqueda, tendremos a disposición los filtros de búsqueda, con los cuales contamos con

• Started at: Filtro de inicio de fecha de ejecución de robot.
• Ended at: Filtro de fin de fecha de ejecución de robot.
• Filter by dates: Botón para iniciar la búsqueda de robots que coincidan entre la o las fechas configuradas.
• Search process execution: Búsqueda general.
• Process: Filtrar por nombre de proceso.
• Instance: Filtrar por nombre de instancia.
• Boton “XLSX”: Imprimir resultados en un Excel.