HISinOne Plugin

Dieses Plugin erlaubt es ein eigenes HISinOne System anzusprechen. Damit kann ein Austausch von personenbezogenen Daten stattfinden. Es können Informationen dynamisch versendet und empfangen werden.

Das Plugin sollte nur als Systemplugin installiert werden.

Inhalt

Konfiguration des Plugins

Für die Anbindung Ihres HISinOne Systems muss das Plugin zuerst installiert werden. Dies geschieht in den Systemeinstellungen > Plugins. Weitere Informationen dazu sind in folgendem Artikel zu finden: System-Plugins

Nach einer erfolgreichen Installation über den Store wird das Plugin initial deaktiviert sein. Sie müssen zuerst diverse Pflichtangaben hinterlegen, welche für die Verwendung notwendig sind. Diese können direkt in den Plugin-Properties angegeben werden. Die entsprechenden Schlüssel sind bereits hinterlegt. Die Schlüssel für die Plugin-Properties sind mögleicherweise nicht direkt korrekt geladen, Sie können sich an folgender Reihenfolge orientieren:

Endpoint-URL zum Webservice

• Die Url zu Ihrem HISinOne System. Die Angabe eines Pfads ist möglich, jedoch sollte nicht der exakte Service angegeben werden. Dies wird durch formcycle gesetzt.

Benutzername für die Anmeldung am Webservice

• Der Benutzername des Webservice-Nutzers. Entspricht nicht automatisch dem Zugang zur Weboberfläche des HISinOne Systems.

Passwort für die Anmeldung am Webservice

• Das Passwort des Webservice-Nutzers. Entspricht nicht automatisch dem Zugang zur Weboberfläche des HISinOne Systems.

Connection Timeout

• Standardwert für Dauer von Verbindungsversuchen.

Read Timeout

• Standardwert für Dauer von Leseversuchen.

Verwendung der Workflow-Aktion

Das Plugin stellt aktuell eine Workflow-Aktion zur Verfügung: Person suchen. Diese kann Teil einer Verarbeitungskette sein:

Weitere Informationen zur Konfiguration des Workflows ist in folgendem Artikel zu finden: Workflow-Designer

Verbindung zum Webservice

Die zuvor getätigten Angaben für die Verbindung zum Webservice werden in der Workflow-Aktion teilweise angezeigt. Diese Angaben können hier überladen werden, wodurch je Workflow-Aktion eine andere URL angesprochen werden kann. Die Angaben in der Workflow-Aktion überschreiben die Angaben in den Plugin-Properties.

Übergabewerte

Eine Person kann auf Basis von Suchkriterien gefiltert werden. Die Suchkriterien müssen ausgewählt werden und einem Wert zugeordnet werden. Diese Werte können dynamisch aus dem Formular befüllt werden. Dies geschieht durch Formularplatzhalter, wozu in folgendem Artikel ausführliche Informationen zu finden sind: Platzhalterersetzung (Formularwerte)

Die Aktion führt ausschließlich die PersonService:findPerson Operation aus.

Die Auswahlmöglichkeiten der Suchkriterien richten sich nach der Schnittstellenbeschreibung. Es können beliebig viele Übergabewerte deklariert werden. Eine doppelte Zuweisung von Suchkriterien sollte vermieden werden. Es wird nur eine einzelne ID von der Aktion zurückgegeben. Falls es mehrere Treffer gibt, wird nur der erste Treffer ausgegeben und ein weicher Fehler im Protokoll mit allen Treffern angegeben. Mehr Informationen zum Protokoll: Protokoll

Rückgabewerte der Workflow-Aktion

Die Workflow-Aktion erzeugt Rückgabewerte. Auf diese Werte kann per Platzhalter zugegriffen werden. Die Werte stehen nur innerhalb der Verarbeitungskette zur Verfügung, in der die Workflow-Aktion ausgeführt wird.

[%$Person suchen.RESULT.PersonID%]

• Die ID der gefundenen Person.

Fehlercodes der Workflow-Aktion

AUTHORIZATION_FAILED

• Wenn gegenüber dem Webservice keine Autorisierung durchgeführt werden konnte.

EMPTY_SEARCH_CRITERIA

• Es fehlen Suchkriterien oder die Werte der angegebenen Suchkriterien sind leer.

INTERNAL_ERROR

• Wenn ein nicht näher spezifizierter Fehler aufgetreten ist.

SRV_METHOD_ERROR

• Wenn der Aufruf einer Service-Methode in einem Fehler resultierte.

Weiche Fehlercodes der Workflow-Aktion

MULTIPLE_RESULTS_FOUND

• Es wurden mehrere Personen für die angegebenen Suchkriterien gefunden.

NO_RESULTS_FOUND

• Es wurde keine Person für die angegebenen Suchkriterien gefunden.