Searching for Tasks and ClinicalImpressions
Guidelines or example of queries for retrieving task and clinical impressions.
- 1 How do I get the list of unassigned Task resources for my CareTeam?
- 2 How do I get the list of Task resources for my CareTeam sorted by priority and paginated?
- 3 How do I get a list of ClinicalImpression resources referenced in Task resources for my CareTeam?
- 4 How do I get a list of ClinicalImpression resources in an EpisodeOfCare?
- 5 How to get the list of Task resources related to a specific solution (eg K-PRO or TELMA)
How do I get the list of unassigned Task resources for my CareTeam?
GET [task.base]/Task/?status=requested&reponsible=<my CareTeam reference>
How do I get the list of Task resources for my CareTeam sorted by priority and paginated?
Ordering of the Priority value is by default lexicographical in FHIR. It is possible to get a descending priority ordering by using the following two queries:
GET [task.base]/Task/?status=requested&reponsible=<my CareTeam reference>&priority=asap,stat&_sort=-status
GET [task.base]/Task/?status=requested&reponsible=<my CareTeam reference>&priority=routine,urgent&_sort=-status
How do I get a list of ClinicalImpression resources referenced in Task resources for my CareTeam?
GET [task.base]/Task/?reponsible=<my CareTeam reference>&_include=Task:focus
This search gives a paginated result where the same page contains both Tasks and referenced ClinicalImpression.
The _include=Task:focus
works for resources provided on the same service as Task, currently ClinicalImpression only.
How do I get a list of ClinicalImpression resources in an EpisodeOfCare?
The solution must perform two searches to get the list of ClinicalImpression resources referencing an EpisodeOfCare.
It is not possible to do that in one search as ClinicalImpression might be scoped to CarePlan for the EpisodeOfCare that the users do not have access to, and therefore need to do the search in scope of the CarePlan(s) the user has access to for that EpisodeOfCare (See Access Control in eHealth Services).
That is:
One search for ClinicalImpression resources for the EpisodeOfCare. That returns ClinicalImpressions referring to the EpisodeOfCare (if the user's CareTeam context is in the EpisodeOfCare.team)
Another search for ClinicalImpression resources for the CarePlan for that EpisodeOfCare. The second search returns ClinicalImpressions scoped to the CarePlans (e.g. CarePlan for that EpisodeOfCare).
How to get the list of Task resources related to a specific solution (eg K-PRO or TELMA)
Example:
Possible tags can be found in this CodeSystem: Ehealth System - eHealth Infrastructure v3.3.0
Details about co-existence tags can be found here: Multitenancy