IG TTP-FHIR Gateway

addPossibleMatch

Konzeptarbeit. Noch nicht implementiert

Zweck

Fügt manuell ein Match zu einer Domäne hinzu.

Voraussetzung

Der angegebene Parameter zur Spezifikation der Matching-Domäne muss im E-PIX konfiguriert 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/$addPossibleMatch

Der Funktionsaufruf liefert eine Parameters-Ressource bestehend aus einem Multi-Part-Parameter zurück.

Invocations

URL: [base]/$addPossibleMatch

This operation changes content

Parameters (In)

Name	Cardinality	Type	Documentation
domain	1..1	string	Angabe der Matching-Domaene
mpiId	1..1	Identifier	Identifikator eines MPI-Entrags (MPI-ID, Person.identifier).
aliasMpiId	1..1	Identifier	Identifikator des matchenden MPI-Entrags.

Return Values (Out)

Name	Cardinality	Type	Documentation
match	1..1		Match-Informationen zu zwei Identitäten.
match.item	2..2	Patient	Die beiden matchenden Identitäten wie im Request übergeben.
match.score	1..1	decimal	Matching-Score
match.result	1..1	decimal	Matching-Ergebnis
match.linkId	1..1	integer	Link-ID des Matches
match.comment	0..1	string	Anmerkung zum Match

Fügt einen Match zu einem bestimmten MPI-Eintrag einer Domäne hinzu.

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 Patienten-Attribute.

Beispiel

Beispielhafter Request-Body:

<Parameters xmlns="http://hl7.org/fhir">
    <id value="Parameters-AddPossibleMatch-request-example-1" />
    <parameter>
        <name value="domain" />
        <valueString value="MIRACUM" />
    </parameter>
    <parameter>
        <name value="mpiId" />
        <valueIdentifier>
            <system value="https://ths-greifswald.de/fhir/epix/identifier/MPI" />
            <value value="1001000000066" />
        </valueIdentifier>
    </parameter>
    <parameter>
        <name value="aliasMpiId" />
        <valueIdentifier>
            <system value="https://ths-greifswald.de/fhir/epix/identifier/MPI" />
            <value value="1001000068944" />
        </valueIdentifier>
    </parameter>
</Parameters>

Beispielhafte Response:

<Parameters xmlns="http://hl7.org/fhir">
    <id value="Parameters-AddPossibleMatch-response-example-1" />
    <parameter>
        <name value="match" />
        <part>
            <name value="item" />
            <resource>
                <Patient>
                    <id value="52" />
                    <meta>
                        <versionId value="1" />
                        <lastUpdated value="2021-06-17T08:28:03.200+02:00" />
                        <source value="dummy_safe_source" />
                        <profile value="https://ths-greifswald.de/fhir/StructureDefinition/epix/Patient" />
                    </meta>
                    <active value="true" />
                    <name>
                        <family value="xxxxx" />
                        <given value="Stefanie" />
                    </name>
                    <gender value="male" />
                    <birthDate value="1962-12-17" />
                </Patient>
            </resource>
        </part>
        <part>
            <name value="item" />
            <resource>
                <Patient>
                    <id value="53" />
                    <meta>
                        <versionId value="1" />
                        <lastUpdated value="2021-06-17T08:28:24.180+02:00" />
                        <source value="dummy_safe_source" />
                        <profile value="https://ths-greifswald.de/fhir/StructureDefinition/epix/Patient" />
                    </meta>
                    <active value="true" />
                    <name>
                        <family value="xxxxx" />
                        <given value="Stefanie" />
                    </name>
                    <gender value="male" />
                    <birthDate value="1962-12-16" />
                </Patient>
            </resource>
        </part>
        <part>
            <name value="score" />
            <valueDecimal value="0.965" />
        </part>
        <part>
            <name value="result" />
            <valueDecimal value="0.952" />
        </part>
        <part>
            <name value="linkId" />
            <valueInteger value="5654986" />
        </part>
        <part>
            <name value="comment" />
            <valueString value="This match was added manually!" />
        </part>
    </parameter>
</Parameters>