Objekte & Befehle

Zuerst: die Konventionen

Bevor Sie einzelne Befehle lernen, lernen Sie die Regeln, die für alle gelten. Das spart mehr Zeit als jede Befehlsliste.

Das Befehlsformat

Jeder Befehl steht in einer eigenen Template-Zeile:

<CMD="BEFEHL"><PARAMETER="Wert"><PARAMETER="Wert">…

Für jedes Kommando kann zusätzlich eine WHEN-Bedingung angegeben werden (siehe Guide 4).

Farbangaben

Alle Farbparameter (COLOR, BGCOLOR, FORECOLOR, BACKCOLOR, TEXTCOLOR, COLOREDGE, …) akzeptieren zwei Schreibweisen:

• Konstante: BLACK, BLUE, GREEN, CYAN, RED, MAGENTA, YELLOW, WHITE
• RGB-Wert: R,G,B, z. B. 255,0,0

Die zwei Merksätze

Weitere gemeinsame Werte

---

CANVAS, die Grundlage jedes Templates

CANVAS gibt die Auflösung des Templates in Pixel vor. Die Werte müssen mit den physischen Label-Werten übereinstimmen.

<CMD="CANVAS"><WIDTH="640"><HEIGHT="960"><ROTATE="90">

Diese Werte setzen Sie normalerweise über den Config-Dialog (siehe Guide 2), Sie können sie aber jederzeit direkt im Quellcode ändern.

screenshot201.png

---

TEXT, das wichtigste Objekt

TEXT ist der Befehl, den Sie am häufigsten verwenden, und zugleich der komplexeste. Wenn Sie TEXT beherrschen, verstehen Sie das Muster aller anderen Befehle.

<CMD="TEXT"><Y="36"><X="0"><WIDTH="640"><HEIGHT="100"><TEXT="{ARTIKELBEZEICHNUNG 1}"><COLOR="BLACK"><FONT="Segoe UI"><FONTSIZE="40"><BOLD="FALSE"><CENTER>

screenshot202.png

Position und Rahmen

Der Textinhalt

Text kürzen und beschneiden

Diese Parameter retten Layouts, wenn ERP-Daten mal wieder länger sind als geplant:

Schrift und Ausrichtung

screenshot203.png

---

ATEXT, mehrere Formatierungen in einem Text

ATEXT (Attribute Text) erlaubt unterschiedliche Formatierungen innerhalb eines Textes, Schriften, Größen, Farben, Stile, über eingebettete Steuerbefehle. Für die allgemeine Formatierung gelten die TEXT-Parameter.

Die Steuerbefehle werden mit zwei Unterstrichen eingeleitet und abgeschlossen:

Zusätzliche ATEXT-Parameter: ANGLE (Drehwinkel, hier mit „L”!), ROTATIONPOINT, LEFT/CENTER/RIGHT, JUSTIFICATION (Blocksatz), BGCOLOR und BGDISTANCE (Rahmenbreite der Hintergrundfarbe).

---

PRICE, der Preis als eigenes Objekt

Für Preise gibt es einen eigenen Befehl. Er liefert versetzte, skalierbare, ggf. unterstrichene Nachkommastellen und ein optionales Währungssymbol, also genau das typische Preisschild-Layout, das Sie mit TEXT nur mühsam nachbauen könnten.

<CMD="PRICE"><X="0"><Y="0"><WIDTH="200"><HEIGHT="100"><TEXT="99.95"><TEXTCOLOR="BLACK"><FONT="Calibri"><FONTSIZE="50"><NSCALE="50"><NOFFSETY="-40"><WAEHRUNG="€"><WSCALE="70"><WOFFSETX="20"><WOFFSETY="-20">

screenshot204.png

---

BARCODE, QRCODE, DATAMATRIX

BARCODE

<CMD="BARCODE"><Y="0"><X="0"><TYPE="EAN13"><TEXT="978020137962"><SIZE="150"><WIDTH="200"><HEIGHT="50">

screenshot205.png

QRCODE

<CMD="QRCODE"><Y="0"><X="0"><WIDTH="75"><TEXT="www.esl-easy.de"><QUITEZONES="ZERO">

QRCODE_VCARD erzeugt einen QR-Code als vCard, Smartphones erkennen ihn als Kontakt und speichern ihn. Die vCard-Felder (NAME, FIRSTNAME, TEL_CELL, EMAIL_WORK, URL, STREET, ORG, …) werden direkt als Parameter übergeben; nicht benötigte Tags können weggelassen werden. Ohne Angabe von VCARD_TEMPLATE wird das mitgelieferte Default-Template vCard.txt verwendet.

DATAMATRIX

<CMD="DATAMATRIX"><Y="10"><X="10"><WIDTH="75"><HEIGHT="75"><TEXT="www.esl-easy.de">

Zusätzliche Parameter: MARGINSIZE (Randgröße), MODULSIZE (Größe/Qualität des Codes) und SCHEME (Data-Matrix-Schema nach ISO, ASCII ist Default, weitere: ASCIGS1, AUTOBEST, AUTOFAST, BASE256, C40, EDIIFACT, TEXT, X12).

---

IMAGE, Grafiken einbinden

Unterstützte Formate: PNG, JPG, BMP, GIF, TIF, TIFF, WMF.

<CMD="IMAGE"><Y="215"><X="170"><HEIGHT="38"><WIDTH="150"><FILE="ESL-Easy.PNG">

---

Die WIDTH/HEIGHT-Falle

---

OFFSET & LAYER, der Multi-Artikel-Trick

Das ist die Technik, die aus einem Preisschild ein Regal-Label mit vier Artikeln macht, ohne dass Sie eine einzige Koordinate neu berechnen müssen.

Das Problem

Sie haben einen fertigen Artikel-Block gebaut: Bezeichnung, Preis, Grundpreis, Barcode. Jetzt sollen vier davon untereinander aufs Label. Von Hand hieße das: alle Zeilen kopieren, bei jeder Kopie alle Y-Koordinaten anpassen und bei jedem Datenfeld die Ebene ändern. Bei vier Artikeln und sechs Objekten sind das 24 manuelle Änderungen.

Die Lösung in zwei Befehlen

OFFSET verschiebt den Nullpunkt für alle folgenden Objekte. Die Objektposition ergibt sich dann aus: eigene X/Y-Angabe + OFFSET.

<CMD="OFFSET"><Y="150">
<CMD="OFFSET"><X="250"><Y="150">
<CMD="OFFSET"><Y="-75">

LAYER setzt die Datenfeld-Ebene für alle folgenden Datenfelder, statt an jedes einzelne Feld ein _2-Suffix zu hängen.

<CMD="LAYER"><LEVEL="2">   → {DESCRIPTION} wird intern zu {DESCRIPTION_2}
<CMD="LAYER"><LEVEL="1">   → Reset: es gilt wieder die Angabe im Quellcode

Das Rezept

Keine Koordinate wird angefasst. Kein Datenfeld wird umbenannt.

screenshot206.png

---

Dynamische Ausrichtung, Objekte, die sich aneinander orientieren

Manchmal reicht eine feste Position nicht: Der Preis soll unter der Artikelbezeichnung stehen, egal, wie hoch die Bezeichnung nach AUTOSIZE und WORDWRAP tatsächlich ausfällt.

So funktioniert es

Ein Objekt erhält einen Namen:

<NAME="Object1">

Jedes nachfolgende Objekt kann dann auf dessen Parameter zugreifen.

Die Befehle

Aufbau: <Befehl, @Objektname, Parameter, Parameter, @Objektname, Parameter, …>

Beispiele

<ADDYFROM="@OBJECT1,Y,HEIGHT">

Addiert zum eigenen Y die Werte Y und HEIGHT von OBJECT1. Rechnung: Eigenes <Y="10">, OBJECT1 hat <Y="20"> und <HEIGHT="10"> → Y = 40 (10 + 20 + 10). Das Objekt sitzt damit exakt unter OBJECT1, egal, wie hoch OBJECT1 wird.

<ADDYFROM="@OBJECT1,Y,HEIGHT,@OBJECT2,Y,HEIGHT">

Zugriff auf mehrere Objekte: erst Objektname, dann dessen Parameter, dann das nächste Objekt.

<ADDXFROM="@OBJECT1,Y,WIDTH,20">

Statt Parametern sind auch feste Zahlen möglich, hier werden zusätzlich 20 Punkte addiert.

<ADDXFROM="PRICE">

Nur ein Objektname: Es wird das zum Befehl passende Attribut verwendet (hier das X des Objekts PRICE).

<ADDXFROM="-100">

Nur eine Zahl, entspricht <SUBXFROM="100">.

screenshot207.png

---

Weitere nützliche Befehle

CHECKDATA, den Anwender vor dem falschen Template schützen

Prüft die Nutzdaten darauf, ob sie zum aktuellen Template passen. Relevant, wenn es mehrere Templates pro Label-Typ gibt.

<CMD="CHECKDATA"><FIELD="WGR"><VALUE="10"><COMPARISON="UNEQUAL"><MESSAGE="Artikel und Template passen nicht zur Produktgruppe WEIN. Soll die Verknüpfung trotzdem erfolgen?"><ACTION="YESNO">

PARAM, label-individuelle Werte

Definiert Parameter, die der Anwender bei der Verknüpfung individuell für das aktuelle Label setzt, z. B. einen Richtungspfeil, der nur auf diesem einen Label erscheinen soll, auch wenn weitere Labels dieselben Artikeldaten zeigen.

<CMD="PARAM"><NAME="PFEIL"><VALUES="OHNE;OBEN;RECHTS;UNTEN;LINKS">

• VALUES, Vorauswahl-Werte, mit Semikolon getrennt. Bleibt VALUES leer, kann der Anwender freien Text erfassen.
• GROUP, gruppiert die Parameter auf dem mobilen Gerät mit Gruppenüberschrift.
• LOCATIONINCLUSION / LOCATIONEXCLUSION, in welchen Locations der Parameter angezeigt wird.

Solche Werte können nicht aus externen Daten kommen; sie werden direkt zur Label-ID gespeichert. Der Zugriff im Template erfolgt wie auf normale Nutzdaten: {PFEIL}.

screenshot208.png

LOCATION, Template-Sichtbarkeit steuern

Beschränkt die Sichtbarkeit des Templates in der Template-Auswahl:

<CMD="LOCATION"><INCLUSION="1"><EXCLUSION="">

INCLUSION = Location-Nummern (mit Komma), in denen das Template angezeigt wird. EXCLUSION = Locations, in denen es nicht angezeigt wird.

NFC, Daten auf den Label-Chip schreiben

Der Befehl unterscheidet sich je nach Hersteller:

Ontime, schlicht:

<CMD="NFC"><NFC_URL="http://www.esl-easy.de">

Eine URL wird vom Smartphone nach dem Lesen automatisch geöffnet.

Hanshow, mit öffentlichem und privatem Bereich:

<CMD="NFC"><URI_STANDARD="{URI_STANDARD}"><URI_PRIVATE="{URI_PRIVATE}"><NFC_KEY="GeheimerKey"><TAG_PERMISSION="READONLY"><APP_PERMISSION="READWRITE">

Daten im öffentlichen Bereich (URI_STANDARD, TEXT_STANDARD) sind mit allen gängigen NFC-Lesegeräten lesbar, etwa dem Kunden-Smartphone. Die Ablage erfolgt im NDEF-Format. Zum Lesen des privaten Bereichs (URI_PRIVATE, TEXT_PRIVATE) ist spezielle HANSHOW-Software nötig; NFC_KEY ist ein 16 Zeichen langer Schlüssel (kürzere Texte werden vorne mit Leerzeichen aufgefüllt).

BARGRAPH, Balken und Fortschrittsanzeigen

<CMD="BARGRAPH"><Y="10"><X="10"><WIDTH="20"><HEIGHT="100"><COLOR="BLACK"><BARCOLOR="RED"><PERCENT="20"><THICKNESS="1"><BARPOSITION="LOWER">

PERCENT gibt den Füllgrad an, BARPOSITION die Zeichenrichtung (LEFT, UPPER, RIGHT, LOWER, Default ist LOWER, also von unten nach oben). BARSTYLE bietet über 50 Füllmuster.

---

Was dieser Guide nicht abdeckt

Die Befehlsreferenz umfasst rund 30 Befehle. Nicht behandelt wurden unter anderem:

• Zeichenobjekte: LINE, RECTANGLE, ELLIPSE, POLYGON, PIE, ARC, COCKPITCHART
• FONT, erzeugt einen Font für nachfolgende Befehle (normalerweise nicht nötig, da der Font je Befehl angegeben wird)
• BACKGROUNDCOLOR, Hintergrundfarbe des Templates (Default: WHITE)
• Formatierungsdateien (.fmt), zu jeder Grafikdatei anlegbar
• PAGE, mehrere Ansichten pro Label (siehe Guide 4)

Vollständige Referenz: Original-PDF ESLEasy_TemplateEditor 2.7_DE, S. 26–61.

---

Zum Weiterlesen

• Vorheriger Guide: Ihr erstes Template in 15 Minuten
• Nächster Guide: Logik: WHEN, Makros, Formatierung, bedingte Sichtbarkeit, Berechnungen und Label-Parameter