SML-Dateien
SML-Dateien (*.sml) können verwendet werden, um ein oder mehrere PDF-Dokumente mit signoSign/2 zu öffnen und Informationen wie Dokumenttyp und Platzhalter für diese Dokumente zu übergeben. Aufbau und Inhalt dieser Dateien basieren auf einer XML-Struktur.
Um Dokumente zu öffnen, muss die SML-Datei mit signoSign/2 geöffnet werden und mindestens einen Verweis auf ein Dokument enthalten.
Wird der Dokumententyp in der SML-Datei definiert, entfällt die automatische Prüfung durch signoSign/2. Wird der Dokumententyp nicht definiert, erfolgt die Identifikation des Dokumententyps wie gewohnt über die Identifizierungsbegriffe der Dokumententypen.
Zusätzlich können in der SML-Datei vordefinierte Werte für die Platzhalter hinterlegt werden, ohne dass diese von signoSign/2 aus dem Dokument ausgelesen werden müssen. Wurden für den entsprechenden Dokumenttyp bereits Platzhalter definiert, so werden diese durch die in der SML-Datei eingetragenen Platzhalter überschrieben. Nicht in der SML-Datei angegebene Platzhalter werden von signoSign/2 wie gewohnt ermittelt.
Beispielhafter Aufbau einer SML-Datei
Das nachfolgende Beispiel erläutert den Aufbau einer SML-Datei.
Als ROOT-Element wird “signotec” verwendet, in welchem beliebig viele “Open”-Elemente eingebettet sein können.
Über das “File”-Element kann ein Dokument mit Namen und Pfad definiert werden, welches geöffnet werden soll.
Ein “Open”-Element kann beliebig viele “File”-Elemente enthalten.
In dem “Values”-Element kann der Dokumententyp über das Element “DocType” und die Platzhalter mittels Element “Variable1” bis “Variable30” definiert werden.
Für jedes “Open”-Element darf nur ein “Values”-Element definiert werden, in dem wiederum die Elemente “DocType” und “VariableX” ebenfalls nur einmal definiert sein dürfen. Zudem kann das Element “DeleteAfterOpen” definiert werden. Insofern es auf “True” gesetzt ist, wird die SML-Datei nach dem Öffnen der Dokumente gelöscht.
Die Groß- und Kleinschreibung bei den Elementen der SML Dateien muss berücksichtigt werden!
<?xml version="1.0" encoding="utf-8"?>
<signotec>
<Open>
<File>C:\Dokument\Document1.pdf</File>
<File>C:\Dokument\Document2.pdf</File>
<Values>
<DocType>Invoice</DocType>
<Variable1>18,96 €</Variable1>
<Variable2>26.08.2019</Variable2>
<Variable3>John Doe</Variable3>
</Values>
</Open>
<Open>
<File>C:\Dokument\ExampleDocument.pdf</File>
<Values>
<DocType>Invoice</DocType>
<Variable1>L2019-H-001</Variable1>
<Variable2>27.08.2019</Variable2>
<Variable3>Germany</Variable3>
</Values>
</Open>
<DeleteAfterOpen>True</DeleteAfterOpen>
</signotec>