Lokaler / systemweiter Admin
Variante1: Unbekannte Parameter in eigene Bögen einleiten
Voraussetzungen:
•Der Anwender verwendet einen eigenen Bogen, der durch "Thieme Compliance GmbH" für die Einleitung von so genannten "Custom-Feldern" vorbereitet wurde. Dadurch besitzt jedes der zu befüllenden Acroform-Felder jeweils eine eindeutige ID, die mit dem Präfix "custom." beginnt.
•Der Anwender kann die gewünschten Daten für "E-ConsentPro" über einen URL-Aufruf oder eine REST-Zuweisung bereitstellen.
•Der Anwender kann Bögen für den Workflow um "E-ConsentPro documents" zuweisen und den Workflow vollständig durchlaufen.
Folge:
Alle übergebenen Parameter werden in die entsprechenden Acroform-Felder des eigenen Bogens übernommen. Sie können beim Durchlaufen des Workflows gelesen, geändert und entfernt werden. Besonderheiten der verwendeten Schnittstelle:
•Verwendung einer URL-Schnittstelle:
Bei der Übergabe der Daten über einen URL-Aufruf müssen sich der Schlüssel des URL-Parameters und die ID des Acroform-Feldes exakt entsprechen. Beispiel: Der Wert des Parameters "custom.ZusatzversicherungAdresse=Hauptstraße 1" (Schlüssel ist hier "custom.ZusatzversicherungAdresse" und der Wert ist "Hauptstraße 1") wird in das Acroform-Feld mit der ID "custom.ZusatzversicherungAdresse" eingeleitet.
Der Wert des Parameters wird bereits in der Vorschau der Zuweisung angezeigt. Er kann dort geändert oder entfernt werden und wird beim Zuweisen in den Bogen übernommen. Im Fall einer direkten Zuweisung ohne Vorschau wird der im URL-Aufruf übergebene Wert in die Zuweisung übernommen.
Beim Befüllen dieses Textfeldes muss als Wert des Parameters einfach der gewünschte Text übergeben werden.
Soll auf diese Weise ein Kontrollkästchen (Checkbox) oder ein Optionsfeld (Radio-Button) an- oder abgewählt werden, dann muss als Wert "true" bzw. "false" übergeben werden.
•Verwendung einer REST-Schnittstelle:
Bei der Übergabe der Daten über eine REST-Zuweisung müssen die Zuweisungsparameter des REST-Aufrufs um das Segment "custom" erweitert werden, das eine Liste der Schlüssel-Wert-Paare der gewünschten Parameter darstellt. Der Schlüssel muss hierbei jeweils die ID des relevanten Acroform-Feldes sein, allerdings ohne das Präfix "custom.". Die Dokumentation der relevanten Endpunkte in Swagger wurde entsprechend erweitert. Siehe z. B. die Dokumentation des Endpunktes "POST /services/v4/leaflets/assignment".
Beim Befüllen dieses Textfeldes muss als Wert des Parameters einfach der gewünschte Text übergeben werden.
Soll auf diese Weise ein Kontrollkästchen (Checkbox) oder ein Optionsfeld (Radio-Button) an- oder abgewählt werden, dann muss als Wert "true" bzw. "false" übergeben werden.
Variante 2: Bekannte Parameter in eigene Bögen einleiten
Voraussetzungen:
•Der Anwender verwendet einen eigenen Bogen mit bereits bekannten Parametern, z. B. "patient.firstName". Diese bekannten Parameter sollen in die Acroform-Felder eingeleitet werden. Zusätzliche Custom-Parameter sind nicht notwendig. Stattdessen kann in den globalen Einstellungen von "E-ConsentPro" ein Mapping des bereits existierenden Parameters auf das entsprechende Acroform-Feld vorgenommen werden. "E-ConsentPro" löst dieses Mapping dann automatisch auf und trägt den entsprechenden Wert, zusätzlich zu seiner normalen Verwendung, in das Acroform-Feld ein.
•Der Anwender kann die gewünschten Daten für "E-ConsentPro" über einen URL-Aufruf oder eine REST-Zuweisung bereitstellen.
•Der Anwender kann Bögen für den Workflow um "E-ConsentPro documents" zuweisen und den Workflow vollständig durchlaufen.
Folge:
Das Mappen von Standard-Parametern kann folgendermaßen durchgeführt werden:
1.Öffnen Sie die Einstellungen unter Admin > Globale Einstellungen > Datenfelddefinitionen > Datenfelder Eigene Bögen.
2.Klicken Sie auf Hinzufügen, um den Dialog zum Anlegen eines Mappings zu öffnen.
3.Geben Sie im Textfeld Feldname die ID des Acroform-Feldes ohne das Präfix "custom" ein.
4.Erfassen Sie im Feld Inhalt den Namen des Parameters dessen Daten übernommen werden sollen.
5.Klicken Sie auf Variable und öffnen Sie damit eine Auswahl der bekannten Parameter. Wählen Sie hier den gewünschten Parameter aus.
Dies verhindert mögliche Fehler bei der Eingabe der Parameters.
6.Klicken Sie auf OK, um das neue Mapping zu übernehmen.
7.Klicken Sie auf Anwenden, um das Mapping zu speichern.
