JI4 - Limiti e sicurezza
JI4.1 - Cosa non fa
In una frase. Un flusso ripete, non decide: davanti a una cosa che non conosce si ferma, e alcune cose oggi non le fa o sono ancora da provare dal vivo.
Meglio saperlo prima. Un flusso che si ferma ti fa perdere un giro. Un flusso che tira a indovinare dentro il gestionale farebbe danni.
Non indovina
Di ogni maschera il flusso ricorda la struttura. Se il programma è cambiato (un campo nuovo, un campo più lungo, una maschera diversa, un messaggio mai visto) si ferma prima di premere tasti, torna al menu e ti mostra la differenza.
Un giro fermato: la tabella mette a confronto la maschera registrata e quella trovata. Pagina di prova con dati finti
Non fa tutto quello che fai tu
- Finestre di ricerca, liste di opzioni, clic sui pulsanti: non si registrano. Se durante un giro ne compare una, il flusso si ferma e dice quale.
- Stampanti del PC: un flusso stampa solo sulle stampanti del server.
- Password: non si registrano mai.
- Due giri insieme dello stesso flusso: no. E ogni giro occupa una sessione del gestionale.
Le funzioni che scrivono dati
Chi registra dichiara se il flusso è di sola lettura o se scrive dati. Il sistema non può capirlo da solo: dipende dal programma. Un flusso che scrive:
- lo pubblica solo chi ha il permesso di approvare;
- si prova prima con Prova a secco: fa tutti i passi e si ferma davanti all'ultima conferma, senza consegnare niente;
- se lo modifichi torna in bozza e va approvato di nuovo.
Da provare dal vivo
Sul server vero è stata provata una funzione di sola lettura: un elenco di ordini, con il file Excel pronto in meno di mezzo minuto. Non sono ancora provati dal vivo:
- un flusso che scrive dati, dall'approvazione al giro vero;
- la consegna dei file per email (va prima configurata la posta nelle Impostazioni);
- una pianificazione lasciata girare per giorni;
- i giri a orario quando il login unico è acceso sul Ponte col COBOL.
Finché queste prove mancano, usa i flussi per elenchi e stampe, e controlla il Log esecuzioni i primi giorni.
Per chi sviluppa. La prova a secco è nel rigioco (frontend/sbh-web/src/flows/headless/sbh-flow-replayer.ts).
Il pianificatore non è fatto per più copie di SBHgateway sulla stessa cartella dati. Le prove automatiche
sul server vero passano solo se l'utente del flusso è lo stesso che registra. Le variabili da impostare
all'installazione sono in docs/sbh-web/FLUSSI-RIGHE-PROTETTE.md.
Per approfondire.
• Client SBH — i flussi: una funzione COBOL che si riesegue da sola: docs/guide/moduli/sbh-flussi/README.md
JI4.2 - Se qualcosa non va
In una frase. I problemi più comuni con le Macro/Workflow SBH, cosa vuol dire ciascuno e cosa fare.
| Vedo questo | Faccio questo |
|---|---|
| «Nessuna sessione collegata» | Le pagine dei flussi lavorano a nome di una sessione aperta. Premi Vai alle sessioni, collegati, poi torna |
| Il giro resta In coda | Apri il dettaglio: il motivo è scritto. Di solito manca il servizio, manca la password dell'utente del flusso, o un altro giro dello stesso flusso non è finito. Le prime due le sistema chi amministra |
| Fermata: la maschera non è quella registrata | Guarda la tabella delle differenze. Se il cambiamento è innocuo premi Riallinea l'impronta e riprova; se no Apri l'editor su questo passo, o registra di nuovo |
| Si ferma sempre alla prima maschera | Hai registrato con un utente diverso da quello del flusso. Registra di nuovo con lo stesso utente |
| Fermata su un messaggio | È un messaggio che in registrazione non era comparso. Registra di nuovo passando da quel messaggio |
| Errore e «Sessione chiusa» | Il server ha chiuso il collegamento. Chi amministra controlla la rete e dà al flusso una postazione solo sua |
| Prova adesso è spento | Hai modifiche non salvate. Premi Salva |
| Pubblica è spento | Mancano un passo, un formato, il nome dei file o una destinazione. Oppure il flusso scrive dati e non sei tu ad approvare |
| Un altro ha salvato prima di te | Premi Ricarica e rifai la modifica |
| L'email non arriva | La posta non è configurata o non risponde. I file sono comunque nello Storico |
| Non vedo Impostazioni | È solo per chi amministra |
| Il primo giro dura minuti | Il flusso è stato registrato prima che l'avvio rapido esistesse. Registralo di nuovo |
Se non ne esci, apri il dettaglio del giro, premi Mostra su Diagnostica, poi Copia, e manda il testo a chi ti assiste.
Parole da sapere
- Flusso. Una funzione dell'ERP legacy/COBOL registrata, che il sistema ripete da solo. È il nome che vedi a schermo.
- Passo. Una cosa fatta durante la registrazione: una voce di menu, un campo, un tasto, una risposta.
- Parametro. Un valore che cambia a ogni giro, come una data.
- Data relativa. Una data che si calcola al momento:
@oggi-30è trenta giorni fa. - Uscita. Il file che il flusso produce e il posto dove lo manda.
- Pubblicare. Dichiarare il flusso pronto: da quel momento può girare a orario.
- Esecuzione. Un giro del flusso. Finisce riuscita, fermata o in errore.
- Impronta. La struttura di una maschera com'era quando hai registrato. Serve a capire se è cambiata.
- Prova a secco. Una prova che si ferma prima dell'ultima conferma, per i flussi che scrivono dati.
- Utente del flusso. L'utente del gestionale con cui girano tutti i flussi. Lo sceglie chi amministra.
Per chi sviluppa. I motivi di «In coda» nascono in SbhFlowOrchestrator (SBHgateway). Senza
SBH_FLOW_URL le esecuzioni restano in coda; senza SBH_FLOWS_SECRET le password delle impostazioni non
si salvano. Dettagli in docs/sbh-web/FLUSSI-RIGHE-PROTETTE.md.
Per approfondire.
• Client SBH — i flussi: una funzione COBOL che si riesegue da sola: docs/guide/moduli/sbh-flussi/README.md