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: pseudonymize
| Official URL: https://ths-greifswald.de/fhir/OperationDefinition/gpas/pseudonymize | Version: 2025.2.0 | |||
| Active as of 2025-06-12 | Computable Name: Pseudonymize | |||
Abfrage je eines Pseudonym-Wertes für eine gegebene Liste von 1-n Originalwerten und eine spezifische Domäne.
Unterstützt ab TTP-FHIR Gateway Version 1.0.0
Suche von Pseudonymen
Abfrage je eines Pseudonym-Wertes für eine gegebene Liste von 1-n Originalwerten und eine spezifische Domäne.
Voraussetzung
Die angegebene Pseudonym-Domäne muss in gPAS konfiguriert und der angegebene Originalwert in dieser Domäne bereits vorhanden sein.
URL: [base]/$pseudonymize
Parameters
| Use | Name | Scope | Cardinality | Type | Binding | Documentation |
| IN | target | 1..1 | string (string) | Angabe der Domäne auf Basis derer für die angegebenen Originalwerte ein vorhandenens eindeutiges Pseudonym gesucht wird | ||
| IN | original | 1..* | string (string) | Angabe der Originalwerte für die in der angegebenen Domäne nach vorhandenen zugeordneten Pseudonymen gesucht wird | ||
| OUT | pseudonym | 0..* | Ermitteltes bzw. generiertes studien- und standort-spezifisches Pseudonym | |||
| OUT | pseudonym.original | 1..1 | Identifier | Original-Identifikator | ||
| OUT | pseudonym.target | 1..1 | Identifier | Target-Identifikator | ||
| OUT | pseudonym.pseudonym | 1..1 | Identifier | Pseudonym | ||
| OUT | error | 0..* | Fehlerrückgabe bei Teil-Fehlern | |||
| OUT | error.target | 0..1 | Identifier | Target-Identifikator | ||
| OUT | error.original | 0..1 | Identifier | Original-Identifikator | ||
| OUT | error.error-code | 1..1 | Coding | Fehlercode |
Abfrage je eines Pseudonym-Wertes für eine gegebene Liste von 1-n Originalwerten und eine spezifische Domäne.
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/$pseudonymize
Der Funktionsaufruf liefert ein ParameterSet bestehend aus multiplen benannten Parametern zurück:
- original = der zu pseudonymisierende Werte (Teil des Requests)
- target = die genutzte Ziel-Domäne (Teil des Requests)
- pseudonym = das erzeugte Pseudonym.
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.