anonymizeOriginals

Unterstützt ab TTP-FHIR Gateway Version 2024.2.0

Anonymisiert eine gegebene Liste von 1-n Originalwerten innerhalb der angegebenen Domäne. Dabei wird der Bezug von Originalwert und Pseudonym dauerhaft únd irreversibel gelöscht.

Voraussetzung

Die angegebene Pseudonym-Domäne muss in gPAS konfiguriert und der angegebene Originalwert in dieser Domäne bereits vorhanden sein.

Aufruf und Rückgabe

Invocations

URL: [base]/$anonymizeOriginals

This operation changes content

Parameters (In)

NameCardinalityTypeDocumentation
target1..1string

Angabe der Domäne innerhalb derer für die angegebenen Originalwerte eine Anonymisierung durchgeführt werden soll.

original1..*string

Angabe der Originalwerte für die in der angegebenen Domäne eine Anonymisierung durchgeführt werden soll.

Return Values (Out)

NameCardinalityTypeDocumentation
successStatus1..*

Status-Rückgabe der einzelnen durchgeführten Anonymisierungen

successStatus.target0..1Identifier

Target-Identifikator

successStatus.original1..1Identifier

Original-Identifikator

successStatus.result-code1..1Coding

Erfolgs- bzw. Fehlercode

Anonymisiert eine gegebene Liste von 1-n Originalwerten innerhalb der angegebenen Domäne. Dabei wird der Bezug von Originalwert und Pseudonym dauerhaft únd irreversibel gelöscht.

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/$anonymizeOriginals

Der Funktionsaufruf liefert ein ParameterSet bestehend aus multiplen benannten Parametern zurück:

  1. original = der zu pseudonymisierende Werte (Teil des Requests)
  2. target = die genutzte Ziel-Domäne (Teil des Requests)
  3. result-code = Ergebnisstatus (Erfolg oder Fehler).

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-AnonymizeOriginals-request-example-1" />
<parameter>
<name value="target" />
<valueString value="MIRACUM" />
</parameter>
<parameter>
<name value="original" />
<valueString value="1001000000022" />
</parameter>
<parameter>
<name value="original" />
<valueString value="1001000000033" />
</parameter>
</Parameters>

Eine beispielhafte Rückmeldung kann wie folgt aussehen:

<Parameters xmlns="http://hl7.org/fhir">
<id value="Parameters-AnonymizeOriginals-response-example-1" />
<parameter>
<name value="successStatus" />
<part>
<name value="target" />
<valueIdentifier>
<system value="https://ths-greifswald.de/gpas" />
<value value="MIRACUM" />
</valueIdentifier>
</part>
<part>
<name value="original" />
<valueIdentifier>
<system value="https://ths-greifswald.de/gpas" />
<value value="1001000000022" />
</valueIdentifier>
</part>
<part>
<name value="result-code" />
<valueCoding>
<system value="http://terminology.hl7.org/CodeSystem/operation-outcome" />
<code value="MSG_UPDATED" />
</valueCoding>
</part>
</parameter>
<parameter>
<name value="successStatus" />
<part>
<name value="target" />
<valueIdentifier>
<system value="https://ths-greifswald.de/gpas" />
<value value="MIRACUM" />
</valueIdentifier>
</part>
<part>
<name value="original" />
<valueIdentifier>
<system value="https://ths-greifswald.de/gpas" />
<value value="1001000000033" />
</valueIdentifier>
</part>
<part>
<name value="result-code" />
<valueCoding>
<system value="http://hl7.org/fhir/issue-type" />
<code value="not-found" />
<display value="Not Found" />
</valueCoding>
</part>
</parameter>
</Parameters>

Auftretende Fehler (z.B. angegebenes Pseudonym ist unbekannt) werden im Einzelnen entsprechend per Coding vom Typ Issue-Type signalisiert.