2025.2.0 - ci-build

IGTTPFHIRGatewaygPAS - Local Development build (v2025.2.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

OperationDefinition: anonymizeOriginals

Official URL: https://ths-greifswald.de/fhir/OperationDefinition/gpas/anonymizeOriginals Version: 2025.2.0
Active as of 2025-06-12 Computable Name: AnonymizeOriginals

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.

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.

URL: [base]/$anonymizeOriginals

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INtarget1..1string
(string)

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

INoriginal1..*string
(string)

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

OUTsuccessStatus1..*

Status-Rückgabe der einzelnen durchgeführten Anonymisierungen

OUTsuccessStatus.target0..1Identifier

Target-Identifikator

OUTsuccessStatus.original1..1Identifier

Original-Identifikator

OUTsuccessStatus.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.

Hinweise

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/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.

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

Beispiel