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-secondary
| Official URL: https://ths-greifswald.de/fhir/OperationDefinition/gpas/pseudonymize-secondary | Version: 2025.2.0 | |||
| Active as of 2025-06-12 | Computable Name: PseudonymizeSecondary | |||
Erzeugung einer spezifischen Anzahl von Pseudonymen in einem vorhandenen Pseudonymisierungskontext bei gleichzeitiger Zuordnung zum übermittelten Originalwert.
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)
URL: [base]/$pseudonymize-secondary
Parameters
| Use | Name | Scope | Cardinality | Type | Binding | Documentation |
| IN | original | 1..* | Originalwerte | |||
| IN | 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. | ||
| IN | original.value | 1..1 | string | Original-Identifikator für den n Sekundärpseudonyme erzeugt werden sollen. | ||
| IN | original.count | 1..1 | integer | Anzahl der zu erzeugenden Sekundärpseudonyme. | ||
| OUT | secondarypseudonym | 1..* | erzeugte SekundärPersonenpseudonyme | |||
| OUT | secondarypseudonym.target | 1..1 | Identifier | Pseudonymisierungskontext (Teil des Requests). | ||
| OUT | secondarypseudonym.original | 1..1 | Identifier | Original-Identifikator (Teil des Requests). | ||
| OUT | secondarypseudonym.value | 1..1 | Identifier | Sekundär-Pseudonym. | ||
| OUT | secondarypseudonym.result-code | 0..1 | Coding | Erfolgsstatus | ||
| OUT | error | 0..* | Aufgetretene Fehler | |||
| OUT | error.target | 1..1 | Identifier | Fehlerhafte Domänenangabe | ||
| OUT | error.error-code | 0..1 | Coding | Fehlerdetails |
Erzeugung einer spezifischen Anzahl von Pseudonymen in einem vorhandenen Pseudonymisierungskontext bei gleichzeitiger Zuordnung zum übermittelten Originalwert.
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.
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
- Request-Body
- Rückmeldung
- Fehler-Rückmeldung (hier: unbekannte target-Angabe)