Barcode hinzufügen
Inhalt
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 |
---|---|---|---|
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:
| 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:
Es werden folgende 2D-Barcodes unterstützt:
| 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 |
---|---|---|---|
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 |
---|---|---|---|
Ergebnis | Ergebnis der Aktivität: | Bool |
Verwandte Themen
PDF-Aktivitäten