# 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>