Python-Etikettendruck: Felder mit LPSNG anpassen

Sie müssen Etiketten drucken, deren Inhalt nicht feststeht. Ein Produktname muss möglicherweise in Großbuchstaben umgewandelt werden, ein Verfallsdatum aus einem Produktionsdatum berechnet oder ein Gesamtpreis aus Menge und Stückpreis abgeleitet werden. Statt vor jedem Druckauftrag ein separates Python-Skript zur Transformation Ihrer Daten auszuführen, können Sie Python direkt an Etikettenfelder in LPSNG anhängen.

Mit der Field Script API betten Sie kleine Python-Blöcke in einzelne Etikettenfelder ein. Bevor LPSNG das Etikett rendert, führt es diese Skripte aus und verwendet den zurückgegebenen Wert als endgültigen Feldinhalt. Dies ist der Kern des Python-Skript-Etikettendrucks in LPSNG: datengesteuerte Feldwerte ohne externe Skript-Pipeline.

Da das Next Generation Label Printing System einen visuellen Etikettendesigner und eine integrierte Python-Ausführung umfasst, müssen Sie keine separate Python-Umgebung einrichten, keine Druckertreiber verwalten und keine rohen Druckprotokolle handhaben. Der verwaltete Workflow hält Etikettendesign, Skriptausführung und Druckauftragsübermittlung an einem Ort.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

• Ein LPSNG-Konto mit Zugriff auf den Etikettendesigner. Dies gilt sowohl für die Cloud- als auch für die Embedded-Edition.
• Grundlegende Vertrautheit mit der Python-Syntax: Variablen, Funktionen, String-Methoden und F-Strings.
• Ein Etikettenlayout, mit dem Sie arbeiten können, oder die Möglichkeit, ein neues in LPSNG zu erstellen.
• Optional: eine Beispieldatendatei wie CSV oder Excel, um dynamische Feldwerte anhand realistischer Datensätze zu testen.

Sie benötigen keine lokale Python-Installation. Die Python-Skripte werden innerhalb von LPSNG als Teil des Etiketten-Rendering-Prozesses ausgeführt.

Schritt für Schritt: Python-Skripte zu Etikettenfeldern hinzufügen

Schritt 1: Öffnen Sie den Etikettendesigner und wählen Sie das Zielfeld aus

Melden Sie sich bei LPSNG an und öffnen Sie das Etikett, das Sie ändern möchten. Wählen Sie im Etikettendesigner das Feld aus, das dynamischen Inhalt enthalten soll — zum Beispiel ein Textfeld für den Produktnamen.

Wenn Sie von Grund auf beginnen, erstellen Sie ein neues Etikett, fügen Sie ein Textfeld hinzu und binden Sie es an eine Datenquelle oder lassen Sie es als Platzhalter zum Testen.

Schritt 2: Öffnen Sie die Feldeigenschaften und suchen Sie den Skriptbereich

Wählen Sie das Feld aus und öffnen Sie seine Eigenschaften. Suchen Sie nach dem Skriptbereich, der für Python-Code vorgesehen ist. Die Field Script API behandelt diesen als einen an das Feld angehängten Skriptblock, daher kann der Abschnitt je nach Designer-Version mit Script, Python oder ähnlich beschriftet sein.

Der wichtige Punkt ist, dass das Skript zum Feld gehört, nicht zum gesamten Etikett. Wenn Sie ein Skript an das falsche Feld anhängen, hat es nicht die erwartete Auswirkung auf die Ausgabe.

Schritt 3: Schreiben Sie ein Skript, das den Feldwert empfängt und einen geänderten Wert zurückgibt

Im Python-Skriptbereich steht der aktuelle Feldwert Ihrem Code zur Verfügung. Ein minimales Skript, das den Wert in Großbuchstaben umwandelt, sieht so aus:

return value.upper()

Wenn das Feld vor der Skriptausführung "apple" enthält, zeigt das gerenderte Etikett "APPLE" an.

Verwenden Sie return, um den endgültigen Wert an das Etikett zurückzusenden. LPSNG verwendet den zurückgegebenen Wert als gedruckten Feldinhalt.

Schritt 4: Verwenden Sie Kontextvariablen, um dynamische Inhalte zu erstellen

Sie können den aktuellen Feldwert mit Datumsangaben, Datensatzdaten oder anderem während des Renderings verfügbaren Kontext kombinieren. Um beispielsweise das aktuelle Datum an einen Produktnamen anzuhängen:

from datetime import datetime

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

Wenn der Feldwert "Tomato Sauce" ist, könnte das gerenderte Ergebnis so aussehen:

Tomato Sauce - 2026-08-26

Je nachdem, wie Ihr Etikett an eine Datenquelle gebunden ist, kann der aktuelle Datensatz auch als Teil des Skriptkontexts verfügbar sein. Überprüfen Sie die Datenbindungseinstellungen Ihres Etiketts im Designer, um zu bestätigen, welche Variablen Sie verwenden können.

Schritt 5: Testen Sie das Skript im Designer

Verwenden Sie die Etikettenvorschau oder Testdaten, um die Ausgabe vor dem Druck zu überprüfen. LPSNG führt die Felder-Skripte während der Vorschau aus, sodass Sie das genaue Ergebnis Ihres Python-Codes sehen können, ohne einen Druckauftrag zu senden.

Nehmen Sie kleine Änderungen vor und führen Sie die Vorschau erneut aus, bis das Feld genau das anzeigt, was Sie benötigen.

Schritt 6: Speichern Sie das Etikett und verwenden Sie es in einem Druckauftrag

Sobald das Skript in der Vorschau funktioniert, speichern Sie das Etikett. Sie können es nun über die Web-UI, die Web-Service-API oder den LPSNG Player verwenden.

Der verwaltete Workflow bedeutet, dass Sie Ihr Python-Skript nicht exportieren, in einen separaten Auftragsprozessor einbinden oder mit einem Druckerprotokoll kommunizieren müssen. LPSNG führt das Skript als Teil des Etiketten-Renderings aus und sendet die fertige Ausgabe an den ausgewählten Drucker oder das Dateiformat.

Schritt 7: Optional — kombinieren Sie mehrere Felder oder führen Sie Berechnungen durch

Python-Feldskripte können auch Werte aus anderen Daten berechnen. Wenn der aktuelle Datensatz beispielsweise quantity und unit_price bereitstellt, können Sie einen Gesamtpreis berechnen:

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

return f"{total:.2f}"

Dies ist nützlich für Auftragsetiketten, Lieferscheine oder Lageretiketten, bei denen ein gedruckter Wert von mehreren Eingabefeldern abhängt.

Achten Sie darauf, einen String zurückzugeben. Wenn Ihr Skript eine Zahl zurückgibt, rendert LPSNG sie möglicherweise nicht wie erwartet. Wandeln Sie das Ergebnis im Zweifelsfall mit str() oder einem F-String um.

Überprüfung: Bestätigen, dass Ihr Python-Skript funktioniert

Nachdem Sie ein Python-Skript an ein Feld angehängt haben, bestätigen Sie die Ausgabe mit mindestens einer dieser Prüfungen:

• Verwenden Sie die Etikettenvorschau in LPSNG. Dies ist der schnellste Weg, um die Feldwerte nach der Skriptausführung zu sehen.
• Erzeugen Sie eine PDF- oder PNG-Ausgabe über den Web-Service oder den LPSNG Player und prüfen Sie dann das gerenderte Etikett. Wenn Sie keinen physischen Drucker zur Verfügung haben, siehe So testen Sie den Etikettendruck ohne physischen Drucker.
• Prüfen Sie auf Skriptfehler im Designer. LPSNG kann Python-Ausnahmen oder Fehlermeldungen anzeigen, wenn Sie das Feld testen.
• Vergleichen Sie die Ausgabe über mehrere Datensätze hinweg. Führen Sie dasselbe Etikett mit unterschiedlichen Eingabedaten aus, um zu bestätigen, dass sich das Skript konsistent verhält und keine unerwarteten Werte für leere oder fehlende Felder erzeugt.

Fehlerbehebung bei häufigen Problemen

Skript wird nicht ausgeführt

Stellen Sie sicher, dass das Skript an das richtige Feld angehängt ist. Ein Skript an einem anderen Feld wirkt sich nicht auf das Feld aus, das Sie prüfen. Bestätigen Sie außerdem, dass der Feldtyp Skripting unterstützt.

Syntaxfehler

Python-Einrückungen und fehlende Doppelpunkte sind häufige Ursachen. Wenn der Skripteditor Fehlerdetails anzeigt, lesen Sie diese sorgfältig. Testen Sie zuerst mit einem minimalen einzeiligen Skript:

return value

Bauen Sie die Logik dann schrittweise auf.

Falsche Ausgabe

Wenn der gedruckte Wert falsch aussieht, prüfen Sie, ob Ihr Skript einen String zurückgibt. Verwenden Sie für Zahlen und Datumsangaben str() oder einen F-String, um Textausgabe zu erzeugen:

return str(total)

Überprüfen Sie außerdem, ob das Skript die richtigen Variablennamen für das aktuelle Feld und den Datensatz liest.

Leistung bei großen Druckaufträgen

Halten Sie Feldskripte bei großen Stapeln leichtgewichtig. Vermeiden Sie komplexe Schleifen oder wiederholte teure Operationen, wenn dasselbe Ergebnis vor dem Druck in Ihrer Datendatei vorberechnet werden kann.

Kontextzugriff

Bestätigen Sie, welche Variablen und Importe in der Skriptumgebung verfügbar sind. Die Field Script API ist darauf ausgelegt, Feldwerte basierend auf dem aktuellen Datensatz und dem integrierten Kontext zu ändern. Sie erlaubt aus Sicherheitsgründen möglicherweise keinen beliebigen Netzwerk- oder Dateizugriff.

FAQ

Kann ich Python-Skripte verwenden, um Barcodes dynamisch zu generieren?

Ja. LPSNG unterstützt Python-Skripte auf Feldern, und Sie können Barcode-Inhalte dynamisch generieren, indem Sie den entsprechenden String zurückgeben. Der Barcode-Feldtyp kann diesen String dann als Barcode rendern. Prüfen Sie die Dokumentation zu den Barcode-Formaten für unterstützte Typen. Wenn Sie einen vollständigen API-gesteuerten Barcode-Druckablauf benötigen, siehe Barcode-Etikettendruck mit LPSNG API automatisieren.

Ist es möglich, aus einem Python-Skript in LPSNG auf externe Datenquellen zuzugreifen?

Die Field Script API ist darauf ausgelegt, Feldwerte basierend auf dem aktuellen Datensatz und dem integrierten Kontext zu ändern. Sie erlaubt aus Sicherheitsgründen möglicherweise keinen beliebigen Netzwerk- oder Dateizugriff. Für externe Daten sollten Sie die Web-Service-API oder Datendateien wie Excel und CSV verwenden, um Daten vor dem Druck bereitzustellen.

Wie debugge ich ein Python-Skript, das stillschweigend fehlschlägt?

LPSNG kann Skriptfehler im Designer anzeigen, wenn Sie das Feld testen. Sie können auch temporäre Return-Anweisungen hinzufügen, um Zwischenwerte zu prüfen:

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

Stellen Sie sicher, dass das Skript einen String zurückgibt und Ausnahmen ordnungsgemäß behandelt, damit ein fehlerhafter Datensatz nicht den gesamten Druckauftrag unterbricht.

Kann ich Python-Skripte über mehrere Etiketten hinweg wiederverwenden?

Skripte sind in der Regel an einzelne Felder angehängt, aber Sie können sie zwischen Etiketten kopieren und einfügen. Für komplexe Logik sollten Sie eine externe Integration über die API in Betracht ziehen, um Daten vor dem Senden an LPSNG vorzuverarbeiten. Dies hält die Etikettenskripte einfach und macht wiederverwendete Logik leichter wartbar.

Fazit

Python-Skripting in LPSNG bietet Ihnen eine praktische Möglichkeit, dynamische, datengesteuerte Etiketten ohne externe Tools zu erstellen. Sie können Strings formatieren, Werte berechnen, Datumsangaben anhängen und Barcode-Inhalte direkt im Etikettendesigner generieren.

Sobald Ihre Python-Feldskripte funktionieren, besteht der nächste Schritt darin, den umgebenden Workflow zu automatisieren. Erkunden Sie die Web-Service-API für programmatische Druckaufträge oder verwenden Sie den LPSNG Player für die Stapelverarbeitung. Wenn Sie Editionen vergleichen, siehe Preise für Etikettendrucksoftware: RSJ LPSNG-Tarife erklärt.

Melden Sie sich bei LPSNG an und öffnen Sie den Etikettendesigner, um noch heute Ihr erstes Python-Feldskript auszuprobieren.

Verwandte Beiträge

• Barcode-Etikettendruck mit LPSNG API automatisieren
• So testen Sie den Etikettendruck ohne physischen Drucker
• Preise für Etikettendrucksoftware: RSJ LPSNG-Tarife erklärt
• Etikettendrucklösungen für Lagerverwaltungssysteme