So erstellen Sie Etiketten aus Excel-Datendateien und Nachschlagetabellen

Ihre Bestellungen liegen in Excel. Ihre Produktnamen liegen in Excel. Ihre Adressen liegen in Excel. Und trotzdem öffnet jedes Mal, wenn Sie Etiketten benötigen, jemand die Tabellenkalkulation, kopiert eine Zeile, fügt sie in eine Vorlage ein, speichert ein PDF und wiederholt das Ganze – vierzig Mal. Oder schlimmer: Jemand hat vor zwei Jahren ein brüchiges Skript geschrieben, das jedes Mal bricht, wenn eine Spalte umbenannt wird.

Dieser Artikel beschreibt die Alternative: eine Excel-Datei als Datenquelle und eine zweite Excel-Datei (oder ein zweites Tabellenblatt) als Nachschlagetabelle verwenden und daraus fertige Etiketten als mehrseitiges PDF, einzelne PNGs oder direkte Druckerausgabe erzeugen – ohne Copy-Paste und ohne einen Parser pflegen zu müssen.

Was Sie am Ende haben werden:

• Eine Datendatei mit einer Zeile pro Etikett und einer Kopfzeile, die zu Ihren Feldnamen wird.
• Eine Nachschlagetabelle, die Schlüssel wie SKU in vollständige Produktnamen oder Kategorien auflöst.
• Ein Etikettenlayout im LPSNG-Etikettenstudio mit Feldern, die auf Tabellenkalkulationsspalten abgebildet sind.
• Einen wiederholbaren Job: Tabellenkalkulation ändern, erneut ausführen, neue Etiketten erhalten.

Das Next Generation Label Printing System übernimmt das Rendering, die Job-Warteschlange und die Ausgabe für Sie. Wenn Sie einzelne Feldwerte mit Python statt mit einfachem Mapping transformieren möchten, wird das separat behandelt in Label Printing API for Python Developers: Field Scripting – dieser Artikel bleibt beim Tabellenkalkulations-Weg.

Voraussetzungen: Was Sie vor dem Start benötigen

• Eine RSJ LPSNG-Edition mit Zugriff auf Etikettenstudio und Job-Warteschlange. Die Cloud Solution, die Embedded Edition (ein Einplatinencomputer wie ein Raspberry Pi) und die Enterprise Features stellen alle dieselbe Kernfunktionalität bereit.
• Ihre Excel-Datendatei, eine Zeile pro Etikett – zum Beispiel Artikelnummer, Beschreibung, Preis.
• Optional eine separate Nachschlagetabelle (oder ein separates Tabellenblatt), die einen Schlüssel – zum Beispiel die Artikelnummer – auf den Text abbildet, den Sie tatsächlich auf dem Etikett haben möchten, etwa den vollständigen Produktnamen oder die Kategorie.
• Ein Etikettenlayout. Entweder eines, das Sie im LPSNG-Etikettenstudio erstellt haben, oder ein vorhandenes Layout, das Sie mit Tabellenkalkulationsdaten speisen möchten.
• Eine klare Vorstellung davon, welche Spalte in welches Feld gehört. Skizzieren Sie es zur Not auf Papier; fünf Minuten hier sparen eine Stunde Nachmapping.

Die Excel-Schnittstelle ist dokumentiert unter lpsng.rsj.de/en/excel. Außer Ihrem Browser ist keine lokale Installation erforderlich; Ihre Druckereinrichtung ist der einzige lokale Bestandteil.

Schritt 1: Bereiten Sie Ihre Excel-Datendatei und Nachschlagetabelle vor

Strukturieren Sie die Datendatei mit einer Kopfzeile, denn jede Spaltenüberschrift wird zu einem benannten Feld, das Sie später zuordnen können.

SKU,Description,Price,Quantity
A-1001,Steel bracket 40mm,4.90,1
A-1002,Steel bracket 60mm,5.40,2
A-1003,Aluminium bracket 40mm,6.10,1

Erstellen Sie dann die Nachschlagetabelle als separates Tabellenblatt oder separate Datei mit einer Schlüsselspalte und den zu mischenden Werten:

[
  { "SKU": "A-1001", "ProductName": "Steel Bracket, 40 mm, galvanised", "Category": "Hardware" },
  { "SKU": "A-1002", "ProductName": "Steel Bracket, 60 mm, galvanised", "Category": "Hardware" },
  { "SKU": "A-1003", "ProductName": "Aluminium Bracket, 40 mm",        "Category": "Hardware" }
]

Ein paar Regeln, die die meisten späteren Probleme verhindern:

• Halten Sie Schlüssel konsistent. Gleiche Schreibweise, gleiches Format, gleiche Groß-/Kleinschreibung auf beiden Seiten.
• Entfernen Sie verbundene Zellen und leere Zeilen. Sie brechen das Spalten-Mapping und können die erkannte Kopfzeile verschieben.
• Achten Sie auf führende Nullen. Wenn SKU 0042 ist, erzwingen Sie in Excel das Textformat für die Spalte – sonst kommt der Schlüssel als 42 an und die Nachschlagetabelle verfehlt ihn stillschweigend.
• Eine Datei genügt. Sie können dieselbe Arbeitsmappe sowohl für Daten als auch für die Nachschlagetabelle verwenden, indem Sie sie auf separate Tabellenblätter legen.

Vor dem Hochladen fängt ein schneller Plausibilitätscheck in pandas Schlüsselabweichungen früh ab:

import pandas as pd

data   = pd.read_excel("orders-october.xlsx", sheet_name="Data",     dtype=str)
lookup = pd.read_excel("orders-october.xlsx", sheet_name="Products", dtype=str)

# Normalise the join key identically on both sides.
for df in (data, lookup):
    df["SKU"] = df["SKU"].str.strip().str.upper()

orphans = sorted(set(data["SKU"]) - set(lookup["SKU"]))
print(f"{len(data)} data rows, {len(orphans)} keys without a lookup entry")
print(orphans)

Wenn orphans leer ist, wird Ihre Nachschlagetabelle für jede Zeile aufgelöst.

Schritt 2: Entwerfen oder öffnen Sie Ihr Etikettenlayout in LPSNG

Öffnen Sie das LPSNG-Etikettenstudio und erstellen Sie ein neues Layout oder öffnen Sie ein vorhandenes.

• Fügen Sie Textfelder für Beschreibungen und Preise, Barcode-Felder für die Artikelnummer und Bildfelder hinzu, wenn Sie ein Logo oder Produktfoto möchten.
• Benennen Sie jedes Feld aussagekräftig – field_product_name, field_price, field_sku –, damit das Mapping von der Tabellenkalkulationsspalte zum Etikettenfeld auch in sechs Monaten noch offensichtlich ist. Für die Barcode-Seite sind die unterstützten 1D- und 2D-Formate aufgeführt unter lpsng.rsj.de/en/barcode.
• Reservieren Sie genügend Platz. Tabellenkalkulationswerte sind nicht einheitlich: Die erste Zeile mag eine kurze Beschreibung sein, die fünfzigste bricht auf drei Zeilen um. Lassen Sie Raum, statt später die Schrift zu verkleinern.
• Transformieren Sie Werte nur, wenn nötig. Einen Preis formatieren, zwei Spalten verketten oder eine Prüfziffer berechnen ist Aufgabe eines Python-Skriptblocks, der an das Feld angehängt wird, dokumentiert in der Python-API-Referenz unter lpsng.rsj.de/api.

Speichern Sie das Layout. Es wird zur Vorlage für jede Zeile in Ihrer Excel-Datei – die Designarbeit erfolgt einmalig.

Schritt 3: Ordnen Sie Excel-Spalten Etikettenfeldern zu

Laden Sie in der LPSNG-Excel-Schnittstelle Ihre Arbeitsmappe als Datenquelle hoch oder wählen Sie sie aus, und weisen Sie dann jede Spalte einem Feld zu. Geben Sie für Nachschlagewerte das Nachschlageblatt oder die Nachschlagedatei und die Schlüsselspalte an; LPSNG löst die Nachschlagetabelle pro Zeile vor dem Rendern auf, sodass das Etikettenfeld den zusammengeführten Wert erhält, nicht den Rohschlüssel.

Die Mapping-Oberfläche drückt etwa Folgendes aus – die Schnittstelle schreibt die Konfiguration für Sie:

# Illustrative shape of the mapping you configure in the Excel interface.
layout: product-label
data_source:
  file: orders-october.xlsx
  sheet: Data
fields:
  field_sku:         SKU
  field_description: Description
  field_price:       Price
lookup:
  file: orders-october.xlsx
  sheet: Products
  key: SKU
  merge:
    field_product_name: ProductName
    field_category:     Category
output:
  format: pdf

Prüfen Sie dann das Mapping mit den ersten paar Zeilen in der Vorschau. In der Vorschau erkennen Sie eine um eins verschobene Spalte oder einen Preis, der im Beschreibungsfeld landet – bevor Sie eine Rolle Etiketten verbrauchen.

Dies ist die verwaltete Alternative zum Schreiben eines eigenen Parsers oder zum Verdrahten einer Kommandozeilen-Pipeline: Das Mapping selbst benötigt keinen Code.

Schritt 4: Rendern Sie Etiketten als PDF, PNG oder senden Sie sie zum Druck

Wählen Sie Ihre Ausgabe:

• Mehrseitiges PDF – ideal zum Archivieren, Versenden per E-Mail oder Weitergeben an eine Druckerei.
• Einzelne PNG-Bilder – zum Einbetten in ein anderes System oder ein Web-Frontend.
• Direkter Druck – wählen Sie den Drucker, und die Job-Warteschlange verarbeitet jede Zeile als separates Etikett.
• JSON – wenn ein nachgelagertes System das gerenderte Ergebnis oder die aufgelösten Daten statt Papier benötigt.

Für die Automatisierung steuern Sie denselben Job aus dem Code. Die Web-Service-API übermittelt Druckjobs, rendert einzelne Etiketten als PDF oder PNG und unterstützt den direkten Druck; die Authentifizierung erfolgt über OAuth2, dokumentiert unter lpsng.rsj.de/en/webservice. Der eigenständige LPSNG Player nimmt ein Paket plus Daten entgegen und schreibt PDF, PNG, JSON oder sendet an einen Drucker:

# Endpoint paths, flags and payload fields are documented on the web service
# and Player pages — the shape below is illustrative only.
curl -X POST "https://<your-lpsng-host>/…"   -H "Authorization: Bearer $LPSNG_TOKEN"   -d '{ "layout": "product-label", "data": "orders-october.xlsx", "output": "pdf" }'

lpsng-player   --package product-label   --data orders-october.xlsx   --output pdf

Wenn Ihr Team eher in Google Sheets als in Excel arbeitet, bietet das Google Sheets Add-on denselben Workflow zum Erstellen und Drucken im Browser. Und das gesamte Rendering erfolgt serverseitig – Sie installieren lokal keine Schriften oder Treiber, abgesehen von Ihrer Druckereinrichtung.

Schritt 5: Überprüfen Sie die Ausgabe und kontrollieren Sie die Nachschlagevorgänge

Erfolgreich gerendert ist nicht dasselbe wie korrekt gerendert. Prüfen Sie die Artefakte:

• Stichprobenartige Kontrolle mehrerer Etiketten gegen die Quellzeilen – erste Zeile, letzte Zeile und alles mit ungewöhnlicher Formatierung.
• Bestätigen Sie, dass Nachschlagevorgänge aufgelöst wurden. Wenn das Etikett A-1002 zeigt, wo Sie „Steel Bracket, 60 mm, galvanised" erwartet hätten, hat der Schlüssel nicht gepasst.
• Scannen Sie ein paar Barcodes mit einem Lesegerät und vergleichen Sie den dekodierten Wert mit den beabsichtigten Daten. How to Verify Barcodes Before Printing Labels enthält eine ausführlichere Checkliste.
• Lesen Sie die Job-Warteschlange. Zeilen, die fehlgeschlagen oder übersprungen wurden, erscheinen dort, meist mit dem problematischen Wert oder Skriptfehler.
• Wenn Sie Feldskripte angehängt haben, bestätigen Sie, dass die Transformationen angewendet wurden – ein falsch angewendetes Datumsformat übersieht man leicht, bis jemand ein Etikett im Regal liest.

Fehlerbehebung bei häufigen Problemen

Etiketten werden mit leeren Feldern gedruckt. Prüfen Sie, ob die Spaltenüberschriften exakt mit den zugeordneten Feldnamen übereinstimmen und ob die Datendatei keine führenden Leerzeilen über der Kopfzeile enthält. Eine einzige leere Zeile oben verschiebt alles.

Ein Nachschlagevorgang liefert nichts. Die Schlüsselspalten müssen bei Groß-/Kleinschreibung, umgebenden Leerzeichen und führenden Nullen übereinstimmen. Normalisieren Sie beide Seiten wie in Schritt 1 gezeigt.

Barcodes scannen falsch. Vergewissern Sie sich, dass das Barcode-Feld auf die richtige Spalte abgebildet ist und dass das gewählte Format die Datenlänge tragen kann, die Sie kodieren.

Das Rendering schlägt nur bei einigen Zeilen fehl. Prüfen Sie die Job-Warteschlange auf Fehlermeldungen. Häufige Ursachen sind ein fehlender Wert, den das Layout erfordert, oder ein Skriptfehler in einem Feldblock.

Der Drucker erhält nichts. Vergewissern Sie sich, dass der Drucker online und in den Ausgabeeinstellungen ausgewählt ist. Für Google Cloud Print-Szenarien siehe die Dokumentation Cloud Printing.

FAQ

Kann ich dieselbe Excel-Datei sowohl für Daten als auch für die Nachschlagetabelle verwenden? Ja. Legen Sie Ihre Daten auf ein Tabellenblatt und Ihre Nachschlagetabelle auf ein anderes Tabellenblatt innerhalb derselben Arbeitsmappe. Wählen Sie beim Mapping das passende Tabellenblatt für jede Rolle aus. Stellen Sie nur sicher, dass die für Nachschlagevorgänge verwendete Schlüsselspalte auf beiden Tabellenblättern konsistent ist.

Muss ich Code schreiben, um Excel-Spalten Etikettenfeldern zuzuordnen? Nein. Die LPSNG-Excel-Schnittstelle bietet eine Mapping-Oberfläche, in der Sie Tabellenkalkulationsspalten Etikettenfeldern zuweisen. Code benötigen Sie nur, wenn Sie Werte transformieren möchten – zum Beispiel einen Preis formatieren oder Felder verketten –, was Sie mit an Felder angehängten Python-Skriptblöcken erledigen können (siehe Python API documentation).

Welche Ausgabeformate kann ich aus Excel-Daten erzeugen? Sie können mehrseitige PDFs, einzelne PNG-Bilder erzeugen, Jobs direkt an einen Drucker senden oder JSON ausgeben. Die Web-Service-API und der LPSNG Player unterstützen diese Ausgaben, sodass Sie das Rendering in Ihre eigenen Anwendungen integrieren können.

Wie aktualisiere ich Etiketten, wenn sich die Excel-Datei ändert? Laden Sie einfach die aktualisierte Excel-Datei erneut hoch oder führen Sie den Job mit den neuen Daten erneut aus. LPSNG wendet dasselbe Etikettenlayout und Mapping an, sodass Sie nichts neu gestalten müssen. Die Job-Warteschlange verarbeitet die neuen Zeilen und erzeugt aktualisierte Etiketten.

Fazit: Von der Tabellenkalkulation zu regalfertigen Etiketten

Der Workflow ist kurz: Bereiten Sie Ihre Excel-Daten und die Nachschlagetabelle vor, gestalten Sie das Layout einmal, ordnen Sie Spalten Feldern zu, rendern Sie, überprüfen Sie. Nichts in dieser Liste erfordert, dass Sie einen Parser schreiben oder ein Skript beaufsichtigen.

Das Next Generation Label Printing System erledigt die Schwerarbeit – Rendering, Job-Warteschlange, Auflösung von Nachschlagevorgängen und Ausgabe –, damit Sie Ihre Zeit mit den Daten statt mit der Infrastruktur verbringen können. Es funktioniert gleich, ob Sie zehn Etiketten oder zehntausend produzieren, und die Web-Service-API ermöglicht anderen Systemen, dieselben Jobs programmatisch auszulösen.

Testen Sie die Excel-Schnittstelle in Ihrer LPSNG-Edition – Cloud, Embedded oder Enterprise – und wenn Ihr Team Tabellenkalkulationen im Browser bevorzugt, werfen Sie einen Blick auf das Google Sheets Add-on für denselben Workflow in Ihrem Browser.

Verwandte Beiträge

• Zebra Designer Alternative for Developers: What to Compare
• How to Connect ESL Tags to Items via API
• What a Vendor-Neutral ESL Interface Means for Developers