Saltar al contenido principal
Ir al Studio
Configuración del robot

Parámetros del robot

Parámetros del robot

Los parámetros son variables configurables asociadas a un robot: contraseñas, claves de acceso, rutas de carpeta o cualquier otro valor que pueda cambiar sin que tengas que editar el flujo del robot. Importan sobre todo para la información sensible que no debería verse en el Designer.

¿Por qué usar parámetros?​

Imagina un robot que entra en un sistema con usuario y contraseña. Si escribes la contraseña directamente en una acción, queda visible para cualquiera que abra el Designer. Como parámetro, se guarda de forma segura y separada del flujo, y cuando cambia, cambia en un solo sitio.

Otros usos habituales:

  • Credenciales de correo, bases de datos o sistemas internos
  • Rutas de carpeta que varían según el entorno
  • Claves de API o tokens de acceso
  • Ajustes que cambian a menudo

Cómo llegar a los parámetros​

  1. Abre el Designer del robot.
  2. Haz clic en el icono de etiqueta 🏷️ de la barra lateral para abrir la pantalla de parámetros.

Crear un parámetro​

  1. Haz clic en Crear parámetro (o en el botón +).
  2. Completa los campos:
CampoObligatorioQué es
NombreSíEl identificador del parámetro. Usa nombres descriptivos, sin espacios (contrasena_sistema, ruta_carpeta).
ValorSíEl valor que usará el robot.
DescripciónNoUna explicación para que otras personas sepan para qué sirve el parámetro.
Tratar como secreto (contraseña)NoCon esto activado, el valor queda oculto y nadie puede volver a leerlo.
  1. Haz clic en Guardar.

Parámetros de tipo contraseña​

Activar Tratar como secreto (contraseña) guarda el valor completamente oculto: ni tú puedes volver a leerlo una vez guardado. Solo se puede sobrescribir con un valor nuevo.

Parámetros de contraseña y dispositivos vinculados

Los parámetros de contraseña se guardan localmente en el dispositivo. Si desvinculas el dispositivo del robot, esos valores se pierden y habrá que volver a introducirlos al vincular otro dispositivo.

Usar un parámetro en una acción​

Los parámetros que creas quedan disponibles en cualquier campo dinámico del Designer. Para usar uno:

  1. En el campo de configuración de una acción, cambia el modo de entrada a Parámetros.
  2. Elige el parámetro en la lista.

El robot sustituye su valor real en el momento de la ejecución, sin exponerlo en el flujo.

Usar parámetros en expresiones (campos de texto)​

Además de elegir un parámetro por el modo Parámetros, puedes incrustar uno dentro de un campo de texto con esta sintaxis:

{{PARAMETROS.nombre_del_parametro}}

Resulta útil cuando el parámetro forma parte de un valor mayor, como una URL o un mensaje:

EjemploResultado en ejecución
https://api.ejemplo.com/{{PARAMETROS.cliente_id}}/datoshttps://api.ejemplo.com/abc123/datos
¡Hola, {{PARAMETROS.nombre_usuario}}!¡Hola, Brendon!
Bearer {{PARAMETROS.token_api}}Bearer eyJhbGc...

Para los secretos (parámetros marcados como contraseña), usa:

{{SEGREDOS.nombre_del_secreto}}
información

El nombre debe coincidir exactamente con el registrado en el parámetro (sin espacios). Las mayúsculas y minúsculas no influyen.

Los prefijos PARAMETROS y SEGREDOS son la sintaxis en sí y se mantienen en portugués en todos los idiomas.

precaución

La sintaxis {{PARAMETROS.X}} en campos de texto se resuelve en tiempo de compilación: el valor no se ve en el Designer, pero sí queda incluido en el código compilado. Para valores que deban permanecer realmente ocultos, usa {{SEGREDOS.X}} (parámetros marcados como contraseña).

Usar parámetros en campos de código​

En un campo de tipo Código puedes referenciar parámetros y secretos dentro de template literals con la misma sintaxis:

typescript
// Un parámetro normal
const usuario = `{{PARAMETROS.usuario}}`

// Un secreto
const contrasena = `{{SEGREDOS.contrasena_sistema}}`

// Interpolado en una cadena mayor
const url = `https://{{PARAMETROS.servidor}}/api/login`

return usuario

Al ejecutarse, el robot sustituye {{PARAMETROS.X}} por el valor real del parámetro.

Editar y eliminar parámetros​

  • Para editar un parámetro, haz clic sobre él en la lista de parámetros guardados.
  • Para eliminarlo, haz clic en el icono de borrado que tiene al lado.
Actualizar no rompe el flujo

Cambiar el valor de un parámetro no exige ningún cambio en el flujo del robot. El robot simplemente usa el valor nuevo en su siguiente ejecución.

Siguientes pasos​