Variables de flujo de trabajo

Las variables de flujo de trabajo contienen datos compartidos durante una ejecución. Define sus valores iniciales en el panel Variables, léelas desde los bloques con <variable.name> y actualízalas mediante un bloque Variables. Las asignaciones durante la ejecución no persisten entre ejecuciones.

Descripción general

La función Variables sirve como almacén central de datos de tu flujo de trabajo y te permite:

Crear variables

Crea y gestiona variables en el panel Variables del flujo de trabajo o en el widget Workflow Variables. Cada variable tiene:

• Nombre: Un identificador único para referenciar la variable
• Tipo: plain (texto sin formato), number, boolean, object, array o listingIdentity
• Valor inicial: El valor guardado para inicializar cada ejecución; las variables nuevas usan texto plain vacío

Acceder a las variables

Las variables se pueden consultar desde cualquier bloque de tu flujo de trabajo mediante el menú desplegable de variables. Simplemente:

1. Escribe < en cualquier campo de texto de un bloque
2. Recorre el menú desplegable para seleccionar entre las variables disponibles
3. Selecciona la variable que quieres usar

Cuando escribes < en un campo de texto, aparece un menú desplegable con todas las variables del flujo de trabajo disponibles. Selecciona la que necesites para insertar una referencia a ella.

Tipos de variables

Las variables de TradingGoose pueden almacenar distintos tipos de datos:

"Hello, World!"

42

true

{
  "name": "John",
  "age": 30,
  "city": "New York"
}

[1, 2, 3, "four", "five"]

Uso de variables en bloques

Cuando accedes a una variable desde un bloque, puedes:

• Leer su valor: Usa el valor actual de la variable en la lógica de tu bloque
• Modificarla: Asigna un valor nuevo con un bloque Variables
• Usarla en expresiones: Calcula en código Function o en una expresión de condición; los campos de valor de Variables no evalúan operaciones aritméticas

Ámbito de las variables

Las variables de TradingGoose tienen ámbito global, lo que significa:

• Son accesibles desde cualquier bloque de tu flujo de trabajo
• Los cambios en las variables persisten durante toda la ejecución del flujo de trabajo
• Cada ejecución nueva carga los valores iniciales guardados del estado activo o desplegado del flujo de trabajo; las asignaciones de ejecuciones anteriores no se guardan

Las instancias Parallel comparten estas variables, por lo que las escrituras concurrentes pueden sobrescribirse. Usa salidas por instancia y agrega los resultados del contenedor cuando necesites aislamiento. Para conservar estado entre ejecuciones, usa almacenamiento persistente.

Prácticas recomendadas

• Usa nombres descriptivos: Elige nombres de variables que indiquen con claridad qué representa la variable. Por ejemplo, usa userPreferences en lugar de up.
• Documenta tus variables: Explica su propósito en las notas del flujo de trabajo; el editor de variables no tiene un campo de descripción separado.
• Ten en cuenta el ámbito de las variables: Se comparten durante la ejecución. Conecta los bloques para imponer el orden cuando una lectura dependa de una asignación anterior.
• Inicializa las variables al principio: Configura e inicializa tus variables al inicio del flujo de trabajo para que estén disponibles cuando se necesiten.
• Gestiona las variables ausentes: Considera siempre el caso en que una variable aún no exista o tenga un valor inesperado. Añade la validación adecuada en tus bloques.
• Limita el número de variables: Mantén un número de variables manejable. Demasiadas variables pueden hacer que el flujo de trabajo sea difícil de entender y mantener.