[v4.53 ADMIN] MOXIS Resolver und ihre Funktion
Inhalt
Standardsignaturen können mithilfe sogenannter Resolver (Platzhalter für Text/Informationen) in MOXIS individuell angepasst werden. Dieser Artikel zeigt auf, welcher Logik die Auflösung folgt und welche Resolver es gibt.
1. Begriffsklärung
Was ist ein Resolver?
Ein Resolver ist eine Software-Komponente, die per DNS-Protokoll Informationen von einem Nameserver abruft.
Im Fall von MOXIS ist ein Resolver ein Platzhalter, der stellvertretend für einen bestimmten Text oder eine gewisse Information in einer Komponente von MOXIS platziert wird. Sobald die Information vorliegt, wird sie automatisch abgerufen und der Platzhalter durch die Info/den Text ersetzt. Dies erlaubt es, gewisse Abläufe in MOXIS zu automatisieren und zu erleichtern.
2. Auflösung von Resolvern
Die Auflösung der Resolver folgt der unten anstehenden Logik.
Resolver | Auflösung |
|---|---|
| Das Prozentzeichen ( |
| Das Fragezeichen ( |
| Die Zeichenkette |
| Optionale Platzhalter funktioniert auch für Gruppen. |
| Gruppen können auch verschachtelt werden und statische Elemente enthalten. Statische Elemente werden nur berücksichtigt, wenn alle Platzhalter der Untergruppe gültig auflösen. |
| Ein statischer Platzhalter für |
2.1. Beispiele für Resolver
Resolver | Auflösung |
|---|---|
| … löst zum common name aus dem Zertifikat auf, sofern das Zertifikat zur Verfügung steht. |
| … löst zu Vorname und Nachname des angemeldeten MOXIS Users auf, sofern der MOXIS User zur Verfügung steht. |
| Hardcodierter Name (je nach Sprache Max Mustermann bzw. John Doe). Wird in der Vorschau für externe Signierende benötigt. |
| … aktueller (Signatur-)Zeitpunkt |
2.2. Beispiel für Resolver mit Gruppierungen
Resolver | Auflösung |
|---|---|
| … löst zu common name aus einem Zertifikat oder Vorname und Nachname oder Max Mustermann (wenn Sprache Deutsch) auf. Je nachdem, was zuerst gültig auflöst. |
2.3. Weitere Resolver und ihre Auswirkungen
Resolver | Auflösung |
|---|---|
| … löst sich auf in die erste gültige Übereinstimmung von |
| … löst sich in den |
| … löst sich in den |
| … löst sich in die Seriennummer des Zertifikats auf, falls angegeben, sonst null. |
| … löst sich in den aktuell angemeldeten MOXIS-Benutzernamen Wird für die Freigabe für alle User dasselbe Zertifikat verwendet, sollte für die Konfiguration am Freigabeprofil statt |
| … löst sich in die E-Mail-Adresse des aktuell angemeldeten MOXIS-Benutzers auf, andernfalls null. |
| … löst sich in die Konstanten John Doe oder Max Mustermann auf, je nach verwendetem Gebietsschema und wenn der Vorschaumodus verwendet wird, andernfalls null. |
| … löst den Namen des Unterzeichners auf, der dargestellt werden muss |
| … löst den Namen des Benutzers auf, der anstelle des ursprünglichen Unterzeichners unterschreibt, ansonsten null. |
| … löst den Iterationskommentar auf, der in der Ansicht „Auftrag erstellen“ gesetzt ist, ansonsten null. |
| … löst die Jobid (Prozessinstanz-ID) auf, die ansonsten automatisch auf null gesetzt wird |
| … löst die Jobrefid auf, sonst null. |
| … löst in das Signaturkommentar einer qualifizierten Unterschrift auf. |
| … löst in das Signaturkommentar einer einfachen Unterschrift oder einer Freigabe auf. |
3. Use Case: Resolver in der praktischen Anwendung
In MOXIS lassen sich zum Beispiel Signaturvisualisierungen anhand von Resolvern unterschiedlich gestalten. Wir möchten Ihnen deren Funktion und den Nutzen anhand eines Beispiels aus der Praxis näher bringen.
Gerade in Branchen, die strengen Richtlinien unterliegen, ist es wichtig, auf gutes Dokumentenmanagement zu achten. So auch in der Pharmabranche. Hier spielt vor allem Transparenz eine große Rolle. So ist nicht nur der Name, sondern auch die Rolle der unterzeichnenden Personen sind auf Dokumenten zu vermerken.
Nun kann es jedoch vorkommen, dass mehr als eine Person an einem Dokument arbeitet. Auch dies muss natürlich durch eine Unterschrift festgehalten werden.
3.1. Use Case: Rahmenbedingungen
Für unser Beispiel haben wir drei Personen definiert, die ein und dasselbe Dokument bearbeiten. Nach erfolgreicher Interaktion müssen sie es in irgendeiner Form gegenzeichnen:
Ersteller:in des Dokuments = Creator
Lektor:in des Dokuments = Checker
Freigebender (hierarchisch befugte Person) = Approver
Nun könnte man für jede Rolle ein eigenes Signaturprofil anlegen. Dieses müsste jedoch jeweils vor der Signatur ausgewählt werden. Da dies durchaus fehlerbehaftet sein kann, bietet sich der Einsatz eines Resolvers an. Dieser kann über den oder die Auftraggeber:in im Zuge der Anmerkung je Signaturebene gesteuert werden.
3.2 Use Case: Personalisieren von Signaturen in MOXIS
Use Case: Eine Person im Qualitätsmanagement eines Pharmaunternehmens möchte ein Dokument erstellen. Ihre Unterschrift soll mit dem Namen, dem Datum und der Uhrzeit und ihrer Rolle gekennzeichnet sein.
Lösung: Für unser Beispiel eignet sich der Resolver “%iteration-comment”. Dieser kann laut der Beschreibung der Syntax in Kapitel 1.3 in diesem Artikel aufgelöst und entsprechend in das Signaturprofil eingefügt werden.
Um einen Resolver in ein Signaturprofil einzupflegen, öffnen Sie bitte das Signaturprofil, welches Sie bearbeiten möchten. Sodann fügen Sie Ihre gewünschten Informationen hinzu.
Im Abschnitt Bildunterschrift (siehe Abbildung 1 [1]) stellen Sie bitte sicher, dass Sie das Häkchen bei allen wichtigen Positionen gesetzt haben, die Sie gerne angezeigt haben möchten. Sie haben die Wahl zwischen:
Name anzeigen
Datum anzeigen
Uhrzeit anzeigen
Hinweistext anzeigen
XiTipp
Bitte beachten Sie: Das Häkchen bei “Hinweistext anzeigen” muss auf jeden Fall gesetzt sein. Ansonsten wird der Resolver nicht in Textform angezeigt.
Nun tragen Sie im Textfeld (siehe Abbildung 1 [2]) den Resolver (siehe hier in türkis) mit zusätzlichem, frei gewählten Text (siehe hier in gelb) ein:
%(I am the %iteration-comment of this document| )
Die finale Signatur sieht dann - folgt man der Logik unseres Beispiels - folgendermaßen aus, wobei der Resolver der folgenden Logik folgt:
%(I am the %iteration-comment of this document| )
%(I am the Creator of this document| )
Gerne laden wir Sie dazu ein, Ihre eigenen Signaturprofile auszuprobieren und zu eruieren, was für Sie stimmig ist.