Stampa di etichette con Python: personalizza i campi con LPSNG

Devi stampare etichette il cui contenuto non è fisso. Un nome di prodotto potrebbe dover essere convertito in maiuscolo, una data di scadenza calcolata a partire da una data di produzione, oppure un prezzo totale derivato da quantità e prezzo unitario. Invece di eseguire uno script Python separato per trasformare i dati prima di ogni lavoro di stampa, puoi collegare Python direttamente ai campi delle etichette in LPSNG.

Con la Field Script API, incorpori piccoli blocchi Python nei singoli campi dell’etichetta. Prima che LPSNG renderizzi l’etichetta, esegue questi script e utilizza il valore restituito come contenuto finale del campo. Questo è il cuore della stampa di etichette con script Python in LPSNG: valori dei campi basati sui dati senza una pipeline di scripting esterna.

Poiché il sistema di stampa etichette di nuova generazione include un designer visuale di etichette e l’esecuzione Python integrata, non devi configurare un ambiente Python separato, gestire i driver della stampante o occuparti dei protocolli di stampa grezzi. Il flusso di lavoro gestito mantiene in un unico posto la progettazione delle etichette, l’esecuzione degli script e l’invio dei lavori di stampa.

Prerequisiti

Prima di iniziare, assicurati di avere:

• Un account LPSNG con accesso al designer di etichette. Questo vale sia per l’edizione cloud sia per quella embedded.
• Familiarità di base con la sintassi Python: variabili, funzioni, metodi per le stringhe e f-string.
• Un layout di etichetta su cui lavorare, oppure la possibilità di crearne uno nuovo in LPSNG.
• Facoltativo: un file di dati di esempio come CSV o Excel per testare i valori dinamici dei campi con record realistici.

Non è necessaria un’installazione Python locale. Gli script Python vengono eseguiti all’interno di LPSNG come parte del processo di rendering delle etichette.

Passo dopo passo: aggiungere script Python ai campi delle etichette

Passo 1: aprire il designer di etichette e selezionare il campo di destinazione

Accedi a LPSNG e apri l’etichetta che desideri modificare. Nel designer di etichette, seleziona il campo che deve contenere contenuti dinamici, ad esempio un campo di testo per il nome del prodotto.

Se parti da zero, crea una nuova etichetta, aggiungi un campo di testo e collegalo a un’origine dati oppure lascialo come segnaposto per i test.

Passo 2: aprire le proprietà del campo e individuare la sezione script

Con il campo selezionato, apri le sue proprietà. Cerca l’area di scripting destinata al codice Python. La Field Script API la tratta come un blocco di script collegato al campo, quindi la sezione potrebbe essere etichettata Script, Python o in modo simile a seconda della versione del designer.

Il punto importante è che lo script appartiene al campo, non all’intera etichetta. Se colleghi uno script al campo sbagliato, non influenzerà l’output che ti aspetti.

Passo 3: scrivere uno script che riceve il valore del campo e restituisce un valore modificato

Nell’area dello script Python, il valore corrente del campo è disponibile per il tuo codice. Uno script minimo che converte il valore in maiuscolo si presenta così:

return value.upper()

Se il campo contiene "apple" prima dell’esecuzione dello script, l’etichetta renderizzata mostrerà "APPLE".

Usa return per restituire il valore finale all’etichetta. LPSNG utilizza il valore restituito come contenuto stampato del campo.

Passo 4: usare le variabili di contesto per creare contenuti dinamici

Puoi combinare il valore corrente del campo con date, dati del record o altro contesto disponibile durante il rendering. Ad esempio, per aggiungere la data corrente a un nome di prodotto:

from datetime import datetime

return f"{value} - {datetime.now().strftime('%Y-%m-%d')}"

Se il valore del campo è "Tomato Sauce", il risultato renderizzato potrebbe essere:

Tomato Sauce - 2026-08-26

A seconda di come l’etichetta è collegata a un’origine dati, il record dati corrente potrebbe essere disponibile anche come parte del contesto dello script. Controlla le impostazioni di associazione dati dell’etichetta nel designer per verificare quali variabili puoi utilizzare.

Passo 5: testare lo script nel designer

Usa l’anteprima dell’etichetta o i dati di test per verificare l’output prima di stampare. LPSNG esegue gli script dei campi durante l’anteprima, quindi puoi vedere il risultato esatto del tuo codice Python senza inviare un lavoro di stampa.

Apporta piccole modifiche ed esegui nuovamente l’anteprima finché il campo non mostra esattamente ciò di cui hai bisogno.

Passo 6: salvare l’etichetta e usarla in un lavoro di stampa

Una volta che lo script funziona nell’anteprima, salva l’etichetta. Ora puoi utilizzarla tramite l’interfaccia web, l’API del servizio web o LPSNG Player.

Il flusso di lavoro gestito significa che non devi esportare il tuo script Python, inserirlo in un processore di lavori separato o comunicare con un protocollo di stampa. LPSNG esegue lo script come parte del rendering dell’etichetta e invia l’output finito alla stampante o al formato di file selezionato.

Passo 7: facoltativo — combinare più campi o eseguire calcoli

Gli script Python sui campi possono anche calcolare valori da altri dati. Ad esempio, se il record corrente espone quantity e unit_price, puoi calcolare un prezzo totale:

quantity = float(data["quantity"])
unit_price = float(data["unit_price"])
total = quantity * unit_price

return f"{total:.2f}"

Questo è utile per l’etichettatura degli ordini, le distinte di imballaggio o le etichette di magazzino dove un valore stampato dipende da più campi di input.

Fai attenzione a restituire una stringa. Se lo script restituisce un numero, LPSNG potrebbe non renderizzarlo come ti aspetti. In caso di dubbio, converti il risultato con str() o una f-string.

Verifica: confermare che lo script Python funzioni

Dopo aver collegato uno script Python a un campo, conferma l’output utilizzando almeno uno di questi controlli:

• Usa l’anteprima dell’etichetta in LPSNG. È il modo più rapido per vedere i valori dei campi dopo l’esecuzione dello script.
• Genera un output PDF o PNG tramite il servizio web o LPSNG Player, quindi ispeziona l’etichetta renderizzata. Se non hai una stampante fisica disponibile, consulta Come testare la stampa di etichette senza una stampante fisica.
• Controlla gli errori dello script nel designer. LPSNG potrebbe mostrare eccezioni Python o messaggi di errore quando testi il campo.
• Confronta l’output tra più record di dati. Esegui la stessa etichetta con dati di input diversi per confermare che lo script si comporti in modo coerente e non produca valori inattesi per campi vuoti o mancanti.

Risoluzione dei problemi comuni

Lo script non viene eseguito

Assicurati che lo script sia collegato al campo corretto. Uno script su un campo diverso non influenzerà il campo che stai ispezionando. Verifica inoltre che il tipo di campo supporti lo scripting.

Errori di sintassi

L’indentazione Python e i due punti mancanti sono cause comuni. Se l’editor dello script mostra i dettagli dell’errore, leggili attentamente. Prova prima con uno script minimo di una riga:

return value

Poi costruisci la logica in modo incrementale.

Output errato

Se il valore stampato sembra sbagliato, controlla se lo script restituisce una stringa. Per numeri e date, usa str() o una f-string per produrre output testuale:

return str(total)

Verifica inoltre che lo script stia leggendo i nomi di variabile corretti per il campo corrente e il record dati.

Prestazioni con lavori di stampa di grandi dimensioni

Per lotti di grandi dimensioni, mantieni gli script dei campi leggeri. Evita cicli complessi o operazioni costose ripetute se lo stesso risultato può essere precalcolato nel file di dati prima della stampa.

Accesso al contesto

Verifica quali variabili e import sono disponibili nell’ambiente dello script. La Field Script API è progettata per modificare i valori dei campi in base al record corrente e al contesto integrato. Potrebbe non consentire accessi arbitrari alla rete o ai file per motivi di sicurezza.

FAQ

Posso usare gli script Python per generare codici a barre dinamicamente?

Sì. LPSNG supporta gli script Python sui campi e puoi generare dinamicamente il contenuto dei codici a barre restituendo la stringa appropriata. Il tipo di campo codice a barre può quindi renderizzare quella stringa come codice a barre. Consulta la documentazione sui formati dei codici a barre per i tipi supportati. Se hai bisogno di un flusso di stampa di codici a barre completamente basato su API, consulta Automatizzare la stampa di etichette con codici a barre con l’API LPSNG.

È possibile accedere a origini dati esterne da uno script Python in LPSNG?

La Field Script API è progettata per modificare i valori dei campi in base al record dati corrente e al contesto integrato. Potrebbe non consentire accessi arbitrari alla rete o ai file per motivi di sicurezza. Per dati esterni, considera l’uso dell’API del servizio web o di file di dati come Excel e CSV per fornire i dati prima della stampa.

Come posso eseguire il debug di uno script Python che fallisce silenziosamente?

LPSNG potrebbe mostrare gli errori dello script nel designer quando testi il campo. Puoi anche aggiungere istruzioni return temporanee per ispezionare i valori intermedi:

return f"DEBUG: value={value}, type={type(value)}"

Assicurati che lo script restituisca una stringa e gestisca le eccezioni in modo appropriato, così un record errato non interrompe l’intero lavoro di stampa.

Posso riutilizzare gli script Python su più etichette?

Gli script sono generalmente collegati ai singoli campi, ma puoi copiarli e incollarli tra le etichette. Per logiche complesse, considera l’uso di un’integrazione esterna tramite l’API per preelaborare i dati prima di inviarli a LPSNG. Questo mantiene semplici gli script delle etichette e rende più facile la manutenzione della logica riutilizzata.

Conclusione

Lo scripting Python in LPSNG ti offre un modo pratico per creare etichette dinamiche e basate sui dati senza strumenti esterni. Puoi formattare stringhe, calcolare valori, aggiungere date e generare contenuti per codici a barre direttamente nel designer di etichette.

Una volta che gli script Python sui campi funzionano, il passo successivo è automatizzare il flusso di lavoro circostante. Esplora l’API del servizio web per lavori di stampa programmatici, oppure usa LPSNG Player per l’elaborazione in batch. Se stai valutando le edizioni, consulta Prezzi del software di stampa etichette: spiegazione dei piani RSJ LPSNG.

Accedi a LPSNG e apri il designer di etichette per provare oggi il tuo primo script Python sui campi.

Articoli correlati

• Automatizzare la stampa di etichette con codici a barre con l’API LPSNG
• Come testare la stampa di etichette senza una stampante fisica
• Prezzi del software di stampa etichette: spiegazione dei piani RSJ LPSNG
• Soluzioni di stampa etichette per sistemi di gestione del magazzino