pseudonymizeSecondary

Unterstützt ab TTP-FHIR Gateway Version 2025.1.0

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

Voraussetzung
  • Der oder die erforderlichen Pseudonymisierungskontexte (target) wurden im Vorfeld bereits konfiguriert und sind vorhanden
  • Die target-Domänen sind als "MultiPsn"-Domänen konfiguriert (mehrere Pseudonyme pro Originalwert innerhalb derselben Domäne gestattet)
Aufruf und Rückgabe

Invocations

URL: [base]/$pseudonymize-secondary

This operation changes content

Parameters (In)

NameCardinalityTypeDocumentation
original1..*

Originalwerte

original.target1..1string

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.value1..1string

Original-Identifikator für den n Sekundärpseudonyme erzeugt werden sollen.

original.count1..1integer

Anzahl der zu erzeugenden Sekundärpseudonyme.

Return Values (Out)

NameCardinalityTypeDocumentation
secondarypseudonym1..*

erzeugte SekundärPersonenpseudonyme

secondarypseudonym.target1..1Identifier

Pseudonymisierungskontext (Teil des Requests).

secondarypseudonym.original1..1Identifier

Original-Identifikator (Teil des Requests).

secondarypseudonym.value1..1Identifier

Sekundär-Pseudonym.

secondarypseudonym.result-code0..1Coding

Erfolgsstatus

error0..*

Aufgetretene Fehler

error.target1..1Identifier

Fehlerhafte Domänenangabe

error.error-code0..1Coding

Fehlerdetails

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.

Je nach Werteangaben (target, count) erfolgt bei der Verarbeitung intern eine Gruppierung der angefragten Werte, um die Vorteile des Batch-Processing nutzen zu können. Einheitliche count- und target-Angaben führen zu besserer Performance.

<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>
        <part>
            <name value="result-code" />
            <valueCoding>
                <system value="http://terminology.hl7.org/CodeSystem/operation-outcome" />
                <code value="MSG_CREATED" />
            </valueCoding>
        </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>
        <part>
            <name value="result-code" />
            <valueCoding>
                <system value="http://terminology.hl7.org/CodeSystem/operation-outcome" />
                <code value="MSG_CREATED" />
            </valueCoding>
        </part>
    </parameter>
</Parameters>

Eine beispielhafte Fehlermeldung (hier: unbekannte target-Angabe): 

<Parameters xmlns="http://hl7.org/fhir">
    <id value="Parameters-PseudonymizeSecondary-response-example-2" />
    <parameter>
        <name value="error" />
        <part>
            <name value="target" />
            <valueIdentifier>
                <system value="https://ths-greifswald.de/gpas" />
                <value value="DOMAINXY" />
            </valueIdentifier>
        </part>
        <part>
            <name value="error-code" />
            <valueCoding>
                <system value="http://hl7.org/fhir/issue-type" />
                <code value="not-found" />
                <display value="Not Found" />
            </valueCoding>
        </part>
    </parameter>
</Parameters>