2025.2.0 - ci-build
IGTTPFHIRGatewayWorkflowbasierteSchnittstellen - Local Development build (v2025.2.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
OperationDefinition: requestTasks
| Official URL: https://ths-greifswald.de/fhir/OperationDefinition/dispatcher/requestTasks | Version: 2025.2.0 | |||
| Active as of 2026-02-18 | Computable Name: RequestTasks | |||
Abruf offener Standort-Aufgaben (Tasks) von der föderierten Treuhandstelle (fTTP).
Zweck
Tasks sind Aufgaben, die ein Standort regelmäßig abruft und abarbeitet. Dies umfasst beispielsweise die Auflösung eines Clearing-Prozesses, wenn ein Privacy-Preserving Record Linkage zu einem uneindeutigem Ergebnis kam. Es wird empfohlen, die Aufgaben regelmäßig (und mehrmals die Woche) abzurufen. Andernfalls können uneindeutige Matches nicht aufgelöst werden und entsprechende Pseudonyme nicht vergeben werden. Aufgaben können sein: Einen vorhergehenden Request erneut senden, das Pseudonym nach einem Clearing-Prozess abrufen und am Standort hinterlegen, Identifizierende Daten zu einem vorher gesendeten Bloomfilter senden. Aufgaben haben ein Verfallsdatum. Werden diese nicht rechtzeitig abgearbeitet, wird der auslösende Prozess abgebrochen (z.B. Clearing-Prozess).
Voraussetzung
- API-Key: Der spezifizierte API-Key muss valide und zum Aufruf der Methode autorisiert sein. Der API-KEY wird im Request-Header übermittelt.
- Die spezifizierte Studie muss im Zielsystem bekannt und angelegt sein.
- Die standortspezifische Ziel-Domäne (target) muss im Zielsystem bekannt und angelegt sein.
URL: [base]/$requestTasks
Parameters
| Use | Name | Scope | Cardinality | Type | Binding | Documentation |
| IN | study | 1..1 | string | Angabe der Studie | ||
| IN | target | 1..1 | string | Angabe der Ziel-Domäne bzw. des abrufenden Standorts | ||
| OUT | dic_psn_available | 0..* | Pseudonym-Rückgabe aus einem Bloomfilter-Request. | |||
| OUT | dic_psn_available.expires | 0..1 | instant | Ablaufdatum (danach ist die Information ungültig) | ||
| OUT | dic_psn_available.bloomfilter | 1..1 | base64Binary | Bloomfilter | ||
| OUT | dic_psn_available.target | 1..1 | Identifier | Target-Identifikator | ||
| OUT | dic_psn_available.pseudonym | 1..1 | Identifier | Pseudonym | ||
| OUT | send_idat | 0..* | Anforderung, IDAT zu übermitteln. | |||
| OUT | send_idat.expires | 1..1 | instant | Ablaufdatum (danach ist die Information ungültig) | ||
| OUT | send_idat.taskId | 1..1 | id | Identifikator der Aufgabe, dient der Rückreferenzierung in der providePatientData Operation. | ||
| OUT | send_idat.pseudonym | 0..1 | Identifier | Pseudonym. Entweder Pseudonym oder Bloomfilter müssen enthalten sein. | ||
| OUT | send_idat.bloomfilter | 0..1 | base64Binary | Bloomfilter. Entweder Pseudonym oder Bloomfilter müssen enthalten sein. | ||
| OUT | send_idat.element | 1..* | Coding | https://ths-greifswald.de/fhir/ValueSet/dispatcher/IdatElements (Required) | Vorgabe, welche Elemente in den IDAT von providePatientData enthalten sein sollen. Das Coding ist an das Value Set IdatElements gebunden. | |
| OUT | repeat_request | 0..* | Anforderung einen Bloomfilter-Request zu wiederholen. | |||
| OUT | repeat_request.expires | 0..1 | instant | Ablaufdatum (danach ist die Information ungültig) | ||
| OUT | repeat_request.study | 1..1 | Identifier | Angabe der Studie | ||
| OUT | repeat_request.bloomfilter | 1..1 | base64Binary | Studien- und standortspezifischer Bloomfilter (base64-codiert) | ||
| OUT | repeat_request.target | 1..1 | Identifier | Angabe des Bloomfilter sendenden Standorts (Ziel-Domäne) |
Ein Standort kann seine offenen Aufgaben abrufen. Antwort ist eine Liste von Tasks.
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/dispatcher/$requestTasks
Der Funktionsaufruf liefert eine Parameters-Ressource bestehend aus multiplen Multi-Part-Parametern zurück.
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.