🇮🇹 IT

📌 Set Variable

Crea o aggiorna variabili di workflow con nome che persistono in tutti gli step successivi dell'esecuzione. A differenza degli output degli step — che vengono scritti una volta e non cambiano mai — le variabili possono essere impostate e sovrascritte più volte durante una singola esecuzione.

Categoria: Manipolazione Dati · Identificatore tipo: set_variable

Panoramica

Ogni step in un workflow produce dati di output, ma quell'output è immutabile: una volta scritto, non può essere modificato. Le variabili funzionano diversamente. Una variabile è un dato con nome che qualsiasi step può scrivere e qualsiasi step successivo può leggere. Puoi inizializzare una variabile a zero, incrementarla all'interno di un loop, e leggere il valore finale dopo la fine del loop — tutto usando nodi separati.

Il nodo Set Variable ti permette di definire una o più variabili in un singolo step. Ogni variabile ha un nome, un tipo e un valore. Il valore può essere un letterale statico o un riferimento {{ variabile }} che attinge dall'output di uno step precedente.

Output dello step vs variabile. L'output di uno step (es. {{ fetch.output.status }}) è sempre il dato restituito da quello specifico step e non cambia mai. Una variabile (es. {{ my_counter }}) è uno slot condiviso che può essere sovrascritto quante volte necessario. Usa le variabili per valori che evolvono durante l'esecuzione.

Configurazione

Il nodo Set Variable accetta un array di definizioni di variabili. Aggiungine quante ne servono in un singolo nodo piuttosto che impilare più nodi Set Variable.

Sotto-campo	Stato	Descrizione
Nome	Obbligatorio	Il nome della variabile. Usa lettere minuscole e underscore (es. `email_count`). La variabile viene poi referenziata nel workflow come `{{ email_count }}`.
Tipo	Obbligatorio	Il tipo di dato della variabile. Scegli tra: `string` — testo `number` — intero o decimale `boolean` — `true` o `false` `array` — un elenco di valori `object` — una mappa chiave-valore
Valore	Obbligatorio	Il valore iniziale. Può essere un letterale statico o un riferimento `{{ variabile }}` che punta all'output di uno step precedente. Per tipo `number`, inserendo `0` si inizializza un contatore. Per tipo `array`, inserendo `[]` si crea un elenco vuoto.

Dati di Output

Tutte le variabili impostate da questo nodo sono disponibili immediatamente negli step successivi. Accedile direttamente per nome, senza prefisso della chiave step:

// Le variabili impostate da un nodo Set Variable sono globali per l'esecuzione {{ email_count }} {{ result_summary }} {{ is_eligible }} // Puoi anche accedervi tramite l'oggetto output dello step {{ init_vars.output.email_count }} {{ init_vars.output.result_summary }}

Esempio di Utilizzo

Inizializzare un contatore prima di un loop

Stai iterando su un elenco di ordini e vuoi contare quanti superano un certo valore.

Aggiungi un nodo Set Variable (chiave step: init_vars) prima del nodo Loop. Definisci una variabile:
Name: high_value_count Type: number Value: 0
All'interno del loop, aggiungi un Logic Gate che verifica se {{ loop_step.current_item.total }} è maggiore di 100.
Sul ramo true, aggiungi un nodo Counter che incrementa high_value_count di 1.
Dopo il loop, riferisci il conteggio finale:
Trovati {{ high_value_count }} ordini di alto valore su {{ loop_step.output.count }} totali.

Costruire un oggetto risultato tra più step

// Imposta una variabile oggetto iniziale Name: report Type: object Value: {} // Gli step successivi possono riferirla e costruire su di essa {{ report }}

Suggerimenti e Note

Inizializza sempre prima dell'uso. Un nodo Counter o Set Variable successivo che fa riferimento a una variabile per nome fallirà se quella variabile non è mai stata definita. Posiziona sempre un nodo Set Variable all'inizio del workflow per stabilire i valori iniziali.
Definisci tutte le variabili iniziali in un unico nodo. Raggruppare tutte le inizializzazioni in un singolo nodo Set Variable all'inizio del workflow rende facile vedere con quale stato il workflow parte.
La sovrascrittura è intenzionale. Aggiungere un secondo nodo Set Variable più avanti nel workflow con lo stesso nome di variabile sostituisce il valore precedente. Questo è il meccanismo per aggiornare una variabile durante il flusso.
L'ambito è per esecuzione. Le variabili sono isolate in una singola esecuzione del workflow. Due esecuzioni concorrenti non condividono le variabili.

Nodi Correlati

Counter — incrementa o decrementa una variabile numerica senza un nodo Set Variable completo.
Filter — filtra un array e memorizza il risultato in una variabile.
Loop — il contesto più comune in cui le variabili vengono inizializzate prima e lette dopo.