Skip to Content
Guide UtenteGuida per l'AmministratoreConfigurazione Stampanti e KDSWindows Printer Service

Windows Printer Service

Il Windows Printer Service è l’applicazione desktop che permette di collegare le stampanti fisiche al sistema SagraFacile. Funziona come ponte tra il cloud (o il server self-hosted) e le stampanti installate su un PC Windows.

Panoramica

L’applicazione permette di:

  • Gestire multiple stampanti da un unico PC
  • Supportare sia stampanti termiche ESC/POS che stampanti standard (laser, inkjet)
  • Ricevere i lavori di stampa in tempo reale tramite connessione WebSocket
  • Monitorare lo stato e la coda di ogni stampante
  • Funzionare in background con icona nella barra delle applicazioni

Il Windows Printer Service è gratuito ed è incluso in tutte le versioni di SagraFacile.

Requisiti di Sistema

  • Sistema operativo: Windows 10 o successivo (64-bit)
  • Connessione internet: Necessaria per comunicare con il server SagraFacile
  • Stampanti: Qualsiasi stampante installata e funzionante su Windows

Download e Installazione

Scarica l’applicazione

Dalla pagina Gestione Stampanti nel pannello di amministrazione SagraFacile, clicca su “Scarica App Windows”.

In alternativa, scarica l’ultima versione dalla pagina delle release .

Estrai i file

Il download è un file ZIP. Estrai il contenuto in una cartella a tua scelta, ad esempio:

  • C:\Program Files\SagraFacilePrinter\
  • C:\SagraFacilePrinter\

Avvia l’applicazione

Esegui il file SagraFacilePrinter.exe. Al primo avvio, verrà mostrata la finestra di configurazione iniziale.

L’applicazione non richiede installazione. Non eliminare la cartella dopo aver estratto i file.

Configurazione Iniziale

Al primo avvio, l’applicazione mostra una finestra di benvenuto per la configurazione iniziale.

Configura l’URL del server

Per la versione Cloud, inserisci l’URL fornito da SagraFacile:

https://app.sagrafacile.com

Avvio automatico (opzionale)

Seleziona “Avvia automaticamente all’accensione del PC” se vuoi che l’applicazione parta in automatico quando accendi il computer.

Completa la configurazione

Clicca su “Inizia” per completare la configurazione e accedere alla dashboard principale.

Dashboard Principale

La dashboard mostra una panoramica di tutte le stampanti configurate e il loro stato.

Elementi dell’Interfaccia

ElementoDescrizione
ServerURL del server configurato
StatoStato generale della connessione (Connesso, Parziale, Disconnesso)
Lista StampantiElenco di tutte le stampanti configurate con stato e coda
Log AttivitàRegistro in tempo reale degli eventi e delle stampe

Indicatori di Stato

SimboloColoreSignificato
●VerdeConnessa e pronta
◔ArancioneConnessione in corso
○GrigioDisconnessa
●RossoErrore
◌Grigio chiaroDisabilitata

Aggiungere una Stampante

Crea la stampante nel pannello web

Prima di tutto, devi creare la stampante nel pannello di amministrazione SagraFacile:

  1. Vai a Gestione Stampanti nel pannello admin
  2. Clicca “Aggiungi Nuova Stampante”
  3. Configura nome, tipo documento (ESC/POS o HTML/PDF), e altre impostazioni
  4. Salva la stampante

Genera il codice di associazione

  1. Dal menu azioni della stampante (tre puntini), seleziona “Associa App Windows”
  2. Apparirà un codice di 6 cifre valido per alcuni minuti

Aggiungi la stampante nell’app Windows

  1. Nella dashboard del Windows Printer Service, clicca “Aggiungi Stampante”
  2. Inserisci il codice di 6 cifre nel campo apposito
  3. Clicca “Associa con Codice”

Configura la stampante locale

Dopo l’associazione riuscita, configura i dettagli:

  1. Nome: Un nome descrittivo per identificare la stampante
  2. Stampante Windows: Seleziona la stampante fisica dal menu a tendina
  3. Tipo: ESC/POS (termica) o Standard (GDI)
  4. Formato carta: Solo per stampanti Standard (A4, A5, Letter, Legal)
  5. Abilitata: Lascia attivo per iniziare a ricevere stampe

Verifica la connessione

La stampante apparirà nella lista con stato verde (●). Puoi inviare una stampa di test dal pannello web per verificare.

Gestire le Stampanti

Clicca sulla colonna [···] di una stampante per aprire il menu azioni:

AzioneDescrizione
ModificaCambia nome, stampante fisica, tipo, o formato carta
Stampa TestInvia una pagina di prova alla stampante
Stampa ProssimoStampa manualmente il prossimo job dalla coda
Abilita/DisabilitaAttiva o disattiva temporaneamente la stampante
RimuoviElimina la stampante dalla configurazione

Modificare una Stampante

  1. Seleziona la stampante e clicca “Modifica” dal menu azioni
  2. Modifica i campi desiderati
  3. Se necessario, clicca “Riassocia” per generare un nuovo collegamento
  4. Clicca “Salva”

Disabilitare Temporaneamente

Se devi mettere in pausa una stampante (manutenzione, sostituzione carta, ecc.):

  1. Apri il menu azioni della stampante
  2. Clicca “Disabilita”

La stampante rimarrà configurata ma non riceverà nuovi lavori di stampa. I job verranno accodati sul server.

Per riattivare, clicca “Abilita” dallo stesso menu.

Rimuovere una Stampante

Rimuovere una stampante la disconnette completamente. Per riutilizzarla dovrai generare un nuovo codice di associazione dal pannello web.

  1. Apri il menu azioni della stampante
  2. Clicca “Rimuovi”
  3. Conferma la rimozione

Icona nella Barra delle Applicazioni

L’applicazione funziona in background e mostra un’icona nella system tray (area di notifica di Windows).

Comportamento

  • Chiudere la finestra (X) la nasconde nella barra, non chiude l’applicazione
  • Doppio clic sull’icona riapre la dashboard
  • Clic destro sull’icona apre il menu rapido
OpzioneDescrizione
Apri DashboardMostra la finestra principale
StampantiLista rapida delle stampanti con stato
ImpostazioniApre le impostazioni
Cartella LogApre la cartella dei file di log
EsciChiude completamente l’applicazione

Colore dell’Icona

L’icona cambia colore in base allo stato generale:

ColoreSignificato
VerdeTutte le stampanti connesse
ArancioneAlcune stampanti disconnesse
RossoTutte le stampanti disconnesse o errore
GrigioNessuna stampante configurata

Impostazioni

Accedi alle impostazioni cliccando “Impostazioni” nella dashboard o dal menu della system tray.

Opzioni Disponibili

ImpostazioneDescrizione
URL ServerIndirizzo del server SagraFacile
Avvio automaticoAvvia l’app all’accensione del PC
RiconnettiForza la riconnessione al server

Cambiare il Server

Se devi cambiare il server (es. da test a produzione):

  1. Apri le Impostazioni
  2. Modifica l’URL Server
  3. Clicca “Riconnetti”
  4. Attendi che le stampanti si ricolleghino

Cambiando server, le stampanti esistenti potrebbero non funzionare se non sono state create anche sul nuovo server. Potrebbe essere necessario riassociarle.

Log e Diagnostica

Log Attività

La dashboard mostra un log in tempo reale con:

  • Connessioni e disconnessioni
  • Lavori di stampa ricevuti ed eseguiti
  • Errori e avvisi

File di Log

I log dettagliati vengono salvati in:

%LOCALAPPDATA%\SagraFacilePrinterService\logs\

Equivalente a:

C:\Users\[TuoUtente]\AppData\Local\SagraFacilePrinterService\logs\

Per aprire la cartella:

  • Dal menu Impostazioni, clicca “Apri Cartella Log”
  • Oppure dal menu della system tray, seleziona “Cartella Log”

Esporta Diagnostica

Per inviare informazioni di debug al supporto:

  1. Apri le Impostazioni
  2. Clicca “Esporta Diagnostica”
  3. Scegli dove salvare il file
  4. Il file conterrà: configurazione, stato stampanti, informazioni sistema

Problemi Comuni

La stampante rimane “Disconnessa”

  1. Verifica l’URL del server nelle impostazioni
  2. Controlla la connessione internet del PC
  3. Verifica che la stampante sia abilitata nel pannello web
  4. Prova a cliccare “Riconnetti” nelle impostazioni

La stampa non esce

  1. Verifica che la stampante Windows sia corretta (modifica la configurazione)
  2. Controlla che la stampante sia accesa e pronta
  3. Verifica la coda di stampa di Windows per errori
  4. Prova una stampa di test dal menu azioni

Caratteri speciali non stampati correttamente

Per le stampanti ESC/POS, i caratteri speciali dipendono dalla codepage configurata:

  1. Nel pannello web, vai a Gestione Stampanti
  2. Dal menu azioni della stampante, seleziona “Trova Codepage”
  3. Segui la procedura guidata per trovare la codepage corretta

L’applicazione non si avvia

  1. Verifica i requisiti di sistema (Windows 10+ 64-bit)
  2. Controlla l’antivirus che potrebbe bloccare l’esecuzione
  3. Prova a eseguire come amministratore (clic destro → Esegui come amministratore)
  4. Controlla i log per messaggi di errore

Connessione instabile

Se la connessione si interrompe frequentemente:

  1. Verifica la stabilità della rete internet
  2. Controlla firewall e proxy che potrebbero bloccare WebSocket
  3. Per self-hosted: verifica che il server sia raggiungibile dalla rete del PC

Migrazione da Versioni Precedenti

Se hai utilizzato una versione precedente del Windows Printer Service (con profili singoli), l’applicazione rileverà automaticamente i vecchi profili e offrirà di importarli.

Rilevamento automatico

All’avvio, se vengono trovati profili legacy, apparirà la finestra di migrazione.

Seleziona i profili

Seleziona quali profili importare dalla lista. Ogni profilo diventerà una stampante nella nuova configurazione.

Completa la migrazione

Clicca “Importa e Continua”. I vecchi profili verranno convertiti nel nuovo formato multi-stampante.

I vecchi file di configurazione non vengono eliminati. Puoi rimuoverli manualmente dalla cartella %LOCALAPPDATA%\SagraFacilePrinterService\profiles\ dopo aver verificato che tutto funzioni.

Percorsi dei File

File/CartellaPercorso
Configurazione%LOCALAPPDATA%\SagraFacilePrinterService\settings.json
Log%LOCALAPPDATA%\SagraFacilePrinterService\logs\
Profili legacy%LOCALAPPDATA%\SagraFacilePrinterService\profiles\

Pagine Correlate

Last updated on
Configurazione StampaConfigurazione KDS