# JI2.1 - Registrare una funzione

**In una frase.** Accendi la registrazione, fai la funzione una volta come la fai sempre, e i tuoi passi diventano un flusso.

Non devi descrivere niente e non devi programmare. Il sistema guarda cosa fai: la voce di menu, le maschere che incontri, i campi che scrivi, i tasti che premi, le risposte ai messaggi. Alla fine hai l'elenco dei passi, pronto da ripetere.

1. **Scegli la voce nel menu, senza avviarla.** Partire dal menu è meglio: così il flusso sa da dove cominciare.
2. **Apri Opzioni e scegli «Registra flusso…».** Dai un nome che dica cosa fa, per esempio «Ordini da evadere», e premi **Registra**. Sopra la maschera compare una barra rossa: la registrazione è accesa.
3. **Lavora come sempre.** Avvia la funzione, scrivi i valori, conferma, rispondi ai messaggi. La barra conta i passi. Con **Passi** li vedi uno per uno; con **Pausa** fai una cosa che non vuoi registrare.
    
    ![La barra di registrazione sopra la maschera: gli ultimi passi, le griglie trovate, i pulsanti per fermarsi. Registrazione di prova](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/la-barra-di-registrazione-sopra-la-maschera-gli-ultimi-passi-le-griglie-trovate-i-pulsanti-per-fermarsi-registrazione-di-prova.)
    
    *La barra di registrazione sopra la maschera: gli ultimi passi, le griglie trovate, i pulsanti per fermarsi. Registrazione di prova*
4. **Di' quale elenco ti serve.** Quando arriva la griglia, nella barra premi **Usa come uscita**: sono i dati che finiranno nel file. Con **Tutte le pagine** il flusso scorre l'elenco fino in fondo, non solo la prima pagina.
5. **Premi «Termina e apri l'editor».** Il flusso si salva come bozza e si apre la sua pagina. Lì controlli i passi, scegli formato e destinazione dei file, e quando è a posto premi **Pubblica**: solo un flusso pubblicato può girare a orario.

<p class="callout warning">**Attenzione.** Registra con lo stesso utente con cui poi il flusso girerà. Un altro utente può vedere maschere diverse, per esempio un campo in più, e il flusso si ferma al primo passo.</p>

<p class="callout info">**Nota.** Alcune cose non diventano un passo, e la barra te lo dice in arancione: le password (non si registrano mai), i clic sui pulsanti, le finestre di ricerca, le liste di opzioni. Se la funzione non può farne a meno, non è adatta a un flusso.</p>

<p class="callout info">**Per chi sviluppa.** La registrazione è `SbhFlowRecorderService` in `frontend/sbh-web/src/flows/services`. Di ogni maschera si salva la struttura (campi, tipi, lunghezze, colonne della griglia), non i dati. Il passo del menu porta con sé quanto serve per avviare la voce senza riscaricare i menu.</p>

<p class="callout info">**Per approfondire.**  
• Client SBH — i flussi: una funzione COBOL che si riesegue da sola: `docs/guide/moduli/sbh-flussi/README.md`</p>