Installazione
Questa sezione riguarda l'installazione dell'applicazione desktop DPD Label Print per Windows. Non è applicabile a Online Label Print, che è basata su browser — è sufficiente accedere all'URL fornito da DPD, nessuna installazione richiesta.
Prima di iniziare
Verificate che il vostro sistema soddisfi i requisiti:
- Windows 10 o Windows Server 2016+
- 5 GB di spazio su disco libero — il programma di installazione richiede 293,8 MB, il resto è margine per i vostri dati di spedizione
- Diritti di amministratore sul computer
Decidete due cose prima di iniziare. Le due sono indipendenti — qualsiasi combinazione funziona, ed entrambe vengono fissate al momento dell'installazione:
- se Label Print viene eseguito come applicazione o come servizio Windows
- se memorizza i dati in SQLite o PostgreSQL
Modificare l'una o l'altra in seguito richiede una reinstallazione.
Download
Scaricate il programma di installazione da:
http://label-print-api.dpd.ch/api/v1/public/installers/latest
Quel link fornisce sempre la versione corrente. Eseguite il file scaricato — clic destro → Esegui come amministratore se richiesto.
La procedura guidata di installazione
1. Lingua del programma di installazione
La prima finestra di dialogo chiede quale lingua deve utilizzare la procedura guidata di installazione. Questo riguarda solo il programma di installazione — la lingua dell'applicazione stessa segue quella del vostro browser per impostazione predefinita, e può essere modificata nell'applicazione stessa.
2. Benvenuti
Una pagina di benvenuto standard. Cliccate su Avanti per continuare.
3. Componenti
Scegliete quali collegamenti creare:
| Componente | Effetto |
|---|---|
| Start Menu Shortcuts | Crea collegamenti nel menu Start |
| Desktop Shortcut | Crea un collegamento sul desktop |
Entrambi sono facoltativi — deselezionate quello che non desiderate.
4. Modalità di installazione e porta
Scegliete come deve essere eseguito Label Print:
| Modalità | Comportamento |
|---|---|
| Esegui come applicazione (modalità desktop) | Avviate Label Print voi stessi e si arresta quando chiudete la finestra del launcher. Adatto per una singola postazione di lavoro. |
| Esegui come servizio Windows | Label Print viene eseguito finché il computer è acceso, avviato e arrestato da Windows. Richiesto per l'uso condiviso su server. |
Porta — la porta su cui è in ascolto il backend, 8082 per impostazione predefinita. Modificatela solo se qualcos'altro sul computer utilizza già quella porta.
Account di servizio — questi due campi compaiono solo dopo aver selezionato Esegui come servizio Windows, motivo per cui non sono visibili nello screenshot sopra:
- Lasciate entrambi i campi account e password vuoti per eseguire il servizio con l'account integrato NETWORK SERVICE. Questa è la scelta normale.
- Inserite un account Windows e una password solo se il servizio necessita di risorse di rete con un'identità specifica — ad esempio una cartella di rete per l'importazione di file.
5. Database
Scegliete dove Label Print memorizza i suoi dati:
| SQLite | PostgreSQL | |
|---|---|---|
| Memorizzazione | File locale nella cartella dati | Server database separato |
| Configurazione | Nessuna — è l'impostazione predefinita | Richiede un server PostgreSQL, preparato in anticipo |
| Prestazioni su larga scala | Fino a circa 10.000 spedizioni al mese | Nessun limite pratico |
Entrambi i database funzionano con entrambe le modalità di installazione, ed entrambi supportano più persone che condividono un'unica installazione — SQLite può supportare un servizio Windows usato da un team, e PostgreSQL può supportare un'installazione in modalità applicazione. La scelta dipende dal volume di dati, non dal numero di utenti.
SQLite è l'impostazione predefinita. La sua cartella dati predefinita è C:\ProgramData\DPD\LabelPrintClient\.
PostgreSQL è consigliato per grandi volumi di dati. Create il database e il relativo utente prima di eseguire il programma di installazione:
CREATE DATABASE labelprint;
CREATE USER labelprint WITH PASSWORD 'your_password';
GRANT ALL PRIVILEGES ON DATABASE labelprint TO labelprint;
Si consiglia PostgreSQL 16 o versioni successive. Inserite i dettagli di connessione in questo passaggio della procedura guidata.
Il tipo di database viene fissato al momento dell'installazione. Non è possibile passare da SQLite a PostgreSQL, né viceversa, in seguito — modificarlo significa reinstallare.
6. Posizione di installazione
La directory di installazione predefinita è C:\Program Files\DPD\LabelPrintClient. Il programma di installazione mostra lo spazio necessario (293,8 MB) rispetto a quello disponibile.
Cliccate su Installa e attendete il completamento.
Primo avvio
Appare la finestra DPD Label Print App che avvia il backend.
Una volta che lo stato indica Backend è pronto:
- Apri nel browser apre Label Print su
http://localhost:8082— o la porta scelta - Esci arresta il backend e chiude il runner
In modalità applicazione il backend è un processo locale — tenete aperta la finestra del launcher mentre lavorate, perché chiuderla arresta il backend. In modalità servizio Windows questo non si applica: il servizio viene eseguito in modo indipendente e potete aprire l'indirizzo in un browser in qualsiasi momento.
L'applicazione viene eseguita interamente sul vostro computer locale. Il browser è solo l'interfaccia — nessun dato viene inviato tramite il browser a server esterni (solo direttamente dal backend a DPD).
Attivare il vostro account
DPD fornisce un codice di attivazione, un ID utente e una password. Il codice di attivazione viene inserito una sola volta, al primo avvio, prima che chiunque possa accedere.
- Nella schermata di accesso scegliete la scheda Attivazione account
- Incollate il codice — si trova nell'e-mail che DPD vi ha inviato
- Cliccate su Attiva
Dopo «Attivazione completata» la schermata torna al normale modulo di accesso. Accedete con:
- ID utente — ad esempio
AB12345 - Login — il vostro nome utente, ad esempio
admin - Password
Se l'attivazione fallisce, Problemi di accesso elenca ogni messaggio di errore e il suo significato.
Configurazione iniziale
Eseguite questi passaggi una volta sola, dopo il primo accesso.
- Verificate le impostazioni predefinite — peso, riferimenti, servizio e dati del mittente da cui parte ogni nuova spedizione → Impostazioni predefinite
- Controllate utenti e accessi — chi può accedere e quali servizi e indirizzi di ritiro ha a disposizione → Amministrazione utenti
- Aggiungete una stampante e inviate una stampa di prova → Configurazione delle stampanti
- Configurate le importazioni e, se le spedizioni arrivano automaticamente, una cartella monitorata o una sorgente FTP → Importazioni file, Origini dati
- Configurate l'esportazione automatica delle spedizioni, se un altro sistema prende i vostri dati di spedizione → Esportazione automatica delle spedizioni
- Create la vostra prima spedizione, stampate l'etichetta e poi stampate un manifesto → Creare una spedizione, Manifesti
Eseguire come servizio Windows
Scegliendo Esegui come servizio Windows durante l'installazione, più persone possono condividere un'unica istanza, un unico database e un unico insieme di impostazioni.
Usatelo quando:
- più membri del personale hanno bisogno di Label Print contemporaneamente
- volete avere la cronologia delle spedizioni e le impostazioni in un unico posto
- Label Print deve continuare a funzionare anche quando nessuno è collegato
- l'applicazione deve essere gestita dall'IT anziché dagli utenti
Windows Server
├── Backend DPD Label Print (servizio Windows, porta 8082)
├── Database (SQLite o PostgreSQL — entrambi funzionano)
└── Gli utenti si connettono tramite browser → http://<server-ip>:8082
Ogni utente apre http://<server-ip>:8082 in un browser. Non viene installato nulla sulle postazioni di lavoro.
Firewall — il programma di installazione aggiunge una regola del Firewall di Windows per la porta scelta. Se manca, aggiungetela manualmente, sostituendo 8082 con la vostra porta:
netsh advfirewall firewall add rule name="DPD Label Print" dir=in action=allow protocol=TCP localport=8082
Account utente — createli in Impostazioni → Gestione utenti.
Hardware consigliato
| Componente | Minimo | Consigliato |
|---|---|---|
| CPU | Dual-core | Quad-core |
| RAM | 4 GB | 8 GB |
| Archiviazione | 20 GB | 50 GB (per una cronologia di spedizioni estesa) |
| OS | Windows Server 2016 | Windows Server 2019/2022 |
Lavorare offline
Con SQLite, Label Print continua a funzionare senza connessione internet per:
- creare spedizioni e stampare etichette — le etichette vengono generate localmente
- memorizzare la cronologia delle spedizioni
Non appena una connessione è di nuovo disponibile, automaticamente:
- trasmette le spedizioni in sospeso a DPD
- scarica i dati di routing e la configurazione aggiornati
Dove si trovano i file
| Cosa | Percorso predefinito |
|---|---|
| Applicazione | C:\Program Files\DPD\LabelPrintClient |
| Dati, incluso il database SQLite | C:\ProgramData\DPD\LabelPrintClient\ |
| Log | C:\ProgramData\DPD\LabelPrintClient\logs |
La cartella dei log è il primo posto da controllare quando qualcosa non funziona all'avvio, ed è la prima cosa che il supporto DPD chiederà.
Disinstallazione
Accedete a Impostazioni Windows → App → DPD Label Print Client → Disinstalla.
Oppure eseguite:
"C:\Program Files\DPD\LabelPrintClient\uninstall.exe"
I vostri dati rimangono in C:\ProgramData\DPD\LabelPrintClient\ — la disinstallazione non elimina la cronologia delle spedizioni né le impostazioni.
Passi successivi
- Creare una spedizione — create e stampate la vostra prima etichetta
- Migrazione del server — spostare un'installazione esistente su nuovo hardware
- Aggiornamenti — come funziona l'updater integrato