OBS/Makros und Scripting/Anwendungsbereiche/interaktive PDF
Interaktive PDF
Interaktive PDF sind PDF Dokumente, die es erlauben bestimmte Werte direkt einzutragen oder zu ändern.
OBS bieten ebenfalls die Möglichkeiten diese PDF nach der Ausfüllung wieder einzulesen und die eingetragenen Daten zu verarbeiten.
Mithilfe von interaktiven/ausfüllbaren PDF ist es möglich Dokumente außerhalb von OBS zu bearbeiten um zum Beispiel bei einem Kundenbesuch diese über ein Tablet oder Laptop direkt auszufüllen.
Die ausgefüllten Daten können dann direkt in OBS importiert werden
Besonderheiten PDF/A
PDF/A ist ein spezielles PDF Format zum langfristigen archivieren von Dokumenten. Dabei ist unter anderem die Unveränderbarkeit des Dokumentes sehr wichtig.
Diese Eigenschaft von PDF/A steht im direkten Kontrast zu interaktiven PDF und hat zur Folge, dass PDF/A interaktive Elemente nur zum teil oder gar nicht unterstützt.
Mögliche Steuerelemente
Eingabefled/Textfeld
Einfache Eingabefelder die normalen Text beinhalten.
Numerische Felder
Eingabefelder, die nur die Eingabe von Zahlen zulassen
Datumsfelder
Felder zum eintragen eines Datums
Schaltfläche
Drückbare Schaltflächen
Neben den einfachen zurücksetzen des Dokumentes (Reset), bieten diese Schaltflächen auch die Einreichung des Dokumentes an eine externe Website (Submit)
oder das ausführen eines Javascripts für komplexe Aufgaben.
Checkbox
Felder zum ankreuzen
Verbundene Checkbox (Radiobox)
Mehrere Felder zum ankreuzen eines Feldes
Auswahlbox (Combobox)
Eine Liste vordefinierter auswählbarer Einträge
Anmerkungen
Kommentar- und Hinweisfelder
Erstellung über Druckdateien
Die interaktiven Steuerelemente werden direkt über die Druckdatei von OBS hinzugefügt
Dafür können je nach Komplexität kosten zum anpassen der jeweiligen Drucke anfallen.
Beim Export von Durcken als PDF werden diese interaktiv. Sollte ein solcher Druck "normal" ausgedruckt werden, werden die Steuerelemte nach Möglichkeit zu druckbaren Elementen konvertiert.
Implementierung im Druck
Bei der Implementierung stehen folgende Funktionen zur Verfügung:
//Eingabefeld
qRep_PDFFormFieldEdit(EZ, 'EditField1', oValues);
//Nummerisches Feld
qRep_PDFFormFieldNumEdit(EZ, 'EditField2', oValues);
//Datumsfeld
qRep_PDFFormFieldDateEdit(EZ, 'EditField3', oValues);
//Schaltfläche
qRep_PDFFormFieldButton(EZ, 'Schaltfläche', oValues);
//Checkbox
qRep_PDFFormFieldCheckBox(EZ, 'CheckBox', oValues);
//Radiobutton
qRep_PDFFormFieldRadioButton(EZ, 'RadioButton1', oValues);
//Combobox
qRep_PDFFormFieldCombobox(EZ, 'Combobox', oValues);
//Kommentar
qRep_PDFFormFieldTextAnnot(EZ, 'TextAnot1', oValues);
Die spezifischen Eigenschaften der einzelnen Elemente werden über das oValues Objekt definiert und übergeben.
Dieses Objekt ist vom Typ "TFormFieldValue" und muss vor dem Hinzufügen der einzelnen Werte erstellt und am Ende wieder freigegeben werden.
Das Objekt bietet eine Reset Funktion, die alle Werte des Objekt auf Standard zurück setzt. Dadurch ist es möglich das Objekt mehrfach zu nutzen.
oValues := TFormFieldValue.Create(Rect(10, 10, 50, 20));
oValues.cValue := 'dies ist ein Textfeld';
oValues.lIsMultiline := False;
oValues.oFont.Size := 10;
qRep_PDFFormFieldEdit(EZ, 'EditField1', oValues);
oValues.Reset(Rect(10, 30, 26, 46));
oValues.lChecked := True;
qRep_PDFFormFieldCheckBox(EZ, 'CheckBox', oValues);
MyFreeAndNil(oValues);
Für das Create und Reset wird jeweils ein Rect übergeben, welches die Position im Dokument definiert
Rect(left, top, right, bottom)
oValues.Reset(Rect(qRep_SAnfang(EZ,'pk1'), qRep_Ypos(EZ,y), qRep_SAnfang(EZ,'pk2'), qRep_Ypos(EZ,y+1)));
Verfügbare Werte
| Wert | Für Typ | Werte | Standard Wert | Beschreibung |
|---|---|---|---|---|
| aRect: TRect | alle | Rect für die Positionierung im Dokument | ||
| cPreferences: String | alle | 'afpreadonly'
'afprequired' |
[] | Definition des Feldes (nur Lesen oder ausfüllen erforderlich) |
| oBackgroundColor: TColor | alle | $FFD7CC | Farbe des Hintergrunds | |
| oBorderColor: TColor | alle | clBlack | Farbe dess Rahmens | |
| oFont: TFont | alle | oFont.Name := 'Arial';
oFont.Size := 10;
oFont.Color := clBlack;
|
Definition der Schriftart
(Schriftstile wie "Fett" oder Kursiv" werden wie folgt definiert:qSetRepStyle(EZ, [fsBold]);
oValues.Reset(Rect(10, 10, 30, 20));
qRep_PDFFormFieldEdit(EZ, 'Textfeld', oValues);
qSetRepStyle(EZ, []);
Die schriftart von Checkboxen und Radioboxen ist nicht änderbar | |
| lPrintable: Boolean | alle | True, False | True | True: Das Feld wird bei normalen Drucken angezeigt |
| cValue: String | Textfeld
Numerisches Feld Datumsfeld |
Der initialwert eines Feldes | ||
| cHAlignment: String | Textfeld
Numerisches Feld Datumsfeld |
'tacenter'
'taright' 'taleft' |
'taleft' | die Textausrichtung eines Feldes
mitte, rechts-, linksbündig |
| lIsMultiline: Boolean | Textfeld
Numerisches Feld Datumsfeld |
True, False | False | Einzeilig oder mehrzeilige Felder |
| lIsPassword: Boolean | Textfeld
Numerisches Feld Datumsfeld |
True, False | False | Anzeige von Punkten statt der Eingabe |
| lIsFileSelect: Boolean | Textfeld
Numerisches Feld Datumsfeld |
True, False | False | Auswahl einer Datei zum speichern des Pfades |
| lIsDoNotSpellCheck: Boolean | Textfeld
Numerisches Feld Datumsfeld |
True, False | False | Rechtschreibung für das Feld ignorieren |
| lIsDoNotScroll: Boolean | Textfeld
Numerisches Feld Datumsfeld |
True, False | False | Keine Scrollbar anzeigen |
| lIsBorder: Boolean | Textfeld
Numerisches Feld Datumsfeld |
True, False | False | Rahmen anzeigen |
| nMaxLength: Integer | Textfeld
Numerisches Feld Datumsfeld |
-1 | Maximale länge der Eingabe | |
| nXTextOffsetPtn: Double | Textfeld
Numerisches Feld Datumsfeld Schaltflächen |
0 | Korrektur des anzuzeigenden Textes auf der X-Achse in Punkte
Für bestimmte Fonts kann es nötig sein diese anzupassen, da der Text nicht korrekt Positioniert wird | |
| nYTextOffsetPtn: Double | Textfeld
Numerisches Feld Datumsfeld Schaltflächen |
0 | Korrektur des anzuzeigenden Textes auf der Y-Achse in Punkte
Für bestimmte Fonts kann es nötig sein diese anzupassen, da der Text nicht korrekt Positioniert wird | |
| nBorderWidth: Integer | Schaltflächen | 1 | Rahmenbreite | |
| lVisible: Boolean | Schaltflächen | True, False | True | Sichbarkeit der Schaltfläche |
| cNormalCaption: String | Schaltflächen | Text bei normaler Anzeige der Schaltfläche | ||
| cRolloverCaption: String | Schaltflächen | cNormalCaption | Text beim berühren der Schaltfläche mit der Maus | |
| cDownCaption: String | Schaltflächen | cNormalCaption | Text beim betätigen der Schaltfläche | |
| cAction: String | Schaltflächen | 'pbaNone'
'pbasubmit' 'pbareset' 'pbajavascript' |
'pbaNone' | Typ der Schaltfläche |
| cJavaScript: String | Schaltflächen | Hinterlegtes Javascript bei Typ 'pbajavascript'cJavaScript := 'app.alert("Hello World")';
cJavaScript :=
' var tf1 = this.getField("tfName"); ' +
' var btn1 = this.getField("pbValidate"); ' +
' var btn2 = this.getField("pbSubmit"); ' +
' if (tf1.valueAsString.length > 3) { ' +
' tf1.value = tf1.valueAsString.toUpperCase(); ' +
' btn2.buttonSetCaption("Submit"); ' +
' btn1.display = display.hidden; ' +
' btn1.setFocus(); ' +
' } else { ' +
' app.alert("Please enter a valid name."); ' +
' tf1.setFocus(); ' +
' }';
| ||
| cSubmitURL: String | Schaltflächen | URL bei Typ 'pbasubmit'cSubmitURL :=
'http://www.bergau.de/newsletters/demos/200804/forms_test.asp';
| ||
| cFormSubmitFormat: String | Schaltflächen | 'fsfhtml'
'fsffdf' 'fsfxml' |
'fsfhtml' | Format der Einreichung |
| lAtleastOneSelectedItem: Boolean | Radiobox | True, False | False | Mindestens ein Feld muss ausgefüllt sein |
| lChecked: Boolean | CheckBox
Radiobox |
True, False | False | Checkbox ist bei der Erstellung angehakt |
| cSymbol: String | CheckBox
Radiobox |
'pfcsCross'
'pfcscheck' 'pfcscircle' 'pfcsdiamond' 'pfcssquare' 'pfcsstar' |
'pfcsCross' | Symbol für die Checkbox |
//CheckBox/RadioButton
cSymbol : String;
//ComboBox
lIsEditable : Boolean;
lIsSortList : Boolean;
cBoxItems : String;
//ComboBox/RadioButton
nSelectedItemIndex : Integer;
//TextNote
cTitel : String;
cSubject : String;
cContents : String;
lOpen : Boolean;
cTyp : String;