Signaturprofil

Jeder signaturberechtigter Benutzer braucht mindestens ein Signaturprofil zugewiesen. Dabei kann ein Signaturprofil an X Benutzern zugewiesen werden und ein Benutzer kann mehrere Signaturprofile besitzen (zum Beispiel für verschiedene Signaturarten). Ein Signaturprofil ist ein Stammdatenobjekt und kann "Einstellungen → Stammdaten neu → Signaturprofil" erstellt werden. Dabei besteht ein Signaturprofil aus:

Einer Bezeichnung
Einer Basiskonfiguration
Einer JSON Konfiguration
Einen oder mehreren Benutzern

Bezeichnung

Als Bezeichnung kann ein beliebiger Textwert verwendet werden (zum Beispiel Name des zugewiesenen Benutzers oder Name der Organisation, wenn nur ein Signaturprofil vorhanden).

Konfiguration

JSON Konfiguration

Hier wird die eigentliche JSON Konfiguration für das Profil hinterlegt. Jeder Signaturprovider erwartet hier eine unterschiedliche Konfiguration. Details, welche Konfiguration für welchen Provider hinterlegt werden muss, sind hier beschrieben.

Basiskonfiguration

Eine Basiskonfiguration ist ein weiteres Stammdatenobjekt vom Typ "Signaturkonfiguration". Wird eine Basiskonfiguration ausgewählt, so wird die JSON-Konfiguration des Signaturprofils und die JSON-Konfiguration der Basiskonfiguration zusammengesetzt. So kann ein Teil der Konfiguration ausgelagert und für alle verfügbar gemacht werden. Die Verwendung von Basiskonfigurationen bietet sich an, um sich häufig wiederholende Abschnitte in Signaturprofilen an einem Ort auszulagern.

Beispiel

Angenommen es existiert das Signaturprofil namens "Siegeln" mit der folgenden JSON Konfiguration:

{
    "firstname": "Hans",
    "lastname": "Müller"
}

Und es wird die Basiskonfiguration namens "Basis" mit der folgenden JSON Konfiguration referenziert:

{
    "options": {
        "closeViewerAfterSigning": true
    }
}

Dann werden beim signieren die beiden JSON Konfigurationen zusammengesetzt:

{
    "firstname": "Hans",
    "lastname": "Müller"
    "options": {
        "closeViewerAfterSigning": true
    }
}

Variabeln

In der JSON-Konfiguration vom Signaturprofil und von der Basiskonfiguration können dynamische Inhalte verwendet werden, welche sich auf dem Benutzer befinden. Dabei können alle Feldwerte vom Benutzer verwendet werden (Vorname, Nachname, etc). Die Felder können mit der Syntax ${FELDKEY} referenziert werden. Ein Feld kann auch als Optional markiert werden, indem am Schluss ein Fragezeichen angehängt wird ⇨ ${FELDKEY}?. Ist beim Signieren ein Feld, welches nicht als optional markiert ist, nicht ausgefüllt, so wird ein Fehler geworfen.

Beispiel: Gegeben sei die folgende JSON Konfiguration:

{
    "firstname": "${Vorname}",
    "lastname": "${Nachname}"
}

Dann werden die Variablen beim signieren durch die Werte des angemeldeten Benutzers ersetzt zu:

{
    "firstname": "VornameDesAngemeldetenBenutzers",
    "lastname": "NachnameDesAngemeldetenBenutzers"
}

Benutzer

Unter Benutzer werden die Benutzer zum Signaturprofil zugewiesen. Alternativ kann auch auf dem Benutzerobjekt unter "Technische Details" das Signaturprofil zugewiesen werden.