CIB pdf toolbox technischer Leitfaden (DE)

4. Nutzungsmöglichkeiten im Formularbereich

4.2. Wie verhält sich die CIB pdf toolbox bei mehreren PDF Formularen?

Wenn man mehrere PDF Formulare mit einer CIB pdf toolbox Funktion verarbeiten möchte, dann kann es je nach gewähltem Verarbeitungsschritt zu Einschränkungen kommen, für die folgende Regeln gelten:

CIB pdf join

Beim Zusammenhängen von mehreren PDF Formularen kann es zu Situationen kommen, bei denen Formularfelder mit gleichem Namen in mehreren der Quellformulare auftreten. Folgende Regeln gelten dabei für das erzeugte PDF Zielformular:

  • Die gleichnamigen Formularfelder müssen vom gleichen Feldtyp sein, ansonsten bricht der „Join-Vorgang“ ab.
  • Globale Eigenschaften eines Formularfeldes – das sind Eigenschaften, die alle Felder gleichen Namens gemeinsam haben – werden grundsätzlich vom ersten Dokument übernommen.

Ausnahmen:

Die Eigenschaft „Text verbergen“ wie bei Passwortfeldern genießt Vorrang vor dem obigen Prinzip.

Die Elemente einer Listbox, werden um die Elemente des zweiten Dokuments erweitert.

Das gleiche gilt für Kombinationsfelder.

  • Lokale Eigenschaften von Formularfeldern bleiben erhalten.
  • Hierarchische Verfeinerungen eines existierenden Feldnamens sind nicht erlaubt.

Beispiel: Besitzt ein Dokument ein Formularfeld mit dem Namen „Säugetier.Wal“
und ein weiteres Dokument  ein Formularfeld mit dem Namen „Säugetier.Wal.Delfin“
so würde der „Join-Vorgang“ der beiden Dokumente abbrechen. Der Grund liegt darin,
dass für die gängigsten Pdf-Reader diese Situation nicht vorgesehen ist.

Wichtiger Hinweis:

Grundsätzlich hat die aufrufende Anwendung auch die Möglichkeit den Formularfeldern jedes beteiligten Einzelformulars ein Präfix voranzustellen, so dass beim zusammenfügen mehrerer Formulare zu einem großen PDF Formular, alle Felder einen eindeutigen Feldnamen haben. Siehe Property: FormfieldNamePrefix