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