# JH - SBHweb

Le funzioni dell'ERP legacy/COBOL dentro il browser.

**Cosa ci guadagni.** Niente client da installare e niente funzioni perse: il gestionale di sempre, raggiungibile da ovunque.

# JH1 - A cosa serve

# JH1.1 - Il legacy nel browser

**In una frase.** SBHweb porta nel browser le funzioni dell'ERP legacy/COBOL: stesse maschere, stessi tasti, stessi dati, senza il programma installato su ogni PC.

Molte funzioni del gestionale girano ancora sul programma COBOL. Funzionano bene e nessuno le vuole perdere. Prima per usarle serviva un programma installato su ogni PC. Adesso apri una pagina.

![Condizioni pagamento, una funzione del programma COBOL, aperta nel browser](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/condizioni-pagamento-una-funzione-del-programma-cobol-aperta-nel-browser.png)

*Condizioni pagamento, una funzione del programma COBOL, aperta nel browser*

Il programma COBOL non cambia: resta sul suo server e continua a fare i controlli di sempre. SBHweb disegna le sue maschere nel browser e gli rimanda quello che scrivi. In mezzo c'è il Ponte col COBOL, che traduce.

Le funzioni storiche lavorano sui Dati aziendali, gli stessi di SIGEAnext. Una condizione di pagamento inserita qui la trovi anche nelle pagine nuove.

E quello che ADSWnext ha aggiunto vale anche qui: da una funzione storica ottieni il PDF impaginato e l'analisi con grafici e totali.

<p class="callout success">**Cosa ci guadagni.**  
• Niente client da installare e aggiornare su ogni PC: il gestionale di sempre si apre da un indirizzo, anche da telefono e tablet.  
• Niente funzioni perse: maschere, numeri del menu e tasti funzione sono quelli che conosci. In più trovi la ricerca in tutti i moduli, i preferiti e una vista moderna delle maschere.  
• Il lavoro non si perde: se il PC va in standby o chiudi la scheda per sbaglio, rientri nella funzione dov'eri. </p>

<p class="callout info">**Nota.** Su un PC Windows serve un piccolo programma di aiuto, SBH Helper, per le cose che un browser non può fare: stampare diretto su una stampante, salvare nelle cartelle, firmare. Si installa una volta, senza diritti di amministratore. Su telefono e tablet si lavora senza. Vedi [SBH Helper](https://gsdoc.genesyssoftware.eu/link/37882).</p>

<p class="callout info">**Per chi sviluppa.** Le pagine storiche sono `frontend/sbh-web`. Il Ponte col COBOL è SBHgateway, `backend/middleware/it_gsba_sbh_gateway`, porta 5086. Dentro l'applicazione SBHweb risponde all'indirizzo `/sbh`. La documentazione tecnica è in `docs/sbh-web/README.md`.</p>

# JH1.2 - Come funziona il Ponte col COBOL

**In una frase.** Il Ponte col COBOL sta fra il browser e il programma storico: porta le maschere in un verso e i tuoi tasti nell'altro.

Il programma COBOL parla una lingua sua, pensata per il vecchio programma installato sul PC. Un browser quella lingua non la può usare da solo. Il Ponte fa da interprete, e il programma non si accorge della differenza.

<div drawio-diagram="2748"><img src="https://gsdoc.genesyssoftware.eu/uploads/images/drawio/2026-11/chi-parla-con-chi-quando-apri-una-maschera-storica.png" alt="Chi parla con chi quando apri una maschera storica"/></div>

*Chi parla con chi quando apri una maschera storica*

Tre cose da sapere.

**Comanda il programma COBOL.** Decide lui quale maschera mostrare, quale campo aspetta, quali tasti valgono. SBHweb disegna e rimanda. Per questo i controlli sono quelli di sempre.

**Il canale resta aperto.** Fra la pagina e il Ponte c'è un collegamento che dura quanto la sessione. Se la pagina sparisce, il Ponte tiene viva la connessione col server per un certo tempo. Così rientri senza ricominciare: vedi [Sessioni che non si perdono](https://gsdoc.genesyssoftware.eu/link/37870).

**Il Ponte non va dove vuole.** Si collega solo ai server che chi amministra ha scritto in un elenco: vedi [Server ammessi](https://gsdoc.genesyssoftware.eu/link/37884).

## La stampa in PDF fa un'altra strada

Il PDF impaginato non passa dal Ponte. Il programma COBOL prepara i dati della stampa e li manda alla pagina. La pagina li consegna al Gateway, che li porta a GPEnext. GPEnext li mette nel modello e restituisce il PDF.

<div drawio-diagram="2749"><img src="https://gsdoc.genesyssoftware.eu/uploads/images/drawio/2026-11/le-maschere-passano-dal-ponte-il-pdf-impaginato-dal-gateway.png" alt="Le maschere passano dal Ponte, il PDF impaginato dal Gateway"/></div>

*Le maschere passano dal Ponte, il PDF impaginato dal Gateway*

<p class="callout info">**Per chi sviluppa.**  
• Browser e Ponte parlano in WebSocket, Ponte e server COBOL in TCP. Il protocollo è descritto in `docs/sbh-web/ARCHITETTURA.md`.  
• Il Ponte è `backend/middleware/it_gsba_sbh_gateway` (porta 5086). Il server predefinito è in `SBH_HOST` e `SBH_PORT`: senza, il Ponte parte ma rifiuta le connessioni.  
• Quando il browser tace, il Ponte manda al server un segnale ogni 50 secondi (`SBH_KEEPALIVE_SECONDS`).  
• Il PDF: la pagina chiama `POST /api/gpe/print/{docType}` sul Gateway con l'identità dell'utente. Dettagli in `docs/sbh-web/GPE-NEXT-PDF.md`. </p>

# JH1.3 - Dove sta nella mappa

**In una frase.** SBHweb e il Ponte col COBOL stanno nel gruppo «Gestionale storico»: da una parte parlano con te, dall'altra con il programma COBOL.

<div drawio-diagram="2750"><img src="https://gsdoc.genesyssoftware.eu/uploads/images/drawio/2026-11/la-mappa-di-adswnext-con-accese-le-pagine-storiche-il-ponte-col-cobol-e-lerp-legacycobol.png" alt="La mappa di ADSWnext con accese le Pagine storiche, il Ponte col COBOL e l&#039;ERP legacy/COBOL"/></div>

*La mappa di ADSWnext con accese le Pagine storiche, il Ponte col COBOL e l'ERP legacy/COBOL*

- **Chi lo chiama.** Tu, dal browser. Le Pagine storiche sono una delle due parti dell'app web, accanto alle Pagine nuove di SIGEAnext.
- **Chi chiama lui.** Le Pagine storiche chiamano il Ponte col COBOL. Il Ponte chiama l'ERP legacy/COBOL, che legge e scrive i Dati aziendali. Sullo stesso programma lavorano le Macro/Workflow SBH, quando rifanno da sole un'operazione registrata.
- **Con chi altro parla.** Per il PDF impaginato le Pagine storiche passano dal Gateway e arrivano a GPEnext. Per l'analisi passano le righe della griglia ad Analytics.

Il Ponte col COBOL ha una sua porta, diversa da quella del Gateway. Le maschere storiche non passano dal Gateway: fanno la strada più corta verso il programma.

<p class="callout info">**Per chi sviluppa.** Tessere della mappa: `fesbh` (`frontend/sbh-web`), `sbhgw`(`backend/middleware/it_gsba_sbh_gateway`, porta 5086), `cobol` (il server COBOL, fuori dal repository). Le Macro/Workflow SBH sono `backend/middleware/sbh-flow`.</p>

# JH2 - Entrare

# JH2.1 - Server e connessioni

**In una frase.** Dalla pagina di avvio scegli a quale server COBOL collegarti e salvi con un nome le connessioni che usi spesso.

La maggior parte delle persone ha un server solo: preme **Connetti** e basta. Chi lavora su più ambienti (per esempio produzione e prova) tiene un elenco con nomi e colori, e non scrive più indirizzi a mano.

1. **Apri la pagina di avvio.** Al centro c'è **Connetti**. Sotto leggi la **Postazione**, cioè il nome con cui il server vede il tuo PC, e il server a cui stai per collegarti.
    
    ![La pagina di avvio: Connetti, la postazione, il server e le connessioni salvate](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/la-pagina-di-avvio-connetti-la-postazione-il-server-e-le-connessioni-salvate.png)
    
    *La pagina di avvio: Connetti, la postazione, il server e le connessioni salvate*
2. **Cambia server, se serve.** Un clic sul server apre **Server di connessione**: scrivi server e porta. Vanno bene solo quelli che chi amministra ha ammesso. **Ripristina predefinito** torna al server di partenza.
3. **Salva la connessione.** **Nuova configurazione** chiede nome, server, porta ed etichette colorate. **Salva questa connessione** salva il server che hai appena scelto.
4. **Ritrovala.** Le etichette diventano filtri sopra l'elenco. La ricerca trova per nome, server o etichetta. Un clic sulla riga ti collega. La matita modifica, il cestino elimina.
    
    ![Le connessioni salvate, filtrate con l'etichetta «prova»](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/le-connessioni-salvate-filtrate-con-letichetta-prova.png)
    
    *Le connessioni salvate, filtrate con l'etichetta «prova»*

Ogni connessione può avere un colore e il logo del cliente. Li ritrovi sulla scheda della sessione e in alto, così capisci subito dove stai lavorando: vedi [Logo, colore e ordine delle connessioni](https://gsdoc.genesyssoftware.eu/link/37948).

Se apri la pagina da una scheda del browser, sotto **Connetti** una riga propone di installarla come app: vedi [SBHweb come app installata](https://gsdoc.genesyssoftware.eu/link/37949).

<p class="callout info">**Nota.** Le connessioni salvate stanno nel tuo browser. Su un altro PC le rifai.</p>

<p class="callout info">**Nota.** L'icona accanto alla **Postazione** ne copia il nome: serve quando chiedi assistenza.</p>

<p class="callout info">**Nota.** Dove il cliente ha un server solo, chi amministra può togliere la scelta: la pagina si collega da sola e non mostra né il server né le connessioni salvate.</p>

<p class="callout info">**Per chi sviluppa.** Il server predefinito è `SBH_HOST` e `SBH_PORT` del Ponte col COBOL. L'accesso unico è `SBH_ACCESS_ONLY=true`. L'elenco dei server ammessi è spiegato in [Server ammessi](https://gsdoc.genesyssoftware.eu/link/37884).</p>

<p class="callout info">**Per approfondire.**  
• SBH — accesso e novita': `docs/guide/moduli/sbh-accesso-e-novita/README.md`</p>

# JH2.10 - Le tue sessioni aperte

**In una frase.** La finestra **Le tue sessioni aperte** elenca le sessioni rimaste in sospeso sul server e ti fa scegliere, una per una, se riprenderle o chiuderle.

Capita di lasciare una sessione aperta in un altro browser, o di dimenticarne una dal giorno prima. Qui le vedi tutte e decidi tu, senza chiamare nessuno.

La finestra si apre da sola quando entri e ci sono sessioni che la pagina non ha ripreso. La apri anche da **Opzioni**, scheda **Sessione**, voce **Le tue sessioni aperte**.

Per ogni sessione leggi: utente e modulo, il browser in cui è nata, l'indirizzo da cui era collegata, da quando è in sospeso, se è dentro una funzione e quando scade.

<table id="bkmrk-pulsante-quando-c%27%C3%A8-"><thead><tr><th>Pulsante</th><th>Quando c'è</th><th>Cosa fa</th></tr></thead><tbody><tr><td>**Riprendi**</td><td>la sessione è nata in questo browser</td><td>apre una scheda che rientra dov'eri</td></tr><tr><td>**Riapri in Chrome** (o Edge, Firefox)</td><td>è nata in un altro browser di questo PC e SBH Helper la conosce</td><td>SBH Helper apre quel browser sulla sessione</td></tr><tr><td>**Chiudi**</td><td>sempre</td><td>esce in modo ordinato dal server</td></tr></tbody></table>

**Non adesso** chiude la finestra: le sessioni restano dove sono.

## Perché si riprende solo dal browser in cui è nata

Per rientrare servono due cose, e tutte e due stanno solo in quel browser:

- la **chiave di rientro**, che il Ponte col COBOL consegna all'apertura. Vale come una password della sessione, e per questo non esce da lì;
- il **registro** di quello che il server ha mandato (menu, maschere, dati a video), con cui la pagina ricostruisce la funzione.

Un altro browser, una finestra anonima o un browser a cui hai cancellato i dati non hanno né l'una né l'altro. La sessione la vedono e la possono chiudere, se la richiesta viene dalla stessa postazione e dallo stesso indirizzo.

## Il limite di cinque

Una postazione può avere al massimo 5 sessioni in sospeso. Alla sesta la finestra si apre con l'avviso «Hai già 5 sessioni in sospeso su questa postazione» e **Connetti** resta spento finché non ne riprendi o chiudi una. Le schede collegate non contano.

<p class="callout warning">**Attenzione.** **Chiudi** su una sessione che era dentro una funzione chiede conferma: il lavoro non confermato si perde.</p>

<p class="callout info">**Nota.** Il Ponte non chiude mai da solo la sessione più vecchia per fare posto: scegli tu quale.</p>

<p class="callout info">**Per chi sviluppa.** La finestra è `frontend/sbh-web/src/session/components/sbh-open-sessions`. Il limite è `SBH_MAX_PARKED_PER_CLIENT`. La postazione è il nome del PC che arriva da SBH Helper; senza, un nome per browser.</p>

<p class="callout info">**Per approfondire.**  
• SBH — sessioni che non si perdono (standby, scheda chiusa, SBH Helper): `docs/guide/moduli/sbh-sessioni-che-non-si-perdono/README.md`</p>

# JH2.11 - La finestra rossa di SBH Helper

**In una frase.** Se la pagina sparisce mentre sei dentro una funzione, SBH Helper ti avvisa con una finestra rossa in primo piano e riapre la sessione nel browser giusto.

Un browser non sa dirti che hai chiuso la scheda sbagliata, e non si accorge di un blocco. SBH Helper è sul PC, resta acceso, e fa da guardiano: sa quali sessioni hai aperte e in quale browser.

## Cosa succede

Finché la pagina è aperta, ogni mezzo minuto dice a SBH Helper quali sessioni ha e se c'è una funzione in corso. Se la pagina sparisce senza **Esci**:

- **eri dentro una funzione**: dopo circa due minuti e mezzo compare sopra tutte le finestre, con un suono, la finestra con la banda rossa **Sessione SBH ancora aperta in una funzione**;
- **eri sul menu**: nessun avviso, perché non c'è lavoro a metà. La sessione resta nell'elenco di SBH Helper.

## Cosa puoi fare

<table id="bkmrk-tasto-cosa-fa-invio-"><thead><tr><th>Tasto</th><th>Cosa fa</th></tr></thead><tbody><tr><td>Invio (**Riapri nel browser di origine**)</td><td>apre SBHweb nel browser in cui la sessione era nata, anche se non è quello predefinito, e rientra nella funzione</td></tr><tr><td>Esc (**Più tardi**)</td><td>chiude la finestra; la sessione resta nell'elenco</td></tr></tbody></table>

Rientrato, esci dalla funzione col tasto Esci e poi dalla sessione.

Sotto il messaggio c'è l'elenco delle altre sessioni perse: un doppio clic riapre quella.

## L'elenco delle sessioni

Dal menu dell'icona di SBH Helper, vicino all'orologio di Windows, **Sessioni SBH…** mostra le sessioni custodite: browser, se sono attive o da quando sono perse, se sono in funzione, quando scadono. **Riapri** la riporta nel suo browser, **Dimentica** la toglie dall'elenco.

Nelle impostazioni di SBH Helper la casella **Riapri da solo le sessioni SBH interrotte** fa riaprire il browser senza passare dalla finestra rossa. Di serie è spenta.

<p class="callout info">**Nota.** L'avviso arriva dopo un paio di minuti e non subito, per non dare falsi allarmi: i browser rallentano le schede nascoste. Se la pagina torna da sola, la finestra si chiude da sé.</p>

<p class="callout info">**Nota.** La finestra è una sola: una seconda sessione persa la aggiorna.</p>

<p class="callout info">**Per chi sviluppa.**  
• La finestra rossa c'è con SBH Helper 1.2.0 o successivo. La 1.1.0 mandava una notifica di Windows e riapriva nel browser predefinito.  
• Dopo uno standby SBH Helper aspetta 15 secondi che le pagine rientrino da sole.  
• SBH Helper tiene una copia delle sessioni in un file cifrato con l'utente di Windows.  
• La pagina affida le sessioni a SBH Helper da `frontend/sbh-web/src/session/services/sbh-tabs.service.ts`. </p>

<p class="callout info">**Per approfondire.**  
• SBH — sessioni che non si perdono (standby, scheda chiusa, SBH Helper): `docs/guide/moduli/sbh-sessioni-che-non-si-perdono/README.md`</p>

# JH2.2 - Accesso e sessione

**In una frase.** Entri con l'utente del gestionale, lavori, e alla fine esci con **Esci**: è l'unico modo che libera subito il posto sul server.

Una sessione è il tuo collegamento al programma COBOL. Il server ne accetta un numero limitato. Per questo conta come esci: una sessione lasciata aperta tiene occupato un posto.

1. **Premi Connetti.** Il server risponde con la sua richiesta di accesso.
2. **Scrivi utente e password.** Sono quelli del gestionale storico, al massimo 12 caratteri. L'occhio mostra la password mentre la scrivi. La casella **Richiedi il cambio della password** chiede al server di cambiarla subito: vedi [Cambiare la password](https://gsdoc.genesyssoftware.eu/link/37950).
    
    ![La richiesta di accesso del server](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/la-richiesta-di-accesso-del-server.png)
    
    *La richiesta di accesso del server*
3. **Aspetta il menu.** La prima volta la pagina scarica i menu di tutti i moduli: servono alcuni minuti. Poi restano nel browser e l'ingresso dura pochi secondi.
    
    ![Dopo l'accesso: a sinistra il menu del modulo, al centro il benvenuto](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/dopo-laccesso-a-sinistra-il-menu-del-modulo-al-centro-il-benvenuto.png)
    
    *Dopo l'accesso: a sinistra il menu del modulo, al centro il benvenuto*
4. **Esci dal menu.** Il pulsante di uscita è in basso a destra. La pagina chiede conferma con **Chiudere la sessione?**. Il server chiude i suoi programmi e libera la connessione.
    
    ![La conferma prima di chiudere la sessione](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/la-conferma-prima-di-chiudere-la-sessione.png)
    
    *La conferma prima di chiudere la sessione*

<p class="callout warning">**Attenzione.** Dentro una funzione il pulsante di uscita è spento. Prima torna al menu con il tasto Esci della funzione. Uscire a metà troncherebbe il programma e il lavoro non confermato andrebbe perso.</p>

<p class="callout info">**Nota.** Se qualcosa non torna, apri **Opzioni**, poi **Sessione**, poi **Informazioni sulla sessione**: dice chi è collegato, a quale server e con quale versione. Vedi [Chiedere assistenza](https://gsdoc.genesyssoftware.eu/link/37994).</p>

<p class="callout info">**Nota.** L'occhio della password si usa anche da tastiera: Tab fino all'occhio, poi Invio o Spazio. **Entra** resta spento finché utente e password sono vuoti.</p>

<p class="callout info">**Nota.** L'uscita è ordinata anche dalla richiesta di accesso: se chiudi la scheda prima di entrare, la pagina dice comunque al server che te ne vai.</p>

<p class="callout info">**Per chi sviluppa.**  
• L'accesso qui è quello del server COBOL, non quello dell'app web. L'accesso unico anche per le pagine storiche esiste ma è spento di serie (`SBH_SSO_MODE`): è ancora da accendere installazione per installazione.  
• La finestra di accesso è in `frontend/sbh-web/src/session/components/sbh-login`. </p>

<p class="callout info">**Per approfondire.**  
• SBH — avvio della sessione, login, schede, rientro e uscita: `docs/guide/moduli/sbh-avvio-e-sessioni/README.md`</p>

# JH2.3 - Schede e rientro

**In una frase.** Ogni scheda della barra in basso è una sessione completa: ne tieni più di una, le affianchi, e dopo una ricarica della pagina le ritrovi tutte.

Con il vecchio programma, per guardare un dato mentre ne inserivi un altro aprivi due finestre. Qui apri due schede nella stessa pagina e le metti una accanto all'altra.

1. **Apri una seconda sessione.** Il **+** accanto alle schede ne apre una nuova e chiede l'accesso: serve per entrare con un altro utente. Per restare lo stesso utente, fai clic destro sulla scheda e scegli **Duplica**: non chiede di nuovo la password.
    
    ![Il menu della scheda: Duplica e Chiudi la scheda](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/il-menu-della-scheda-duplica-e-chiudi-la-scheda.png)
    
    *Il menu della scheda: Duplica e Chiudi la scheda*
2. **Affiancale.** Clic destro su una scheda che non è quella attiva, poi **Affianca alla scheda attiva**. Lo schermo si divide in due. Un clic in una metà la rende attiva. **Separa** torna a una sola.
    
    ![Due sessioni affiancate nella stessa pagina](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/due-sessioni-affiancate-nella-stessa-pagina.png)
    
    *Due sessioni affiancate nella stessa pagina*
3. **Passa da una all'altra.** Con un clic sulla scheda, oppure da tastiera con Ctrl e le frecce sinistra e destra, o con Ctrl e il numero della scheda: vedi [Scorciatoie da tastiera](https://gsdoc.genesyssoftware.eu/link/37984).
4. **Ricarica senza paura.** Se premi F5, o chiudi e riapri la pagina, le sessioni tornano una per scheda, ognuna dov'era. Il browser chiede prima «Uscire dal sito?»: è la sua domanda di sempre, conferma pure.
5. **Chiudi una scheda.** Clic destro, **Chiudi la scheda**: esce da quella sessione in modo ordinato, dopo una conferma. Con una funzione aperta la voce è spenta: prima torna al menu. Una scheda che non si è ancora collegata si chiude subito, senza conferma.

<p class="callout info">**Nota.** Dopo una ricarica **Duplica** apre la scheda nuova ma chiede l'accesso. La password non viene mai salvata nel browser: sta solo nella memoria della pagina, e la ricarica la cancella.</p>

<p class="callout warning">**Attenzione.** Due schede sono due connessioni al server. Chiudi quelle che non usi.</p>

<p class="callout info">**Per chi sviluppa.** Le schede sono in `frontend/sbh-web/src/session/components/sbh-tabs`. Il rientro usa una chiave che il Ponte col COBOL consegna all'apertura della sessione: vedi [Sessioni che non si perdono](https://gsdoc.genesyssoftware.eu/link/37870).</p>

<p class="callout info">**Per approfondire.**  
• SBH — avvio della sessione, login, schede, rientro e uscita: `docs/guide/moduli/sbh-avvio-e-sessioni/README.md`</p>

# JH2.4 - Sessioni che non si perdono

**In una frase.** Se il PC va in standby, cade la rete o chiudi la scheda per sbaglio, la sessione resta aperta sul server e rientri nella funzione dov'eri.

Con il programma installato, una finestra chiusa per errore voleva dire lavoro perso. Qui la sessione non vive nella pagina: la tiene il Ponte col COBOL. La pagina può sparire e tornare.

<div drawio-diagram="2758"><img src="https://gsdoc.genesyssoftware.eu/uploads/images/drawio/2026-11/la-sessione-resta-aperta-sul-ponte-e-la-pagina-rientra.png" alt="La sessione resta aperta sul Ponte e la pagina rientra"/></div>

*La sessione resta aperta sul Ponte e la pagina rientra*

**Quanto resta aperta.** Dipende da dove eri, e il tempo lo imposta chi amministra. Con i valori previsti sono 16 ore se eri dentro una funzione, perché c'è lavoro a metà, e 30 minuti se eri sul menu.

**Come rientri.** Riapri la pagina nello stesso browser: le sessioni tornano da sole, con i dati scritti e il cursore dov'era. Dopo uno standby la pagina se ne accorge subito e rientra senza che tu faccia niente. Se trova sessioni che non ha ripreso, apre [Le tue sessioni aperte](https://gsdoc.genesyssoftware.eu/link/37953).

**Se vai in un'altra parte dell'applicazione.** La pagina chiede **Uscire dalle sessioni?**: vedi [Lasciare la pagina con una sessione aperta](https://gsdoc.genesyssoftware.eu/link/37952).

**Con SBH Helper.** Se la pagina sparisce mentre eri in una funzione, dopo un paio di minuti compare una finestra rossa sopra tutte le altre: vedi [La finestra rossa di SBH Helper](https://gsdoc.genesyssoftware.eu/link/37954).

**Se il browser sospende la scheda.** Edge e Chrome scaricano le schede rimaste a lungo in secondo piano. Quando ci torni la pagina riparte e rientra da sola. Se resta vuota si ricarica una volta da sé; se non basta compare il pulsante **Ricarica**. Per evitarlo, nelle impostazioni del browser aggiungi il sito fra quelli da non sospendere mai.

<p class="callout warning">**Attenzione.**  
• Una sessione si riprende solo nel browser in cui è nata. Da un altro browser la vedi e la chiudi, ma non ci rientri.  
• Le sessioni in sospeso sono al massimo 5 per postazione. Alla sesta, **Connetti** resta spento finché non ne riprendi o chiudi una.  
• Non si recupera: una sessione oltre il tempo previsto, una chiusa dal server, o tutte quelle aperte quando il Ponte viene riavviato. </p>

<p class="callout info">**Nota.** Chiudere la scheda o spegnere il PC non chiude la sessione. Per liberare il posto sul server si usa sempre **Esci**.</p>

<p class="callout info">**Nota.** Alla scadenza il Ponte esce in modo ordinato. Se il server sta ancora elaborando, aspetta che finisca, per non interrompere il lavoro a metà: vedi [Tempi e limiti delle sessioni](https://gsdoc.genesyssoftware.eu/link/37982).</p>

<p class="callout info">**Per chi sviluppa.**  
• I tempi sono `SBH_RESUME_SECONDS` (dentro una funzione) e `SBH_RESUME_MENU_SECONDS` (sul menu). Il file `devops/deploy/docker-compose.deploy.yml` propone 57600 secondi per il primo; senza variabile il Ponte usa 900 secondi, cioè 15 minuti.  
• Il limite è `SBH_MAX_PARKED_PER_CLIENT`. Chi ha il ruolo `SBH_ADMIN_ROLE` vede e chiude le sessioni di tutti da **Opzioni**, **Avanzate**, **Sessioni del gateway**.  
• La guida d'origine dichiara che queste funzioni sono coperte da test automatici ma non ancora provate passo passo sul server vero. </p>

<p class="callout info">**Per approfondire.**  
• SBH — sessioni che non si perdono (standby, scheda chiusa, SBH Helper): `docs/guide/moduli/sbh-sessioni-che-non-si-perdono/README.md`</p>

# JH2.5 - Logo, colore e ordine delle connessioni

**In una frase.** A ogni connessione salvata dai un colore, il logo del cliente e il posto che vuoi nell'elenco: così vedi a colpo d'occhio su quale server stai lavorando.

Chi segue più aziende o più ambienti rischia di scrivere nel posto sbagliato. Un colore e un logo diversi per ogni connessione tolgono il dubbio prima ancora di leggere.

1. **Crea o modifica la connessione.** **Nuova configurazione** apre la scheda: nome, server, porta ed etichette. Per una connessione che c'è già usa la matita, oppure F2 sulla riga.
    
    ![La scheda di una connessione nuova: nome, server, porta ed etichette colorate](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-logo-colore-e-ordine-delle-connessioni-01-nuova-configurazione.png)
    
    *La scheda di una connessione nuova: nome, server, porta ed etichette colorate*
2. **Dai le etichette.** Fino a otto per connessione, ognuna col suo colore. Sopra l'elenco diventano filtri: un clic su «prova» e restano solo le connessioni di prova.
3. **Scegli il logo.** Nella scheda, al campo **Logo della connessione**, premi **Scegli…**. La finestra mostra il logo come si vedrà su fondo chiaro e su fondo scuro. **Carica logo…** prende il file, oppure lo trascini sul riquadro. **Togli** lo leva, **Salva** conferma.
    
    ![La finestra del logo, con l'anteprima su chiaro e su scuro](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-logo-colore-e-ordine-delle-connessioni-02-logo.png)
    
    *La finestra del logo, con l'anteprima su chiaro e su scuro*
4. **Metti in ordine l'elenco.** Sopra l'elenco scegli fra tre ordini.
    
    <table><thead><tr><th>Ordine</th><th>Cosa fa</th></tr></thead><tbody><tr><td>**Personale**</td><td>l'ordine che decidi tu: trascini la riga dalla presa a sinistra</td></tr><tr><td>**Recenti**</td><td>prima le connessioni usate da poco</td></tr><tr><td>**Nome**</td><td>in ordine alfabetico</td></tr></tbody></table>

Dove ritrovi logo e colore:

- nell'elenco delle connessioni, accanto al logo del prodotto;
- nella finestra di accesso, col nome della connessione sotto;
- nella barra in alto, finché la scheda attiva è di quella connessione;
- sulla scheda della sessione in basso: il colore è la linea sul bordo in alto.

Se entri con una connessione salvata che non ha ancora un logo, per una decina di secondi compare in basso **Scegli il logo per questa connessione**. Lo stesso comando resta in **Opzioni**, scheda **Sessione**, voce **Logo della connessione**.

<p class="callout info">**Nota.** Il logo può essere PNG, JPEG, SVG o WebP, al massimo 200 KB. Le immagini più grandi si rimpiccioliscono da sole.</p>

<p class="callout info">**Nota.** L'ordine **Personale** si cambia solo con l'elenco intero a video: con una ricerca o un filtro attivo la presa sparisce. Da tastiera: Alt e freccia su o giù sulla riga.</p>

<p class="callout info">**Nota.** Connessioni, colori e loghi stanno nel tuo browser. Se elimini una connessione sparisce anche il suo logo.</p>

<p class="callout info">**Per chi sviluppa.** Elenco e scheda sono in `frontend/sbh-web/src/session/components/sbh-saved-connections`, la finestra del logo in `frontend/sbh-web/src/session/components/sbh-connection-logo`. I loghi sono salvati da `frontend/sbh-web/src/session/services/sbh-connection-logos.store.ts`.</p>

<p class="callout info">**Per approfondire.**  
• SBH — accesso e novita': `docs/guide/moduli/sbh-accesso-e-novita/README.md`</p>

# JH2.6 - SBHweb come app installata

**In una frase.** SBHweb si può installare come un'app: ha la sua finestra e la sua icona, senza le schede e la barra degli indirizzi del browser.

Chi lavora tutto il giorno sul gestionale non vuole cercarlo fra venti schede aperte. L'app installata sta nel menu Start e nella barra delle applicazioni, come un programma qualunque. Dentro è la stessa pagina.

Quando apri SBHweb da una scheda del browser, sotto **Connetti** e nel benvenuto trovi una riga: «Stai usando SIGEA dal sito: installa l'app o aprila dall'app installata».

1. **Premi Installa l'app.** Se il browser lo permette, compare la sua proposta di installazione: conferma.
2. **Se la proposta non compare**, la riga mostra le istruzioni per il menu del browser.
    
    <table><thead><tr><th>Browser</th><th>Dove si trova il comando</th></tr></thead><tbody><tr><td>Edge</td><td>i tre puntini, **App**, **Installa questo sito come app**</td></tr><tr><td>Chrome</td><td>i tre puntini, **Trasmetti, salva e condividi**, **Installa**</td></tr></tbody></table>
3. **Apri l'app.** Da quel momento la trovi nel menu Start o nella barra delle applicazioni.

Se l'app è già installata su quel PC con quel browser, la riga propone **Apri nell'app** e spiega dove trovarla. Una pagina del sito non può aprire l'app da sola: la apri tu.

Per togliere la riga: **Non ora** la nasconde per quella scheda, **Non mostrare più** per sempre su quel browser.

<p class="callout info">**Nota.** La riga non c'è dentro l'app installata, e nemmeno su telefono e tablet.</p>

<p class="callout info">**Nota.** L'app installata usa lo stesso browser: connessioni salvate, preferiti e preferenze sono quelli che avevi già.</p>

<p class="callout info">**Per chi sviluppa.** La proposta è gestita da `frontend/sbh-web/src/session/services/sbh-install-app.service.ts`. L'app si apre sull'indirizzo `/sbh`.</p>

<p class="callout info">**Per approfondire.**  
• SBH — accesso e novita': `docs/guide/moduli/sbh-accesso-e-novita/README.md`</p>

# JH2.7 - Cambiare la password

**In una frase.** La password del gestionale si cambia dalla finestra di accesso: lo chiedi tu con una casella, oppure lo chiede il server quando è scaduta.

La password è quella del gestionale storico: la stessa che usavi col programma installato. Cambiarla da qui vale dappertutto.

1. **Chiedi il cambio.** Nella finestra di accesso scrivi utente e password e accendi **Richiedi il cambio della password**. Poi premi **Entra**.
2. **Compila i tre campi.** Si apre la finestra di cambio: password attuale, password nuova, conferma. Ognuna al massimo di 12 caratteri.
3. **Guarda l'indicatore.** Sotto la password nuova quattro tacche dicono quanto è robusta. Cinque requisiti si spuntano mentre scrivi.
    
    <table><thead><tr><th>Requisito</th><th></th></tr></thead><tbody><tr><td>lunghezza</td><td>almeno 8 caratteri</td></tr><tr><td>lettere</td><td>una maiuscola e una minuscola</td></tr><tr><td>numeri</td><td>una cifra</td></tr><tr><td>simboli</td><td>uno fra `!@#$%^&*`</td></tr></tbody></table>
4. **Conferma.** Il server registra la password nuova e l'accesso prosegue.

Cosa blocca e cosa avvisa soltanto:

- **Blocca**: nuova e conferma diverse, oppure meno di 8 caratteri.
- **Avvisa**: nuova uguale alla vecchia, o requisiti non tutti rispettati. Il pulsante diventa **Cambia comunque**: al secondo clic prosegui lo stesso.

La stessa finestra compare da sola, senza la casella, quando il server decide che la password è scaduta. **Annulla** esce senza cambiare niente.

<p class="callout warning">**Attenzione.** La casella cambia davvero la password dell'utente. Non accenderla per prova.</p>

<p class="callout info">**Nota.** La password non viene mai salvata nel browser: resta nella memoria della pagina finché la pagina è aperta.</p>

<p class="callout info">**Per chi sviluppa.** La finestra è in `frontend/sbh-web/src/session/components/sbh-login`. La guida d'origine dichiara che il cambio non è stato provato dal vivo: la descrizione viene dal codice e dai test automatici.</p>

<p class="callout info">**Per approfondire.**  
• SBH — avvio della sessione, login, schede, rientro e uscita: `docs/guide/moduli/sbh-avvio-e-sessioni/README.md`</p>

# JH2.8 - La barra in basso

**In una frase.** La barra in fondo alla pagina dice in ogni momento chi sei, dove sei collegato e cosa sta girando, e tiene a portata di mano i comandi che servono sempre.

Era la barra di stato del vecchio programma. Un'occhiata basta per sapere se sei connesso, in quale funzione sei e con quale stampante è partita.

Da sinistra a destra trovi:

<table id="bkmrk-dove-cosa-c%27%C3%A8-a-sini"><thead><tr><th>Dove</th><th>Cosa c'è</th></tr></thead><tbody><tr><td>a sinistra</td><td>il pulsante **Opzioni** (le tre righe)</td></tr><tr><td>le schede</td><td>una per sessione, col pallino verde se è collegata, poi il **+** e la campanella delle notifiche</td></tr><tr><td>al centro</td><td>il server e il numero della connessione</td></tr><tr><td>con una funzione aperta</td><td>tipo di lavoro, **Definitivo** o **Simulato**, stampante, ruolo</td></tr><tr><td>a destra</td><td>**Menu**, **Tutta la finestra**, **Esporta**, **Cerca**, **Documenti**, SBH Helper, l'uscita</td></tr></tbody></table>

**La scheda.** Dice utente e modulo. Accanto c'è il numero della sessione, per esempio `#5`. Passando col mouse compare un riquadro con connessione, server, utente, modulo e stato.

![Il riquadro che compare passando sulla scheda: connessione, server, utente, modulo, stato](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-la-barra-in-basso-01-suggerimento-della-scheda.png)

*Il riquadro che compare passando sulla scheda: connessione, server, utente, modulo, stato*

**Lo stato.** La scritta «Non connesso» o «Chiuso» compare solo quando non sei collegato. Da collegato lo dice già il pallino verde della scheda. Durante l'accesso la scheda dice «Accesso…».

**La funzione in corso.** Tipo di lavoro, modalità e stampante sono le scelte fatte nel pannello di avvio. Il simulato è su fondo arancione. Se il programma cambia stampante, la barra si aggiorna. Con poco spazio diventano un solo pulsante: un clic apre i dettagli.

**Tutta la finestra.** Toglie anche la barra in alto: la sessione prende tutta la finestra del browser, come la finestra del vecchio programma. Vale per tutte le schede. Lo stesso pulsante rimette la barra. Non è lo schermo intero: schede e indirizzo del browser restano.

**L'uscita.** L'icona di spegnimento a destra chiude la sessione. È spenta mentre una funzione è aperta: vedi [Accesso e sessione](https://gsdoc.genesyssoftware.eu/link/37868).

<p class="callout info">**Nota.** L'icona del telefonino accanto al numero della sessione indica la scheda a cui sono agganciati i terminalini di magazzino di SBH Helper.</p>

<p class="callout info">**Nota.** Su telefono i comandi di destra si raccolgono in **Altre azioni**.</p>

<p class="callout info">**Per chi sviluppa.** La barra è disegnata da `frontend/sbh-web/src/session/components/sbh-session-page`, le schede da `frontend/sbh-web/src/session/components/sbh-tabs`. Il «nodo» è il nome con cui si presenta il server COBOL.</p>

<p class="callout info">**Per approfondire.**  
• SBH — avvio della sessione, login, schede, rientro e uscita: `docs/guide/moduli/sbh-avvio-e-sessioni/README.md`  
• SBH — accesso e novita': `docs/guide/moduli/sbh-accesso-e-novita/README.md`</p>

# JH2.9 - Lasciare la pagina con una sessione aperta

**In una frase.** Se vai in un'altra parte dell'applicazione con una sessione aperta, la pagina ti chiede cosa farne: tornare indietro, lasciarla in sospeso o chiuderla.

Una sessione abbandonata senza dirlo tiene occupato un posto sul server, e una funzione troncata a metà può perdere il lavoro non confermato. Per questo la pagina non ti lascia andare via in silenzio.

Quando esci dalle pagine storiche verso un'altra parte dell'app compare **Uscire dalle sessioni?**. Il testo cambia secondo dove sei.

## Se sei dentro una funzione

La finestra dice in quale funzione sei e consiglia di uscirne prima col tasto Esci.

<table id="bkmrk-pulsante-cosa-succed"><thead><tr><th>Pulsante</th><th>Cosa succede</th></tr></thead><tbody><tr><td>**Torna alla funzione**</td><td>resti dove sei, non cambia niente</td></tr><tr><td>**Lascia in sospeso**</td><td>esci; la sessione resta aperta sul server e la riprendi tornando sulla pagina</td></tr><tr><td>**Forza l'uscita**</td><td>chiude tutte le connessioni e tronca la funzione a metà</td></tr></tbody></table>

## Se sei sul menu

<table id="bkmrk-pulsante-cosa-succed-1"><thead><tr><th>Pulsante</th><th>Cosa succede</th></tr></thead><tbody><tr><td>**Resta**</td><td>resti sulla pagina</td></tr><tr><td>**Lascia in sospeso**</td><td>esci; le sessioni restano aperte per il tempo indicato</td></tr><tr><td>**Chiudi le sessioni ed esci**</td><td>chiude in modo ordinato e libera i posti sul server</td></tr></tbody></table>

Il pulsante **Lascia in sospeso** scrive fra parentesi per quanto tempo: con i valori previsti 16 ore dentro una funzione e 30 minuti sul menu. Quanto vale davvero lo decide chi amministra.

## Se chiudi o ricarichi la scheda del browser

Qui parla il browser, con la sua domanda di sempre: «Uscire dal sito?» o «Ricaricare il sito?». Il testo non si può cambiare e il browser non distingue la ricarica dalla chiusura.

- **Ricarica**: confermi e le sessioni tornano dov'erano.
- **Chiusura**: la sessione resta in sospeso sul server. Riaprendo la pagina nello stesso browser la ritrovi.

<p class="callout warning">**Attenzione.** **Forza l'uscita** fa perdere i dati non confermati e tronca le elaborazioni. Usala solo se la funzione non risponde più.</p>

<p class="callout info">**Nota.** Un browser non può impedire la chiusura né accorgersi di uno spegnimento o di un blocco. Per quei casi c'è [La finestra rossa di SBH Helper](https://gsdoc.genesyssoftware.eu/link/37954).</p>

<p class="callout info">**Per chi sviluppa.** I tempi li dichiara il Ponte col COBOL all'apertura della sessione (`SBH_RESUME_SECONDS` e `SBH_RESUME_MENU_SECONDS`): la pagina li scrive a parole. Il tasto consigliato per uscire è quello scelto in **Tasti funzione**.</p>

<p class="callout info">**Per approfondire.**  
• SBH — avvio della sessione, login, schede, rientro e uscita: `docs/guide/moduli/sbh-avvio-e-sessioni/README.md`  
• SBH — sessioni che non si perdono (standby, scheda chiusa, SBH Helper): `docs/guide/moduli/sbh-sessioni-che-non-si-perdono/README.md`</p>

# JH3 - Menu e maschere

# JH3.1 - Il menu e la ricerca

**In una frase.** Il menu è quello del gestionale di sempre, con i suoi numeri. In più c'è una ricerca che trova una funzione in tutti i moduli mentre scrivi.

Chi conosce il gestionale chiama le funzioni per numero: «la 1.1.1.1». Quei numeri ci sono ancora. Chi non li sa a memoria scrive due parole e trova la funzione, anche se sta in un altro modulo.

1. **Scegli il modulo.** In testa al menu c'è la barra del modulo, con nome, sigla e numero di funzioni. Un clic apre l'elenco dei moduli. I quadratini a destra aprono la griglia **Scegli il modulo**, con una ricerca.
2. **Scorri l'albero.** Ogni voce ha il suo numero. Con le frecce ti muovi, con Invio apri un ramo o avvii una funzione. Scrivendo le cifre vai dritto alla voce con quel numero. In testa trovi **Recenti**, le funzioni usate da poco.
    
    ![L'albero del modulo Amministrazione, con i numeri delle voci e i Recenti](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/lalbero-del-modulo-amministrazione-con-i-numeri-delle-voci-e-i-recenti.png)
    
    *L'albero del modulo Amministrazione, con i numeri delle voci e i Recenti*
3. **Cerca.** Scrivi nella casella sopra l'albero. Al posto dell'albero compare l'elenco delle funzioni trovate, con il modulo a sinistra e il numero a destra. Le parole valgono in qualunque ordine, senza badare a maiuscole e accenti.
    
    ![La ricerca «Condizioni»: 308 funzioni trovate in 16 moduli](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/la-ricerca-condizioni-308-funzioni-trovate-in-16-moduli.png)
    
    *La ricerca «Condizioni»: 308 funzioni trovate in 16 moduli*
4. **Apri il risultato.** Invio o un clic scelgono la funzione. Se è di un altro modulo, il menu cambia modulo da solo.

Cosa capisce la ricerca:

<table id="bkmrk-scrivi-trovi-condizi"><thead><tr><th>Scrivi</th><th>Trovi</th></tr></thead><tbody><tr><td>`condizioni pag`</td><td>le funzioni con quelle parole, anche a metà</td></tr><tr><td>`2.20`</td><td>il ramo con quel numero, in tutti i moduli</td></tr><tr><td>`ddt`</td><td>anche «bolla» e «documento di trasporto»: conosce i sinonimi del gestionale</td></tr><tr><td>`b31 ordini`</td><td>solo le funzioni di quel modulo</td></tr><tr><td>`condizoni`</td><td>anche con un errore di battitura, segnato con `≈`</td></tr></tbody></table>

In testa ai risultati scegli fra **Tutti i moduli** e il solo modulo aperto. Prima vengono le funzioni che si chiamano proprio così, poi quelle usate di recente. Il pulsante con l'albero mostra gli stessi risultati dentro l'albero del modulo, coi rami già aperti. Esc svuota la ricerca.

**Ctrl+K** apre [Cerca ovunque](https://gsdoc.genesyssoftware.eu/link/37957): una casella sola che cerca nelle funzioni, nei Preferiti, nei Recenti e nelle voci delle Opzioni.

<p class="callout info">**Nota.** Con il clic destro su una voce copi il suo percorso o un link che porta un collega dritto a quella funzione: vedi [Copiare una voce o il suo link](https://gsdoc.genesyssoftware.eu/link/37958).</p>

<p class="callout info">**Nota.** Per il cambio di modulo e per tutti i tasti del menu vedi [Scegliere il modulo](https://gsdoc.genesyssoftware.eu/link/37955) e [Il menu da tastiera e con il mouse](https://gsdoc.genesyssoftware.eu/link/37956).</p>

<p class="callout info">**Per chi sviluppa.** La ricerca è in `frontend/sbh-web/src/session/utils/sbh-function-search.util.ts`. I sinonimi sono un elenco curato: `frontend/sbh-web/src/session/data/sbh-sinonimi.json`. I menu scaricati restano nel browser.</p>

<p class="callout info">**Per approfondire.**  
• Il client web del legacy SBH — menu e maschere: `docs/guide/moduli/sbh-menu-e-maschere/README.md`</p>

# JH3.10 - Il manuale in linea

**In una frase.** Il libro accanto al titolo della funzione apre la pagina del manuale di quella funzione, di fianco alla maschera.

Il manuale del gestionale è un sito a parte. Qui non lo devi cercare: la pagina giusta si apre da sola, e la leggi mentre lavori senza cambiare finestra.

1. **Scegli la funzione nel menu.** Nel pannello di avvio, accanto al titolo, ci sono la stella e il libro.
2. **Premi il libro.** Il manuale si apre a destra, nel pannello **Documenti**, come un documento in più. La maschera resta a sinistra.
3. **Se preferisci una finestra a parte**, premi **Apri in una finestra** nella barra del pannello: il manuale va in una finestrella accostata a destra, sempre la stessa.

Lo stesso comando è in **Opzioni**, scheda **Manuale**, voce **Manuale in linea**. Senza una voce scelta nel menu apre la pagina iniziale del manuale.

## Averlo sempre di fianco

In **Opzioni**, scheda **Manuale**, accendi **Manuale sempre affiancato**. Da quel momento, a ogni funzione che avvii, il suo manuale si apre da solo nel pannello. Alla funzione dopo la pagina si aggiorna.

Se chiudi il pannello resta chiuso fino alla funzione successiva. La scelta resta nel browser.

<p class="callout info">**Nota.** Il manuale non conta nel numero sul pulsante **Documenti**: quel numero è delle stampe.</p>

<p class="callout info">**Nota.** Se il pannello resta bianco, il sito del manuale non si lascia mostrare dentro un'altra pagina: usa **Apri in una finestra**. Se il browser blocca le finestre, si apre in una scheda.</p>

<p class="callout info">**Nota.** Dove chi amministra ha spento il manuale, il libro resta visibile ma spento, e il suggerimento lo dice.</p>

<p class="callout info">**Nota.** **Manuale sempre affiancato** non scatta al tocco, dove il pannello coprirebbe la maschera, né su una sessione ripresa dopo una ricarica.</p>

<p class="callout info">**Per chi sviluppa.** L'indirizzo della pagina si calcola da modulo, versione, posizione della voce nel menu e prodotto: `frontend/sbh-web/src/session/utils/menu-file.util.ts`. Il sito si spegne sul Ponte col COBOL con `SBH_WEB_GSDOC_URL=off`.</p>

<p class="callout info">**Per approfondire.**  
• Il client web del legacy SBH — menu e maschere: `docs/guide/moduli/sbh-menu-e-maschere/README.md`  
• Client SBH — il pannello Opzioni, le stampe e gli strumenti: `docs/guide/moduli/sbh-stampe-e-strumenti/README.md`</p>

# JH3.11 - La ricerca con F8

**In una frase.** **F8** su un campo chiede al programma l'elenco dei valori possibili: scegli la riga e il valore torna nel campo.

Nessuno ricorda a memoria tutti i codici. La ricerca è quella del gestionale di sempre: la fa il programma, e quindi trova esattamente quello che il campo accetta.

1. **Premi F8 sul campo.** Si apre la finestra **Ricerca**. Mentre il server risponde vedi la rotella con «Ricerca in corso…»: il tasto è stato preso, stai aspettando il programma.
2. **Leggi la prima pagina.** Il server manda le righe a pagine, per esempio dieci alla volta. In basso a sinistra leggi quante sono arrivate: «10 righe caricate».
3. **Chiedi le altre.** **Altre righe**, oppure Pag giù. Le righe già arrivate restano a video, ferme, e le nuove si accodano. Non perdi il punto in cui eri.
    
    ![La finestra Ricerca mentre carica la seconda pagina: le righe già arrivate restano sotto](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-la-ricerca-con-f8-01-altre-righe.png)
    
    *La finestra Ricerca mentre carica la seconda pagina: le righe già arrivate restano sotto*
4. **Stringi l'elenco.** La casella in alto filtra le righe già arrivate.
5. **Scegli.** Frecce e Invio, oppure doppio clic sulla riga, oppure **Conferma selezione**. Il valore va nel campo e il programma prosegue da solo: legge il dato e porta il cursore al campo dopo.

Dopo **Altre righe** la selezione si posa sulla prima riga nuova: una freccia giù e sei sulla successiva.

## Spostare e allargare la finestra

Col mouse trascini la finestra dalla barra del titolo e la allarghi dall'angolo in basso a destra: la griglia segue l'altezza. Serve per leggere i campi che la finestra copre. Su telefono e tablet resta ferma, a tutto schermo.

<p class="callout warning">**Attenzione.** Il filtro in alto lavora solo sulle righe già caricate. La ricerca vera l'ha fatta il programma, col valore che avevi scritto nel campo. Se non trovi una riga, chiedi prima le altre pagine.</p>

<p class="callout info">**Nota.** **Altre righe** è acceso finché il server ha altre pagine da mandare.</p>

<p class="callout info">**Nota.** La finestra si chiude con la **X** o con **Annulla**.</p>

<p class="callout info">**Per chi sviluppa.** Il programma COBOL risponde a F8 con una griglia di ricerca; la pagina la apre come finestra. Il componente è in `frontend/sbh-web/src/session/components/sbh-dialogs`.</p>

<p class="callout info">**Per approfondire.**  
• Il client web del legacy SBH — menu e maschere: `docs/guide/moduli/sbh-menu-e-maschere/README.md`</p>

# JH3.12 - La guida del campo e la mini-guida

**In una frase.** **F10** spiega cosa scrivere nel campo; **F7** mostra la scheda tecnica del campo, quella che serve quando chiedi aiuto.

Sono due aiuti diversi. La guida è per chi lavora: dice a cosa serve il campo e quali valori accetta. La mini-guida è per chi assiste: dice come si chiama il campo dentro il programma.

## F10: la guida del campo

Un campo che ha la guida porta un piccolo angolo colorato in basso a destra.

1. **Premi F10.** Si apre una finestra col nome del campo e la sua spiegazione.
2. **Scegli un valore, se ci sono.** Quando il campo ammette pochi valori, la guida li elenca: un clic e il valore va nel campo.
3. **Chiudi con la X.** Il cursore torna sul campo e riprendi a scrivere senza cliccare.

Aprire e chiudere la guida non disturba il programma: i testi sono già nel browser.

Dopo aver scelto un codice, accanto compare in blu la sua descrizione, per esempio «Dalla data della fattura». Anche quella viene dalla guida del campo.

## F7: la mini-guida

**F7** sul campo attivo accende una scheda con: il nome della funzione e della maschera, il nome del campo, i tasti ammessi in quel campo e il tipo di dato. Resta accesa e segue il campo mentre ti sposti. **F7** di nuovo la spegne.

La stessa scheda, per qualunque campo e non solo per quello attivo, si apre con Maiuscolo e clic destro.

![La scheda del campo Codice pagamento: funzione, maschera, campo, posizione, guida e valore](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-la-guida-del-campo-e-la-mini-guida-01-scheda-del-campo.png)

*La scheda del campo Codice pagamento: funzione, maschera, campo, posizione, guida e valore*

## Copiare il nome della maschera

Il clic destro sulla maschera apre un menu con la sezione **Sviluppo**: **Copia nome maschera** e, su un campo, anche il nome del campo. È il modo più rapido per dire a chi assiste «il problema è qui».

<p class="callout info">**Nota.** Sotto la mini-guida trovi le note di reparto della maschera: vedi [Note di reparto](https://gsdoc.genesyssoftware.eu/link/37991).</p>

<p class="callout info">**Nota.** Un campo numerico preso vuoto con F10 mostra zero, come con ogni altro tasto.</p>

<p class="callout info">**Per chi sviluppa.** F7 non arriva al programma COBOL: nemmeno nel vecchio programma era un suo tasto. La scheda mostra anche il codice della barra di stato storica, per esempio `-N0702`: segno, numerico, cifre e decimali. Guida e scheda sono in `frontend/sbh-web/src/mask`.</p>

<p class="callout info">**Per approfondire.**  
• Il client web del legacy SBH — menu e maschere: `docs/guide/moduli/sbh-menu-e-maschere/README.md`  
• SBH — accesso e novita': `docs/guide/moduli/sbh-accesso-e-novita/README.md`</p>

# JH3.13 - La barra dei comandi

**In una frase.** La barra dei comandi mette sotto il mouse tutti i tasti della maschera, e la puoi tenere in alto, in basso, libera sullo schermo o attaccata al campo.

È la barra che stava sopra le maschere nel vecchio programma. Ogni pulsante fa esattamente quello che fa il suo tasto. È acceso solo quello che in quel campo si può usare: guardandola sai sempre cosa puoi fare.

Cosa c'è sopra, da sinistra:

- conferma, invio ed esci;
- campo e pagina precedente e successiva;
- i tasti da **F1** a **F8**;
- la ricerca e la guida del campo;
- gli strumenti: stampa, esporta, **Adatta le colonne**, **Vista della griglia**, manuale e informazioni.

Passando su un pulsante leggi il nome e il tasto, per esempio «Esci · Esc». Il clic non toglie il cursore dal campo. A destra della barra c'è il percorso della funzione nel menu.

## Dove metterla

Il menu coi tre puntini della barra propone quattro posizioni.

<table id="bkmrk-posizione-com%27%C3%A8-fiss"><thead><tr><th>Posizione</th><th>Com'è</th></tr></thead><tbody><tr><td>**Fissa in alto**</td><td>sopra la maschera: è quella proposta</td></tr><tr><td>**Fissa in basso**</td><td>sotto la maschera</td></tr><tr><td>**Mobile**</td><td>una finestrella che trascini dalla maniglia a sinistra</td></tr><tr><td>**Segue il cursore**</td><td>piccola, con i soli tasti accesi, accanto al campo attivo</td></tr></tbody></table>

![La barra mobile, trascinata in mezzo allo schermo](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-la-barra-dei-comandi-01-mobile.png)

*La barra mobile, trascinata in mezzo allo schermo*

![La barra che segue il cursore: solo i tasti accesi, sotto il campo attivo](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-la-barra-dei-comandi-02-segue-il-cursore.png)

*La barra che segue il cursore: solo i tasti accesi, sotto il campo attivo*

La barra mobile si sposta anche con le frecce, e non esce dallo schermo della sessione. Un doppio clic la rimette in alto a destra.

## Spegnerla e riaccenderla

**Alt+Maiusc+B** la spegne e la riaccende com'era. Lo stesso fa **Opzioni**, scheda **Aspetto**, voce **Barra dei comandi**.

<p class="callout warning">**Attenzione.** La **X** rossa in testa alla barra non chiude la barra: è il tasto Esci del programma. La funzione si chiude e torni al menu.</p>

<p class="callout info">**Nota.** I tasti Maiuscolo con F e **Rifiuta** compaiono solo quando il campo li ammette.</p>

<p class="callout info">**Nota.** La posizione scelta resta nel browser e vale per tutte le schede.</p>

<p class="callout info">**Per chi sviluppa.** La barra è `frontend/sbh-web/src/session/components/sbh-command-bar`. I tasti ammessi arrivano dal programma COBOL campo per campo; le etichette sono fisse, come nel vecchio programma.</p>

<p class="callout info">**Per approfondire.**  
• Client SBH — il pannello Opzioni, le stampe e gli strumenti: `docs/guide/moduli/sbh-stampe-e-strumenti/README.md`</p>

# JH3.14 - Le finestre che apre il programma

**In una frase.** Certe finestre non le chiedi tu: le apre il programma quando la funzione ne ha bisogno, per esempio per ricevere un file o mostrare un grafico.

Sono le stesse richieste che il programma faceva al vecchio client installato. SBHweb le riconosce e risponde al posto suo, così le funzioni che le usano continuano a lavorare nel browser.

Cosa può comparire:

<table id="bkmrk-il-programma-chiede-"><thead><tr><th>Il programma chiede</th><th>Cosa vedi</th></tr></thead><tbody><tr><td>un file</td><td>la finestra **Invia un file al server**: trascini il file o lo scegli; il nome lo propone il programma</td></tr><tr><td>righe da un foglio</td><td>la finestra **Importa in griglia**: un file CSV (col punto e virgola) o Excel, entro i limiti che il programma dichiara</td></tr><tr><td>di mostrare un grafico</td><td>un istogramma, nella stessa finestra del grafico delle griglie</td></tr><tr><td>di mostrare un'immagine</td><td>l'immagine nei campi della maschera che la prevedono</td></tr><tr><td>di mostrare una pagina web</td><td>la pagina va fra i **Documenti** della sessione</td></tr><tr><td>di aprire un indirizzo nel browser</td><td>una scheda nuova del browser</td></tr><tr><td>di cambiare stampante</td><td>la finestra **Scegli la stampante**</td></tr><tr><td>una nuova password</td><td>la finestra di cambio password</td></tr></tbody></table>

Le finestre che il programma apre sopra la maschera portano come titolo il nome della funzione che stai usando, non il nome tecnico della maschera.

## Cosa nel browser non si può fare

Tre richieste del vecchio programma la pagina non le esegue: leggere le coordinate, aprire la mappa e l'invio diretto di un documento al documentale. In quei casi SBHweb risponde al programma che la cosa non è disponibile e ti mostra un avviso. Non finge mai che sia andata bene.

<p class="callout warning">**Attenzione.** **Annulla** in **Invia un file al server** o in **Importa in griglia** dice al programma che hai rinunciato. Come prosegue lo decide la funzione.</p>

<p class="callout info">**Nota.** Un indirizzo che non è una pagina web, per esempio una cartella del PC, non si apre: compare un avviso. Se il browser blocca la scheda nuova, la pagina resta fra i Documenti.</p>

<p class="callout info">**Nota.** I colori che il programma chiede per il grafico non si usano: valgono quelli del tema.</p>

<p class="callout info">**Per chi sviluppa.**  
• La guida d'origine dichiara che queste finestre sono provate dai test automatici, non viste sul server vero. L'importazione in griglia non ha ancora un test.  
• Le richieste del programma sono gestite in `frontend/sbh-web/src/session/services/sbh-session.service.ts`.  
• Le funzioni che solo il programma installato sa fare sono elencate in `docs/sbh-web/INVENTARIO-LEGACY.md`. </p>

<p class="callout info">**Per approfondire.**  
• Client SBH — il pannello Opzioni, le stampe e gli strumenti: `docs/guide/moduli/sbh-stampe-e-strumenti/README.md`</p>

# JH3.2 - Il pannello di avvio

**In una frase.** Prima che la funzione parta decidi tre cose in una schermata sola: cosa fare, in che modalità, dove mandare la stampa.

Nel vecchio programma queste scelte stavano in una finestrella. Qui sono in chiaro, una accanto all'altra, e sotto leggi il riepilogo di quello che sta per partire.

1. **Scegli la funzione nel menu.** Al centro si apre il pannello di avvio, con il percorso della voce in alto.
2. **Scegli il tipo di lavoro.** **Inserimento**, **Modifica**, **Interrogazione**, **Cancellazione**. Vedi solo quelli che la funzione ammette. Ognuno ha la sua lettera: I, M, R, C.
3. **Guarda la modalità.** Definitiva aggiorna gli archivi. Dove la funzione lo permette c'è anche la simulata, che prova senza scrivere. Se la funzione ammette solo la definitiva non c'è niente da scegliere: lo dice una riga.
4. **Scegli l'uscita.** È la stampante o il formato a cui andrà la stampa. Quella di sempre è già segnata come **PREDEFINITA**.
    
    ![Il pannello di avvio: tipo di lavoro, modalità e uscita](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/il-pannello-di-avvio-tipo-di-lavoro-modalita-e-uscita.png)
    
    *Il pannello di avvio: tipo di lavoro, modalità e uscita*
5. **Premi Avvia.** Oppure Invio. **Esci** chiede se chiudere la sessione.

Chi ha fretta fa doppio clic sulla voce del menu: la funzione parte subito, con le scelte che il pannello mostra in quel momento.

**Ruolo.** Se il tuo utente ha più di un ruolo, il pannello ti fa scegliere con quale partire. L'ultimo scelto viene ricordato.

**Preferiti.** La stella accanto al titolo mette la funzione fra i Preferiti: vedi [Preferiti, Recenti e Più usate](https://gsdoc.genesyssoftware.eu/link/37988).

**Manuale.** Il libro accanto alla stella apre [Il manuale in linea](https://gsdoc.genesyssoftware.eu/link/37959) della funzione, affiancato alla maschera.

<p class="callout success">**Cosa ci guadagni.** Nel pannello trovi anche due uscite che il vecchio programma non aveva: `GPE_NEXT_PDF`, per avere il PDF impaginato, e **ANALISI**, per aprire grafici e totali sulle righe della funzione. Vedi [Le uscite di stampa](https://gsdoc.genesyssoftware.eu/link/37879) e [Analisi e stampa dalla griglia](https://gsdoc.genesyssoftware.eu/link/37878).</p>

<p class="callout info">**Per chi sviluppa.** Il pannello è `frontend/sbh-web/src/session/components/sbh-launcher`. Tipi di lavoro, modalità e stampanti li dichiara il menu che arriva dal server: la pagina non li deduce.</p>

<p class="callout info">**Per approfondire.**  
• Il client web del legacy SBH — menu e maschere: `docs/guide/moduli/sbh-menu-e-maschere/README.md`</p>

# JH3.3 - Lavorare in una maschera

**In una frase.** Scrivi solo nel campo che il programma sta aspettando; per sapere cosa metterci hai la ricerca e la guida del campo.

La regola è quella del gestionale di sempre: decide il programma dove si scrive. Il campo attivo ha il bordo colorato. Gli altri sono grigi e non si toccano. Chi arriva dal vecchio programma non deve imparare niente.

1. **Guarda il campo attivo.** È quello col bordo colorato. Scrivi e premi Invio: il programma controlla il valore e passa al campo dopo.
2. **Cerca un valore.** Se non ricordi un codice, premi **F8** sul campo. Si apre **Ricerca** con le righe che il programma propone. Scegli con le frecce e Invio, o con un doppio clic. **Altre righe** chiede la pagina successiva. Tutti i dettagli sono in [La ricerca con F8](https://gsdoc.genesyssoftware.eu/link/37960).
    
    ![La finestra Ricerca aperta con F8 sul codice pagamento](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/la-finestra-ricerca-aperta-con-f8-sul-codice-pagamento.png)
    
    *La finestra Ricerca aperta con F8 sul codice pagamento*
3. **Leggi la guida del campo.** Premi **F10**. Compare la spiegazione del campo e, se ci sono, i valori ammessi. Vedi [La guida del campo e la mini-guida](https://gsdoc.genesyssoftware.eu/link/37961).
    
    ![La guida del campo Codice pagamento](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/la-guida-del-campo-codice-pagamento.png)
    
    *La guida del campo Codice pagamento*
4. **Controlla la barra in basso.** Dice cosa sta girando: tipo di lavoro, definitivo o simulato, stampante. Il simulato è su fondo arancione, per non confonderlo.
5. **Torna al menu.** Con il tasto Esci della funzione. Solo dal menu si chiude la sessione.

Mentre una funzione è aperta il menu resta consultabile, ma non avvia altro. Per fare due cose insieme apri una seconda scheda: vedi [Schede e rientro](https://gsdoc.genesyssoftware.eu/link/37869).

<p class="callout warning">**Attenzione.** In una maschera Esc non chiude una finestra: è il tasto Esci del programma. Le finestre della pagina, come la guida e la ricerca, si chiudono con la **X**.</p>

<p class="callout info">**Nota.** Un campo numerico lasciato vuoto diventa zero, come nel vecchio programma. Se lo zero va bene lo decide il programma.</p>

<p class="callout info">**Nota.** Fra la maschera e la griglia c'è una presa con tre puntini: trascinala per dare più spazio all'una o all'altra. In alto a destra leggi il percorso completo della funzione nel menu.</p>

<p class="callout info">**Nota.** Le etichette che fanno da pulsante sono grigie. Quella della sezione in cui ti trovi è in evidenza, col bordo colorato e il testo in grassetto, come una scheda attiva.</p>

<p class="callout info">**Per chi sviluppa.** La maschera è disegnata da `frontend/sbh-web/src/mask`. Guida e ricerca non sono uguali: la guida usa testi già scaricati e non chiama il server, la ricerca la esegue il programma COBOL. F7 mostra una scheda tecnica del campo (maschera, nome, tasti ammessi).</p>

<p class="callout info">**Per approfondire.**  
• Il client web del legacy SBH — menu e maschere: `docs/guide/moduli/sbh-menu-e-maschere/README.md`</p>

# JH3.4 - Vista classica e moderna

**In una frase.** La stessa maschera si può vedere com'era nel vecchio programma oppure in una veste moderna, con campi allineati e tendine: scegli tu, con un clic.

Chi usa il gestionale da anni trova i campi a occhi chiusi nella disposizione di sempre. Chi arriva adesso legge meglio una pagina ordinata. La funzione è la stessa: cambia solo come è disegnata.

1. **Apri una funzione.** Sul PC parte nella vista classica, che a schermo si chiama **Fedele**: i campi stanno dove li metteva il vecchio programma. Su telefono e tablet parte già nella vista Moderna, che si adatta allo schermo.
    
    ![La maschera nella vista classica](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/la-maschera-nella-vista-classica.png)
    
    *La maschera nella vista classica*
2. **Cambia vista.** Nella barra in basso c'è l'interruttore della vista. Ogni clic passa alla successiva: **Fedele**, **Fedele con tasti**, **Moderna** (anche con le etichette a lato del campo).
3. **Guarda la vista Moderna.** I campi sono in colonna, con le etichette allineate. Dove il programma ammette pochi valori trovi una tendina **Scegli**. Accanto al campo attivo c'è la lente della ricerca.
    
    ![La stessa maschera nella vista Moderna](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/la-stessa-maschera-nella-vista-moderna.png)
    
    *La stessa maschera nella vista Moderna*

Le tre viste:

<table id="bkmrk-vista-com%27%C3%A8-fedele-l"><thead><tr><th>Vista</th><th>Com'è</th></tr></thead><tbody><tr><td>**Fedele**</td><td>la disposizione del vecchio programma</td></tr><tr><td>**Fedele con tasti**</td><td>la stessa, con accanto al campo attivo i pulsanti dei suoi tasti</td></tr><tr><td>**Moderna**</td><td>campi in colonna, tendine, lente accanto al campo</td></tr></tbody></table>

La scelta si cambia anche da **Opzioni**, scheda **Aspetto**, voce **Vista maschere**: lì la vista Moderna si chiama **A flusso**, e **Automatica** lascia decidere al dispositivo. Nella stessa scheda trovi il carattere più grande, il tema scuro e l'alto contrasto.

<p class="callout info">**Nota.** In tutte le viste comanda il programma: stessi campi, stesso ordine, stessi controlli, stessi tasti funzione. La vista Moderna non aggiunge e non toglie niente.</p>

<p class="callout info">**Per chi sviluppa.** Le due maschere sono in `frontend/sbh-web/src/mask/components`: `sbh-mask` disegna a coordinate, `sbh-form` a flusso. I valori delle tendine vengono dalla guida del campo.</p>

<p class="callout info">**Per approfondire.**  
• SBH — accesso e novita': `docs/guide/moduli/sbh-accesso-e-novita/README.md`</p>

# JH3.5 - Tasti funzione

**In una frase.** I tasti funzione sono quelli del gestionale di sempre; li trovi anche come pulsanti nella barra dei comandi e puoi decidere quale tasto fa Esci, Conferma, Guida e Cerca.

Chi lavora da anni col gestionale ha i tasti nelle dita, e li ritrova. Chi non li conosce li legge sulla barra: è acceso solo quello che in quel campo si può usare.

1. **Guarda la barra dei comandi.** Sta sopra la maschera. Ogni pulsante fa quello che fa il suo tasto. I tasti ammessi cambiano da campo a campo, perché li decide il programma.
    
    ![La barra dei comandi: conferma, invio, esci, i tasti da F1 a F8 e gli strumenti](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/la-barra-dei-comandi-conferma-invio-esci-i-tasti-da-f1-a-f8-e-gli-strumenti.png)
    
    *La barra dei comandi: conferma, invio, esci, i tasti da F1 a F8 e gli strumenti*
2. **Usa i tasti di tutti i giorni.**
    
    <table><thead><tr><th>Tasto</th><th>Cosa fa</th></tr></thead><tbody><tr><td>Invio</td><td>manda il campo al programma</td></tr><tr><td>**F8**</td><td>apre la ricerca sul campo</td></tr><tr><td>**F10**</td><td>apre la guida del campo</td></tr><tr><td>**F12**</td><td>conferma la maschera</td></tr><tr><td>Esc</td><td>esce dalla funzione</td></tr></tbody></table>
3. **Cambia i tasti, se vuoi.** **Opzioni**, scheda **Strumenti**, voce **Tasti funzione**. Scegli quale tasto fa **Esci**, **Conferma**, **Guida** e **Cerca / Salto**. Un tasto vale per un'azione sola.
    
    ![La finestra Tasti funzione](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/la-finestra-tasti-funzione.png)
    
    *La finestra Tasti funzione*
4. **Rimetti quelli di una volta.** **Come il client legacy** riporta Esci su F11. **Predefiniti** torna alla proposta della pagina.

I tasti fra cui scegliere sono F9, F10, F11, F12 ed Esc. Se ne scegli uno già usato per un'altra azione, le due si scambiano.

La barra dei comandi si sposta dal suo menu con i tre puntini: fissa in alto, fissa in basso, mobile, oppure piccola e accanto al campo attivo. Vedi [La barra dei comandi](https://gsdoc.genesyssoftware.eu/link/37962). Per l'elenco dei tasti validi in ogni momento vedi [Scorciatoie da tastiera](https://gsdoc.genesyssoftware.eu/link/37984).

<p class="callout info">**Nota.** La tabella mostra i tasti proposti dalla pagina. Se li hai cambiati, il suggerimento che compare passando sul pulsante dice sempre il tasto giusto.</p>

<p class="callout info">**Nota.** Alcuni tasti il browser li tiene per sé, come Ctrl+T o Ctrl+W: non si possono assegnare.</p>

<p class="callout info">**Per chi sviluppa.** La scelta dei tasti resta nel browser. La barra dei comandi ripete la barra del vecchio programma; i tasti ammessi arrivano dal programma COBOL campo per campo.</p>

<p class="callout info">**Per approfondire.**  
• Il client web del legacy SBH — menu e maschere: `docs/guide/moduli/sbh-menu-e-maschere/README.md`  
• Client SBH — il pannello Opzioni, le stampe e gli strumenti: `docs/guide/moduli/sbh-stampe-e-strumenti/README.md`</p>

# JH3.6 - Scegliere il modulo

**In una frase.** Il gestionale ha un menu per ogni modulo: lo cambi dalla barra in testa al menu, con una lista veloce o con una griglia che si può cercare.

Amministrazione, Ciclo attivo, Magazzino: ogni modulo ha le sue funzioni. Chi lavora su due o tre moduli li cambia decine di volte al giorno, e deve farlo in un attimo, anche senza mouse.

In testa al menu, a sinistra, c'è la **barra del modulo**: icona, nome, sigla e numero di funzioni.

## La lista

Un clic sulla barra, o sulla freccia, apre sotto la lista dei moduli. Il modulo in uso ha il segno a sinistra. I moduli senza funzioni sono attenuati.

<table id="bkmrk-tasto-cosa-fa-frecci"><thead><tr><th>Tasto</th><th>Cosa fa</th></tr></thead><tbody><tr><td>freccia giù o su, con la barra a fuoco</td><td>apre la lista</td></tr><tr><td>frecce, Home, Fine</td><td>si muove fra i moduli</td></tr><tr><td>una o più lettere</td><td>va al primo modulo che comincia così</td></tr><tr><td>Invio o Spazio</td><td>sceglie il modulo</td></tr><tr><td>Esc, Tab o un clic fuori</td><td>chiude la lista senza cambiare</td></tr></tbody></table>

## La griglia

I quadratini a destra della barra aprono **Scegli il modulo**: una carta per modulo, col numero di funzioni, e una ricerca per sigla o descrizione. Serve quando i moduli sono tanti e cerchi per parola.

![La finestra Scegli il modulo, filtrata su B20: resta la carta di Amministrazione](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-scegliere-il-modulo-01-griglia-dei-moduli.png)

*La finestra Scegli il modulo, filtrata su B20: resta la carta di Amministrazione*

## Cosa leggi dopo la scelta

- In testa al menu compaiono nome, sigla e numero di funzioni del modulo scelto.
- In fondo al menu una riga piccola dice modulo, versione e rilascio del menu, per esempio «Menu B20 · vers. 0000 · rel. 6800». È il dato da citare quando segnali un problema su una voce.

<p class="callout info">**Nota.** Un modulo con più versioni è una riga sola nella lista. Nel menu trovi una riga per ogni versione.</p>

<p class="callout info">**Nota.** Qui Esc chiude solo la lista: non chiede di uscire dalla sessione.</p>

<p class="callout info">**Nota.** Non serve cambiare modulo a mano per aprire una funzione di un altro modulo: la ricerca del menu e i Preferiti lo cambiano da soli. Vedi [Il menu e la ricerca](https://gsdoc.genesyssoftware.eu/link/37871).</p>

<p class="callout info">**Per chi sviluppa.** I menu dei moduli arrivano dal server al primo accesso e restano nel browser (`frontend/sbh-web/src/session/services/sbh-menu-cache.store.ts`). Il menu è `frontend/sbh-web/src/session/components/sbh-menu`.</p>

<p class="callout info">**Per approfondire.**  
• Il client web del legacy SBH — menu e maschere: `docs/guide/moduli/sbh-menu-e-maschere/README.md`</p>

# JH3.7 - Il menu da tastiera e con il mouse

**In una frase.** Il menu si usa tutto da tastiera, come nel vecchio programma, e col mouse un doppio clic avvia subito la funzione.

Chi inserisce dati tutto il giorno non stacca le mani dalla tastiera. Tornando da una funzione trova già scelta l'ultima voce usata, con i rami aperti: non serve cliccare per ripartire.

## Da tastiera

<table id="bkmrk-tasto-cosa-fa-frecci"><thead><tr><th>Tasto</th><th>Cosa fa</th></tr></thead><tbody><tr><td>freccia su e giù</td><td>voce sopra e sotto; su una funzione il pannello di avvio la mostra subito</td></tr><tr><td>freccia destra</td><td>apre il ramo; se è già aperto va alla prima voce dentro</td></tr><tr><td>freccia sinistra</td><td>chiude il ramo, o torna al ramo che contiene la voce</td></tr><tr><td>Home, Fine</td><td>prima e ultima voce visibile</td></tr><tr><td>Invio</td><td>su un ramo lo apre o lo chiude; su una funzione la avvia</td></tr><tr><td>Spazio</td><td>sceglie la funzione e porta il cursore sui tipi di lavoro</td></tr><tr><td>le cifre</td><td>vanno alla voce con quel numero: `1` e `2` di seguito portano alla voce 12</td></tr><tr><td>`*`</td><td>apre tutti i rami dello stesso livello</td></tr><tr><td>Tab</td><td>passa dal menu al pannello di avvio</td></tr></tbody></table>

Le lettere restano del pannello di avvio: `I`, `M`, `R`, `C`, `E`, `S` scelgono il tipo di lavoro.

## Con il mouse

- **Un clic** su una funzione la sceglie e apre il pannello di avvio.
- **Doppio clic** la avvia subito, con le scelte che il pannello ha in quel momento: tipo di lavoro, modalità, ruolo e stampante.
- **Doppio clic su un ramo** lo apre o lo chiude.
- **Clic destro** apre il menu delle copie e dei promemoria.

Se la funzione non può partire, per esempio perché nessuna stampante è adatta, resta il pannello, che dice perché.

## Con una funzione aperta

Il menu non sparisce: si ritira nel pulsante **Menu** della barra in basso. Un clic lo riapre sopra la maschera, per guardare dove sei o cercare la prossima voce. In testa leggi «Funzione in corso: menu in consultazione».

![Il menu riaperto sopra la funzione: in testa l'avviso, le voci non si avviano](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-il-menu-da-tastiera-e-con-il-mouse-01-menu-in-consultazione.png)

*Il menu riaperto sopra la funzione: in testa l'avviso, le voci non si avviano*

Ti muovi, ma non avvii niente: il programma esegue una funzione alla volta per sessione. Per farne due insieme apri un'altra scheda.

<p class="callout info">**Nota.** Con lo schermo stretto il menu è un cassetto che si apre e si chiude. I comandi sono gli stessi.</p>

<p class="callout info">**Per chi sviluppa.** Il comportamento ripete quello del menu del vecchio programma. Il componente è `frontend/sbh-web/src/session/components/sbh-menu`.</p>

<p class="callout info">**Per approfondire.**  
• Il client web del legacy SBH — menu e maschere: `docs/guide/moduli/sbh-menu-e-maschere/README.md`</p>

# JH3.8 - Cerca ovunque

**In una frase.** **Ctrl+K** apre una casella sola che cerca nelle funzioni di tutti i moduli, nei Preferiti, nei Recenti e nelle voci delle Opzioni.

Non devi sapere se quello che cerchi è una funzione o un'impostazione, né in quale modulo sta. Scrivi, e la casella guarda dappertutto.

1. **Apri la casella.** Premi **Ctrl+K**. Compare in alto al centro. Senza testo mostra Preferiti e Recenti.
2. **Scrivi.** I risultati escono a gruppi, ognuno col numero di righe.
    
    <table><thead><tr><th>Gruppo</th><th>Cosa trovi</th></tr></thead><tbody><tr><td>**Funzioni**</td><td>le voci dei menu di tutti i moduli: per testo, per numero (`1.1.1.1`) o per nome del programma</td></tr><tr><td>**Preferiti** e **Recenti**</td><td>le tue, di tutti i moduli</td></tr><tr><td>**Opzioni**</td><td>tasti funzione, sessioni aperte, tema scuro, dati salvati nel browser e le altre</td></tr></tbody></table>
    
    Ogni riga ha il numero della voce, la descrizione col testo trovato in evidenza, il percorso nel menu e il modulo a destra.
3. **Scegli.** Frecce su e giù, poi Invio. Oppure un clic.

Cosa succede con Invio:

- su una **funzione**, un preferito o un recente: si apre il suo pannello di avvio. Se la voce è di un altro modulo, il menu cambia modulo da solo. Un preferito riapre il tipo di lavoro con cui l'avevi salvato;
- su un'**opzione**: fa quello che fa il clic nel pannello Opzioni.

Esc o un clic fuori chiudono la casella, e il cursore torna dov'era.

La casella si apre anche dal pulsante **Cerca** della barra in basso e da **Cerca in tutti i moduli** nel benvenuto.

<p class="callout info">**Nota.** Con una funzione aperta la casella si apre in consultazione: le funzioni si vedono spente e Invio non le apre. Le opzioni restano usabili.</p>

<p class="callout info">**Nota.** La ricerca è la stessa del menu: parole in qualunque ordine, senza badare a maiuscole e accenti, con i sinonimi del gestionale. Si vedono i 50 risultati migliori.</p>

<p class="callout info">**Nota.** Il tasto si cambia in **Opzioni**, **Strumenti**, **Tasti funzione**, riga **Cerca ovunque**: Ctrl+K, Ctrl+Maiusc+K, Alt+K, oppure un altro a scelta. Non si possono usare i tasti di copia e incolla né quelli che il browser tiene per sé.</p>

<p class="callout info">**Per chi sviluppa.** La casella è `frontend/sbh-web/src/session/components/sbh-command-palette`. Usa lo stesso indice della ricerca del menu, costruito sui menu scaricati al primo accesso.</p>

<p class="callout info">**Per approfondire.**  
• Il client web del legacy SBH — menu e maschere: `docs/guide/moduli/sbh-menu-e-maschere/README.md`</p>

# JH3.9 - Copiare una voce o il suo link

**In una frase.** Con il clic destro su una voce del menu copi il suo percorso, il suo numero o un link che porta un collega dritto a quella funzione.

«Vai in Amministrazione, poi Parametri base, poi…»: al telefono o in un'istruzione scritta si sbaglia facilmente. Copiare il percorso esatto, o mandare un link, toglie l'errore.

1. **Fai clic destro sulla voce.** Al tocco vale la pressione lunga. Si apre il menu delle copie.
2. **Scegli cosa copiare.**
    
    <table><thead><tr><th>Voce</th><th>Cosa finisce negli appunti</th></tr></thead><tbody><tr><td>**Copia**</td><td>il percorso completo, come lo scriveva il vecchio programma: `B20\1.1 Parametri base\1 Tabelle Generali\1 Condizioni Pagamento`</td></tr><tr><td>**Copia link**</td><td>l'indirizzo che porta a quella voce</td></tr><tr><td>le altre righe</td><td>il solo numero (`1.1.1.1`), numero e descrizione, il nome del programma, il percorso coi numeri completi</td></tr></tbody></table>
3. **Incolla dove serve.** L'icona della riga diventa una spunta e il menu si chiude da solo.

## Come funziona il link

Chi apre il link entra in SBHweb come sempre: fa l'accesso, oppure rientra in una sessione in sospeso. Appena il server è sul menu, la pagina cambia modulo se serve e apre il **pannello di avvio** della voce.

- Il link **non avvia niente** e non sceglie nessun dato: la funzione la avvia chi lo apre.
- Se la voce è fra i tuoi Preferiti o Recenti, il link porta anche il tipo di lavoro, per esempio Interrogazione.
- Vale una volta sola: una ricarica della pagina non riapre la voce.
- Se chi lo apre non ha quella voce nel suo menu, lo legge nella riga dei messaggi: «Il link chiede la voce B20 1.1.1.1: non c'è nel menu di questo utente».

<p class="callout info">**Nota.** **Copia link** c'è solo sulle funzioni, non sui rami.</p>

<p class="callout info">**Nota.** Per un modulo con più versioni la copia porta la versione fra parentesi dopo la sigla.</p>

<p class="callout info">**Nota.** Se il browser non concede gli appunti, lo dice la riga dei messaggi.</p>

<p class="callout info">**Per chi sviluppa.** Il link ha la forma `/sbh?voce=B20/1.1.1.1&tipo=R`: modulo, numero completo e, se c'è, la lettera del tipo di lavoro. Il parametro si toglie dall'indirizzo appena letto.</p>

<p class="callout info">**Per approfondire.**  
• Il client web del legacy SBH — menu e maschere: `docs/guide/moduli/sbh-menu-e-maschere/README.md`</p>

# JH4 - Le griglie

# JH4.1 - Cercare e filtrare

**In una frase.** Le righe che il programma manda arrivano in una griglia che ordini, filtri e sommi da solo, senza toccare il programma.

Nel vecchio programma una lista si poteva solo scorrere. Qui trovi in pochi secondi «tutte le condizioni con BANC nel nome» o la somma di tre celle. Il programma non se ne accorge: le sue righe restano le sue.

1. **Ordina.** Un clic sull'intestazione ordina in crescendo, il secondo al contrario, il terzo rimette l'ordine del programma.
2. **Filtra una colonna.** Clic destro sull'intestazione, poi **Filtra…**. È lo stesso filtro dell'imbuto che compare passando sull'intestazione. Scegli la condizione (Uguale, Diverso, Inizia con, Contiene, Non contiene, vuoto, non vuoto) e scrivi il valore. Con **Aggiungi condizione** ne sommi altre. **Azzera**rimette tutte le righe.
    
    ![Il filtro sulla colonna Descrizione: Contiene BANC](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/il-filtro-sulla-colonna-descrizione-contiene-banc.png)
    
    *Il filtro sulla colonna Descrizione: Contiene BANC*
3. **Somma una selezione.** Clic sulla prima cella, Maiuscolo e clic sull'ultima. Il clic destro mostra quante celle hai scelto e, se sono numeri, somma, media, minimo e massimo. Gli stessi numeri restano nella barra in fondo alla griglia.
    
    ![Tre celle selezionate: somma, media, minimo e massimo, e il menu della griglia](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/tre-celle-selezionate-somma-media-minimo-e-massimo-e-il-menu-della-griglia.png)
    
    *Tre celle selezionate: somma, media, minimo e massimo, e il menu della griglia*
4. **Sistema le colonne.** Dallo stesso menu, **Strumenti**, poi **Colonne visibili**: accendi e spegni le colonne. Trascinando il bordo di un'intestazione cambi la larghezza. Le scelte restano per la prossima volta.
5. **Porta fuori i dati.** **Copia** ed **Esporta** stanno nello stesso menu: vedi [Copiare ed esportare](https://gsdoc.genesyssoftware.eu/link/37969).

Per approfondire ogni strumento: [Colonne e larghezze](https://gsdoc.genesyssoftware.eu/link/37965), [Ordinamento e subtotali](https://gsdoc.genesyssoftware.eu/link/37966), [La tabella pivot](https://gsdoc.genesyssoftware.eu/link/37967), [Il grafico](https://gsdoc.genesyssoftware.eu/link/37968).

<p class="callout warning">**Attenzione.** Il filtro lavora sulle righe già arrivate. Se il programma manda le righe a pagine, prima chiedi le altre con Pag giù, poi filtra.</p>

<p class="callout info">**Nota.** I colori delle righe li decide il programma: vedi [I colori delle righe](https://gsdoc.genesyssoftware.eu/link/37964).</p>

<p class="callout info">**Nota.** L'intestazione di una colonna filtrata cambia colore e tiene l'imbuto acceso. Sulle colonne molto strette l'imbuto non si vede: il filtro si apre dal clic destro.</p>

<p class="callout info">**Nota.** Su alcune intestazioni, a icona o a casella, il clic destro è del programma: lì il menu della colonna non si apre.</p>

<p class="callout info">**Per chi sviluppa.** È la stessa griglia delle pagine nuove, `frontend/core/src/grid`. Ordinamento e filtri sono del browser: il programma COBOL rilegge sempre le sue righe.</p>

<p class="callout info">**Per approfondire.**  
• Griglie e analisi nel client web del legacy SBH: `docs/guide/moduli/sbh-griglie-e-analisi/README.md`</p>

# JH4.2 - Viste e formati

**In una frase.** Una vista ricorda come vuoi vedere una griglia: colonne, ordine, filtri, totali, colori. La salvi con un nome e la ritrovi.

Ognuno guarda la stessa lista in modo diverso. Chi controlla i margini vuole i negativi in rosso, chi fa i conti vuole i totali per agente. Con le viste non si rifà il lavoro ogni volta.

1. **Apri il menu delle viste.** È il pulsante a sinistra nella barra della griglia. Da **Opzioni**, scheda **Griglia**, è la voce **Viste della griglia**. All'inizio c'è solo **Standard**, la griglia come la manda il programma.
    
    ![Il menu delle viste: Salva come, Gestisci la vista, Colonne calcolate, Formattazione condizionale](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/il-menu-delle-viste-salva-come-gestisci-la-vista-colonne-calcolate-formattazione-condizionale.png)
    
    *Il menu delle viste: Salva come, Gestisci la vista, Colonne calcolate, Formattazione condizionale*
2. **Sistema la griglia e salva.** **Salva come…** chiede un nome e che cosa ricordare: colonne, ordinamento, gruppi e totali, filtri. Con **Predefinita** la vista si apre da sola insieme alla griglia.
3. **Aggiungi una colonna calcolata.** **Colonne calcolate…** crea una colonna con una formula sulle altre, per esempio un margine. Non serve toccare il programma.
4. **Dai un colore ai numeri.** **Formattazione condizionale…** applica regole del tipo «se l'importo è negativo, testo rosso e icona di attenzione», oppure una barra lunga quanto il valore.
    
    ![Una regola di formattazione: se Importo è minore di zero, testo rosso in grassetto con icona](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/una-regola-di-formattazione-se-importo-e-minore-di-zero-testo-rosso-in-grassetto-con-icona.png)
    
    *Una regola di formattazione: se Importo è minore di zero, testo rosso in grassetto con icona*
5. **Torna indietro quando vuoi.** Scegli **Standard** e la griglia torna com'era. Un asterisco accanto al nome dice che la vista ha modifiche non salvate.

Le due schermate sono della pagina di prova delle griglie, con dati finti. Nelle funzioni storiche menu e finestre sono gli stessi.

<p class="callout info">**Nota.** Le viste sono salvate sul Ponte col COBOL, per utente: le ritrovi su un altro PC. Una vista può essere solo tua, del ruolo o aziendale. Chi può pubblicare quelle condivise lo decide chi amministra: vedi [Regole e viste delle griglie](https://gsdoc.genesyssoftware.eu/link/37883).</p>

<p class="callout info">**Nota.** La vista cambia solo quello che vedi. Le righe che il programma legge e scrive non cambiano.</p>

<p class="callout info">**Per chi sviluppa.** L'archivio delle viste è acceso di serie (`SBH_VIEWS_ENABLED`). Spento, le viste restano solo nel browser e la griglia lo segnala con un'icona.</p>

<p class="callout info">**Per approfondire.**  
• Griglie: viste, colonne calcolate, formattazione condizionale: `docs/guide/moduli/griglie-viste-calcolate-formati/README.md`</p>

# JH4.3 - Analisi e stampa dalla griglia

**In una frase.** Dalle righe di una funzione storica arrivi a una tabella pivot, a un grafico, a un cruscotto o a un PDF, senza chiedere un report a nessuno.

Le funzioni storiche hanno le loro stampe, sempre uguali. Quando la domanda è nuova («quante condizioni per tipo di carta?») prima serviva un programmatore. Ora la risposta la costruisci tu sulle righe a video.

1. **Apri la tabella pivot.** Clic destro su una cella, **Analisi**, **Pivot**. Trascina i campi in Righe, Colonne e Valori. Lavora sulle righe a video, con i filtri che hai messo.
    
    ![La tabella pivot costruita sulle righe di Condizioni pagamento](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/la-tabella-pivot-costruita-sulle-righe-di-condizioni-pagamento.png)
    
    *La tabella pivot costruita sulle righe di Condizioni pagamento*
2. **Passa al grafico.** Dal pivot premi **Grafico**. Scegli fra colonne, barre, linee, torta e altri tipi. Un clic su una barra mostra le righe che la compongono.
3. **Salva o esporta.** Il pivot esce in Excel e CSV, il grafico in immagine. La vista salvata ricorda la costruzione per la volta dopo.
4. **Chiedi l'analisi già all'avvio.** Nel pannello di avvio, sotto l'uscita, c'è **ANALISI**. Se la scegli, appena le griglie della funzione sono a video si apre un cruscotto di Analytics. Con la casella accanto carica anche le righe non ancora a video, fino al numero che scegli. La prima volta, quando per quella schermata non c'è ancora un cruscotto salvato, l'analisi aspetta la tua conferma: così fai comparire prima tutte le griglie che ti servono.
    
    ![Il pannello di avvio con ANALISI scelta e il numero massimo di righe da caricare](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/il-pannello-di-avvio-con-analisi-scelta-e-il-numero-massimo-di-righe-da-caricare.png)
    
    *Il pannello di avvio con ANALISI scelta e il numero massimo di righe da caricare*
5. **Stampa in PDF.** Nello stesso pannello l'uscita `GPE_NEXT_PDF` manda la stampa della funzione a GPEnext, che la impagina. Vedi [Le uscite di stampa](https://gsdoc.genesyssoftware.eu/link/37879).

<p class="callout info">**Nota.** Pivot e grafico sono gli stessi di tutte le griglie di ADSWnext: quello che impari qui vale anche sulle pagine nuove. Qui sono spiegati in [La tabella pivot](https://gsdoc.genesyssoftware.eu/link/37967) e [Il grafico](https://gsdoc.genesyssoftware.eu/link/37968).</p>

<p class="callout info">**Nota.** **ANALISI** e `GPE_NEXT_PDF` si scelgono a ogni lancio: non vengono ricordate.</p>

<p class="callout info">**Nota.** Qui c'è solo come ci arrivi dal legacy.  
• Per i cruscotti vedi Da SBHweb, all'avvio o dopo (libro «JF - Analytics», pagina «JF2.2 - Da SBHweb, all'avvio o dopo»).  
• Per le stampe vedi Da SBHweb con l'uscita GPE\_NEXT\_PDF (libro «JK - GPEnext», pagina «JK2.2 - Da SBHweb con l'uscita GPE\_NEXT\_PDF»). </p>

<p class="callout info">**Per chi sviluppa.** Pivot e grafico sono in `frontend/core/src/grid`. **ANALISI** vale per un avvio solo e non viene ricordata: `frontend/sbh-web/src/session/services/sbh-analisi-avvio.service.ts`. **ANALISI** e `GPE_NEXT_PDF` ci sono solo dentro l'applicazione completa.</p>

<p class="callout info">**Per approfondire.**  
• Griglie e analisi nel client web del legacy SBH: `docs/guide/moduli/sbh-griglie-e-analisi/README.md`  
• Stampare in PDF con GPE-NEXT dalla sessione SBH: `docs/guide/moduli/sbh-stampa-gpe-next/README.md`</p>

# JH4.4 - I colori delle righe

**In una frase.** I colori di una griglia li decide il programma, cella per cella: imparando a leggerli capisci subito quali righe hai toccato e quali chiedono attenzione.

Nel vecchio programma una riga blu voleva dire «modificata, non ancora confermata». Qui il significato è lo stesso. Cambia solo la resa: i colori seguono il tema della pagina e si leggono bene anche in scuro e in alto contrasto.

Le righe arrivano dal programma COBOL e la pagina le mostra con la griglia di ADSWnext. Le prime colonne, di solito il codice e la descrizione, restano ferme quando scorri a destra.

## Cosa vogliono dire

<table id="bkmrk-colore-di-solito-ind"><thead><tr><th>Colore</th><th>Di solito indica</th></tr></thead><tbody><tr><td>testo blu, con un filetto blu a sinistra della riga</td><td>riga modificata o inserita, non ancora confermata</td></tr><tr><td>sfondo giallo</td><td>cella che il programma vuole mettere in evidenza</td></tr><tr><td>rosso</td><td>errore</td></tr><tr><td>verde</td><td>esito positivo</td></tr><tr><td>grigio</td><td>voce spenta</td></tr></tbody></table>

Il filetto blu sulla prima colonna serve a ritrovare le righe toccate mentre scorri una griglia lunga.

## Cosa non cambia

- I colori non li scegli tu e non dipendono dai filtri o dall'ordinamento: seguono la riga.
- Le righe senza colore restano come sono.
- Se vuoi colori tuoi, per esempio i negativi in rosso, li aggiungi con la formattazione condizionale: vedi [Viste e formati](https://gsdoc.genesyssoftware.eu/link/37877).

<p class="callout info">**Nota.** Il significato preciso di un colore lo decide la singola funzione. La tabella dice l'uso più comune.</p>

<p class="callout info">**Nota.** L'intestazione di una colonna filtrata cambia colore e tiene acceso l'imbuto: quello è un segno della griglia, non del programma.</p>

<p class="callout info">**Per chi sviluppa.** Il programma manda il colore del testo e dello sfondo per ogni cella. La pagina traduce la famiglia dei blu nel blu informativo del tema, i rossi nel colore di errore, i gialli nello sfondo di evidenza. La griglia delle maschere è `frontend/sbh-web/src/mask/components/sbh-grid`.</p>

<p class="callout info">**Per approfondire.**  
• Griglie e analisi nel client web del legacy SBH: `docs/guide/moduli/sbh-griglie-e-analisi/README.md`</p>

# JH4.5 - Colonne e larghezze

**In una frase.** Nascondi le colonne che non ti servono e allarga quelle che leggi di più: la griglia ricorda le scelte per la volta dopo.

Molte griglie del gestionale hanno decine di colonne, e a te ne servono cinque. Sistemarle una volta vuol dire non scorrere più a destra ogni giorno.

1. **Apri l'elenco delle colonne.** Clic destro su una cella, **Strumenti**, **Colonne visibili**. L'elenco si apre verso l'alto e scorre.
    
    ![Il menu della griglia con Strumenti e l'elenco Colonne visibili](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-colonne-e-larghezze-01-colonne-visibili.png)
    
    *Il menu della griglia con Strumenti e l'elenco Colonne visibili*
2. **Accendi e spegni.** Togli la spunta e la colonna sparisce. Rimettila e torna. Le colonne senza titolo, come quella della matita, compaiono come «(azioni)».
3. **Cambia la larghezza.** Trascina il bordo destro di un'intestazione. Mentre trascini una targhetta dice i pixel e una riga tratteggiata mostra dove finirà il bordo.
4. **Nascondi al volo.** Clic destro sull'intestazione, **Nascondi la colonna**.
5. **Torna alle larghezze di partenza.** **Adatta le colonne** rimette ogni colonna larga quanto il suo contenuto e dimentica le larghezze che avevi trascinato.

## I due pulsanti della barra dei comandi

Nella barra dei comandi, dopo la stampa, ci sono due pulsanti per le griglie.

<table id="bkmrk-pulsante-cosa-fa-ada"><thead><tr><th>Pulsante</th><th>Cosa fa</th></tr></thead><tbody><tr><td>**Adatta le colonne**</td><td>adatta tutte le griglie della maschera che hanno righe</td></tr><tr><td>**Vista della griglia**</td><td>apre la finestra **Vista** di una griglia: colonne, ordine, gruppi, filtri</td></tr></tbody></table>

Se a video c'è più di una griglia, **Vista della griglia** chiede prima quale, con in testa quella del campo attivo. Senza griglie con righe i due pulsanti sono spenti. Le stesse voci sono in **Opzioni**, scheda **Griglia**.

<p class="callout info">**Nota.** Le scelte valgono per quella funzione, quella maschera e quell'utente, e restano nel browser. Su un altro PC le ritrovi solo se le salvi in una vista: vedi [Viste e formati](https://gsdoc.genesyssoftware.eu/link/37877).</p>

<p class="callout info">**Nota.** Quando apri la funzione il programma chiede di adattare le colonne al contenuto. La griglia lo fa, ma rispetta le larghezze che avevi scelto a mano.</p>

<p class="callout info">**Per chi sviluppa.** Larghezze, colonne nascoste e ordine delle colonne le salva la griglia comune, `frontend/core/src/grid`, con una chiave fatta da funzione, maschera e utente.</p>

<p class="callout info">**Per approfondire.**  
• Griglie e analisi nel client web del legacy SBH: `docs/guide/moduli/sbh-griglie-e-analisi/README.md`</p>

# JH4.6 - Ordinamento e subtotali

**In una frase.** **Configura la griglia** ordina le righe su più colonne e aggiunge righe di subtotale e di totale, come faceva la configurazione del vecchio programma.

Il clic sull'intestazione ordina per una colonna sola. Quando vuoi «per tipo di carta, e sotto ogni tipo quante condizioni ci sono», serve un ordinamento con i subtotali.

1. **Apri la finestra.** **Opzioni**, scheda **Griglia**, voce **Configura la griglia**.
2. **Scegli l'ordine.** Fino a tre colonne, una dopo l'altra. Con **Decrescente** l'ordine si rovescia.
3. **Chiedi i subtotali.** Accanto alla colonna spunta **subtotale**: a ogni cambio di valore la griglia inserisce una riga di totale del gruppo.
4. **Accendi Righe di totale** e scegli, colonna per colonna, cosa calcolare.
    
    <table><thead><tr><th>Funzione</th><th>Cosa calcola</th></tr></thead><tbody><tr><td>Somma, Media</td><td>sui valori numerici della colonna</td></tr><tr><td>Conteggio</td><td>quante righe</td></tr><tr><td>Distinti</td><td>quanti valori diversi</td></tr><tr><td>Minimo, Massimo</td><td>il più piccolo e il più grande</td></tr></tbody></table>
    
    ![La finestra Configura la griglia: ordine per tipo di carta con subtotale, conteggio sul codice](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-ordinamento-e-subtotali-01-configura-la-griglia.png)
    
    *La finestra Configura la griglia: ordine per tipo di carta con subtotale, conteggio sul codice*
5. **Premi Applica.** Le righe di subtotale sono in grassetto su fondo grigio.
    
    ![La griglia con una riga di subtotale a ogni cambio di tipo di carta](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-ordinamento-e-subtotali-02-subtotali.png)
    
    *La griglia con una riga di subtotale a ogni cambio di tipo di carta*
6. **Torna indietro.** **Togli configurazione** rimette l'ordine del programma, senza righe di totale, e dimentica la scelta.

## Il clic sull'intestazione

Per un ordinamento veloce resta il clic: il primo ordina in crescendo, il secondo al contrario, il terzo rimette l'ordine del programma. Si ordina per una colonna alla volta. La colonna ordinata ha un filetto colorato in fondo all'intestazione, con una freccina che dice il verso.

<p class="callout info">**Nota.** Le righe di totale sono solo a video: il programma non le riceve e continua a leggere le sue righe.</p>

<p class="callout info">**Nota.** La configurazione resta nel browser, per quella funzione e quell'utente.</p>

<p class="callout info">**Nota.** Per raggruppare con un clic c'è anche il menu dell'intestazione: **Raggruppa per questa colonna**e **Totale sotto**.</p>

<p class="callout info">**Per chi sviluppa.** La finestra è propria delle pagine storiche e ripete il file di configurazione del vecchio programma. Problemi noti: la colonna col numero di riga resta bianca nelle righe di subtotale, e l'elenco dei totali è lungo e scorre senza un segno che lo dica.</p>

<p class="callout info">**Per approfondire.**  
• Griglie e analisi nel client web del legacy SBH: `docs/guide/moduli/sbh-griglie-e-analisi/README.md`</p>

# JH4.7 - La tabella pivot

**In una frase.** La tabella pivot incrocia due colonne della griglia e conta o somma: rispondi a una domanda nuova senza chiedere una stampa a nessuno.

«Quante condizioni di pagamento per tipo di carta e per decorrenza?» Nessuna stampa del gestionale lo dice. Con il pivot lo costruisci in mezzo minuto sulle righe che hai a video.

1. **Apri il pivot.** Clic destro su una cella, **Analisi**, **Pivot**. Oppure **Opzioni**, scheda **Griglia**. Il pivot parte già con una proposta.
2. **Trascina i campi.** A sinistra c'è l'elenco dei campi. Le zone sono quattro.
    
    <table><thead><tr><th>Zona</th><th>A cosa serve</th></tr></thead><tbody><tr><td>**Righe**</td><td>i gruppi, uno per riga</td></tr><tr><td>**Colonne**</td><td>i gruppi, uno per colonna</td></tr><tr><td>**Valori**</td><td>il numero da calcolare: somma, conteggio, media</td></tr><tr><td>**Filtri**</td><td>i valori da escludere</td></tr></tbody></table>
3. **Scegli come leggere i numeri.** **Calore** scurisce le celle coi numeri più grandi. **Barre** disegna in ogni cella una barra lunga quanto il valore. **123** lascia solo i numeri.
    
    ![Il pivot per tipo di carta e decorrenza, coi primi cinque gruppi e le celle colorate per valore](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-la-tabella-pivot-01-calore-e-primi.png)
    
    *Il pivot per tipo di carta e decorrenza, coi primi cinque gruppi e le celle colorate per valore*
4. **Tieni i più grandi.** Ordina per etichetta o per valore. **Primi N** tiene i gruppi più grandi e raccoglie il resto in «Altri».
5. **Passa dal numero ai casi.** Un clic su una cella apre sotto il pivot le righe che la compongono, con tutte le colonne.
    
    ![Un clic sul totale di un gruppo: sotto compaiono le sue 41 righe](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-la-tabella-pivot-02-righe-di-una-cella.png)
    
    *Un clic sul totale di un gruppo: sotto compaiono le sue 41 righe*
6. **Salva.** In basso a sinistra dai un nome alla vista e la salvi. La stella la rende predefinita: la volta dopo si apre da sola.

Altre cose utili:

- con **due campi in Righe** il primo diventa un gruppo che si apre e si chiude; due pulsanti aprono e chiudono tutti i gruppi;
- **Mostra come: % del totale** trasforma i numeri in percentuali;
- un campo in **Filtri** ha un imbuto: togli la spunta ai valori che non vuoi contare;
- i due pulsanti a destra esportano il pivot in Excel e in CSV.

<p class="callout warning">**Attenzione.** Il pivot lavora sulle righe a video, con i filtri di colonna che hai messo. Se il programma manda le righe a pagine, carica prima quelle che ti servono.</p>

<p class="callout info">**Nota.** Il pivot conta numeri e date veri, non il testo scritto nella cella. Non considera la colonna delle azioni né le righe di totale.</p>

<p class="callout info">**Per chi sviluppa.** Il pivot è della griglia comune, `frontend/core/src/grid`: è lo stesso delle pagine nuove. Le viste del pivot si salvano nel browser per funzione, maschera e utente.</p>

<p class="callout info">**Per approfondire.**  
• Griglie e analisi nel client web del legacy SBH: `docs/guide/moduli/sbh-griglie-e-analisi/README.md`</p>

# JH4.8 - Il grafico

**In una frase.** Dalle righe di una griglia, o da un pivot già costruito, ottieni un grafico con i numeri chiave in testa e lo scarichi come immagine.

Una colonna di numeri si legge, un grafico si vede. Per una riunione o per una mail basta un'immagine: la fai da solo, sulle righe che hai davanti.

1. **Apri il grafico.** Tre strade: dal pivot col pulsante **Grafico**; dal clic destro su una cella, **Analisi**, **Grafico**; da **Opzioni**, scheda **Griglia**.
2. **Scegli il tipo.** Otto tipi, con un clic: Colonne, Barre, Linee, Aree, Torta, Ciambella, Polare, Radar.
3. **Scegli cosa mostrare.** **Etichette** è il campo sull'asse. **Serie** divide ogni etichetta in più colori. **Valori** è il numero: conteggio, somma, media.
    
    ![Il grafico a colonne aperto dal pivot, con Totale, Media, Massimo e Minimo in testa](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-il-grafico-01-colonne-e-numeri-chiave.png)
    
    *Il grafico a colonne aperto dal pivot, con Totale, Media, Massimo e Minimo in testa*
4. **Leggi i numeri chiave.** In testa: **Totale** di tutte le righe, **Media**, **Massimo** con la sua quota sul totale, **Minimo**.
5. **Sfoltisci.** **Primi N** tiene le etichette più grandi; con **Altri** acceso il resto finisce in una sola. **Impilato** mette le serie una sull'altra.
6. **Guarda dentro una barra.** Un clic su una barra apre le righe che la compongono.
7. **Scarica.** **PNG** salva l'immagine del grafico.

Se arrivi dal pivot, il grafico eredita tutto: etichette, serie, valori e anche i filtri. Un pulsante in alto dice quanti valori sono esclusi, per esempio «1 esclusi»: la **×** accanto toglie il filtro e il totale torna a tutte le righe.

Anche il grafico salva le sue viste, in basso a sinistra, accanto a quelle del pivot. La **×** accanto a una vista la cancella.

<p class="callout info">**Nota.** La media è calcolata sulle etichette a video, senza «Altri»: per questo sotto dice «su N etichette».</p>

<p class="callout info">**Nota.** Torta e ciambella hanno un solo cerchio di valori: la scelta delle serie sparisce.</p>

<p class="callout info">**Nota.** Cambiando tipo, campi o filtri, le righe della barra che avevi aperto si chiudono: valevano per quella barra.</p>

<p class="callout info">**Per chi sviluppa.** Il grafico è della griglia comune, `frontend/core/src/grid`. Lo stesso grafico si apre quando è il programma COBOL a chiedere un istogramma.</p>

<p class="callout info">**Per approfondire.**  
• Griglie e analisi nel client web del legacy SBH: `docs/guide/moduli/sbh-griglie-e-analisi/README.md`</p>

# JH4.9 - Copiare ed esportare

**In una frase.** Le righe di una griglia escono dal gestionale in pochi clic: negli appunti, in un file Excel, CSV o PDF, oppure in XML.

Prima, per avere una lista in un foglio di calcolo, serviva una stampa su file e un po' di pazienza. Ora selezioni e incolli.

## Copiare

1. **Seleziona le celle.** Clic sulla prima, Maiuscolo e clic sull'ultima.
2. **Clic destro, Copia.** **Per Excel** mette negli appunti le celle pronte da incollare in un foglio.

## Esportare

1. **Clic destro su una cella, Esporta.** Scegli fra CSV, Excel e PDF.
2. **Conferma nella finestra.** Il file si scarica nel browser.

## Esportare tutta la schermata

Il pulsante **Esporta** della barra in basso apre **Esporta la schermata**. Prima scegli che cosa: quali maschere e quali griglie, e dentro ognuna quali campi o colonne. Poi il formato: PDF (un documento solo), Excel (un foglio per sezione) o CSV (un file per sezione).

## La griglia in XML

**Opzioni**, scheda **Griglia**, voce **Griglia in XML**. È l'esportazione XML del vecchio programma: la griglia intera, coi titoli e una riga per ogni riga di dati. Si apre nel visualizzatore dei documenti, a tutta larghezza.

![La griglia in XML aperta nel visualizzatore dei documenti](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-copiare-ed-esportare-01-griglia-in-xml.png)

*La griglia in XML aperta nel visualizzatore dei documenti*

Da lì hai **Copia XML**, **Scarica**, **Stampa**, l'apertura in un'altra scheda del browser e **Affianca alle maschere**.

## Che cosa scegliere

<table id="bkmrk-ti-serve-usa-incolla"><thead><tr><th>Ti serve</th><th>Usa</th></tr></thead><tbody><tr><td>incollare poche celle in un foglio o in una mail</td><td>**Copia**</td></tr><tr><td>lavorare i dati in un foglio di calcolo</td><td>**Esporta** in Excel o CSV</td></tr><tr><td>un elenco da stampare o mandare</td><td>**Esporta** in PDF</td></tr><tr><td>passare i dati a un altro programma</td><td>**Griglia in XML**</td></tr></tbody></table>

<p class="callout warning">**Attenzione.** Esce quello che è arrivato a video. Se il programma manda le righe a pagine, carica prima le altre con Pag giù.</p>

<p class="callout info">**Nota.** Anche pivot e grafico hanno i loro pulsanti: il pivot esce in Excel e CSV, il grafico in immagine.</p>

<p class="callout info">**Nota.** Per un documento impaginato col modello dell'azienda non si usa l'esportazione: si usa l'uscita `GPE_NEXT_PDF`. Vedi [Le uscite di stampa](https://gsdoc.genesyssoftware.eu/link/37879).</p>

<p class="callout info">**Per chi sviluppa.** Copia ed esportazione sono della griglia comune, `frontend/core/src/grid`. La griglia in XML la prepara `frontend/sbh-web/src/session/services/sbh-session.service.ts`.</p>

<p class="callout info">**Per approfondire.**  
• Griglie e analisi nel client web del legacy SBH: `docs/guide/moduli/sbh-griglie-e-analisi/README.md`</p>

# JH5 - Stampe e strumenti

# JH5.1 - Le uscite di stampa

**In una frase.** L'uscita è dove va a finire la stampa di una funzione: una stampante, un file, lo schermo, oppure il PDF impaginato da GPEnext.

Le stampanti e i formati sono quelli che il gestionale ha sempre avuto. In più c'è un'uscita nuova, `GPE_NEXT_PDF`: la stampa storica esce come un documento curato, con il modello che l'azienda si è disegnata.

1. **Scegli l'uscita nel pannello di avvio.** Al punto **3 Uscita** ci sono i formati che la funzione ammette, per esempio **Testo**, **Laser**, **PDF**, **XML**. Sotto, l'elenco delle stampanti di quel formato. Quella proposta è segnata **PREDEFINITA**.
2. **Per il PDF impaginato scegli `GPE_NEXT_PDF`.** Non c'è una stampante da scegliere: il documento si apre a video. La scelta vale solo per quel lancio: la volta dopo va rifatta.
    
    ![Il pannello di avvio con l'uscita GPE_NEXT_PDF scelta](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/il-pannello-di-avvio-con-luscita-gpe-next-pdf-scelta.png)
    
    *Il pannello di avvio con l'uscita GPE\_NEXT\_PDF scelta*
3. **Avvia e lancia la stampa come sempre.** In basso compare l'avviso che il PDF è in lavorazione.
4. **Leggi il PDF.** Si apre nel visualizzatore. Una riga sopra il documento dice con quale modello è stato fatto.
    
    ![Il PDF impaginato da GPEnext, aperto nel visualizzatore](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/il-pdf-impaginato-da-gpenext-aperto-nel-visualizzatore.png)
    
    *Il PDF impaginato da GPEnext, aperto nel visualizzatore*

Dove finisce una stampa, secondo l'uscita:

<table id="bkmrk-uscita-dove-la-trovi"><thead><tr><th>Uscita</th><th>Dove la trovi</th></tr></thead><tbody><tr><td>una stampante del server</td><td>sulla carta, come sempre</td></tr><tr><td>un'uscita a video o su file</td><td>nel pannello **Documenti** della sessione</td></tr><tr><td>`GPE_NEXT_PDF`</td><td>nel visualizzatore, come PDF impaginato</td></tr></tbody></table>

**Se manca il modello** non si perde niente: resta a video la stampa com'è arrivata, e un messaggio dice che il modello non c'è ancora. Vedi [Il modello del PDF: sceglierlo, cambiarlo, crearlo](https://gsdoc.genesyssoftware.eu/link/37971).

Il PDF si ottiene anche dopo, o arriva da solo per le stampe già preparate per GPEnext: vedi [Il PDF di GPEnext: tre strade](https://gsdoc.genesyssoftware.eu/link/37970).

Se la funzione era partita con una stampante «da stampare» e sul PC c'è SBH Helper, anche il PDF esce direttamente dalla stampante, senza anteprima.

<p class="callout info">**Nota.** `GPE_NEXT_PDF` c'è solo dentro l'applicazione completa, su ogni funzione. È spenta se GPEnext non risponde o se il tuo ruolo non permette di stampare: il suggerimento dice perché.</p>

<p class="callout info">**Nota.** Per i formati che il browser non mostra vedi [Documenti Word, RTF ed Excel](https://gsdoc.genesyssoftware.eu/link/37973). Se qualcosa non torna: [Se la stampa non esce](https://gsdoc.genesyssoftware.eu/link/37979).</p>

<p class="callout info">**Nota.** Qui c'è solo come ci arrivi dal legacy. Per modelli e designer vedi Da SBHweb con l'uscita GPE\_NEXT\_PDF (libro «JK - GPEnext», pagina «JK2.2 - Da SBHweb con l'uscita GPE\_NEXT\_PDF»).</p>

<p class="callout info">**Per chi sviluppa.** Il programma stampa in XML su una stampante del server di tipo X. La pagina manda quell'XML a GPEnext passando dal Gateway. Il modello si cerca per nome della stampa (programma e sequenza). Dettagli in `docs/sbh-web/GPE-NEXT-PDF.md`.</p>

<p class="callout info">**Per approfondire.**  
• Client SBH — il pannello Opzioni, le stampe e gli strumenti: `docs/guide/moduli/sbh-stampe-e-strumenti/README.md`  
• Stampare in PDF con GPE-NEXT dalla sessione SBH: `docs/guide/moduli/sbh-stampa-gpe-next/README.md`</p>

# JH5.10 - Stampare la schermata

**In una frase.** **Stampa la schermata** manda in stampa la funzione com'è a video, e solo quella: senza menu, barre e pannelli.

Serve quando vuoi tenere traccia di quello che vedi: i dati di un cliente prima di cambiarli, un messaggio d'errore da mostrare a un collega. Nel vecchio programma era la copia dello schermo.

1. **Apri una funzione.** Dal menu la voce è spenta e dice «Nessuna funzione a video».
2. **Apri le Opzioni.** **Stampa la schermata** è la prima delle sei mattonelle di **Ogni giorno**. La trovi anche nella scheda **Schermata** e, come icona della stampante, nella barra dei comandi.
3. **Scegli nella finestra del browser.** Si apre la finestra di stampa del browser: lì scegli stampante, copie e formato. Puoi anche salvare in PDF.
4. **Conferma.** Sulla carta va la maschera con i suoi campi e le sue griglie, allargata alla pagina.

## Stampare o esportare

<table id="bkmrk-ti-serve-usa-la-sche"><thead><tr><th>Ti serve</th><th>Usa</th></tr></thead><tbody><tr><td>la schermata su carta, così com'è</td><td>**Stampa la schermata**</td></tr><tr><td>i dati della schermata in un file</td><td>**Esporta** nella barra in basso: scegli maschere, griglie, campi e il formato</td></tr><tr><td>un documento impaginato col modello dell'azienda</td><td>l'uscita `GPE_NEXT_PDF`</td></tr></tbody></table>

Nella scheda **Schermata** delle Opzioni, dentro l'applicazione completa, c'è anche la voce `GPE-NEXT: stampa e modelli`: stampa le griglie e i campi a video con un modello di GPEnext, oppure ne crea uno nuovo.

<p class="callout info">**Nota.** Passa sempre dalla finestra del browser: una pagina non può mandare la schermata a una stampante senza chiedertelo.</p>

<p class="callout info">**Nota.** Questa è la stampa di quello che vedi. Le stampe vere della funzione, quelle che produce il programma, vanno all'uscita scelta nel pannello di avvio: vedi [Le uscite di stampa](https://gsdoc.genesyssoftware.eu/link/37879).</p>

<p class="callout info">**Per chi sviluppa.** La stampa usa le regole di stampa della pagina per nascondere tutto tranne la funzione: `frontend/sbh-web/src/session/components/sbh-cornice`. L'esportazione è `frontend/sbh-web/src/session/components/sbh-export-dialog`.</p>

<p class="callout info">**Per approfondire.**  
• Client SBH — il pannello Opzioni, le stampe e gli strumenti: `docs/guide/moduli/sbh-stampe-e-strumenti/README.md`</p>

# JH5.11 - Tema, carattere e colori

**In una frase.** Scegli tu come si vede SBHweb: chiaro o scuro, carattere più grande, e un colore di sfondo diverso per ogni prodotto, così non confondi le sessioni.

Le maschere del gestionale sono nate per schermi piccoli: su un monitor grande possono sembrare minuscole. E chi passa otto ore davanti allo schermo vuole decidere luce e colori.

## Dalle Opzioni, scheda Aspetto

![La scheda Aspetto delle Opzioni: tema scuro, alto contrasto, vista delle maschere, icone e carattere](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-tema-carattere-e-colori-01-opzioni-aspetto.png)

*La scheda Aspetto delle Opzioni: tema scuro, alto contrasto, vista delle maschere, icone e carattere*

<table id="bkmrk-voce-cosa-fa-tema-sc"><thead><tr><th>Voce</th><th>Cosa fa</th></tr></thead><tbody><tr><td>**Tema scuro**</td><td>cambia il tema di tutta l'applicazione, non solo delle maschere</td></tr><tr><td>**Alto contrasto**</td><td>testo e bordi netti: vedi [Accessibilità](https://gsdoc.genesyssoftware.eu/link/37977)</td></tr><tr><td>**Vista maschere**</td><td>Fedele, Fedele con tasti, A flusso, Automatica: vedi [Vista classica e moderna](https://gsdoc.genesyssoftware.eu/link/37874)</td></tr><tr><td>**Icone**</td><td>lo stile delle icone del menu</td></tr><tr><td>**Carattere di maschere e griglie**</td><td>tre pulsanti: più piccolo, **A**, più grande</td></tr></tbody></table>

Il carattere ingrandisce tutta la maschera, campi e righe comprese, e anche le griglie. **A** torna alla misura normale. La percentuale è scritta accanto.

Su telefono e tablet la stessa scheda ha in più le scelte per il tocco: tasti più larghi, mano destra o sinistra, stile della barra.

## Dal pannello Personalizzazione

L'icona coi cursori in alto a destra apre **Personalizzazione**. Qui i colori si scelgono per prodotto.

![Il pannello Personalizzazione: prodotto, modalità, superficie, tinta dello sfondo, angoli e icone](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-tema-carattere-e-colori-02-personalizzazione.png)

*Il pannello Personalizzazione: prodotto, modalità, superficie, tinta dello sfondo, angoli e icone*

- **Stai personalizzando** sceglie il prodotto: superficie e tinta dello sfondo valgono per le sessioni di quel prodotto. Due prodotti, due colori: capisci subito in quale stai lavorando.
- **Tinta dello sfondo** regola quanto colore mettere. Il testo resta sempre leggibile: la tinta si ferma prima di rovinare il contrasto.
- **Campi di input** sceglie sfondo, bordo e bordo del campo attivo, e l'aspetto dei campi spenti e in sola lettura. **Auto** usa il colore del tema.
- **Ripristina** rimette i colori di partenza del prodotto.

<p class="callout info">**Nota.** Le scelte dei campi valgono per il modo, chiaro o scuro, che stai usando. Con l'alto contrasto acceso non si applicano.</p>

<p class="callout info">**Nota.** Tutto resta nel browser: su un altro PC lo reimposti.</p>

<p class="callout info">**Per chi sviluppa.** Il carattere scala maschere e griglie da `frontend/sbh-web/src/mask/utils/sbh-zoom.util.ts`. Il tema è quello di tutta l'app web: lo stesso interruttore della barra in alto.</p>

<p class="callout info">**Per approfondire.**  
• SBH — accesso e novita': `docs/guide/moduli/sbh-accesso-e-novita/README.md`  
• Il client web del legacy SBH — menu e maschere: `docs/guide/moduli/sbh-menu-e-maschere/README.md`</p>

# JH5.12 - Accessibilità

**In una frase.** SBHweb si usa anche con poca vista o senza vedere lo schermo: c'è l'alto contrasto, e un lettore di schermo annuncia campi, messaggi e schede.

Il vecchio programma installato era difficile da usare con gli aiuti per la vista. Una pagina del browser parla con i lettori di schermo e segue le preferenze del sistema.

## Alto contrasto

**Opzioni**, scheda **Aspetto**, **Alto contrasto**. Lo stesso interruttore è nel pannello **Personalizzazione**: è una preferenza sola, e vale per tutta l'applicazione.

Cosa cambia:

- testo nero su bianco, oppure bianco su nero col tema scuro;
- bordi pieni attorno ai campi;
- colori di stato più scuri;
- un anello spesso attorno al campo dove sei: blu in chiaro, giallo in scuro.

Ogni testo ha un contrasto di almeno 7 a 1 col suo sfondo.

## Annunci per il lettore di schermo

Con un lettore di schermo acceso (NVDA, Narratore di Windows, JAWS) la pagina dice:

<table id="bkmrk-quando-cosa-senti-il"><thead><tr><th>Quando</th><th>Cosa senti</th></tr></thead><tbody><tr><td>il programma aspetta un dato</td><td>il campo: «Campo in input: Codice pagamento»</td></tr><tr><td>arriva un messaggio</td><td>il tono e il testo: «Informazione: …», «Attenzione: …»</td></tr><tr><td>cambi scheda</td><td>il suo nome: «Scheda attiva: …»</td></tr></tbody></table>

A video non compare niente in più. Gli annunci sono accesi di serie e si spengono da **Opzioni**, **Aspetto**, **Annunci vocali**.

## Le zone della pagina

Il lettore di schermo trova le zone per nome: il menu, la maschera, il pannello dei documenti, la barra in basso. Con NVDA il tasto **D** passa da una zona all'altra. La barra dei comandi è annunciata come barra degli strumenti, le schede come elenco di schede, la riga dei messaggi come riga di stato.

## Meno movimento

Se nel sistema hai scelto di ridurre le animazioni, SBHweb le toglie: niente scivolamenti nel tour guidato, niente pulsazioni, la barra dei comandi che segue il cursore si sposta di colpo.

## Trovare il cursore

Su una maschera fitta, premi e rilascia **Ctrl** da solo: un cerchio colorato si stringe attorno al campo dove sei. Vedi [Scorciatoie da tastiera](https://gsdoc.genesyssoftware.eu/link/37984).

<p class="callout info">**Nota.** Con l'alto contrasto acceso i colori scelti per i campi in **Personalizzazione** non si applicano.</p>

<p class="callout info">**Nota.** Tutta la pagina si usa da tastiera: menu, pannello di avvio, maschere, Opzioni, finestre.</p>

<p class="callout info">**Per chi sviluppa.** Gli annunci sono in `frontend/sbh-web/src/session/services/sbh-announcer.service.ts` e `frontend/sbh-web/src/session/components/sbh-live-region`. La guida d'origine indica come prova a mano il Narratore di Windows con una funzione aperta.</p>

<p class="callout info">**Per approfondire.**  
• SBH — accesso e novita': `docs/guide/moduli/sbh-accesso-e-novita/README.md`</p>

# JH5.13 - Dati salvati nel browser

**In una frase.** SBHweb tiene nel browser menu, maschere, preferenze e le sessioni da riprendere: una finestra dice quanto occupano e ti lascia fare pulizia.

Il primo accesso scarica i menu di tutti i moduli e ci mette alcuni minuti. Dalla volta dopo entri in pochi secondi proprio perché quei dati restano nel browser. Sapere cosa c'è, e cosa si può cancellare senza danni, evita sorprese.

1. **Apri la finestra.** **Opzioni**, scheda **Strumenti**, voce **Dati salvati nel browser**.
    
    ![La finestra Dati salvati nel browser: le categorie e quanto occupa ognuna](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-dati-salvati-nel-browser-01-finestra.png)
    
    *La finestra Dati salvati nel browser: le categorie e quanto occupa ognuna*
2. **Leggi le categorie.**
    
    <table><thead><tr><th>Categoria</th><th>A cosa serve</th><th>Si ricostruisce?</th></tr></thead><tbody><tr><td>Sessioni da riprendere</td><td>rientrare dopo una ricarica</td><td>no</td></tr><tr><td>Menu dei moduli, maschere, guide</td><td>entrare e lavorare in fretta</td><td>sì, il server li rimanda</td></tr><tr><td>Regole dei campi, misure delle griglie</td><td>regole e larghezze</td><td>sì</td></tr><tr><td>Preferenze, connessioni, recenti</td><td>le tue scelte</td><td>no</td></tr></tbody></table>
3. **Fai pulizia, se serve.**
    
    <table><thead><tr><th>Pulsante</th><th>Cosa cancella</th></tr></thead><tbody><tr><td>**Svuota cache**</td><td>quello che il server rimanda: menu, maschere, guide. Il prossimo accesso è lento come il primo</td></tr><tr><td>**Dimentica sessioni da riprendere**</td><td>i rientri: le sessioni in sospeso non si riprendono più da questo browser</td></tr></tbody></table>

Sotto l'elenco leggi quanto occupa ogni server e quanto spazio ha a disposizione il sito.

## Cosa vive solo nel browser

Queste cose non stanno sul server. Su un altro PC, o dopo aver cancellato i dati del sito, vanno rifatte:

- connessioni salvate, con colori e loghi;
- preferiti, cartelle, recenti, più usate e promemoria;
- tema, carattere, tasti, posizione della barra dei comandi;
- note di reparto e procedure registrate;
- larghezze e colonne delle griglie, se non le hai salvate in una vista.

Preferiti e note si possono portare su un altro PC con **Esporta** e **Importa**.

<p class="callout warning">**Attenzione.** Cancellare i dati del sito dalle impostazioni del browser toglie tutto, anche la chiave per rientrare nelle sessioni in sospeso. Quelle sessioni si possono solo chiudere.</p>

<p class="callout info">**Nota.** **Svuota cache** non tocca le procedure registrate né le preferenze.</p>

<p class="callout info">**Nota.** Le viste delle griglie salvate con un nome stanno sul Ponte col COBOL e ti seguono su ogni PC.</p>

<p class="callout info">**Per chi sviluppa.** La finestra è `frontend/sbh-web/src/session/components/sbh-storage-dialog`; il conteggio è in `frontend/sbh-web/src/session/services/sbh-storage-usage.ts`.</p>

<p class="callout info">**Per approfondire.**  
• SBH — accesso e novita': `docs/guide/moduli/sbh-accesso-e-novita/README.md`</p>

# JH5.14 - Se la stampa non esce

**In una frase.** I casi più comuni in cui una stampa non arriva dove ti aspetti, e cosa fare in ognuno.

Una stampa ha molte strade: una stampante del server, il PC, lo schermo, un file, GPEnext. Quasi sempre non è persa: è andata da un'altra parte. La prima cosa da guardare è la riga dei messaggi in basso, che dice dove è finita.

## Stampe del gestionale

<table id="bkmrk-vedo-questo-faccio-q"><thead><tr><th>Vedo questo</th><th>Faccio questo</th></tr></thead><tbody><tr><td>Ho lanciato la stampa e a video non compare niente</td><td>Guarda il numero sul pulsante **Documenti**: la stampa è lì. Oppure è andata a una stampante del server: controlla l'uscita nella barra in basso</td></tr><tr><td>Il browser ha scaricato un file invece di mostrarlo</td><td>È un formato che il browser non mostra (Word, RTF, laser). Con SBH Helper si apre da solo sul PC</td></tr><tr><td>Un avviso dice che il documento RTF non è stato stampato</td><td>SBH Helper è vecchio: aggiornalo</td></tr><tr><td>La stampa esce dalla stampante sbagliata</td><td>La stampante scelta non esiste fra quelle di Windows: si usa la predefinita. Controlla il nome con chi amministra</td></tr><tr><td>La stampa a video è senza logo, con «Layout incompleto»</td><td>Manca il logo della ditta: lo carica chi amministra</td></tr><tr><td>**Archivio stampe** è spento</td><td>Si apre solo mentre una funzione aspetta un dato</td></tr><tr><td>Non trovo una stampa nell'archivio</td><td>Di partenza cerca solo oggi: allarga le date</td></tr></tbody></table>

## PDF impaginato da GPEnext

<table id="bkmrk-vedo-questo-faccio-q-1"><thead><tr><th>Vedo questo</th><th>Faccio questo</th></tr></thead><tbody><tr><td>`GPE_NEXT_PDF` è spenta</td><td>Passa col mouse: GPEnext non risponde, oppure il tuo ruolo non permette di stampare</td></tr><tr><td>`GPE_NEXT_PDF` non c'è proprio</td><td>Stai usando le pagine storiche da sole, fuori dall'applicazione completa</td></tr><tr><td>Al posto del PDF vedo i dati in XML</td><td>Manca il modello: `Crea il modello in GPE-NEXT`, oppure chiedi a chi gestisce le stampe</td></tr><tr><td>Ho creato il modello ma la stampa non lo trova</td><td>Non è pubblicato: premi **Pubblica** nel designer, poi **Riprova**</td></tr><tr><td>Ho cambiato il modello ma il PDF è uguale</td><td>Premi **Rigenera** sopra il PDF</td></tr><tr><td>L'avviso dice `PDF con GPE-NEXT non riuscito`</td><td>Leggi il motivo; quando il servizio è tornato premi **Riprova**, oppure usa la stampa in XML</td></tr><tr><td>La volta dopo l'uscita è tornata quella di sempre</td><td>È voluto: `GPE_NEXT_PDF` si sceglie a ogni lancio</td></tr></tbody></table>

## Stampa della schermata

<table id="bkmrk-vedo-questo-faccio-q-2"><thead><tr><th>Vedo questo</th><th>Faccio questo</th></tr></thead><tbody><tr><td>**Stampa la schermata** è spenta</td><td>Non c'è una funzione a video</td></tr><tr><td>Si apre la finestra di stampa del browser</td><td>È normale: scegli lì stampante e copie</td></tr></tbody></table>

Quando chiedi aiuto per una stampa di GPEnext, apri **Opzioni**, **Strumenti**, **Trace del protocollo**, scrivi `GPE-NEXT` nella casella **Filtra** e copia le righe: dicono tipo di documento ed esito di ogni tentativo. Vedi [Chiedere assistenza](https://gsdoc.genesyssoftware.eu/link/37994).

<p class="callout info">**Per chi sviluppa.** Se sul server manca una stampante di tipo X che manda la stampa alla pagina, `GPE_NEXT_PDF` lavora sulla schermata invece che sulla stampa: va creata nella tabella delle stampanti del gestionale. Dettagli in `docs/sbh-web/GPE-NEXT-PDF.md`.</p>

<p class="callout info">**Per approfondire.**  
• Client SBH — il pannello Opzioni, le stampe e gli strumenti: `docs/guide/moduli/sbh-stampe-e-strumenti/README.md`  
• Stampare in PDF con GPE-NEXT dalla sessione SBH: `docs/guide/moduli/sbh-stampa-gpe-next/README.md`</p>

# JH5.2 - Il visualizzatore dei documenti

**In una frase.** Le stampe e i file che il server manda durante la sessione si aprono in un visualizzatore dentro la pagina, che puoi tenere accanto alla maschera.

Con il vecchio programma una stampa a video copriva il lavoro. Qui la leggi di fianco mentre continui a scrivere, la ordini come una tabella, e ritrovi le stampe dei giorni passati.

1. **Apri i documenti.** Il pulsante **Documenti** nella barra in basso porta il numero dei documenti ricevuti nella sessione. Ogni documento ha la sua scheda, con la **X** per chiuderlo.
2. **Affiancalo.** **Affianca alle maschere** sposta il documento a destra. La funzione resta a sinistra e continui a lavorare. Il divisore si trascina.
    
    ![Un documento affiancato alla maschera: a sinistra la funzione, a destra il documento](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/un-documento-affiancato-alla-maschera-a-sinistra-la-funzione-a-destra-il-documento.png)
    
    *Un documento affiancato alla maschera: a sinistra la funzione, a destra il documento*
3. **Scegli come leggerlo.** Sulle stampe impaginate la barra ha tre pulsanti.
    
    <table><thead><tr><th>Pulsante</th><th>Cosa vedi</th></tr></thead><tbody><tr><td>**Originale**</td><td>la pagina com'è stata stampata</td></tr><tr><td>**Moderna**</td><td>la stessa pagina, più leggibile: intestazioni ferme, totali in evidenza, negativi in rosso</td></tr><tr><td>**Griglia**</td><td>le tabelle della stampa dentro la griglia: filtri, pivot, Excel</td></tr></tbody></table>
    
    ![Una stampa nella vista Moderna, ordinata per peso](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/una-stampa-nella-vista-moderna-ordinata-per-peso.png)
    
    *Una stampa nella vista Moderna, ordinata per peso*
4. **Stampa o scarica.** Dalla barra del visualizzatore: **Stampa**, scarica, apri in un'altra scheda del browser.
5. **Ritrova una stampa vecchia.** **Opzioni**, scheda **Sessione**, **Archivio stampe**. Cerchi per stampante, utente e date. Da lì la rivedi in anteprima o la ristampi: vedi [L'archivio stampe](https://gsdoc.genesyssoftware.eu/link/37974).

Il divisore fra maschera e documento si trascina; un doppio clic lo rimette a metà. Prima di qualunque stampa il pannello è vuoto e lo dice. Le tre viste sono spiegate in [Stampe impaginate: Originale, Moderna, Griglia](https://gsdoc.genesyssoftware.eu/link/37972).

La seconda schermata è una stampa di prova con dati finti.

<p class="callout info">**Nota.** Il visualizzatore mostra PDF, pagine impaginate, XML e testo. I file che un browser non sa mostrare, come Word o RTF, con SBH Helper si aprono sul PC col loro programma: vedi [Documenti Word, RTF ed Excel](https://gsdoc.genesyssoftware.eu/link/37973).</p>

<p class="callout info">**Nota.** Nello stesso pannello si aprono anche il manuale in linea e le pagine web che il programma chiede di mostrare.</p>

<p class="callout info">**Nota.** L'archivio stampe si apre mentre la funzione aspetta un dato. Quando lo chiudi, la funzione riprende da dove era.</p>

<p class="callout warning">**Attenzione.** Ristampa, proroga ed eliminazione dall'archivio agiscono sullo storico vero del server.</p>

<p class="callout info">**Per chi sviluppa.** Il visualizzatore è in `frontend/sbh-web/src/session/components/sbh-doc-viewer`. Fogli di stile e loghi delle stampe la pagina li chiede al Ponte col COBOL, che consegna solo i file citati dal server in quella sessione.</p>

<p class="callout info">**Per approfondire.**  
• Client SBH — il pannello Opzioni, le stampe e gli strumenti: `docs/guide/moduli/sbh-stampe-e-strumenti/README.md`</p>

# JH5.3 - Il pannello Opzioni

**In una frase.** Il pulsante con le tre righe in basso a sinistra apre le Opzioni: tutto quello che nel vecchio programma stava nei menu della finestra, con una ricerca in cima.

Non serve ricordare dove sta una voce. Scrivi due lettere e la trovi. Le sei cose di tutti i giorni sono già in evidenza.

1. **Apri le Opzioni.** Il pannello si apre verso l'alto. In testa dice dove sei: sul menu, oppure in quale maschera.
    
    ![Il pannello Opzioni aperto sulla scheda Griglia](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/il-pannello-opzioni-aperto-sulla-scheda-griglia.png)
    
    *Il pannello Opzioni aperto sulla scheda Griglia*
2. **Cerca.** Scrivi nella casella: restano solo le voci trovate, di tutte le schede. Invio esegue la prima.
    
    ![La ricerca «griglia» nelle Opzioni: le voci trovate, a gruppi](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-il-pannello-opzioni-02-ricerca.png)
    
    *La ricerca «griglia» nelle Opzioni: le voci trovate, a gruppi*
3. **Usa «Ogni giorno».** Sei mattonelle: **Stampa la schermata**, **Viste della griglia**, **Flussi**, **Tema scuro**, **Menu delle funzioni**, **Sessioni aperte**.
4. **Scegli una scheda.** A sinistra le schede, a destra le voci della scheda scelta.
    
    <table><thead><tr><th>Scheda</th><th>Cosa trovi</th></tr></thead><tbody><tr><td>**Sessione**</td><td>uscire, sessioni aperte, archivio stampe, informazioni</td></tr><tr><td>**Schermata**</td><td>stampa della schermata, menu, tutta la finestra</td></tr><tr><td>**Griglia**</td><td>viste, colonne calcolate, formati, pivot e grafico</td></tr><tr><td>**Automazione**</td><td>registrare e rivedere procedure e flussi</td></tr><tr><td>**Aspetto**</td><td>tema scuro, alto contrasto, vista delle maschere, carattere</td></tr><tr><td>**Strumenti**</td><td>SBH Helper, tasti funzione, scorciatoie, dati salvati nel browser</td></tr></tbody></table>
    
    In fondo ci sono **Manuale**, **Tour** e **Avanzate**. Quest'ultima è per chi amministra.
5. **Riparti dalle ultime.** In fondo al pannello ci sono le ultime voci che hai usato.

Una voce che in quel momento non serve resta visibile ma spenta, e sotto dice perché. Per esempio **Esci dalla sessione** è spenta mentre una funzione è aperta. A destra di ogni voce vedi cosa fa il clic: un interruttore, la scelta attuale, una freccia se apre una finestra.

Da tastiera: frecce sinistra e destra cambiano scheda, su e giù scorrono le voci, Invio sceglie. Esc svuota la ricerca e poi chiude. Il pannello si riapre sull'ultima scheda usata. La scheda **Griglia** ha un pallino quando a video c'è una griglia con righe.

<p class="callout info">**Nota.** La scheda **Automazione** porta alle Macro/Workflow SBH: registri un'operazione e la fai ripetere a orario. Hanno un libro loro: vedi Cosa si può automatizzare (libro «JI - Macro/Workflow SBH», pagina «JI1.1 - Cosa si può automatizzare»).</p>

<p class="callout info">**Nota.** Tema, carattere, tasti e le altre preferenze restano nel browser. Su un altro PC le rimetti: vedi [Dati salvati nel browser](https://gsdoc.genesyssoftware.eu/link/37978).</p>

<p class="callout info">**Nota.** Le voci sono spiegate nelle loro pagine: [Stampare la schermata](https://gsdoc.genesyssoftware.eu/link/37975), [Tema, carattere e colori](https://gsdoc.genesyssoftware.eu/link/37976), [Accessibilità](https://gsdoc.genesyssoftware.eu/link/37977), [L'archivio stampe](https://gsdoc.genesyssoftware.eu/link/37974), [Il tour guidato](https://gsdoc.genesyssoftware.eu/link/37993).</p>

<p class="callout info">**Per chi sviluppa.** Le voci sono costruite in `frontend/sbh-web/src/session/components/sbh-session-page/sbh-session-page.component.ts`. Per chi segue un problema, in **Strumenti** c'è il **Trace del protocollo**, che mostra lo scambio col server.</p>

<p class="callout info">**Per approfondire.**  
• Client SBH — il pannello Opzioni, le stampe e gli strumenti: `docs/guide/moduli/sbh-stampe-e-strumenti/README.md`</p>

# JH5.4 - SBH Helper

**In una frase.** SBH Helper è un piccolo programma sul PC che fa per SBHweb le cose che un browser non può fare: stampare diretto, salvare nelle cartelle, firmare, e avvisarti se una sessione resta aperta.

Un browser, per sicurezza, non tocca stampanti e cartelle del PC senza chiedere ogni volta. Il vecchio programma lo faceva. SBH Helper riporta quelle funzioni, e SBHweb resta una pagina.

Cosa fa:

- manda le stampe dritte alla stampante del PC, senza anteprima, comprese le etichette;
- salva i file nelle cartelle del PC o di rete;
- apre sul PC i documenti che il browser non sa mostrare, come Word e RTF;
- gestisce firma grafometrica, cassa, posta e i terminalini di magazzino;
- dà al server il nome della postazione;
- custodisce le sessioni: se la pagina sparisce mentre sei in una funzione, ti avvisa con una finestra rossa.

Come si installa, su un PC Windows:

1. **Premi Connetti.** Se SBH Helper non risponde compare **Serve l'SBH Helper**. Se è vecchio, compare **Aggiorna l'SBH Helper**.
2. **Scarica.** Il pulsante scarica il programma di installazione dal server.
3. **Installa.** Doppio clic sul file, **Avanti** fino a **Fine**. Non servono diritti di amministratore. Se Windows dice «Windows ha protetto il PC», premi **Ulteriori informazioni** e poi **Esegui comunque**.
4. **Aspetta la verifica.** SBH Helper parte da solo, e poi a ogni avvio di Windows. Appena risponde, la connessione parte.

La finestra non ha un «continua senza»: **Annulla** torna alla pagina di avvio. Se SBH Helper è installato ma fermo, la pagina prova ad avviarlo e il browser chiede «Aprire SBH Helper?»: rispondi **Apri**.

Come lo controlli: nella barra in basso l'icona del PC ha un puntino, verde se SBH Helper risponde. Un clic apre il suo pannello, con versione, stampanti, dispositivi e aggiornamento. Lo trovi anche in **Opzioni**, scheda **Strumenti**. Nella scheda **Dispositivi** ci sono i terminalini di magazzino: valgono per una sessione alla volta, e **Riprova** li chiede per quella attiva.

![Il pannello di SBH Helper: versione, dispositivi, stampanti, aggiornamento](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/il-pannello-di-sbh-helper-versione-dispositivi-stampanti-aggiornamento.png)

*Il pannello di SBH Helper: versione, dispositivi, stampanti, aggiornamento*

<p class="callout info">**Nota.** Su telefono, tablet e PC che non sono Windows SBH Helper non si installa: si entra senza. La barra in basso lo ricorda: niente stampe locali, firma, salvataggi sul PC.</p>

<p class="callout info">**Nota.** L'obbligo vale solo al **Connetti**. Se SBH Helper si chiude a sessione aperta continui a lavorare, e il puntino non è più verde. Il rientro in una sessione non viene mai bloccato.</p>

<p class="callout info">**Nota.** Per l'avviso sulle sessioni vedi [La finestra rossa di SBH Helper](https://gsdoc.genesyssoftware.eu/link/37954).</p>

<p class="callout info">**Per chi sviluppa.**  
• SBH Helper ascolta solo sul PC, all'indirizzo `http://127.0.0.1:47110`, e risponde solo alle pagine ammesse. Il Ponte col COBOL dice alla pagina dove cercarlo (`SBH_HELPER_URL`; con `off` la pagina non lo cerca).  
• La versione minima è quella che il server distribuisce. Lo script che porta il programma di installazione nel rilascio è in `devops/sbh-helper`.  
• Per le prove su un PC, `/sbh?helper=no` fa entrare senza, per quella scheda del browser. </p>

<p class="callout info">**Per approfondire.**  
• SBH — sessioni che non si perdono (standby, scheda chiusa, SBH Helper): `docs/guide/moduli/sbh-sessioni-che-non-si-perdono/README.md`  
• SBH — accesso e novita': `docs/guide/moduli/sbh-accesso-e-novita/README.md`</p>

# JH5.5 - Il PDF di GPEnext: tre strade

**In una frase.** Una stampa del gestionale diventa un PDF impaginato da GPEnext in tre modi: lo scegli all'avvio, arriva da solo, oppure lo chiedi dopo dal visualizzatore.

Il risultato è lo stesso: il documento con il modello che l'azienda si è disegnata, aperto a video. Cambia solo il momento in cui lo decidi.

<table id="bkmrk-strada-quando-usarla"><thead><tr><th>Strada</th><th>Quando usarla</th></tr></thead><tbody><tr><td>l'uscita `GPE_NEXT_PDF` all'avvio</td><td>sai già che vuoi il PDF impaginato</td></tr><tr><td>l'uscita normale</td><td>la stampa è già preparata per GPEnext: il passaggio è automatico</td></tr><tr><td>il pulsante `PDF con GPE-NEXT`</td><td>hai a video una stampa in XML, anche ripresa dall'archivio</td></tr></tbody></table>

## Prima strada: l'uscita all'avvio

1. Nel pannello di avvio, al punto **3 Uscita**, premi `GPE_NEXT_PDF`. Sotto i pulsanti il riepilogo dice «GPE\_NEXT\_PDF a video». La stampante non si sceglie: la funzione è davanti a te, il PDF si apre a video.
2. Premi **Avvia** e lancia la stampa dalla funzione come sempre.
3. In basso leggi `PDF in corso con GPE-NEXT…`. Poi il PDF si apre nel visualizzatore, con una riga sopra che dice quale modello è stato usato.

L'uscita c'è su ogni funzione, anche quando per quella stampa non esiste ancora un modello. La scelta vale per quel lancio: la volta dopo va rifatta.

## Seconda strada: l'uscita normale

Alcune stampe il gestionale le prepara apposta per GPEnext. Per quelle lasci l'uscita **XML** con la stampante di sempre e avvii: esce lo stesso PDF, con la stessa riga sopra. Le altre stampe, e l'uscita **PDF** del server, escono come prima.

## Terza strada: dal visualizzatore

Quando a video c'è l'XML di una stampa, la barra del visualizzatore ha il pulsante `PDF con GPE-NEXT`. Il PDF si apre come documento nuovo, in una scheda accanto all'XML.

## Se la funzione non ha una stampa adatta

Dove la funzione non stampa né in PDF né in XML, `GPE_NEXT_PDF` lavora sulla schermata. La funzione parte con la sua uscita normale e, alla prima schermata con dati, si apre la finestra di GPEnext: scegli un modello e **Stampa**, oppure la prima volta crei un modello nuovo dai dati a video. Le volte dopo la finestra propone già quel modello.

<p class="callout info">**Nota.** `GPE_NEXT_PDF` è spenta solo se GPEnext non risponde o se il tuo ruolo non permette di stampare: il suggerimento dice quale dei due. C'è solo dentro l'applicazione completa.</p>

<p class="callout info">**Nota.** Dal PDF hai i comandi di ogni documento: **Stampa**, scarica, apri in un'altra scheda, **Affianca alle maschere**.</p>

<p class="callout info">**Per chi sviluppa.** Il PDF non passa dal Ponte col COBOL: la pagina manda i dati della stampa al Gateway, che li porta a GPEnext. La regola che decide fra stampa e schermata è in `frontend/sbh-web/src/session/components/sbh-launcher/sbh-output.util.ts`. Dettagli in `docs/sbh-web/GPE-NEXT-PDF.md`.</p>

<p class="callout info">**Per approfondire.**  
• Stampare in PDF con GPE-NEXT dalla sessione SBH: `docs/guide/moduli/sbh-stampa-gpe-next/README.md`</p>

# JH5.6 - Il modello del PDF: sceglierlo, cambiarlo, crearlo

**In una frase.** Ogni stampa cerca il suo modello per nome; dal PDF puoi cambiarlo, e se manca lo crei dai dati della stampa che hai davanti.

Il modello è il disegno del documento: dove sta il logo, come sono le colonne. Poterlo ritoccare partendo dalla stampa vera, senza chiamare un programmatore, è il motivo per cui esiste GPEnext.

## Come la stampa trova il modello

Il gestionale dà a ogni stampa un nome, fatto dal programma di stampa e da un numero di sequenza, per esempio `PPASC13D_1`. La pagina cerca il modello in quest'ordine:

1. il nome esatto della stampa;
2. lo stesso nome senza il numero di sequenza;
3. se esistono modelli per altre sequenze dello stesso documento, apre **Modello di stampa per …** e scegli tu. Con **Ricorda la scelta per questa stampa** non lo chiede più;
4. se non c'è niente, vale «Se manca il modello» qui sotto.

Accanto al messaggio del PDF, **Cambia modello** ti fa scegliere un'altra variante.

## Cambiare il modello dal PDF

1. Sopra il PDF premi **Modifica il modello**. Il designer di GPEnext si apre in un'altra scheda del browser. La sessione e il PDF restano dove sono.
2. Cambia il modello e premi **Pubblica**.
3. Torna alla sessione e premi **Rigenera**: il PDF si aggiorna nella stessa scheda.

Se il modello è uno standard e il tuo livello non permette di cambiarlo, il pulsante diventa **Personalizza il modello**: ne fa una copia tua.

## Se manca il modello

A video resta la stampa com'è arrivata, in XML, e un messaggio dice che per quella stampa non c'è ancora un modello. Non si perde niente.

<table id="bkmrk-pulsante-cosa-fa-cre"><thead><tr><th>Pulsante</th><th>Cosa fa</th></tr></thead><tbody><tr><td>`Crea il modello in GPE-NEXT`</td><td>crea il modello dai dati di questa stampa, col nome esatto, e apre il designer</td></tr><tr><td>**Riprova**</td><td>rimanda la stampa a GPEnext</td></tr><tr><td>**Mostra XML**</td><td>mostra i dati al posto del documento</td></tr></tbody></table>

Dopo aver creato il modello, sistemalo, premi **Pubblica**, torna alla sessione e premi **Riprova**.

<p class="callout warning">**Attenzione.** La stampa usa solo i modelli pubblicati: una bozza del designer non basta.</p>

<p class="callout info">**Nota.** Per modificare un modello serve il livello Utente base in GPEnext, per crearlo Utente avanzato. Senza, i pulsanti non ci sono e il messaggio dice di chiedere a chi gestisce le stampe.</p>

<p class="callout info">**Nota.** La scelta fra le varianti resta nel browser: su un altro PC la rifai.</p>

<p class="callout info">**Nota.** Per designer e modelli vedi Modificare il modello dal PDF (libro «JK - GPEnext», pagina «JK2.4 - Modificare il modello dal PDF») e Se manca il modello (libro «JK - GPEnext», pagina «JK2.3 - Se manca il modello»).</p>

<p class="callout info">**Per chi sviluppa.** Creare, modificare e rigenerare ci sono solo nell'applicazione completa. La scelta della variante è in `frontend/sbh-web/src/session/services/sbh-gpe-scelta.store.ts`.</p>

<p class="callout info">**Per approfondire.**  
• Stampare in PDF con GPE-NEXT dalla sessione SBH: `docs/guide/moduli/sbh-stampa-gpe-next/README.md`</p>

# JH5.7 - Stampe impaginate: Originale, Moderna, Griglia

**In una frase.** Una stampa impaginata che arriva a video si legge in tre modi: com'è stata stampata, in una veste più leggibile, oppure come una griglia da filtrare ed esportare.

Una stampa su carta si guarda e basta. A video puoi ordinarla per una colonna, cercarci dentro, portarla in Excel. È sempre la stessa stampa: il programma l'ha fatta una volta sola.

Sulle stampe impaginate la barra del visualizzatore ha tre pulsanti.

<table id="bkmrk-vista-cosa-vedi-cosa"><thead><tr><th>Vista</th><th>Cosa vedi</th><th>Cosa puoi fare</th></tr></thead><tbody><tr><td>**Originale**</td><td>la pagina com'è stata stampata</td><td>ordinare con un clic sull'intestazione, stampare</td></tr><tr><td>**Moderna**</td><td>la stessa pagina con lo stile dell'applicazione</td><td>lo stesso, con una lettura più comoda</td></tr><tr><td>**Griglia**</td><td>le tabelle della stampa dentro la griglia</td><td>filtri, ricerca, somme, pivot, grafico, Excel</td></tr></tbody></table>

## Moderna

L'impaginazione è la stessa. Cambia l'aspetto: la testata in una scheda, le intestazioni ferme mentre scorri, righe alterne, numeri in colonna, subtotali e totali in evidenza, negativi in rosso. Segue il tema chiaro o scuro.

Un clic sull'intestazione ordina le righe. Totali e subtotali restano al loro posto: si ordinano le righe dentro ogni gruppo. **Stampa** manda la pagina su carta bianca, con le intestazioni ripetute a ogni foglio.

## Griglia

Le tabelle della stampa diventano una griglia come le altre: vedi [Cercare e filtrare](https://gsdoc.genesyssoftware.eu/link/37876). I totali della stampa restano elencati sotto.

![Una stampa nella vista Griglia: le righe raggruppate per spedizioniere e i totali della stampa sotto](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-stampe-impaginate-originale-moderna-griglia-01-vista-griglia.png)

*Una stampa nella vista Griglia: le righe raggruppate per spedizioniere e i totali della stampa sotto*

La schermata è una stampa di prova con dati finti.

## Da dove arrivano queste stampe

Sono le uscite **XML** del pannello di avvio. Il server le manda in due forme: già impaginate, oppure come dati accompagnati dal loro foglio di impaginazione. In questo secondo caso **Mostra XML** fa vedere i dati grezzi e **Mostra documento** torna alla pagina.

Mentre arrivano fogli di stile e logo leggi «Caricamento del layout di stampa…».

<p class="callout info">**Nota.** La prima volta la stampa si apre in **Originale**, poi nell'ultima vista che hai scelto.</p>

<p class="callout info">**Nota.** **Griglia** è spenta se nella stampa non c'è una tabella riconoscibile: lo dice il suggerimento.</p>

<p class="callout info">**Nota.** Se manca un pezzo dell'impaginazione, per esempio il logo, la stampa si vede lo stesso, con l'avviso «Layout incompleto». Per i loghi vedi [Loghi delle ditte nelle stampe](https://gsdoc.genesyssoftware.eu/link/37981).</p>

<p class="callout info">**Nota.** Una stampa ripresa dall'archivio si vede allo stesso modo.</p>

<p class="callout info">**Per chi sviluppa.** Le viste sono in `frontend/sbh-web/src/session/components/sbh-print-styled` e `frontend/sbh-web/src/session/components/sbh-print-modern`. Fogli di stile e loghi li consegna il Ponte col COBOL, solo per i file citati dal server in quella sessione.</p>

<p class="callout info">**Per approfondire.**  
• Client SBH — il pannello Opzioni, le stampe e gli strumenti: `docs/guide/moduli/sbh-stampe-e-strumenti/README.md`</p>

# JH5.8 - Documenti Word, RTF ed Excel

**In una frase.** Le stampe in formati che un browser non sa mostrare si aprono sul PC col loro programma, o escono direttamente dalla stampante, grazie a SBH Helper.

Lettere, contratti e moduli il gestionale li produce spesso in RTF, il formato di Word. Col vecchio programma si aprivano in Word da soli. Qui succede lo stesso, se sul PC c'è SBH Helper.

## Una stampa a video o salvata

<table id="bkmrk-sul-pc-c%27%C3%A8-cosa-succ"><thead><tr><th>Sul PC c'è</th><th>Cosa succede</th></tr></thead><tbody><tr><td>SBH Helper aggiornato</td><td>il documento si apre col programma predefinito (Word, Excel, LibreOffice), senza scaricare niente</td></tr><tr><td>niente SBH Helper, o una versione vecchia</td><td>il documento si scarica; il visualizzatore si apre sul pannello **Scarica** e spiega il formato</td></tr></tbody></table>

Mentre il programma si apre, una barra in basso al centro dice «Apertura sul PC di …» e poi «… aperto sul PC». Puoi continuare a lavorare.

Una copia resta nei **Documenti** della sessione: il pulsante **Apri sul PC** la riapre.

## Una stampa mandata a una stampante

Se nel pannello di avvio scegli una stampante, il documento RTF va stampato, non mostrato.

- **Con SBH Helper aggiornato** esce dalla stampante senza aprire niente a video. La riga dei messaggi dice che è stato inviato in stampa. Se la stampante scelta non c'è fra quelle di Windows, si usa quella predefinita.
- **Con una versione più vecchia** il documento si apre in Word e un avviso dice che non è stato stampato: aggiorna SBH Helper.
- **Senza SBH Helper** si scarica, con lo stesso avviso.

## Le stampe laser

Le stampe in formato laser si scaricano sempre: nessun programma del PC le apre. Per leggerle a video conviene scegliere un'uscita PDF.

<p class="callout warning">**Attenzione.** Se la stampa «non esce», guarda in basso nel browser: può essere stata scaricata. Senza SBH Helper è il comportamento normale.</p>

<p class="callout info">**Nota.** Se SBH Helper non trova un programma per quel formato, compare un avviso e il file si scarica.</p>

<p class="callout info">**Nota.** Ogni documento del visualizzatore ha la sua **X**, che chiude solo quello.</p>

<p class="callout info">**Per chi sviluppa.**  
• L'apertura sul PC c'è da SBH Helper 1.4, la stampa diretta degli RTF dalla 1.5.  
• La stampante virtuale RTF del server non esiste sul PC: la stampa esce dalla predefinita di Windows, come col vecchio programma.  
• I casi sono coperti dai test di `frontend/sbh-web/src/session/services/sbh-session.rtf-spool.spec.ts`. </p>

<p class="callout info">**Per approfondire.**  
• Client SBH — il pannello Opzioni, le stampe e gli strumenti: `docs/guide/moduli/sbh-stampe-e-strumenti/README.md`</p>

# JH5.9 - L'archivio stampe

**In una frase.** L'archivio stampe è lo storico delle stampe sul server: le ritrovi per stampante, utente e data, le rivedi a video e le ristampi.

«Mi rifai la stampa di ieri?» Non serve rilanciare la funzione. La stampa è ancora sul server: la cerchi e la riapri com'era.

1. **Apri l'archivio.** **Opzioni**, scheda **Sessione**, voce **Archivio stampe**. È acceso solo mentre una funzione aspetta un dato.
2. **Cerca.** Scegli la **Stampante d'uscita**, l'**Utente** e le date di creazione, poi **Cerca**. Di partenza le date sono quelle di oggi: allargale per trovare stampe più vecchie.
    
    ![L'archivio stampe: la ricerca per stampante, utente e date, e i flussi trovati](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-l-archivio-stampe-01-ricerca.png)
    
    *L'archivio stampe: la ricerca per stampante, utente e date, e i flussi trovati*
3. **Scegli un flusso.** A sinistra ci sono i flussi trovati, con titolo, uscita e formato. Un clic ne sceglie uno e a destra compaiono i suoi documenti.
4. **Scegli i documenti, se vuoi.** Le caselle a sinistra dicono quali documenti del flusso vedere o ristampare. Nessuna casella vuol dire tutto il flusso.
5. **Usa i comandi in fondo.**
    
    <table><thead><tr><th>Comando</th><th>Cosa fa</th></tr></thead><tbody><tr><td>**Anteprima**</td><td>apre la stampa nel visualizzatore</td></tr><tr><td>**Ristampa**</td><td>la rimanda alla stampante del server scelta nella tendina accanto</td></tr><tr><td>**Proroga 30 gg**</td><td>allunga di trenta giorni la conservazione</td></tr><tr><td>**Elimina**</td><td>cancella il flusso, in due clic: il primo chiede conferma</td></tr></tbody></table>
6. **Chiudi.** La funzione riprende da dove era, col cursore sul campo.

<p class="callout warning">**Attenzione.** **Ristampa**, **Proroga 30 gg** ed **Elimina** agiscono sullo storico vero del server, per tutti.</p>

<p class="callout info">**Nota.** Un «flusso» è una stampa lanciata; dentro può avere più documenti, per esempio una fattura per cliente.</p>

<p class="callout info">**Nota.** Senza un flusso scelto i comandi sono spenti. **Ristampa** si accende solo dopo aver scelto la stampante del server.</p>

<p class="callout info">**Nota.** Dall'anteprima di una stampa in XML puoi chiedere anche il PDF impaginato: vedi [Il PDF di GPEnext: tre strade](https://gsdoc.genesyssoftware.eu/link/37970).</p>

<p class="callout info">**Per chi sviluppa.** L'archivio è `frontend/sbh-web/src/session/components/sbh-spm-archive`. Le sue richieste viaggiano a parte rispetto alla maschera in attesa: il programma non si muove. La guida d'origine prova la ricerca; anteprima, ristampa, proroga ed eliminazione non sono state eseguite sul server di prova.</p>

<p class="callout info">**Per approfondire.**  
• Client SBH — il pannello Opzioni, le stampe e gli strumenti: `docs/guide/moduli/sbh-stampe-e-strumenti/README.md`</p>

# JH6 - Per chi amministra

# JH6.1 - Regole e viste delle griglie

**In una frase.** Chi amministra decide chi può cambiare le regole dei campi e chi può pubblicare viste delle griglie per un ruolo o per tutta l'azienda.

Sono due cose che cambiano il lavoro degli altri. Una regola può rendere un campo obbligatorio per un collega. Una vista aziendale è quella che tutti si trovano davanti. Per questo il permesso lo controlla il Ponte col COBOL, non il browser.

## Le regole dei campi

Per ogni utente e ogni maschera si può dire, campo per campo: non modificabile, obbligatorio, diverso da zero, contenuto nascosto, valore proposto, valori ammessi. Nel gestionale si chiamano regole MUR.

- **Dove si cambiano.** Dalla maschera: Ctrl e clic destro su un campo apre l'editor delle regole. Le stesse voci sono in **Opzioni**, scheda **Avanzate**: **Regole MUR della maschera**, **Duplica regole MUR**, **Elimina regole MUR**.
- **Per chi valgono.** Per un utente e una maschera. Non esiste una regola «per tutti»: si duplicano le regole di un utente sugli altri.
- **Chi può.** Chi nel gestionale ha classe di sicurezza 0 o 1.
- **Chi controlla.** Il Ponte ripete il controllo prima di passare la richiesta al server. Se non hai il permesso leggi «Non sei abilitato a modificare le regole MUR» e al server non arriva niente.

## Le viste condivise

Ognuno salva le sue viste. Quelle **Del ruolo** e **Aziendale** le pubblica solo chi è autorizzato.

![Salva la vista come: Solo mia, Del ruolo, Aziendale](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/salva-la-vista-come-solo-mia-del-ruolo-aziendale.png)

*Salva la vista come: Solo mia, Del ruolo, Aziendale*

- **Chi può pubblicare.** Chi ha classe di sicurezza 0 o 1, oppure un ruolo scelto da chi amministra.
- **Chi le cambia.** Solo chi pubblica. Gli altri ne fanno una copia personale.
- **Cosa resta scritto.** Ogni modifica finisce in un registro: chi, quando, cosa.

La schermata è della pagina di prova delle griglie, con dati finti: lì le due scelte condivise sono spente perché manca il permesso.

## Dove stanno e come si salvano

Le viste sono file in una cartella del Ponte col COBOL. La copia di sicurezza è la copia di quella cartella. Le viste eliminate restano 30 giorni nel cestino. Vedi [Copia di sicurezza delle viste](https://gsdoc.genesyssoftware.eu/link/37983).

<p class="callout warning">**Attenzione.** Le impostazioni del Ponte valgono dal riavvio, e il riavvio chiude le sessioni aperte. Si fa fuori orario.</p>

<p class="callout info">**Per chi sviluppa.**  
• Controllo delle regole: `SBH_MUR_GUARD` (acceso di serie). Con `false` il Ponte passa tutto come prima.  
• Viste: `SBH_VIEWS_ENABLED`, `SBH_VIEWS_PUBLISH_CLASS` (di serie 1), `SBH_VIEWS_PUBLISH_ROLE`. La cartella è `SBH_DATA_DIR`, nei container il volume `sbh_data`.  
• Spento l'archivio, le griglie funzionano con le viste del browser: niente condivisione.  
• Variabili: `docs/devops/ENVIRONMENT.md`. Dettaglio: `docs/sbh-web/MUR-E-VISTE-GRIGLIE.md`.  
• La guida d'origine dichiara che i passi sono coperti da test automatici, non ancora rifatti a mano su un'installazione. </p>

<p class="callout info">**Per approfondire.**  
• Amministrazione: regole MUR e viste delle griglie: `docs/guide/amministrazione/sbh-regole-mur-e-viste/README.md`</p>

# JH6.2 - Server ammessi

**In una frase.** Il Ponte col COBOL si collega solo al server predefinito e a quelli scritti in un elenco: chi amministra decide quali.

Il Ponte apre connessioni verso la rete interna dell'azienda. Se accettasse qualunque indirizzo chiesto dal browser, chiunque potrebbe usarlo per bussare a macchine che col gestionale non c'entrano. L'elenco chiude questa porta.

<div drawio-diagram="2781"><img src="https://gsdoc.genesyssoftware.eu/uploads/images/drawio/2026-11/il-ponte-si-collega-al-server-predefinito-e-a-quelli-in-elenco-e-rifiuta-gli-altri.png" alt="Il Ponte si collega al server predefinito e a quelli in elenco, e rifiuta gli altri"/></div>

*Il Ponte si collega al server predefinito e a quelli in elenco, e rifiuta gli altri*

Come funziona:

- **Il server predefinito** è sempre ammesso. È quello che la pagina di avvio propone.
- **L'elenco** aggiunge gli altri server che l'utente può scegliere. Vuoto vuol dire: solo il predefinito.
- **Fuori dall'elenco** il Ponte rifiuta, e la pagina mostra il motivo.

Come si scrive l'elenco: una voce per server, separate da virgola.

<table id="bkmrk-voce-cosa-ammette-un"><thead><tr><th>Voce</th><th>Cosa ammette</th></tr></thead><tbody><tr><td>un nome di server</td><td>quel server, su qualunque porta</td></tr><tr><td>nome e porta</td><td>quel server, solo su quella porta</td></tr><tr><td>un dominio con l'asterisco davanti</td><td>i server di quel dominio aziendale</td></tr></tbody></table>

Un asterisco da solo non vale: riaprirebbe la porta a tutti. Il confronto è sul testo com'è scritto: un nome e il suo indirizzo numerico sono due voci diverse.

L'utente vede il risultato nella finestra **Server di connessione**, alla riga **Ammessi dal gateway**.

![La finestra Server di connessione, con la riga dei server ammessi](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/la-finestra-server-di-connessione-con-la-riga-dei-server-ammessi.png)

*La finestra Server di connessione, con la riga dei server ammessi*

**Un server solo.** Dove il cliente ha una sola connessione si accende l'accesso unico: le sessioni vanno solo al server predefinito, l'elenco non conta, e la pagina non offre la scelta.

<p class="callout warning">**Attenzione.** Senza server predefinito il Ponte parte ma rifiuta tutte le connessioni. È voluto: meglio fermo che collegato al server sbagliato.</p>

<p class="callout warning">**Attenzione.** L'elenco vale dal riavvio del Ponte, che chiude le sessioni aperte.</p>

<p class="callout info">**Per chi sviluppa.**  
• Variabili: `SBH_HOST`, `SBH_PORT`, `SBH_ALLOWED_HOSTS`, `SBH_ACCESS_ONLY`. Sono descritte in `docs/devops/ENVIRONMENT.md`.  
• La regola è nella classe `SbhTargetPolicy`. Esempi di voci: `host`, `host:porta`, `*.dominio.esempio`, un IPv6 fra parentesi quadre. Il dominio con l'asterisco vuole almeno due livelli.  
• Le pagine da cui il browser può aprire il canale sono in `SBH_ALLOWED_ORIGINS`. </p>

# JH6.3 - Vedere e chiudere le sessioni di tutti

**In una frase.** Chi amministra vede tutte le sessioni tenute dal Ponte col COBOL, di tutti gli utenti, e chiude quelle dimenticate.

Una sessione lasciata aperta da un collega occupa un posto sul server e può tenere bloccato un dato. Prima bisognava aspettare che scadesse. Ora la chiudi tu, in modo ordinato.

1. **Apri l'elenco.** **Opzioni**, scheda **Avanzate**, voce **Sessioni del gateway**. La voce c'è solo per chi ha il ruolo di amministratore sul server del gestionale.
2. **Leggi le righe.** Una riga per sessione.
    
    <table><thead><tr><th>Colonna</th><th>Cosa dice</th></tr></thead><tbody><tr><td>stato</td><td>collegata, in sospeso, in uscita</td></tr><tr><td>utente, postazione, indirizzo, browser</td><td>di chi è e da dove</td></tr><tr><td>in funzione</td><td>se è dentro una funzione, quindi con lavoro a metà</td></tr><tr><td>in sospeso da, scadenza</td><td>da quanto è senza pagina e quando verrà chiusa</td></tr><tr><td>ultima attività</td><td>l'ultimo scambio col server</td></tr></tbody></table>
3. **Chiudi quella che serve.** L'icona di spegnimento sulla riga, poi la conferma. Il server chiude i suoi programmi: la connessione e i dati bloccati si liberano.

Se il server sta ancora elaborando per quella sessione, il Ponte risponde che non è il momento. La pagina chiede una **seconda conferma** e, se insisti, chiude lo stesso.

<p class="callout warning">**Attenzione.** Chiudere una sessione che è dentro una funzione fa perdere a quell'utente il lavoro non confermato. Chiudere durante un'elaborazione la interrompe a metà. Prima avvisa la persona, se puoi.</p>

<p class="callout info">**Nota.** Il ruolo non lo dichiara il browser: lo legge il Ponte da quello che il server manda all'accesso. La richiesta vale solo da una sessione collegata.</p>

<p class="callout info">**Nota.** L'utente comune ha la sua finestra, limitata alle proprie sessioni: vedi [Le tue sessioni aperte](https://gsdoc.genesyssoftware.eu/link/37953).</p>

<p class="callout info">**Per chi sviluppa.**  
• Il ruolo è `SBH_ADMIN_ROLE`, di serie `SYSADMN`. Vuoto, la funzione è spenta.  
• L'elenco mostra anche quanta memoria occupa ogni sessione per il rientro. Non mostra mai le chiavi di rientro.  
• La pagina è `frontend/sbh-web/src/session/components/sbh-gateway-admin`.  
• La guida d'origine dichiara che il comportamento è coperto dai test del Ponte, non ancora provato passo passo sul server vero. </p>

<p class="callout info">**Per approfondire.**  
• SBH — sessioni che non si perdono (standby, scheda chiusa, SBH Helper): `docs/guide/moduli/sbh-sessioni-che-non-si-perdono/README.md`</p>

# JH6.4 - Loghi delle ditte nelle stampe

**In una frase.** Chi amministra carica il logo di ogni ditta, e le stampe a video lo mostrano al posto giusto.

Le stampe impaginate del gestionale portano in testa il logo della ditta. Il vecchio programma lo leggeva da una cartella del PC. Una pagina del browser non può: il logo glielo consegna il Ponte col COBOL, e qualcuno deve averglielo dato.

1. **Apri la finestra.** **Opzioni**, scheda **Avanzate**, voce **Stampe › Loghi delle ditte**. C'è solo per chi ha il ruolo di amministratore sul server del gestionale.
2. **Scegli il server.** Di partenza è quello della sessione. Puoi scegliere gli altri server del Ponte.
3. **Guarda l'elenco.** Le ditte che hanno un logo, con anteprima, tipo, dimensione e data.
4. **Carica o sostituisci.**
    
    <table><thead><tr><th>Comando</th><th>Cosa fa</th></tr></thead><tbody><tr><td>**Aggiungi ditta**</td><td>chiede il numero della ditta, poi il file</td></tr><tr><td>**Carica logo…** o **Sostituisci…**</td><td>scegli il file e ne vedi l'anteprima</td></tr><tr><td>**Salva**</td><td>manda il logo al Ponte</td></tr><tr><td>il cestino</td><td>toglie il logo, dopo la conferma</td></tr></tbody></table>

Da quel momento, quando una stampa chiede il logo di quella ditta, riceve quello caricato.

## Cosa succede se il logo manca

La stampa cerca nell'ordine: il logo caricato qui, poi quello nella cartella condivisa del server, se il Ponte la raggiunge. Se non trova niente si vede lo stesso, senza logo, con l'avviso «Layout incompleto».

## Con GPEnext acceso

Dentro l'applicazione completa, con GPEnext in funzione, sotto la spiegazione leggi che i loghi sono gestiti dal centro ditte di GPEnext. Sono gli stessi per ogni server e gli stessi dei PDF impaginati: si caricano una volta sola. Se GPEnext non risponde la finestra lo dice in rosso e non salva.

<p class="callout info">**Nota.** Il file può essere PNG, JPEG o GIF, al massimo 2 MB. Un file SVG o troppo grande viene rifiutato con un messaggio, senza salvare niente.</p>

<p class="callout info">**Nota.** Fogli di stile e fogli di impaginazione delle stampe il Ponte li ha già con sé: le stampe hanno il loro aspetto anche quando non raggiunge la cartella condivisa.</p>

<p class="callout info">**Nota.** Il logo della ditta nelle stampe non è il logo della connessione: quello lo sceglie ogni utente per riconoscere il server. Vedi [Logo, colore e ordine delle connessioni](https://gsdoc.genesyssoftware.eu/link/37948).</p>

<p class="callout info">**Per chi sviluppa.** La finestra è `frontend/sbh-web/src/session/components/sbh-spm-logos`. Con GPEnext i loghi passano dal Gateway con l'identità dell'utente: `frontend/sbh-web/src/session/services/sbh-spm-logos.service.ts`.</p>

<p class="callout info">**Per approfondire.**  
• Client SBH — il pannello Opzioni, le stampe e gli strumenti: `docs/guide/moduli/sbh-stampe-e-strumenti/README.md`</p>

# JH6.5 - Tempi e limiti delle sessioni

**In una frase.** Chi amministra decide per quanto tempo una sessione senza pagina resta aperta, quante se ne possono lasciare in sospeso e cosa succede alla scadenza.

Sono scelte fra due esigenze. Tempi lunghi proteggono il lavoro di chi chiude il PC a metà. Tempi corti liberano prima i posti sul server. I valori previsti provano a tenere insieme le due cose.

## I tempi

<table id="bkmrk-dove-era-la-sessione"><thead><tr><th>Dove era la sessione</th><th>Valore previsto</th><th>Perché</th></tr></thead><tbody><tr><td>dentro una funzione</td><td>16 ore</td><td>c'è lavoro a metà: deve reggere una notte</td></tr><tr><td>sul menu, o alla richiesta di accesso</td><td>30 minuti</td><td>non c'è niente da perdere</td></tr></tbody></table>

Il tempo si conta da quando il browser si è staccato. Dove era la sessione lo capisce il Ponte da solo, dai messaggi del server.

## Alla scadenza

Il Ponte esce in modo ordinato, come farebbe **Esci**. Al rientro la pagina dice che la sessione non c'è più.

Se in quel momento il server sta ancora elaborando, l'uscita si rinvia: interromperla lascerebbe l'elaborazione a metà. Il rinvio dura al massimo 15 minuti, poi si esce comunque.

## I limiti

- **Cinque sessioni in sospeso per postazione.** Alla sesta l'utente deve riprenderne o chiuderne una.
- **Memoria per il rientro.** Per ogni sessione il Ponte tiene gli ultimi messaggi del server, per rimandarli alla pagina che rientra. Se una pagina resta troppo indietro il rientro viene rifiutato, ma la sessione non si chiude: resta in sospeso e si chiude a mano.

## Cosa non si recupera mai

- le sessioni aperte quando il Ponte viene riavviato o aggiornato: si chiudono in modo ordinato;
- una sessione chiusa dal server del gestionale;
- una sessione oltre il suo tempo.

<p class="callout warning">**Attenzione.** Ogni cambio vale dal riavvio del Ponte, e il riavvio chiude le sessioni aperte. Si fa fuori orario.</p>

<p class="callout info">**Per chi sviluppa.**  
• Tempi: `SBH_RESUME_SECONDS` (57600) e `SBH_RESUME_MENU_SECONDS` (1800). Senza variabile il Ponte usa 900 secondi: il valore lungo lo propone `devops/deploy/docker-compose.deploy.yml`.  
• Rinvio dell'uscita: `SBH_EXIT_IDLE_SECONDS` (30) e `SBH_EXIT_DEFER_MAX_SECONDS` (900). Con 0 non si rinvia mai.  
• Limite: `SBH_MAX_PARKED_PER_CLIENT` (5; con 0 nessun limite).  
• Memoria: `SBH_LOG_MAX_MB` (64 per sessione) e `SBH_LOG_TOTAL_MB` (256 in tutto).  
• `SBH_RESUME_UNLOAD_SECONDS` è ritirata: viene letta e ignorata.  
• Registro delle variabili: `docs/devops/ENVIRONMENT.md`. Piano: `docs/sbh-web/PIANO-SESSIONI-LUNGHE.md`. </p>

<p class="callout info">**Per approfondire.**  
• SBH — sessioni che non si perdono (standby, scheda chiusa, SBH Helper): `docs/guide/moduli/sbh-sessioni-che-non-si-perdono/README.md`</p>

# JH6.6 - Copia di sicurezza delle viste

**In una frase.** Le viste delle griglie sono file in una cartella del Ponte col COBOL: per non perderle basta copiare quella cartella, e per riaverle rimetterla al suo posto.

Una vista aziendale può valere ore di lavoro: colonne scelte, formule, colori. Sapere dove sta e come si salva evita di ricostruirla dopo un aggiornamento andato male.

## Dove stanno

Dentro la cartella dei dati del Ponte c'è una cartella delle viste, divisa per server e poi per griglia. Per ogni griglia trovi:

<table id="bkmrk-cosa-a-cosa-serve-un"><thead><tr><th>Cosa</th><th>A cosa serve</th></tr></thead><tbody><tr><td>un file per vista</td><td>la vista salvata</td></tr><tr><td>le predefinite personali</td><td>quale vista si apre da sola per ogni utente</td></tr><tr><td>il registro</td><td>chi ha scritto cosa e quando</td></tr><tr><td>il cestino</td><td>le viste eliminate, tenute 30 giorni</td></tr><tr><td>la quarantena</td><td>i file illeggibili trovati all'avvio</td></tr></tbody></table>

Le viste sono separate per server: quelle salvate su un'installazione non si vedono da un'altra.

## Fare la copia

Copia la cartella dei dati, oppure il volume che la contiene se il Ponte gira in un container. È tutto lì.

## Ripristinare

1. Ferma il Ponte.
2. Rimetti la cartella copiata al suo posto.
3. Riavvia. L'elenco delle viste si ricostruisce leggendo i file. Quelli illeggibili finiscono in quarantena, con un avviso nel registro del servizio.

Per una griglia sola c'è una strada più semplice: chi può pubblicare usa **Esporta…** e **Importa…** dal menu delle viste, anche per le viste degli altri.

## Spegnere l'archivio delle viste

Si può spegnere. Le griglie continuano a funzionare con le viste salvate nel browser di ognuno: niente condivisione, niente viste che seguono l'utente da un PC all'altro. Il menu delle viste lo segnala con l'icona «Viste salvate solo in questo browser». I file restano dove sono e riaccendendo si riparte da lì.

Lo stesso succede da solo se la cartella non è scrivibile: il Ponte lo scrive nel registro all'avvio.

<p class="callout warning">**Attenzione.** Senza un volume dedicato le viste si perdono ogni volta che il container viene ricreato, per esempio a un aggiornamento.</p>

<p class="callout warning">**Attenzione.** I nomi delle cartelle sono codificati: non si rinominano a mano.</p>

<p class="callout info">**Per chi sviluppa.**  
• Cartella: `SBH_DATA_DIR` (nei container `/app/data`, volume `sbh_data`), sottocartella `views`. Archivio: `SBH_VIEWS_ENABLED`.  
• Limiti: `SBH_VIEWS_MAX_KB` (64), `SBH_VIEWS_MAX_PER_USER_MASK` (50), `SBH_VIEWS_MAX_PER_MASK` (2000).  
• Le viste delle pagine nuove hanno la stessa forma in SIGEAnext (`SIGEA_DATA_DIR`, volume `sigea_data`).  
• Comandi di copia e ripristino dei volumi: nella guida qui sotto. Dettaglio: `docs/sbh-web/MUR-E-VISTE-GRIGLIE.md`. </p>

<p class="callout info">**Per approfondire.**  
• Amministrazione: regole MUR e viste delle griglie: `docs/guide/amministrazione/sbh-regole-mur-e-viste/README.md`</p>

# JH7 - Tastiera, messaggi e notifiche

# JH7.1 - Scorciatoie da tastiera

**In una frase.** Un tasto mostra tutte le scorciatoie valide in quel momento; altre scorciatoie cambiano scheda e ti fanno ritrovare il cursore.

Con la tastiera si lavora più in fretta che col mouse, ma nessuno vuole imparare un elenco a memoria. Qui l'elenco te lo fa vedere la pagina, e mostra solo quello che puoi usare adesso.

## L'elenco delle scorciatoie

Premi **?** fuori da un campo di testo, oppure tieni premuto **Alt** per più di mezzo secondo. Compare un pannello traslucido sopra la maschera, che resta com'è sotto. Le scorciatoie sono a gruppi.

<table id="bkmrk-gruppo-cosa-elenca-s"><thead><tr><th>Gruppo</th><th>Cosa elenca</th></tr></thead><tbody><tr><td>**Schede**</td><td>scheda precedente e successiva, Ctrl con un numero</td></tr><tr><td>**Sessione**</td><td>Esci, Conferma, Guida e Cerca coi tasti che hai scelto, F7, F8</td></tr><tr><td>**Maschera**</td><td>i tasti funzione che il programma accetta nel campo dove sei</td></tr></tbody></table>

Si chiude con Esc, rilasciando Alt, con un clic fuori o con **?** di nuovo. Lo apri anche da **Opzioni**, scheda **Strumenti**, voce **Scorciatoie**, e dal collegamento nella pagina di avvio.

## Cambiare scheda

<table id="bkmrk-tasto-cosa-fa-ctrl%2B%E2%86%92"><thead><tr><th>Tasto</th><th>Cosa fa</th></tr></thead><tbody><tr><td>**Ctrl+→**</td><td>scheda successiva; dall'ultima torna alla prima</td></tr><tr><td>**Ctrl+←**</td><td>scheda precedente</td></tr><tr><td>**Ctrl+1** … **Ctrl+9**</td><td>va alla scheda con quel numero; Ctrl+9 all'ultima</td></tr></tbody></table>

## Ritrovare il cursore

Premi e rilascia **Ctrl** da solo: un cerchio colorato compare attorno al campo dove sei, si stringe e sparisce in meno di un secondo. Vale anche per la cella di una griglia e per i campi delle finestre.

## Le altre da ricordare

<table id="bkmrk-tasto-cosa-fa-ctrl%2Bk"><thead><tr><th>Tasto</th><th>Cosa fa</th></tr></thead><tbody><tr><td>**Ctrl+K**</td><td>apre Cerca ovunque</td></tr><tr><td>**Alt+Maiusc+B**</td><td>spegne e riaccende la barra dei comandi</td></tr><tr><td>Maiuscolo e clic destro</td><td>scheda tecnica del campo</td></tr><tr><td>Ctrl e clic destro</td><td>regole del campo, per chi può modificarle</td></tr></tbody></table>

<p class="callout info">**Nota.** Dentro un campo di testo **?** resta un carattere.</p>

<p class="callout info">**Nota.** Con più schede aperte, Ctrl con le frecce dentro un campo non salta più di una parola: cambia scheda. Con una scheda sola il tasto resta del campo.</p>

<p class="callout info">**Nota.** I tasti delle schede si cambiano in **Opzioni**, **Strumenti**, **Tasti funzione**, sotto «Schede». Nella stessa finestra le caselle **Ctrl+1…9 va alla scheda** e **Ctrl evidenzia il cursore** accendono e spengono le due scorciatoie.</p>

<p class="callout info">**Nota.** Ctrl premuto insieme a un altro tasto, come per copiare e incollare, non fa comparire il cerchio.</p>

<p class="callout info">**Per chi sviluppa.** Il pannello è `frontend/sbh-web/src/session/components/sbh-shortcuts-overlay`, la scelta dei tasti `frontend/sbh-web/src/session/components/sbh-key-settings`. Ctrl con le frecce è libero perché il programma COBOL non usa le frecce a sinistra e a destra.</p>

<p class="callout info">**Per approfondire.**  
• Client SBH — il pannello Opzioni, le stampe e gli strumenti: `docs/guide/moduli/sbh-stampe-e-strumenti/README.md`</p>

# JH7.2 - I messaggi del programma

**In una frase.** Il programma ti parla in tre modi: una finestra che aspetta la tua risposta, una riga in basso per le informazioni, una nota rossa sotto il campo sbagliato.

Sono i messaggi di sempre, con le parole di sempre. Sapere quale dei tre stai guardando ti dice se il programma è fermo ad aspettarti oppure no.

<table id="bkmrk-forma-quando-compare"><thead><tr><th>Forma</th><th>Quando compare</th><th>Il programma aspetta?</th></tr></thead><tbody><tr><td>finestra</td><td>avviso, errore, domanda di conferma</td><td>sì, finché rispondi</td></tr><tr><td>riga dei messaggi</td><td>informazioni, per esempio «Risorsa prenotata»</td><td>no</td></tr><tr><td>nota rossa in basso</td><td>il valore del campo non va bene</td><td>resta sul campo</td></tr></tbody></table>

## La finestra

Il titolo dice il tipo: «Attenzione», «Errore», «Conferma». La chiudi con **OK**. Invio ed Esc la chiudono lo stesso, e al programma arriva il tasto che hai premuto.

## La domanda di conferma

Prima di una cancellazione o di un aggiornamento il programma chiede «Confermi…?». La finestra **Conferma**ha due pulsanti affiancati.

<table id="bkmrk-pulsante-tasto-cosa-"><thead><tr><th>Pulsante</th><th>Tasto</th><th>Cosa risponde al programma</th></tr></thead><tbody><tr><td>**OK**</td><td>Invio, o il tuo tasto Conferma</td><td>sì, procedi</td></tr><tr><td>**Annulla**</td><td>Esc, o il tuo tasto Esci</td><td>no, lascia tutto com'era</td></tr></tbody></table>

All'apertura il cursore è su **OK**. Se il programma propone anche un tasto funzione, il suo pulsante sta fra i due.

## Spostare la finestra

Col mouse la trascini dalla barra del titolo, per leggere i campi che copre. Su telefono e tablet resta ferma.

<p class="callout warning">**Attenzione.** In una domanda di conferma Invio vale **OK**. Se non sei sicuro, leggi prima di premere: una cancellazione confermata è fatta.</p>

<p class="callout info">**Nota.** Se sposti il cursore su **Annulla** e premi Invio, vale Annulla.</p>

<p class="callout info">**Nota.** Le informazioni che non chiedono risposta non aprono finestre: vedi [La riga dei messaggi](https://gsdoc.genesyssoftware.eu/link/37986).</p>

<p class="callout info">**Per chi sviluppa.** La finestra è `frontend/sbh-web/src/session/components/sbh-message`. La guida d'origine non ha potuto provare i messaggi sul server di prova, perché usa solo funzioni in interrogazione: il comportamento viene dai test automatici.</p>

<p class="callout info">**Per approfondire.**  
• Il client web del legacy SBH — menu e maschere: `docs/guide/moduli/sbh-menu-e-maschere/README.md`</p>

# JH7.3 - La riga dei messaggi

**In una frase.** Le informazioni del programma e gli avvisi della pagina compaiono in una riga in basso, che resta finché non arriva il messaggio dopo e tiene lo storico della sessione.

Un messaggio che sparisce dopo tre secondi lo perdi se stavi guardando altrove. Questa riga resta. E non copre la maschera: le toglie soltanto una riga in fondo.

Sta subito sopra la barra in basso, a tutta larghezza. A sinistra ha l'icona del tono (cerchio per un'informazione, triangolo per un avviso) e l'ora, poi il testo.

## Nasconderla e riaprirla

- La **×** a destra **nasconde la riga**, non chiude il messaggio.
- Al suo posto, nella barra in basso, resta l'icona dei messaggi col numero di quelli ancora aperti. È arancione se l'ultimo è un avviso.
- Un clic sull'icona riapre la riga. Il messaggio successivo la riapre da solo.

## Più messaggi insieme

La riga mostra l'ultimo. Se ce ne sono altri ancora aperti, a destra leggi **+N**. Senza altri aperti leggi **N messaggi**: è lo storico.

Un clic sul contatore apre **Messaggi della sessione**: gli ultimi 20 messaggi della scheda, dal più recente, con ora, tono e testo.

<table id="bkmrk-comando-cosa-fa-la-%C3%97"><thead><tr><th>Comando</th><th>Cosa fa</th></tr></thead><tbody><tr><td>la **×** accanto a un messaggio</td><td>lo chiude davvero: esce dalla riga</td></tr><tr><td>**Chiudi tutti**</td><td>svuota la riga, non lo storico</td></tr></tbody></table>

I messaggi chiusi restano nello storico, in grigio, finché la scheda è aperta.

## Cosa resta e cosa se ne va

- Le informazioni del programma restano finché ne arriva un'altra.
- Gli avvisi che chiedono attenzione restano anche sotto i messaggi successivi.
- Le conferme semplici della pagina, come «inviato in stampa» o «N righe importate», escono dalla riga da sole dopo 30 secondi e restano nello storico.

<p class="callout info">**Nota.** Ogni scheda ha la sua riga: cambiando scheda cambiano i messaggi. Per vedere quelli di tutte le schede c'è la campanella: vedi [Le notifiche](https://gsdoc.genesyssoftware.eu/link/37987).</p>

<p class="callout info">**Nota.** Era la barra di stato del vecchio programma.</p>

<p class="callout info">**Per chi sviluppa.** La riga è `frontend/sbh-web/src/session/components/sbh-message-bar`.</p>

<p class="callout info">**Per approfondire.**  
• Il client web del legacy SBH — menu e maschere: `docs/guide/moduli/sbh-menu-e-maschere/README.md`</p>

# JH7.4 - Le notifiche

**In una frase.** La campanella nella barra in basso raccoglie quello che succede in tutte le schede: messaggi, stampe arrivate, sessioni in sospeso.

Con due o tre sessioni aperte guardi una scheda alla volta. Se nell'altra finisce una stampa o compare un avviso, non lo vedi. La campanella te lo dice, e ti porta lì con un clic.

Sta nella barra delle schede, subito dopo il **+**. È una sola per pagina. Il numero sopra dice quante voci non hai ancora letto.

## Cosa raccoglie

- i **messaggi** della riga dei messaggi, con la scheda da cui vengono;
- le **stampe** e i documenti arrivati nel pannello **Documenti**;
- le **sessioni in sospeso** trovate all'ingresso.

## Come si usa

1. **Fai clic sulla campanella.** Si apre **Notifiche**: le ultime 50 voci, dalla più recente, divise in **Oggi**, **Ieri** e **Prima**.
2. **Leggi la voce.** Ora, scheda, tipo e testo. Le non lette sono in grassetto, con un pallino.
3. **Filtra, se sono tante.** **Tutte**, **Messaggi**, **Stampe**, **Sessioni**.
4. **Fai clic su una voce.**
    
    <table><thead><tr><th>Tipo di voce</th><th>Dove ti porta</th></tr></thead><tbody><tr><td>messaggio</td><td>alla scheda da cui viene</td></tr><tr><td>stampa</td><td>alla scheda, col pannello **Documenti** aperto su quel documento</td></tr><tr><td>sessione in sospeso</td><td>alla finestra **Le tue sessioni aperte**</td></tr></tbody></table>
5. **Fai pulizia.** **Segna tutte lette** toglie il numero dalla campanella.

Una voce si segna letta anche da sola quando la vedi: il messaggio mostrato nella riga della scheda che hai davanti, la stampa aperta nel visualizzatore.

<p class="callout info">**Nota.** Le voci di una scheda che hai chiuso restano in grigio fino alla ricarica della pagina. Il clic non porta da nessuna parte.</p>

<p class="callout info">**Nota.** Il browser non manda notifiche di sistema: la campanella vive dentro la pagina.</p>

<p class="callout info">**Nota.** Con lo schermo diviso fra due sessioni la campanella sta nella barra della scheda di sinistra.</p>

<p class="callout info">**Per chi sviluppa.** Il pannello è `frontend/sbh-web/src/session/components/sbh-notifications`, il servizio `frontend/sbh-web/src/session/services/sbh-notifications.service.ts`.</p>

<p class="callout info">**Per approfondire.**  
• Il client web del legacy SBH — menu e maschere: `docs/guide/moduli/sbh-menu-e-maschere/README.md`</p>

# JH8 - Preferiti, promemoria e note

# JH8.1 - Preferiti, Recenti e Più usate

**In una frase.** Le funzioni che usi sempre le ritrovi senza cercarle: quelle che segni con la stella, le ultime che hai aperto e quelle che apri più spesso.

Ognuno usa davvero dieci o venti funzioni su centinaia. Averle davanti appena entri, già col tipo di lavoro giusto, vuol dire non scorrere più il menu.

## Mettere una funzione fra i Preferiti

1. Scegli la funzione nel menu.
2. Nel pannello di avvio premi la **stella** accanto al titolo: diventa piena e colorata.
    
    ![Il pannello di avvio con la stella accesa; accanto, il libro del manuale](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-preferiti-recenti-e-piu-usate-01-stella-e-libro.png)
    
    *Il pannello di avvio con la stella accesa; accanto, il libro del manuale*

Un secondo clic sulla stella la toglie. Il preferito ricorda il tipo di lavoro che era scelto in quel momento.

## Dove li ritrovi

Nel **benvenuto**, la pagina che vedi appena entri o cambi modulo, e in cima al menu a sinistra.

![Il benvenuto: Preferiti, Recenti e Più usate degli ultimi 30 giorni](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-preferiti-recenti-e-piu-usate-02-benvenuto.png)

*Il benvenuto: Preferiti, Recenti e Più usate degli ultimi 30 giorni*

<table id="bkmrk-sezione-cosa-contien"><thead><tr><th>Sezione</th><th>Cosa contiene</th></tr></thead><tbody><tr><td>**Preferiti**</td><td>le funzioni con la stella, anche di altri moduli</td></tr><tr><td>**Recenti**</td><td>le funzioni avviate da poco</td></tr><tr><td>**Più usate**</td><td>le otto avviate più volte negli ultimi 30 giorni, col numero di avvii</td></tr></tbody></table>

Ogni riga porta l'icona del tipo di lavoro con cui l'hai usata.

## Aprirle

- **Un clic** sceglie la voce e apre il suo pannello di avvio. Se è di un altro modulo, il menu cambia modulo da solo.
- **Doppio clic** la avvia subito, col tipo di lavoro ricordato.

Il benvenuto mostra anche il modulo, l'utente, l'uscita predefinita e un promemoria dei tasti del menu.

<p class="callout info">**Nota.** Il tipo di lavoro ricordato vale solo se la funzione lo ammette ancora. Altrimenti il pannello propone quello di sempre.</p>

<p class="callout info">**Nota.** Una funzione usata molto il mese scorso e mai in questo esce da sola dalle **Più usate**. I tre puntini accanto al titolo offrono **Dimentica le più usate**.</p>

<p class="callout info">**Nota.** Preferiti, Recenti e Più usate stanno nel browser, separati per server.</p>

<p class="callout info">**Per chi sviluppa.** Il benvenuto è parte di `frontend/sbh-web/src/session/components/sbh-launcher`. Le Più usate tengono le date degli avvii, non un contatore: `frontend/sbh-web/src/session/services/sbh-menu-usage.store.ts`.</p>

<p class="callout info">**Per approfondire.**  
• Il client web del legacy SBH — menu e maschere: `docs/guide/moduli/sbh-menu-e-maschere/README.md`</p>

# JH8.2 - Cartelle dei preferiti

**In una frase.** I preferiti si raccolgono in cartelle con il nome che vuoi, e si portano su un altro PC o a un collega con un file.

Con trenta preferiti l'elenco torna a essere un menu da scorrere. Le cartelle li dividono per lavoro: «Fine mese», «Ordini», «Controlli del lunedì».

## Mettere un preferito in una cartella

1. **Clic destro sul preferito**, nel benvenuto o in cima al menu.
2. **Sposta in…**, poi scegli.
    
    <table><thead><tr><th>Scelta</th><th>Cosa fa</th></tr></thead><tbody><tr><td>una cartella che c'è già</td><td>sposta il preferito lì</td></tr><tr><td>**Nuova cartella…**</td><td>chiede il nome, crea la cartella e ci mette il preferito</td></tr><tr><td>**Fuori dalle cartelle**</td><td>lo riporta fra quelli senza cartella</td></tr></tbody></table>

La cartella è un'intestazione che si apre e si chiude con un clic. Nel menu anche con le frecce: destra apre, sinistra chiude. Lo stato, aperta o chiusa, viene ricordato.

## Sistemare le cartelle

Dallo stesso menu del clic destro: **Rinomina cartella** ed **Elimina cartella**. Eliminando la cartella i preferiti restano, senza cartella.

## Portarli su un altro PC

I tre puntini accanto al titolo **Preferiti**, o il clic destro sul titolo, offrono due comandi.

<table id="bkmrk-comando-cosa-fa-espo"><thead><tr><th>Comando</th><th>Cosa fa</th></tr></thead><tbody><tr><td>**Esporta i preferiti…**</td><td>scarica un file con tutti i preferiti e le loro cartelle</td></tr><tr><td>**Importa preferiti…**</td><td>aggiunge le voci del file a quelle che hai già</td></tr></tbody></table>

L'importazione non fa doppioni: una voce che c'è già resta com'è. La riga dei messaggi dice quante se ne sono aggiunte.

È anche il modo per dare a un collega nuovo l'elenco delle funzioni che gli servono, già ordinato.

<p class="callout info">**Nota.** Le cartelle hanno un solo livello: niente cartelle dentro cartelle.</p>

<p class="callout info">**Nota.** I preferiti salvati prima di usare le cartelle restano dov'erano: senza cartella, sopra le cartelle.</p>

<p class="callout info">**Nota.** Preferiti e cartelle sono salvati nel browser, separati per server. Il file esportato porta nel nome il server e l'utente.</p>

<p class="callout info">**Per chi sviluppa.** Il menu del clic destro è `frontend/sbh-web/src/session/components/sbh-memo-actions`; i dati sono in `frontend/sbh-web/src/session/services/sbh-menu-memo.store.ts`.</p>

<p class="callout info">**Per approfondire.**  
• Il client web del legacy SBH — menu e maschere: `docs/guide/moduli/sbh-menu-e-maschere/README.md`</p>

# JH8.3 - Promemoria su una funzione

**In una frase.** A una funzione attacchi un promemoria con giorno e ora: quando è il momento lo trovi in evidenza appena entri.

Certe funzioni si fanno a scadenza: la chiusura del venerdì, il controllo del primo del mese. Il promemoria sta attaccato alla funzione, così da lì la apri con un clic.

1. **Clic destro sulla funzione** nel menu, oppure su un preferito. Scegli **Promemoria…**.
2. **Scegli giorni e ora.** La finestra propone oggi e le 9:00. Puoi segnare più giorni della settimana: il promemoria si ripete.
3. **Scrivi una nota, se vuoi.** Per esempio «prima stampare il brogliaccio».
4. **Salva.**

## Dove li vedi

Nel benvenuto, sopra i Preferiti, la sezione **Promemoria** elenca nell'ordine:

- quelli **scaduti**, in evidenza in arancione;
- quelli di **oggi**;
- i **prossimi**.

Quando apri la sessione, se ce n'è uno scaduto lo dice una volta la riga dei messaggi.

## Cosa fare con un promemoria

<table id="bkmrk-azione-cosa-succede-"><thead><tr><th>Azione</th><th>Cosa succede</th></tr></thead><tbody><tr><td>clic sulla riga</td><td>sceglie la funzione, come un preferito</td></tr><tr><td>**Fatto** (la spunta)</td><td>lo rimanda alla ricorrenza successiva</td></tr><tr><td>il cestino</td><td>lo elimina</td></tr></tbody></table>

Se premi **Fatto** in anticipo, il promemoria salta alla volta dopo.

<p class="callout info">**Nota.** Il promemoria non manda notifiche di Windows e non suona: lo vedi dentro SBHweb, quando entri.</p>

<p class="callout info">**Nota.** Si mette solo sulle funzioni, non sui rami del menu.</p>

<p class="callout info">**Nota.** I promemoria stanno nel browser, separati per server. Su un altro PC non li ritrovi.</p>

<p class="callout info">**Nota.** Per far partire un lavoro da solo a un'ora precisa, senza nessuno davanti, non serve un promemoria: servono le Macro/Workflow SBH. Vedi Cosa si può automatizzare (libro «JI - Macro/Workflow SBH», pagina «JI1.1 - Cosa si può automatizzare»).</p>

<p class="callout info">**Per chi sviluppa.** I promemoria sono in `frontend/sbh-web/src/session/services/sbh-reminders.store.ts`.</p>

<p class="callout info">**Per approfondire.**  
• Il client web del legacy SBH — menu e maschere: `docs/guide/moduli/sbh-menu-e-maschere/README.md`</p>

# JH8.4 - Note di reparto

**In una frase.** A ogni maschera puoi attaccare una nota con le regole del tuo ufficio, e passarla ai colleghi con un file.

La guida del campo dice cosa vuole il programma. Non dice come lavorate voi: «per i clienti esteri il codice IVA è sempre 22». Di solito queste regole stanno su un foglietto attaccato al monitor. Qui stanno attaccate alla maschera giusta.

## Scrivere una nota

1. **Apri la funzione** e arriva sulla maschera che ti interessa.
2. **Premi F7.** Sotto la mini-guida del campo c'è il riquadro delle note di quella maschera. Lo stesso riquadro è in fondo al pannello **Documenti**, finché una maschera è a video.
3. **Scrivi e premi Salva.** La nota prende la data e il tuo utente.

Per toglierla, cancella il testo e premi **Salva**.

## Passarla ai colleghi

<table id="bkmrk-comando-cosa-fa-cond"><thead><tr><th>Comando</th><th>Cosa fa</th></tr></thead><tbody><tr><td>**Condividi**</td><td>scarica in un file tutte le note di quel server</td></tr><tr><td>**Importa**</td><td>unisce le note di un file alle tue</td></tr></tbody></table>

Se una maschera ha una nota sia nel file sia da te, vince la più recente. Un messaggio dice quante sono nuove, quante aggiornate e quante tenute.

## Cosa sapere

- La nota è della **maschera**, non del campo: la rivedi ogni volta che apri quella maschera, in qualunque campo sei.
- Vale per quel server: la stessa maschera su un altro server ha le sue note.
- Non cambia niente nel programma: è un appunto, non un controllo. Per rendere un campo obbligatorio o bloccarlo ci sono le regole dei campi: vedi [Regole e viste delle griglie](https://gsdoc.genesyssoftware.eu/link/37883).

<p class="callout warning">**Attenzione.** Le note stanno nel tuo browser. Non arrivano da sole ai colleghi e non le ritrovi su un altro PC: passano solo con **Condividi** e **Importa**. Il salvataggio sul server è previsto ma non c'è ancora.</p>

<p class="callout info">**Per chi sviluppa.** Il riquadro è `frontend/sbh-web/src/session/components/sbh-notes`, i dati sono in `frontend/sbh-web/src/session/services/sbh-notes.store.ts`, scritto in modo da poter spostare le note sul server senza cambiare il resto.</p>

<p class="callout info">**Per approfondire.**  
• Il client web del legacy SBH — menu e maschere: `docs/guide/moduli/sbh-menu-e-maschere/README.md`</p>

# JH8.5 - Registrare una procedura

**In una frase.** Mentre fai un lavoro, SBHweb scrive per te la guida passo passo con le schermate: alla fine la scarichi e la dai a un collega.

Spiegare a qualcuno «come si fa la chiusura» vuol dire scrivere pagine e fare schermate a mano. Qui fai il lavoro una volta, e la guida è pronta.

1. **Avvia la registrazione.** **Opzioni**, scheda **Automazione**, **Registra procedura…**. Scrivi un titolo, obbligatorio, e una descrizione. Premi **Registra**.
2. **Lavora come sempre.** Nella barra in basso compare l'indicatore rosso **REC** col tempo e il numero dei passi. Puoi cominciare dal menu o con una funzione già aperta.
3. **Usa i comandi della registrazione.**
    
    <table><thead><tr><th>Comando</th><th>Cosa fa</th></tr></thead><tbody><tr><td>**Pausa**, poi **Riprendi**</td><td>quello che fai in pausa non viene registrato</td></tr><tr><td>**Nota…**</td><td>aggiunge un commento in quel punto della guida</td></tr><tr><td>**Stop**</td><td>chiude la registrazione e apre l'anteprima</td></tr></tbody></table>
4. **Rivedi l'anteprima.** Correggi il testo di ogni passo, togli un passo o la sua schermata. **Salva**tiene le modifiche.
5. **Scarica.** **Markdown** dà un file di testo con le immagini dentro. **HTML** dà una pagina che si apre da sola e si stampa.

## Cosa diventa un passo

- la funzione avviata dal menu, col suo percorso;
- la maschera o la finestra che si apre, con la schermata;
- il campo compilato: «Nel campo Codice scrivi 30GG»;
- il tasto funzione premuto, con la schermata di prima del tasto;
- il messaggio del programma e la tua risposta;
- la stampa prodotta.

Invio e le frecce fra un campo e l'altro non fanno un passo.

## Ritrovarle

**Opzioni**, **Automazione**, **Procedure registrate**: l'elenco di quelle fatte su quel server in quel browser. Un clic apre l'anteprima; accanto ci sono **Markdown**, **HTML** ed **Elimina**.

<p class="callout warning">**Attenzione.** Serve a documentare, non a ripetere: la procedura registrata non rifà i passi. Per far ripetere un'operazione al sistema ci sono le Macro/Workflow SBH: vedi Cosa si può automatizzare (libro «JI - Macro/Workflow SBH», pagina «JI1.1 - Cosa si può automatizzare»).</p>

<p class="callout info">**Nota.** Le password e i campi riservati non vengono mai registrati: nella guida compare «valore riservato» e nelle schermate dei pallini.</p>

<p class="callout info">**Nota.** Le registrazioni restano nel browser. **Svuota cache** non le tocca, ma per darle a qualcuno vanno scaricate.</p>

<p class="callout info">**Per chi sviluppa.** Il registratore è `frontend/sbh-web/src/session/services/sbh-procedure-recorder.service.ts`. Le schermate le disegna il browser, senza programmi: se non ci riesce, al loro posto mette una tabella con campi e valori.</p>

<p class="callout info">**Per approfondire.**  
• Client SBH — il pannello Opzioni, le stampe e gli strumenti: `docs/guide/moduli/sbh-stampe-e-strumenti/README.md`</p>

# JH9 - Aiuto

# JH9.1 - Il tour guidato

**In una frase.** Il tour guidato è un giro di un quarto d'ora dentro la pagina vera: illumina una cosa alla volta e spiega a cosa serve.

Leggere un manuale è un conto, vedere le cose al loro posto è un altro. Il tour ti porta per mano fra menu, schede, documenti e griglie, senza toccare nessun dato.

## Quando parte

La prima volta che arrivi al menu dopo l'accesso compare l'invito, una volta per browser.

<table id="bkmrk-pulsante-cosa-fa-ini"><thead><tr><th>Pulsante</th><th>Cosa fa</th></tr></thead><tbody><tr><td>**Inizia**</td><td>parte dall'inizio, o dal capitolo che scegli sotto</td></tr><tr><td>**Più tardi**</td><td>lo ripropone al prossimo ingresso</td></tr><tr><td>**Non mostrare più**</td><td>non parte più da solo; resta nelle Opzioni</td></tr></tbody></table>

Quando il tour viene aggiornato con cose nuove, l'invito ricompare una volta.

## Da dove lo riapri

- **Tour guidato** sulla pagina di avvio e nel benvenuto;
- **Opzioni**, scheda **Tour**: **Tour guidato** e **Tour delle griglie**;
- **Ctrl+K**, scrivendo «tour».

## Come si usa

Il resto della pagina si oscura e un riflettore illumina l'elemento di cui si parla. Accanto c'è la scheda del passo: capitolo, numero del passo, titolo e spiegazione.

<table id="bkmrk-tasto-o-pulsante-cos"><thead><tr><th>Tasto o pulsante</th><th>Cosa fa</th></tr></thead><tbody><tr><td>freccia destra, Invio, **Avanti**</td><td>passo successivo</td></tr><tr><td>freccia sinistra, **Indietro**</td><td>passo precedente</td></tr><tr><td>**Indice**</td><td>l'elenco dei capitoli: un clic porta lì</td></tr><tr><td>**Salta il capitolo**</td><td>va al capitolo dopo</td></tr><tr><td>Esc, o la **×**</td><td>chiude il tour</td></tr></tbody></table>

L'elemento illuminato si può anche cliccare. Alcuni passi aprono da soli quello che descrivono, per esempio le Opzioni, e il passo dopo lo richiude.

## Di cosa parla

Connessione e SBH Helper, schede e sessioni, menu e ricerca, messaggi e notifiche, documenti e strumenti, aspetto e accessibilità, e poi le griglie.

## Le griglie si provano davvero

Al capitolo **Le griglie** il tour apre una pagina di prova con 120 documenti di vendita finti. Lì i passi fanno le cose che spiegano: salvano una vista, aggiungono una colonna calcolata. Le tue sessioni restano collegate, nascoste accanto. Alla fine **Torna dove eri** ti riporta alla pagina da cui eri partito.

<p class="callout info">**Nota.** Se un passo parla di qualcosa che in quel momento non è a video, la scheda va al centro e dice «Lo vedrai…». Il riflettore non indica mai una cosa che non c'è.</p>

<p class="callout info">**Nota.** Il tour sopravvive a una ricarica della pagina: riprende dal passo dov'eri.</p>

<p class="callout info">**Nota.** Su telefono il giro è più corto e le griglie non ci sono: si provano dal PC.</p>

<p class="callout info">**Per chi sviluppa.** Il tour è `frontend/sbh-web/src/session/components/sbh-tour`, la pagina di prova `frontend/sbh-web/src/session/components/sbh-prova-griglia`. Sul PC sono 15 capitoli e 66 passi.</p>

<p class="callout info">**Per approfondire.**  
• SBH — accesso e novita': `docs/guide/moduli/sbh-accesso-e-novita/README.md`</p>

# JH9.2 - Chiedere assistenza

**In una frase.** Prima di chiamare l'assistenza copia tre cose: le informazioni sulla sessione, il nome della maschera e, se te lo chiedono, lo scambio col server.

«Non funziona» non basta a chi deve aiutarti. Con i dati giusti il problema si capisce al primo messaggio, senza dieci domande di ritorno.

## 1. Le informazioni sulla sessione

**Opzioni**, scheda **Sessione**, **Informazioni sulla sessione**. Dice chi è collegato, a quale server, con quale connessione, prodotto e versione, da quale postazione e con quale browser. **Copia** mette tutto negli appunti, una riga per voce.

![La finestra Informazioni sulla sessione, col pulsante Copia](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-chiedere-assistenza-01-informazioni-sulla-sessione.png)

*La finestra Informazioni sulla sessione, col pulsante Copia*

## 2. Dove sei

- **Il nome della maschera**: clic destro sulla maschera, **Copia nome maschera**.
- **Il percorso della funzione**: clic destro sulla voce del menu, **Copia**.
- **La versione del menu**: la riga piccola in fondo al menu, per esempio «Menu B20 · vers. 0000 · rel. 6800».
- **Il messaggio**: il testo esatto, preso dalla riga dei messaggi o dal suo storico.

## 3. Lo scambio col server

Serve solo se chi ti assiste lo chiede. **Opzioni**, scheda **Strumenti**, **Trace del protocollo**: si apre a destra un pannello con tutto quello che pagina e server si dicono.

![Il pannello del trace: i messaggi in arrivo e in partenza, col livello in alto a sinistra](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/h-sbhweb-img-chiedere-assistenza-02-trace.png)

*Il pannello del trace: i messaggi in arrivo e in partenza, col livello in alto a sinistra*

1. **Accendilo prima** di rifare l'operazione: scrive solo da quando è acceso.
2. **Scegli il livello** in alto a sinistra.
    
    <table><thead><tr><th>Livello</th><th>Cosa scrive</th></tr></thead><tbody><tr><td>0</td><td>niente: spento</td></tr><tr><td>1</td><td>solo gli eventi: sessione, errori, avvisi</td></tr><tr><td>2</td><td>anche una riga per ogni messaggio scambiato</td></tr><tr><td>3</td><td>anche il contenuto completo di ogni messaggio</td></tr></tbody></table>
3. **Rifai l'operazione** che dà il problema.
4. **Filtra, se serve.** La casella **Filtra** tiene le righe che contengono un testo, per esempio il nome della maschera.
5. **Premi Scarica.** Ottieni un file di testo con le righe filtrate, da allegare. Il cestino svuota.

<p class="callout warning">**Attenzione.** Il trace al livello 3 contiene i dati che passano a video. Mandalo solo a chi ti assiste.</p>

<p class="callout info">**Nota.** Per un problema su una stampa di GPEnext, nel filtro scrivi `GPE-NEXT`: le righe dicono tipo di documento ed esito di ogni tentativo.</p>

<p class="callout info">**Nota.** Per capire prima da solo, guarda [Se qualcosa non va](https://gsdoc.genesyssoftware.eu/link/37885).</p>

<p class="callout info">**Per chi sviluppa.** Il pannello è `frontend/sbh-web/src/session/components/sbh-trace-panel`; il file si chiama `sbh-trace-` seguito da data e ora locali. Dal lato del server, il registro del Ponte col COBOL dice perché una connessione è stata rifiutata o una sessione chiusa.</p>

<p class="callout info">**Per approfondire.**  
• SBH — avvio della sessione, login, schede, rientro e uscita: `docs/guide/moduli/sbh-avvio-e-sessioni/README.md`  
• Client SBH — il pannello Opzioni, le stampe e gli strumenti: `docs/guide/moduli/sbh-stampe-e-strumenti/README.md`</p>

# JH9.3 - Se qualcosa non va

**In una frase.** I problemi più comuni con SBHweb e cosa fare, e in fondo le parole da sapere.

## Entrare

<table id="bkmrk-vedo-questo-faccio-q"><thead><tr><th>Vedo questo</th><th>Faccio questo</th></tr></thead><tbody><tr><td>Al **Connetti** compare **Serve l'SBH Helper**</td><td>Segui i quattro passi della finestra: scarica, installa, avvia, verifica</td></tr><tr><td>**Connetti** è spento e la pagina parla di 5 sessioni in sospeso</td><td>Apri **Le tue sessioni aperte**: riprendine una o chiudila</td></tr><tr><td>Il server scelto viene rifiutato</td><td>Non è fra quelli ammessi: chiedi a chi amministra</td></tr><tr><td>Il primo ingresso dura minuti</td><td>È normale: scarica i menu di tutti i moduli. Dalla volta dopo è veloce</td></tr></tbody></table>

## Sessioni

<table id="bkmrk-vedo-questo-faccio-q-1"><thead><tr><th>Vedo questo</th><th>Faccio questo</th></tr></thead><tbody><tr><td>**Esci dalla sessione** è spenta</td><td>Sei dentro una funzione: torna prima al menu col tasto Esci</td></tr><tr><td>Dopo lo standby la pagina resta vuota</td><td>Aspetta qualche secondo: si ricarica da sola. Altrimenti premi **Ricarica**</td></tr><tr><td>La pagina dice che la sessione non c'è più</td><td>È scaduto il tempo, o il Ponte è stato riavviato: entra di nuovo</td></tr><tr><td>Vedo una sessione ma non riesco a riprenderla</td><td>È nata in un altro browser: riaprila da lì, oppure chiudila</td></tr><tr><td>La scheda rimasta in secondo piano riparte da zero</td><td>Il browser l'aveva sospesa: nelle sue impostazioni aggiungi il sito fra quelli da tenere sempre attivi</td></tr></tbody></table>

## Menu e maschere

<table id="bkmrk-vedo-questo-faccio-q-2"><thead><tr><th>Vedo questo</th><th>Faccio questo</th></tr></thead><tbody><tr><td>Premo Esc e la funzione si chiude</td><td>In una maschera Esc è il tasto Esci del programma. Le finestre si chiudono con la **X**</td></tr><tr><td>Non riesco a scrivere in un campo</td><td>Si scrive solo nel campo col bordo colorato</td></tr><tr><td>Il menu non avvia niente</td><td>C'è una funzione in corso: il menu è in consultazione. Apri un'altra scheda</td></tr><tr><td>Il doppio clic non avvia la funzione</td><td>Non c'è una stampante adatta: il pannello di avvio dice perché</td></tr><tr><td>Ho perso il cursore</td><td>Premi e rilascia Ctrl da solo</td></tr><tr><td>Un link a una funzione non apre niente</td><td>Quella voce non è nel tuo menu: lo dice la riga dei messaggi</td></tr></tbody></table>

## Griglie

<table id="bkmrk-vedo-questo-faccio-q-3"><thead><tr><th>Vedo questo</th><th>Faccio questo</th></tr></thead><tbody><tr><td>Il filtro non trova una riga che c'è</td><td>Lavora sulle righe già arrivate: chiedi le altre con Pag giù</td></tr><tr><td>Le mie viste non sono su un altro PC</td><td>L'archivio delle viste è spento: lo dice l'icona nel menu delle viste</td></tr></tbody></table>

Per le stampe c'è una pagina a parte: [Se la stampa non esce](https://gsdoc.genesyssoftware.eu/link/37979). Per sapere cosa dire a chi ti assiste: [Chiedere assistenza](https://gsdoc.genesyssoftware.eu/link/37994).

## Parole da sapere

- **Sessione.** Il tuo collegamento al programma COBOL. Una scheda, una sessione.
- **Postazione.** Il nome con cui il server vede il tuo PC.
- **Maschera.** La schermata di una funzione, con i suoi campi.
- **Pannello di avvio.** Dove scegli tipo di lavoro, modalità e uscita prima di partire.
- **Uscita.** Dove va la stampa: una stampante, un file, lo schermo, `GPE_NEXT_PDF`.
- **In sospeso.** Una sessione senza pagina, tenuta aperta dal Ponte finché rientri.
- **Vista.** Come vuoi vedere una griglia, salvata con un nome.
- **SBH Helper.** Il programma sul PC per stampe dirette, salvataggi e firma.
- **Ponte col COBOL.** Il servizio che traduce fra browser e programma storico.

<p class="callout info">**Per chi sviluppa.** Il registro del Ponte col COBOL dice perché una connessione è stata rifiutata o una sessione chiusa. I problemi noti e le cose ancora aperte sono in `docs/sbh-web/INVENTARIO-LEGACY.md`.</p>