🇮🇹 IT

⌨️ Manual Input

Mette in pausa il workflow e presenta un modulo di inserimento dati a un utente specificato. Il workflow riprende quando l'utente invia il modulo. Usa Manual Input quando hai bisogno che una persona fornisca dati durante l'esecuzione del workflow — ad esempio per effettuare una correzione, selezionare un'opzione o inserire informazioni che non possono essere automatizzate.

Categoria: Interazione Umana / Utente · Identificatore tipo: manual_input

Panoramica

Il nodo Manual Input introduce uno step strutturato di inserimento dati umano all'interno di un workflow automatizzato. Quando l'esecuzione raggiunge questo nodo, il workflow entra nello stato In attesa e un'attività con il modulo compare nella pagina Attività dell'utente assegnato. L'utente compila i campi configurati e clicca Invia. I valori inviati sono quindi disponibili per tutti gli step successivi nel contesto del workflow.

A differenza del nodo Approval (che chiede solo una decisione sì/no), Manual Input permette di raccogliere dati strutturati arbitrari — testo libero, numeri, selezioni da un menu a tendina, indirizzi email e altro — prima che il workflow prosegua.

Configurazione

Campo	Stato	Descrizione
Assegnatario	Obbligatorio	Indirizzo email o ID utente della persona a cui richiedere l'input. Supporta riferimenti `{{ variabile }}`.
Titolo	Obbligatorio	Intestazione mostrata sul modulo di input, es. `Rivedi e conferma i dati estratti`.
Descrizione	Opzionale	Istruzioni o contesto per l'utente che compila il modulo.
Campi	Obbligatorio	Elenco dei campi del modulo da mostrare. Ogni campo ha: Etichetta — nome visualizzato mostrato all'utente. Chiave — nome della variabile usato per accedere al valore inviato negli output. Tipo — `text`, `textarea`, `number`, `email`, `select` o `checkbox`. Opzioni (per select) — elenco di opzioni separato da virgole. Obbligatorio — se il campo deve essere compilato prima dell'invio.
Timeout	Opzionale	Tempo massimo di attesa in minuti. Il workflow fallisce se il timeout scade senza un invio. Lascia vuoto per attendere indefinitamente.
Invia Email	Opzionale	Interruttore. Invia una notifica email all'assegnatario oltre alla notifica in-app. Richiede che SMTP sia configurato nelle Impostazioni.

Dati di Output

Tutti i valori dei campi inviati sono disponibili come un unico oggetto data indicizzato dalla Chiave configurata per ogni campo. I singoli campi possono essere acceduti direttamente usando la notazione punto.

Campo	Tipo	Descrizione
`data`	object	Tutti i valori dei campi inviati come coppie chiave-valore, indicizzati dalla Chiave configurata per ogni campo.
`data.[key]`	any	Valore del singolo campo, es. `{{ input.output.data.approved_amount }}`.
`submitted_by`	string	Email o ID utente della persona che ha inviato il modulo.
`submitted_at`	string	Timestamp ISO 8601 dell'invio.

Esempio di Utilizzo

Un nodo Schema Extractor estrae automaticamente i dati della fattura (nome fornitore, importo, data) da un PDF scansionato.
Un nodo Manual Input presenta i valori estratti a un membro del team finanziario, chiedendogli di verificare l'importo. Il modulo ha un campo number con Chiave approved_amount e un campo textarea con Chiave notes.
Un nodo Counter aggiorna il totale progressivo usando {{ input.output.data.approved_amount }}.
Un nodo Email Notification invia una conferma al team contabile con l'importo verificato e le note dell'utente.

Suggerimenti e Note

Scegli le Chiavi dei campi con attenzione — diventano i nomi delle variabili che riferisci negli step successivi (es. una Chiave approved_amount si accede come {{ input.output.data.approved_amount }}). Usa nomi in minuscolo, separati da underscore, senza spazi.
Usa un campo select con opzioni predefinite quando vuoi limitare le scelte dell'utente — ad esempio, un selettore di reparto o un livello di priorità.
Imposta un Timeout per workflow con scadenze temporali per evitare che le esecuzioni restino in sospeso indefinitamente se l'assegnatario non è disponibile.
Il workflow rimane nello stato In attesa nella pagina Attività fino a quando l'utente non invia il modulo, rendendolo visibile agli amministratori che monitorano le esecuzioni attive.
Usa il campo Descrizione per fornire contesto, istruzioni o dati da step precedenti (usando riferimenti a variabili) in modo che l'utente capisca cosa gli viene chiesto di verificare o inserire.

Nodi Correlati

Approval — mette in pausa per una semplice decisione approva/rifiuta anziché per un inserimento dati strutturato.
In-App Notification — avvisa un utente che il suo input è richiesto.
Schema Extractor — estrae automaticamente dati strutturati prima di chiedere a una persona di verificarli.