Barcode hinzufügen

Mit dieser Aktivität kann auf ein PDF-Dokument ein Barcode an einer frei definierbaren Position und mit einer angegebenen Rotation aufgedruckt werden. Manche Barcode-Typen erlauben nur numerische Werte und eine bestimmte Anzahl von Stellen. Die genaue Beschreibung der jeweiligen Barcode-Typen kann z.B. aus dem Internet entnommen werden. Wird der Barcode auf ein PDF/A aufgedruckt, ist das Dokument danach immer noch ein PDF/A. Auch der XML-Anhang eines ZUGFeRD-Dokuments bleibt erhalten.

Hinweis
Mit dem Aufbringen eines Barcodes wird das PDF-Dokument überschrieben. Dies bedeutet, dass z.B. enthaltene Signaturen ungültig werden! Muss das Original unverändert erhalten bleiben, dürfen Sie nur mit einer Kopie des Dokuments arbeiten.

Eigenschaften

Eingabe

Name

Beschreibung

Datentyp

Erforderlich

Name

Beschreibung

Datentyp

Erforderlich

Verzeichnis

Vollständiger Pfad des PDF-Dokuments

String

Dateiname

Dateiname des PDF-Dokuments

String

Seite

Seite auf welcher der Barcode hinzugefügt werden soll.

WMS 1.1.0 Wenn eine Seitennummer angegeben wird, die größer als die Gesamtanzahl der Seiten des PDF-Dokuments ist, dann wird das PDF um entsprechend viele Seiten erweitert werden, so dass der Barcode auf die angegebene Seite hinzugefügt werden kann

WMS 1.1.3 Mit Version V1.1.3 hat sich das Verhalten verändert: Wenn jetzt eine Seitennummer angegeben wird, die größer als die Gesamtanzahl der Seiten des PDF-Dokuments ist, dann wird nicht mehr automatisch eine neue Seite eingefügt. Dies ist jetzt abhängig von dem neuen Kennzeichen "Fehlende Seiten automatisch hinzufügen"

Integer

Fehlende Seiten automatisch hinzufügen WMS 1.1.3

Kennzeichen, ob fehlende Seiten hinzugefügt werden sollen. Wenn die Option gesetzt ist und bei "Seite von" oder "Seite bis" eine Seitennummer größer der Anzahl Seiten angegeben wird, werden die fehlenden Seiten automatisch an das PDF-Dokument angehängt. Ansonsten wird ein Fehler ausgegeben, wenn nicht genügend Seiten vorhanden sind.

Bool



Linke Position

Die linke Position in mm

Double

Obere Position

Die obere Position in mm

Double

Text

Der Text, welcher durch den Barcode dargestellt werden soll.

String

Drehwinkel

Der Drehwinkel im Uhrzeigersinn, mit dem der Barcode aufgebracht werden soll. Es stehen folgende Winkel zur Auswahl:

  • Normal (keine Drehung)

  • 90°

  • 180°

  • 270°

Auswahlliste



BarcodeTyp

Es können sowohl Strichcodes als auch 2D-Barcodes verwendet werden. Je nach Barcode-Typ können weitere Parameter konfiguriert werden.

Es werden folgende Strichcodes unterstützt:

  • Code 39

  • Code 128

  • EAN-13

  • PostNet

  • Code 2 aus 5 Interleaved

Es werden folgende 2D-Barcodes unterstützt:

  • DataMatrix

  • QR Code

  • PDF417

Auswahlliste



Drehung der Seite berücksichtigen

WMS 1.1.3

Bei den Eigenschaften der Aktivität (nicht im Designer der Aktivität) kann noch ein Kennzeichen gesetzt werden, ob die Drehung der Seite berücksichtigt werden soll.

Wenn das Kennzeichen gesetzt ist, dann wird bei gedrehten Seiten der Barcode ebenfalls gedreht aufgebracht. Gleichzeitig verschiebt sich der Referenzpunkt für die angegebenen Koordinaten entsprechend des Drehwinkels der Seite (der Referenzpunkt liegt normalerweise immer in der linken oberen Ecke). 

Wenn das Kennzeichen nicht gesetzt ist, dann wird der Barcode immer ausgehend von der linken oberen Ecke gerade aufgebracht.

Bool



Seite normalisieren

WMS 2.0.0

Bei den Eigenschaften der Aktivität (nicht im Designer der Aktivität) kann das Kennzeichen gesetzt werden, ob die Seite normalisiert werden soll.

Wenn das Kennzeichen gesetzt ist, dann werden die Layer aller Inhalte der Seite entsprechend der Ausrichtung der Seite so angepasst, dass die nachfolgenden Zeichenoperationen (z.B. Text/Bild/Barcode hinzufügen) an den erwarteten Positionen erfolgen. Dabei werden die internen Layer des PDFs auf die physikalische Größe und Ausrichtung der Seite ausgerichtet und die Information des Drehwinkels zurückgesetzt.

Das Kennzeichen muss nur dann gesetzt werden, wenn es Probleme beim Aufbringen von Text/Bildern/Barcodes gibt (z.B. gespiegelte Darstellung, falsche Position, etc.).

Bool



Barcode spezifische Eingabeparameter

Name

Beschreibung

Datentyp

Erforderlich

Name

Beschreibung

Datentyp

Erforderlich

Text anzeigen

Kennzeichen, ob der Text in Klarschrift unterhalb des Barcodes ausgegeben werden soll

Bool

 

Schriftgröße des Textes

Die Schriftgröße, mit welcher der Text ausgegeben werden soll

Integer

 

Breite des Barcodes

Die Breite des Barcodes kann optional angegeben werden. Eine automatische Berechnung der Breite erfolgt, wenn 0 angegeben wird.

Double

 

Höhe des Barcodes

Die Höhe des Barcodes. Standardwert ist 10

Double

 

Größe des Barcodes (DataMatrix)

WMS 1.1.3 Beim DataMatrix Barcode kann jetzt eine feste Größe für den Barcode in Millimeter angegeben werden. Wird hier eine feste Größe angegeben, dann wird die Modulgröße ignoriert, da diese dann automatisch berechnet wird.

Double

 

Trägerbalken

Kennzeichen, ob beim Strichcode „Code 2 aus 5 Interleaved“ oben und unten ein Trägerbalken angezeigt werden soll

Bool

 

Checksummen-Zeichen

Kennzeichen, ob ein Checksummen-Zeichen berechnet werden soll (dieses wird bei der Textausgabe nicht angezeigt).

Bool

 

Modulgröße

Definiert die Größe eines Pixels beim 2D-Barcode. Hier kann nur aus einer Liste von sinnvollen Werten ausgewählt werden. Wird beim Datamatrix Barcode eine feste Symbolgröße angegeben, dann wird dieser Parameter ignoriert, weil die Modulgröße dann automatisch berechnet wird.

Double

 

Symbolgröße

Definiert die Symbolgröße des DataMatrix-Barcodes. Unter Symbolgröße ist die Anzahl der horizontalen und vertikalen Pixels zu verstehen. Wird hier die automatische Anpassung ausgewählt und gleichzeitig eine feste Barcode-Größe angegeben, dann werden nur quadratische Barcodes erzeugt. Die Symbolgröße wird dann automatisch anhand der Textlänge berechnet.

Wie viele Zeichen mit einem DataMatrix-Barcode dargestellt werden können, ist abhängig von der ausgewählten Symbolgröße.

Nähere Informationen zum DataMatrix-Barcode ist bei Wikipedia (https://en.wikipedia.org/wiki/Data_Matrix) zu finden. Der darin enthaltene externen Link “GS1 DataMatrix Guideline: Overview and technical introduction to the use of GS1 DataMatrix“ enthält eine Tabelle mit den Symbolgrößen und den damit abbildbaren Datenmengen.

Auswahlliste



Randeinheit

Definiert die Größe eines Randes um den Barcode. Dieser orientiert sich an der Modulgröße.

Integer

 

Trennzeichen

Das Trennzeichen gibt an, mit welchem Zeichen die einzelnen Werte im Text getrennt werden. Dieses wird nur benötigt, um den angegebenen Text bei 2D-Barcodes für die Anzeige aufzuschlüsseln.

Char

 

Größe (QR Code)

Gibt die Seitenlänge des QR Codes in mm an. Da der Barcode quadratisch ist, entspricht die Angabe der Breite und Höhe des Barcodes

Double

 

Encoding (QR Code)

Gibt das Encoding des Barcode-Inhalts an. Informationen zu Encoding: Encoding

Auswahlliste

 

Spalten (PDF417)

Beim 2D-Barcode PDF417 kann eine feste Anzahl Spalten definiert werden. Mit dem Wert 0 kann eine automatische Festlegung erzwungen werden.

Integer

 

Zeilen (PDF417)

Beim 2D-Barcode PDF417 kann eine feste Anzahl Zeilen definiert werden. Mit dem Wert 0 kann eine automatische Festlegung erzwungen werden.

Integer

 

Ausgabe

Name

Beschreibung

Datentyp

Erforderlich

Name

Beschreibung

Datentyp

Erforderlich

Ergebnis

Ergebnis der Aktivität:
True, wenn Barcode erfolgreich aufgedruckt werden konnte
False, wenn der Barcode nicht aufgedruckt werden konnte

Bool

Verwandte Themen

PDF-Aktivitäten