IG TTP-FHIR Gateway

pseudonymizeSecondary

Erzeugung einer spezifischen Anzahl von Pseudonymen in einem vorhandenen Pseudonymisierungskontext bei gleichzeitiger Zuordnung zum übermittelten Originalwert

Voraussetzung

Der erforderliche Pseudonymisierungskontext (target) wurde im Vorfeld bereits konfiguriert und ist vorhanden

Aufruf und Rückgabe

Invocations

URL: [base]/$pseudonymize-secondary

This operation does NOT change content

Parameters (In)

Name	Cardinality	Type	Documentation
original	1..*		Originalwerte
original.target	1..1	string	Pseudonymisierungskontext auf Basis dessen für den angegebenen Original-Identifikator n Sekundärpseudonyme erzeugt werden sollen. Ist bei allen Tripeln eines Requests der target-Parameter identisch, erfolgt die interne Verarbeitung mit erhöhter Performance.
original.value	1..1	string	Original-Identifikator für den n Sekundärpseudonyme erzeugt werden sollen.
original.count	1..1	integer	Anzahl der zu erzeugenden Sekundärpseudonyme.

Return Values (Out)

Name	Cardinality	Type	Documentation
secondarypseudonym	1..*		erzeugte SekundärPersonenpseudonyme
secondarypseudonym.target	1..1	Identifier	Pseudonymisierungskontext (Teil des Requests).
secondarypseudonym.original	1..1	Identifier	Original-Identifikator (Teil des Requests).
secondarypseudonym.value	1..1	Identifier	Sekundär-Pseudonym.

Erzeugung einer spezifischen Anzahl von Pseudonymen in einem vorhandenen Pseudonymisierungskontext bei gleichzeitiger Zuordnung zum übermittelten Originalwert.

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/gpas/$pseudonymize-secondary

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.

Beispiel

Beispielhafter Request-Body:

<Parameters xmlns="http://hl7.org/fhir">
    <id value="Parameters-PseudonymizeSecondary-request-example-1" />
    <parameter>
        <name value="original" />
        <part>
            <name value="target" />
            <valueString value="Datensatz-Ebene" />
        </part>
        <part>
            <name value="value" />
            <valueString value="H3RAU56A8E" />
        </part>
        <part>
            <name value="count" />
            <valueString value="2" />
        </part>
    </parameter>
</Parameters>

Eine beispielhafte Rückmeldung kann wie folgt aussehen:

<Parameters xmlns="http://hl7.org/fhir">
    <id value="Parameters-PseudonymizeSecondary-response-example-1" />
    <parameter>
        <name value="secondarypseudonym" />
        <part>
            <name value="target" />
            <valueIdentifier>
                <system value="https://sample/psn-system" />
                <value value="Datensatz-Ebene" />
            </valueIdentifier>
        </part>
        <part>
            <name value="original" />
            <valueIdentifier>
                <system value="https://sample/psn-system" />
                <value value="H3RAU56A8E" />
            </valueIdentifier>
        </part>
        <part>
            <name value="value" />
            <valueIdentifier>
                <system value="https://ths-greifswald.de/gpas" />
                <value value="53KUNDA3RP5N1" />
            </valueIdentifier>
        </part>
    </parameter>
    <parameter>
        <name value="secondarypseudonym" />
        <part>
            <name value="target" />
            <valueIdentifier>
                <system value="https://sample/psn-system" />
                <value value="Datensatz-Ebene" />
            </valueIdentifier>
        </part>
        <part>
            <name value="original" />
            <valueIdentifier>
                <system value="https://sample/psn-system" />
                <value value="H3RAU56A8E" />
            </valueIdentifier>
        </part>
        <part>
            <name value="value" />
            <valueIdentifier>
                <system value="https://sample/psn-system" />
                <value value="53KUNDA3RP5N2" />
            </valueIdentifier>
        </part>
    </parameter>
</Parameters>