Zum Hauptinhalt springen

Ausdruck von Etikett-Vorlagen

Probenetikett.par​

Die Vorlagendateien mit der Endung .par dienen zum Ausdruck von Etiketten in der Proben- und Chargenverwaltung sowie der Barcodeerzeugung.

In den Vorlagen wird zumeist innerhalb der Zebra-Felddefinitionen ein Java-Code aufgerufen, über welchen die gewünschten Daten ermittelt werden. Diese Ermittlung kann auf 2 Arten erfolgen:

  1. Per Reflection wird das toString() einer Methode eingefügt. Dazu wird Java-Code in die Vorlage eingegeben.
  2. Durch Zahlen werden bestimmte Elemente aus einem String[] ausgegeben. Hierbei müssen die Variablenwerte in der Klasse für den Etikettendruck ausgefüllt werden. Die Erstellung des Ausdruckes kann dann also nicht allein über die Definition der Vorlagendatei gesteuert werden.

Eine solche Vorlagendatei könnte dann in etwa wie folgt aussehen:

Tip:

Zebra-Etiketten-Vorlage

Label.Columns=-1
Label.Rows=11
Label.VerticalGap=2
Label.Paths=1
Label.HorizontalGap=2
Printer.Port=\\rechner\freigabename
Bracket.Open=<
Bracket.Close=>
Space=_
Row.1=
Row.2=N
Row.3=D10
Row.4=R20,5
Row.5=B0,0,0,1,3,6,50,B,"<getProbe().getKurzbezeichnung().toString()>"
Row.6=A10,80,0,2,1,1,N,"<getProbe().getNahmedatum()> <getProbe().getNahmezeit().toString()>"
Row.7=A0,100,0,2,1,1,N,"<StringUtil.getStringWithLen(getProbe().getProbennehmer().toString(), 40)>"
Row.8=A0,120,0,2,1,1,N,"<StringUtil.getStringWithLen(getProbe().getOrganisation(), 40)>"
Row.9=A0,140,0,2,1,1,N,"<StringUtil.getStringWithLen((getProbe().getPruefplan(), 40)>"
Row.10=A0,160,0,1,1,1,N,"<StringUtil.getStringWithLen(getProbe().getBemerkung().toString(), 40)>"
Row.11=P1

Wichtig bei der Verwendung der ZPL-basierten Vorlagen sind die Attribute:

  • Zeile 2

    Label.Rows: dieser Eintrag gibt an, wie viele Kommando-Zeilen im Etikett vorhanden sind. Die Angabe ist zwingend erforderlich und muss mit der Anzahl Einträge, welche mit Row.* beginnen, übereinstimmen.

  • Zeile 6

    Printer.Port: Angabe des Druckers, an welchen das Etikett gesendet werden soll.

  • Zeile 7/8

    Bracket.Open/Bracket.Close: Steuerzeichen, der von den angegebenen Zeichen umschlossene Inhalt wird ausgewertet und ersetzt.

  • Zeile 12

    Row.3: In dieser Zeile wird die Druckstärke für das Etikett definiert. Ist nicht zwingend erforderlich, wenn sie fehlt werden die Druckerstandardeinstellungen verwendet.

  • Zeile 13

    Row.4: Koordinaten des Referenzpunktes. Alle weiteren Angaben zu Feldkoordinaten erfolgen anhand des Referenzpunktes.

  • Zeile 14

    Row.5: Angabe des ersten Inhaltfeldes.

    • B0,0,0,1,3,6,50,B,

      Gibt an, dass der nachfolgende Inhalt als Barcode, mit verschiedenen weiteren Einstellungen, ausgegeben werden soll

    • "<getProbe().getKurzbezeichnung(). toString()>"

      Der Inhalt des Barcodes, in diesem Falle die Probennummer als Zeichenkette. Die Angabe des Inhaltes muss in Anführungszeichen erfolgen, da es sich um eine Zeichenkette handelt, welche ersetzt werden soll.

  • Zeile 20

    Row.11: Hier wird die Anzahl der zu druckenden Etiketten je ausgewähltem Objekt definiert.

Tip:

Weitere Informationen zum Erstellen von Etiketten finden Sie im Hilfe-Ordner ihrer diaLIMS-Installation in den EPL2 beziehungsweise ZPL-II-Handbüchern..

Formatierungen​

Werden die Variablen in <>-Klammern gesetzt, wird der String-Wert immer in der vollen Länge ausgegeben. Werden die Variablen in []-Klammern gesetzt, dann bestimmt die erste und letzte Klammer genau, wie breit der Wert maximal ausgegeben wird. Eine andere Möglichkeit ist, StringUtil.getStringWithLen zu verwenden. Diese Methode liefert einen String mit immer derselben festen Breite zurück.

hinweis

Tritt ein Fehler bei der Auswertung des Aufrufes auf, wird an der Stelle 'blank' oder 'bsh.evalError' auf das Etikett gedruckt.

Spaltenbreite​

Um in einer Etikettenvorlage für einen EPS-Drucker die Druckbreite zu beschränken, kann man die Funktion "StringUtil.getStringWithLen" verwenden. Diese Funktion hat zwei Übergabeparameter, der erste ist der Ausdruck, der zweite die Anzahl der Zeichen. Die zurückgelieferte Zeichenkette ist immer genauso lang wie angegebene Anzahl.

Tip:

Etikettenvorlage: Spaltenbreiten definieren

[...] Row.6=A0,60,0,4,1,1,N,"Art.:_<StringUtil.getStringWithLen(getProbe().getUntersuchungsgegenstand().toString(), 20)>" [...]

Probenetikett.etikett / Probenetikett.txt​

Vorlagen vom Typ *.etikett verwenden Java-Code um Daten aus dem diaLIMS zu ermitteln und auszugeben. Die Logik ist identisch zu der im Abschnitt Probenetikett.par genannten. Diese Technik kann verwendet werden um verschiedene Drucker anzusprechen. Der Etikettendruck für diese Dateien kann auch über den Druckdialog erfolgen und somit nicht nur an Etikettendrucker, sondern ebenfalls an Bürodrucker mit gegebenenfalls eingelegten Etiketten.

Tip:

Probenetikett.etikett - Aufbau Etikettendatei für ZPL-Drucker

^XA^PW750 ^LH0,0 ^MD10 ^F10,15^A0N,35,30^BCN,70,Y,N,N,N^FD<o.getKurzbezeichnung().toString()>^FS ^FO5,130^A0N,35,30^FD<o.getNahmedatum()> <o.getNahmezeit().toString()>^FS ^FO5,190^A0N,35,30^FD<StringUtil.getStringWithLen(o.getProbennehmer().toString(), 40)>^FS ^FO5,240^A0N,35,30^FD<StringUtil.getStringWithLen(o.getOrganisation(), 40)>^FS ^FO5,290^A0N,35,30^FD<StringUtil.getStringWithLen(o.getPruefplan(), 40)>^FS ^PQ1 ^XZ

hinweis

In diesem Etikett werden alle Befehle mit Zirkumflex eingeleitet.

  • Zeile 1

    Startkommando (^XA) für das Etikett und Angabe des Druckbereichs (^PW) in Punkten

  • Zeile 2

    Referenzpunkt (^LH) mit Koordinaten und Druckstärke (^MD)

  • Zeile 3

    Inhalt: ^FO(x,y) gibt die Koordinaten des folgendes Inhaltsfeldes an. Über das nachfolgende Kommando ^A0N,35,30 werden Angaben zur Schriftformatierung für diese Zeile vorgenommen. Anschließend erfolgt wieder die Angabe, wie das Feld dargestellt werden soll, in diesem Fall als Barcode ^BCN,70,Y,N,N,N, dann der eigentliche Inhalt, die Kurzbezeichnung des ausgewählten Datensatzes, eingeleitet über den Befehl ^FD. Mit ^FS wird dann die Zeile beendet.

  • Zeile 8

    PQ (Print Quantity), gefolgt von einer Ziffer, ist der Befehl zur Festlegung der Anzahl Etiketten

  • Zeile 9

    ^XZ ist der Ende-Befehl für das Etikett.

Probenetikett.docx​

Etikettvorlagen im docx-Format werden im Word erstellt. Für das Seitenformat sollte eine Etikett-Vorlage verwendet werden. In dieser wird auch wieder Java-Code zum Ermitteln der Etikett-Inhalte angegeben.

Diese Art der Etikettenerzeugung ist identisch zur Erstellung von Berichtsvorlagen.

Tip:

*.docx: Aufbau Etikettenvorlage

Probe: {o.getKurzbezeichnung()} {Printer.insertBarcode(o.getKurzbezeichnung)} {! /* Run-First-Skript */ o = Objekt; Printer.startCodeCharacter=“{“; Printer.endCodeCharacter=“}“; Printer.ignoreExceptions=false; Printer.declareEtikettenDrucker („\\\\Freigabe\\Druckername“, 1); Printer.declareEtikettenDrucker („Printer2“, 1); Printer.declareEtikettenDrucker („\\\\Freigabe\\Druckername“, true, 1); return null; !}

  • Zeile 1

    In der ersten Zeile wird das Label 'Probe:' geschrieben, dahinter die Probennummer der ausgewählten Probe

  • Zeile 2

    Zeile 2 wird in der Vorlage als Textbereich eingebunden. Es wird ein Druckerbefehl gegeben, der aus der übergebenen Information, in diesem Fall der Kurzbezeichnung der Probe, einen Barcode erzeugt.

  • Zeile 3ff

    Das Run-First-Script der Vorlage, mit Angabe verschiedener Parameter, wie sie auch in den Berichtsvorlagen verwendet werden.

    1. o : das im diaLIMS selektierte Objekt von welchen ausgegangen wird bei der Ermittlung der auf dem Etikett aufzudruckenden Daten
    2. startCodeCharacter / EndCodeCharacter: Definiert den zu ersetzenden Java-Code, alles was von den hier definierten Zeichen umschlossen ist wird interpretiert und ersetzt
    3. Printer.declareEtikettenDrucker: gibt an, an welchen Drucker (Freigabename) das erzeugte Etikett und wie viele Etiketten gedruckt werden sollen
      • mit dem zusätzlichen Parameter true zwischen dem Druckernamen und der Anzahl der Etiketten, wird der Druckername über eine "ähnlich-wie" Suche gesucht (falls der Drucker automatisch über das Betriebssystem eingebunden wird und ggf. einen Zusatz im Druckernamen enthalten ist).

Zuordnen von Etikettvorlagen​

Abhängig von der Art der Vorlage können diese an verschiedenen Stellen in den Modulen zugeordnet werden.

per Druck-Dialog​

Diese Möglichkeit findet zum Beispiel Anwendung in der Auftragsverwaltung. Hier wird ein Druckdialog eingeblendet, wie er auch bei der Berichtserstellung verwendet wird. Voreingestellt zur Auswahl sind Etiketten von Typ <Modulname>.*.par.

Etiketteneinstellungen​

Diesen Punkt finden Sie im Modul Proben unter dem Punkt Optionen\Etiketteinstellungen. Nach Auswahl dieses Punktes erhalten Sie einen Dialog eingeblendet, über welchen die zu verwendende Vorlage angegeben werden kann und weitere Einstellungen vorgenommen werden können:

  • Automatischer Druck

    Ist diese Option aktiviert, wird die in der Vorlage angegebene Standardanzahl Etiketten für jede Probe ausgedruckt, sobald diese registriert wird.

  • Druckvorschau anzeigen

    Ist diese Option aktiviert wird für jede Probe eine Vorschau des zu erzeugenden Etiketts angezeigt.

per properties​

Wird für ein Objekt (z.B. Auftrag) die Property "etikettVorlage" definiert (z.B. in Einstellungen\USER\Aufträge.properties), so werden die Etiketten automatisch gedruckt.

Wird die Vorlage nicht gefunden, weil z.B. der Pfad fehlerhaft ist), wird ein Dialog angezeigt, welcher darauf hinweist. Beim erneuten Ausführen der Funktion wird der Druckdialog zur Auswahl der Vorlage eingeblendet.