PDF Image Adder

Dieser Adapter fügt einem bestehenden nicht geschützten PDF-Dokument eine oder mehrere Grafiken hinzu oder erstellt ein neues PDF-Dokument mit den angegebenen Grafiken. Diese können sowohl als URL als auch als Base64-kodierte Zeichenkette angegeben werden.

Unterstützte Grafikformate sind BMP, GIF, JPEG/JPG, PNG und TIFF. Die Grafiken können auf jeder PDF-Seite positioniert, skaliert und gedreht werden. In einem adapterspezifisch aufgebauten Input-XML-Dokument werden die Informationen zu den Grafiken hinterlegt. Der Adapter gibt entweder ein neues PDF-Dokument oder ein PDF-Dokument, das um die angegebenen Grafiken ergänzt wurde, aus.

Ab der Adapter-Version 2.0.0 werden die Grafikformate EPS und WMF nicht mehr unterstützt.

Enthält das Input-Dokument kein PDF-Element, wird zunächst ein PDF-Dokument im DIN A4-Format mit der definierten Anzahl an Seiten angelegt, bevor die Grafiken hinzugefügt werden.

Eigenschaften (Properties)

Operation

Bestimmt, welche Operation der Funktions-Adapter durchführt

Mögliche Werte: AddImages: Dem PDF-Dokument Grafiken hinzufügen

Parameter

Adapter

Hauptklasse des Adapters (nicht verändern!)

Mögliche Werte: de.softproject.integration.adapter.pdf.PDFImage: Hauptklasse (Standard)

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.
`-1`	Die Operation ist aufgrund eines technischen Fehlers fehlgeschlagen.

Input

Dieser Adapter erwartet eine adapterspezifische Input-XML-Struktur, in der Informationen zu jeder Grafik hinterlegt sind. Hierzu zählen Breite und Höhe (in cm oder pt), Drehung, x- und y-Position (Abstände vom linken unteren Seitenrand in cm oder pt), der URL zur Grafik sowie die Seite, auf der die Grafik positioniert werden soll. Das Input-PDF-Dokument kann entweder als URL oder als Base64-kodierte Zeichenkette angegeben werden.

HTML/XML

<pdfImage>
   <!-- <PDF url="xstore-URL des Input-PDF-Dokuments im Repository" (Wenn Input-PDF als URL angegeben wird) /> -->
   <!-- <PDF encoding="base64"> Base64-Zeichenkette (Wenn Input-PDF Base64-Zeichenkette)</PDF> -->
   <Image height="Höhe" width="Breite" 
          rad="Drehung (Bogenmaß)" degree="Drehung (Grad)" 
          xPos="Abstand vom linken Seitenrand" yPos="Abstand vom unteren Seitenrand" 
          url="xstore-URL der Grafik im Repository" page="Seite im PDF"/>
</pdfImage>

Folgendes Input-XML-Dokument enthält Informationen für eine PNG-Bilddatei, die auf der ersten Seite eines bereits bestehenden PDF-Dokuments (Angabe als URL oder Base64-Zeichenkette) eingefügt werden soll.

HTML/XML

<pdfImage>
   <!-- <PDF url="xstore://Project/Folder/InputPDF.pdf"/> -->
   <!-- <PDF encoding="base64">base_64_encoded_PDF_document</PDF> -->
   <Image height="90pt" width="60pt" rad="" degree="" 
          xPos="400pt" yPos="100pt" 
          url="xstore://Project/Folder/Image.png" page="1"/>
</pdfImage>

Folgendes Input-XML-Dokument enthält Informationen für drei Grafiken, die in einem neuen PDF-Dokument zusammengeführt werden sollen.

CODE

<?xml version="1.0" encoding="UTF-8"?>
<Root>
    <Image page="1" height="100pt" xPos="10pt" yPos="500pt" url="https://www.softproject.de/assets/images/a/Logo-SoftProject_www-ee6b7fba.png"/>
    <Image page="3" height="100pt" xPos="10pt" yPos="500pt" url="https://www.softproject.de/assets/images/a/Logo-SoftProject_www-ee6b7fba.png"/>
    <Image page="3" height="120pt" xPos="50pt" yPos="100pt" encoding="base64">
	iVBORw0KGgoAAAANSUhEUgAAAEsAAAAWCAYAAACIXmHDAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAAEnQAABJ0Ad5mH3gAAAHDSURBVFhH7ZSxSgNBEIZ9gjyZjS/hY9jbiJW9rWBlaWNpqVUqEQRBwSBRE4gxWf3X/MfvuHvcbO66HfjZy+zO7Mx3k9t53huFqm6qsByqsByqsByqsBz6B+v1YDesJo9hvVyEj7PDxj+/PA0wrHp+erwf1vP3KDzrnu6nbPkwbvKq6d2L26uN99e4h9iU4a7Z+VHswRpiNCd/U/AjDgzUTyUniw0ykABtcohF52CpUEzXl5DaQx1fT/d/4vGMnMhNH+vNNU5YtpYiWBATYoVSMNAE/Mu7m0Fgpc5blcJaTV+idACivwQWL6TZZjh98MemBpysttzFsH72ZhcnMTfrKYYFsdhUArwR+vuApaa5EENL3dEGyxrPYGXt6IPTpX7mUnWClWpQfbhkW1hY9azKNq9n22DlGlcoMX4zXcWw0DiS8HukSfhRT5l+A6xKYVEEo7VsCwu/+S/5HF9nY6AsLCZAIJK3NRQhDDhZKtSld/UBq3kJbxM/LAazAV6eAzIULJzXSW2mXXx9wIKQE+aClSoIYlPWD/UByxr8OG9NoUBtsKwRBM5aKMzjglWVV4XlUIXlUIXlUIXlUIXlUIXVWaPwDd5omEQbL+NTAAAAAElFTkSuQmCC</Image>
</Root>