IG TTP-FHIR Gateway

assignIdentity

Konzeptarbeit. Noch nicht implementiert

Zweck

Verschiebt die Zuordnung einer Identität zu einer Person (MPI-Eintrag) auf eine andere Person, um eine erkannte Dublette (Match Result = possible Match) zu beheben.

Voraussetzung

Verwendete Parameter-Werte müssen im E-PIX bekannt sein.

Aufruf und Rückgabe

Die bereitgestellte Funktionalität kann per POST-Request aufgerufen werden. Die erforderlichen Angaben werden per POST-BODY in Form von FHIR Parameters übermittelt.

<HOST>:<PORT>/ttp-fhir/fhir/epix/$assignIdentity

Der Funktionsaufruf liefert eine OperationOutcome-Ressource zurück.

Invocations

URL: [base]/$assignIdentity

This operation changes content

Parameters (In)

Name	Cardinality	Type	Documentation
domain	1..1	string	Angabe der Matching-Domäne
linkId	1..1	integer	Link-ID des Matches (Dubletteneintrag). Ermittelbar mittels Operation queryPossibleMatches.
identityReference	1..1	Reference	Referenz zur korrekten Ausprägung (Identität, Match-Item, Patient-Ressource), die das Ziel der Verschiebung ist.
comment	0..1	string	Anmerkung zum Änderungsvorgang

Return Values (Out)

Name	Cardinality	Type	Documentation
return	1..1	OperationOutcome	Rückinformation zum Merge-Vorgang.

Im Erfolgsfall wird der HTTP Statuscode 200 zurückgegeben.

Im Fehlerfall wird einer der folgenden HTTP Statuscodes in Verbindung mit einer OperationOutcome-Ressource zurückgegeben:

400: Fehlende oder fehlerhafte Parameter.
401: Fehlende Authentifizierung oder Autorisierung.
404: Parameter mit unbekanntem Inhalt.
422: Fehlende oder falsche Attribute.

Beispiel

Beispielhafter Request-Body:

<Parameters xmlns="http://hl7.org/fhir">
    <id value="Parameters-AssignIdentity-request-example-1" />
    <parameter>
        <name value="comment" />
        <valueString value="Nachforschungen haben ergeben, dass die Zuordnug so korrekt ist." />
    </parameter>
    <parameter>
        <name value="linkId" />
        <valueInteger value="5654986" />
    </parameter>
    <parameter>
        <name value="identityReference" />
        <valueReference>
            <reference value="Patient/52" />
        </valueReference>
    </parameter>
</Parameters>

Beispielhafte Response:

<OperationOutcome xmlns="http://hl7.org/fhir">
    <id value="OperationOutcome-AssignIdentity-response-example-1" />
    <issue>
        <severity value="information" />
        <code value="informational" />
        <diagnostics value="match resolved, identity moved." />
    </issue>
</OperationOutcome>