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: pseudonymizeAllowCreate

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

Generierung je eines Pseudonyms für eine Liste von Originalwerten und eine spezifische Domäne sofern es noch nicht vorhanden ist. Sofern die Zuordnung Originalwert und Domäne bereits bekannt ist, wird das zugeordnete vorhandene Pseudonym zurückgegeben.

Unterstützt ab TTP-FHIR Gateway Version 1.0.0

Suche und ggf. Erzeugung von Pseudonymen

Generierung je eines Pseudonyms für eine Liste von 1-n Originalwerten und eine spezifische Domäne sofern es noch nicht vorhanden ist. Sofern die Zuordnung Originalwert und Domäne bereits bekannt ist, wird das zugeordnete vorhandene Pseudonym zurückgegeben.

Voraussetzung

Die angegebene Pseudonym-Domäne muss in gPAS konfiguriert sein.

URL: [base]/$pseudonymizeAllowCreate

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INtarget1..1string
(string)

Angabe der Domäne auf Basis derer für den angegebenen Originalwert ein vorhandenens eindeutiges Pseudonym gesucht wird

INoriginal1..*string
(string)

Angabe der Originalwerte auf Basis derer in der zusätzlich angegebenen Domäne eindeutige Pseudonym gesucht und sofern noch nicht vorhanden erzeugt werden

OUTpseudonym0..*

Ermitteltes bzw. generiertes studien- und standort-spezifisches Pseudonym

OUTpseudonym.original1..1Identifier

Original-Identifikator

OUTpseudonym.target1..1Identifier

Target-Identifikator

OUTpseudonym.pseudonym1..1Identifier

Pseudonym

OUTerror0..*

Fehlerrückgabe bei Teil-Fehlern

OUTerror.target0..1Identifier

Target-Identifikator

OUTerror.original0..1Identifier

Original-Identifikator

OUTerror.error-code1..1Coding

Fehlercode

Generierung je eines Pseudonyms für eine Liste von 1-n Originalwerten und eine spezifische Domäne sofern es noch nicht vorhanden ist. Sofern die Zuordnung Originalwert und Domäne bereits bekannt ist, wird das zugeordnete vorhandene Pseudonym zurückgegeben.

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

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

  1. target = die genutzte Ziel-Domäne (Teil des Requests)
  2. original = der zu pseudonymisierende Werte (Teil des Requests)
  3. 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.

Beispiel