PDF Barcode Adder | X4Documentation

Dieser Adapter erzeugt Strichcodes und fügt diese einem bestehenden nicht geschützten PDF-Dokument hinzu. Die Strichcode-Grafiken können auf jeder PDF-Seite positioniert, skaliert und gedreht werden. Unterstützt werden die Strichcode-Typen Code 39, Code 128, Codabar, EAN 13, Code 25–Interleaved 2 of 5 sowie POSTNET.

In einem adapterspezifisch aufgebauten Input-XML-Dokument werden die Daten der Strichcodes hinterlegt. Der Adapter gibt ein PDF-Dokument aus, das um die angegebenen Strichcodes ergänzt wurde.

Eigenschaften (Properties)

Operation

Bestimmt, welche Operation der Funktions-Adapter durchführt

Mögliche Werte: AddBarcodes: Dem PDF-Dokument Strichcode(s) hinzufügen

Parameter

ReadPartially

PDF-Dokument in mehreren Teilen in den Arbeitsspeicher laden (kann Performance-Verbesserungen bringen)

Mögliche Werte:

ja: In mehreren Teilen nacheinander in den Arbeitsspeicher laden
nein: PDF-Dokument In einem Stück in den Arbeitsspeicher laden (Standard)

ToXML

PDF-Dokument Base64-kodiert in einem XML-Dokument ausgeben

Mögliche Werte:

ja: XML-Dokument ausgeben
nein: PDF-Dokument als Binärdatenstrom ausgeben (Standard)

Statuswerte

`1`	Die Operation wurde erfolgreich ausgeführt.
`0`	Die Operation wurde erfolgreich ausgeführt, jedoch ohne Ergebnis.
`-1`	Die Operation ist aufgrund eines technischen Fehlers fehlgeschlagen.

Input

Dieser Funktions-Adapter erwartet eine adapterspezifische Input-XML-Struktur, in der sämtliche Daten jeder Strichcode-Grafik hinterlegt sind (siehe unten). Wenn ein PDF aus dem Repository als Quelldokument verwendet werden soll, in Element <PDF> im Attribut url dessen xstore-URL angeben. Alternativ, wenn das Quelldokument als Base64-kodierte Zeichenkette vorliegt, können Sie diese Zeichenkette als Inhalt des Elements <PDF encoding="base64"> hinterlegen (siehe auskommentierte Zeile).

<pdfBarcode>
   <PDF url="xstore-URL des Input-PDF-Dokuments im Repository"/>
   <!-- <PDF encoding="base64">(Wenn Input-PDF Base64-Zeichenkette)</PDF> -->
   <Barcode height="Höhe" width="Breite" 
   rad="Drehung (Bogenmaß)" degree="Drehung (Grad)"
   xPos="Abstand vom linken Seitenrand" yPos="Abstand vom unteren Seitenrand" 
   type="Strichcode-Typ" page="Seite">Strichcode-Daten</Barcode>
</pdfBarcode>

Attribute im Input-XML-Dokument

Der PDF Barcode Adder erwartet eine adapterspezifische Input-XML-Struktur nach oben genanntem Muster. Folgende Attribute können gesetzt werden:

url	xstore-Pfadangabe zum Input-PDF-Dokument im Repository (z. B. xstore://Project/Data/InputData.xml; erforderlich)
height	Höhe der Strichcode-Grafik in cm oder pt (erforderlich)
width	Breite der Strichcode-Grafik in cm oder pt (erforderlich)
rad	Drehung der Strichcode-Grafik im Bogenmaß
degree	Drehung der Strichcode-Grafik in Grad (erforderlich)
xPos	Abstand der Strichcode-Grafik vom linken Seitenrand in cm oder pt (erforderlich)
yPos	Abstand der Strichcode-Grafik vom unteren Seitenrand in cm oder pt (erforderlich)
type	Strichcode-Typ (erforderlich) Mögliche Werte: 39: Code 39 -Format 128: Code 128 -Format Codabar: Codabar -Format EAN: EAN 13 -Format Inter25: Code 25 – Interleaved 2 of 5 -Format Postnet: POSTNET -Format
page	Seitenzahl im PDF-Dokument, auf der die Strichcode-Grafik positioniert wird (erforderlich)

Beispiel

Folgendes Input-XML-Dokument enthält die Daten zum Erzeugen einer EAN 13 -Strichcode-Grafik mit 3 cm Breite und 20° Neigung auf der ersten Seite eines PDF-Dokuments im Repository.

<pdfBarcode>
   <PDF url="xstore://Project/Folder/InputPDF.pdf"/>
   <!-- <PDF encoding="base64">base_64_encoded_PDF_document</PDF> -->
   <Barcode height="3cm" width="3cm" rad="" degree="20" 
         xPos="120pt" yPos="1cm" type="EAN" 
         page="1">1234567891234</Barcode>
</pdfBarcode>