Saturn Studio – Xperience

Xperience es el módulo de Saturn Studio diseñado para gestionar el ciclo de vida de la información transaccional mediante la integración de formularios y colas de datos del Orquestador. Permite a los robots capturar datos, filtrar registros y actualizar estados operativos de forma centralizada.

Para obtener las credenciales de Xperience en Saturn Studio, haga clic aquí.

Para utilizar el módulo Xperience, es indispensable contar con el servicio de Orquestador Rocketbot previamente contratado. Sin esta suscripción activa, no será posible acceder a las herramientas de gestión de formularios y colas transaccionales que ofrece este módulo.

Obtención del Form ID (Form Token)

Para interactuar con un formulario específico, la mayoría de los comandos requieren un identificador único denominado Form ID. Este valor debe extraerse directamente desde la interfaz del Orquestador:

1. Inicie sesión en su instancia del Orquestador.
2. Acceda a la sección Form Xperience en el menú lateral.
3. Seleccione el formulario que desea utilizar y haga clic en el botón de edición.
4. En la cabecera del formulario, localice el campo Form token y copie el código alfanumérico.
5. Pegue este código en el parámetro Form ID del comando correspondiente en Saturn Studio.

Obtención del Queue ID

El Queue ID es el identificador numérico único de un registro o proceso dentro de una cola transaccional. Para obtenerlo, siga estos pasos:

1. Inicie sesión en su instancia del Orquestador.
2. En el menú lateral de navegación, despliegue la sección Form Xperience.
3. Haga clic en la opción Queues.
4. Se desplegará una tabla con el historial de ejecuciones y registros.
5. Localice la columna denominada Id; el valor numérico que aparece allí (ejemplo: 12152) es el Queue ID que debe ingresar en Saturn Studio.

Descripción de los comandos

Obtener lista de formularios (Get form list)

Recupera todos los formularios disponibles vinculados a la credencial.

Parámetro	Descripción	Ejemplo
Credential	Credencial de Orquestador configurada con la API Key.	orchestrator - Test
Assign result to a Variable	Variable donde se almacenará el listado de formularios.	{form_list}

Obtener formulario por ID (Get form by ID)

Obtiene la información técnica de un formulario específico.

Parámetro	Descripción	Ejemplo
Credential	Credencial de Orquestador necesaria para la consulta.	orchestrator - Test
Form ID	Identificador único (token) del formulario.	VGJBQ9DBICYZ4CB
Assign result to a Variable	Variable donde se guardarán los detalles del formulario.	{form_details}

Obtener colas de un formulario (Get queues of a form)

Extrae el listado de colas asociadas a un formulario.

Parámetro	Descripción	Ejemplo
Credential	Credencial de Orquestador.	orchestrator - Test
Form ID	Token del formulario del cual se desean las colas.	VGJBQ9DBICYZ4CB
Reverse list	Si se activa, ordena la lista de la más nueva a la más antigua.	Check
Assign result to a Variable	Variable donde se almacenará la lista de colas.	{queue_list}

Obtener datos de una cola (Get data from a queue)

Trae los registros almacenados dentro de una cola específica.

Parámetro	Descripción	Ejemplo
Credential	Credencial de Orquestador.	orchestrator - Test
Queue ID	ID de la cola transaccional.	125123
Form ID	Token del formulario asociado.	VGJBQ9DBICYZ4CB
Assign result to a Variable	Variable donde se guardará la información de la cola.	{queue_data}

Obtener datos del trabajo (Get job data)

Obtiene la información detallada de una tarea o “job” específico dentro del flujo transaccional del módulo Xperience.

Parámetro	Descripción	Ejemplo
Credential	Credencial de Orquestador necesaria para la conexión.	orchestrator - Test
Select form	Menú desplegable para seleccionar el formulario asociado al trabajo.	testumr
Queue ID	Identificador numérico de la cola; permite el uso de variables {x}.	12152 o {id}
Assign result to a Variable	Variable de Saturn Studio donde se almacenará el resultado de la consulta.	{job_data}

Filtrar datos de una cola (Filter data from a queue)

Busca información específica dentro de una cola aplicando filtros.

Parámetro	Descripción	Ejemplo
Credential	Credencial de Orquestador.	orchestrator - Test
Select form	Selección del formulario desde el menú desplegable.	testumr
Filters	Tabla de condiciones (Input ID, Filtro, Dato).	email = user@test.com
Assign result to a Variable	Variable donde se guardará el resultado del filtro.	{filtered_data}

Descargar archivo (Download file)

Permite bajar archivos adjuntos desde una cola transaccional.

Parámetro	Descripción	Ejemplo
Credential	Credencial de Orquestador.	orchestrator - Test
Queue ID	ID de la cola donde está el archivo.	125123
File name	Nombre con el que se guardará el archivo localmente.	factura_01.pdf
Assign result to a Variable	Variable para confirmar la ruta o éxito de descarga.	{download_status}

Actualizar estado de cola (Update Form queue status)

Modifica el estado lógico de un registro en la cola.

Parámetro	Descripción	Ejemplo
Credential	Credencial de Orquestador.	orchestrator - Test
Queue ID	ID del registro a actualizar.	125123
Set status	Nuevo estado a asignar (ej: Done, Error).	Done
Assign result to a Variable	Variable para almacenar la respuesta del servidor.	{update_res}

Agregar datos a una cola (Add data to a queue)

Inserta un nuevo elemento de datos en la cola de un formulario.

Parámetro	Descripción	Ejemplo
Credential	Credencial de Orquestador.	orchestrator - Test
Form ID	Token del formulario de destino.	VGJBQ9DBICYZ4CB
Form Elements	Mapeo de campos del formulario con valores/variables.	nombre = {cliente}
Assign result to a Variable	Variable donde se recibirá el ID del nuevo registro.	{new_queue_id}