JI1 - A cosa serve JI1.1 - Cosa si può automatizzare In una frase. Una funzione dell'ERP legacy/COBOL che fai sempre uguale la registri una volta, e da lì in poi la rifà il sistema, all'ora che decidi. Ogni mattina qualcuno apre la stessa funzione, scrive gli stessi valori, aspetta l'elenco e lo salva in Excel. È un lavoro che non chiede di pensare, ma chiede una persona. Con le Macro/Workflow SBH quella persona non serve più: il sistema rifà gli stessi passi e ti lascia il file pronto. A schermo queste registrazioni si chiamano Flussi . In questo libro «flusso» vuol dire questo: una funzione registrata che si ripete da sola. L'elenco dei flussi: per ognuno quando gira, com'è andata l'ultima volta e quando sarà la prossima. Pagina di prova con dati finti Si presta bene una funzione che: si ripete uguale : stessa voce di menu, stesse maschere, stessi tasti; cambia solo in pochi valori : una data, un conto, un deposito; finisce con un elenco o una stampa : gli ordini da evadere, le giacenze, un tabulato. Il risultato non è una maschera da guardare ma un file: Excel, PDF, CSV o JSON, anche più di uno insieme. Decidi tu dove va: in una cartella, per email, a un altro programma, oppure resta nello Storico , da dove lo scarichi quando vuoi. La scheda Uscite: quali dati, in che formato, dove consegnarli. Pagina di prova con dati finti Il programma COBOL non sa che dall'altra parte non c'è una persona. Fa i controlli di sempre e dà gli stessi messaggi: quello che non lasciava fare a te, non lo lascia fare neanche al flusso. Cosa ci guadagni. • L'elenco delle sei e mezza è pronto quando arrivi: il flusso gira di notte o all'alba, senza nessuno davanti. • Nessun valore sbagliato per distrazione: i passi sono sempre quelli registrati, e la data si calcola da sola («da trenta giorni fa a oggi»). • Stessi controlli di sempre: lavora la stessa funzione COBOL, non una copia riscritta. Nota. Oggi la strada sicura sono le funzioni che leggono e basta: elenchi e stampe. Per quelle che scrivono dati ci sono regole in più: vedi Cosa non fa . Per chi sviluppa. Il servizio che rifà i passi è SBHflow, backend/middleware/sbh-flow (Node, porta 5087, nessun browser). Le pagine dei flussi sono in frontend/sbh-web/src/flows . Un flusso pubblicato si può avviare anche da un altro programma, con una chiave: scheda API del flusso. Piano e decisioni: docs/sbh-web/PIANO-FLUSSI.md . JI1.2 - Dove sta nella mappa In una frase. Le Macro/Workflow SBH stanno nel gruppo «Gestionale storico», accanto all'ERP legacy/COBOL: fanno al posto tuo quello che faresti tu dalle Pagine storiche. La mappa di ADSWnext con accese le Macro/Workflow SBH e l'ERP legacy/COBOL Chi le chiama. Nessuno, se c'è un orario: partono da sole. Altrimenti le fai partire tu con Esegui , oppure un altro programma che ha la chiave del flusso. Chi chiamano loro. L'ERP legacy/COBOL, passando dal Ponte col COBOL, proprio come fa il tuo browser. Il programma legge e scrive i Dati aziendali come sempre. Dove si preparano. In SBHweb: è lì che registri la funzione, scegli i file e l'orario, e guardi com'è andata. Il meccanismo ha due tempi. Prima registri, una volta sola, lavorando come sempre. Poi il sistema ripete, tutte le volte che serve. Prima registri tu dal browser, poi le Macro/Workflow SBH rifanno gli stessi passi a orario Quando il flusso gira non si apre nessun browser e non serve nessun PC acceso. Per questo le stampe di un flusso vanno solo sulle stampanti del server, mai su quella accanto alla tua scrivania. Il flusso entra nel gestionale con un utente suo, scelto da chi amministra. Può fare solo quello che quell'utente può fare. Per chi sviluppa. Tessere della mappa: sbhflow ( backend/middleware/sbh-flow ) e cobol (il server COBOL, fuori dal repository). Flussi, orari e storico delle esecuzioni li tiene SBHgateway ( backend/middleware/it_gsba_sbh_gateway , porta 5086): è lui che all'ora fissata passa il lavoro a SBHflow. SBHflow apre la sessione sul canale di SBHgateway, come un browser. Contratto fra i due: docs/sbh-web/flussi-contract/SBH-FLOW.md .