Set Variable

Set Variable

Tipo: set-variable  ·  Paquete: Core Activities v1.0.8

Asigna un valor a una variable. Es la actividad con la que creas o actualizas datos a mano dentro del flujo: inicializar un contador, acumular un texto, guardar el resultado de un cálculo, o cambiar el valor de una variable según lo que pase.

A diferencia de las actividades que guardan su resultado en un campo Output, Set Variable existe precisamente para asignar un valor que tú defines mediante una expresión.

Cómo funciona

Indicas el nombre de la variable destino y el valor. Al ejecutarse, evalúa el valor (una expresión C#: un número, un texto entre comillas, una variable o un cálculo) y lo guarda en esa variable, sobrescribiendo lo que tuviera.

• Si el playbook declara variables (en el panel de variables o de argumentos), el nombre debe ser una de ellas y el valor debe ser compatible con su tipo; si no, la actividad falla (ver Errores comunes).
• Si el playbook no declara ninguna variable, la asignación crea la variable al vuelo.
• También sirve para dar valor a un argumento de salida (Out o In/Out) del playbook: ese valor es el que recibe quien lo invoca con Invoke Playbook.
• Las variables del sistema (las que empiezan por $, como $system_playbook_name) son de solo lectura.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
name	string	—	Nombre de la variable a asignar. Un nombre válido (letras, dígitos y _, sin espacios). Es un nombre fijo, no una expresión.
value	object	—	El valor a guardar, como expresión C#: 0, "pendiente", total + 1… Puede ser de cualquier tipo compatible con la variable.

Parámetros opcionales

Ninguno.

Salida

Esta actividad no devuelve un valor aparte: su resultado es la propia variable indicada en name.

Ejemplos

Inicializar un contador y luego incrementarlo (patrón típico dentro de un bucle):

Set Variable   name = contador   value = 0
...
For Each   items = facturas   itemVariable = factura
 └─ activities:
      Set Variable   name = contador   value = contador + 1
Log   message = "Facturas procesadas: " + contador

Acumular un total:

Set Variable   name = total   value = total + num(fila["Monto"])

Construir una bandera según una condición:

Set Variable   name = requiereRevision   value = total > 1000000

¿Set Variable o el campo Output?

Para guardar el resultado de una actividad (un Excel leído, una respuesta HTTP), usa el campo Output de esa actividad — es más directo. Usa Set Variable cuando el valor lo defines tú con una expresión o cuando necesitas modificar una variable existente.

Errores comunes

Mensaje	Causa y solución
Variable '…' is not declared. Declare it in the playbook's 'variables' section before using it.	El playbook declara variables y name no es ninguna de ellas. Revisa el nombre exacto (distingue mayúsculas) o declárala en el panel de variables.
Variable '…': incompatible type. Declared as '…' but received '…'.	El valor no corresponde al tipo declarado (por ejemplo, un texto en una variable numérica). Convierte el valor (num(...), str(...)) o cambia el tipo de la variable.
System variable '…' is read-only and cannot be reassigned.	Intentaste asignar una variable del sistema ($…). Copia su valor en una variable propia.
'name' es obligatorio.	Falta el nombre de la variable destino.
El panel Problemas marca un nombre que no existe	Escribiste un texto fijo sin comillas (pendiente) y se leyó como una variable. Pon el texto entre comillas: "pendiente".

Actividades relacionadas

• Variables — cómo se declaran y su alcance.
• Expresiones — qué puedes calcular en value.