Searching for Tasks and ClinicalImpressions
- Erik Nielsen
- John Schneider
- Tom Pilgård
- malthe lange
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 an EpisodeOfCare?
- 3 How do I get the list of Task resources for my CareTeam sorted by priority and paginated?
- 4 How do I get a list of ClinicalImpression resources referenced in Task resources for my CareTeam?
- 5 How do I get a list of ClinicalImpression resources in an EpisodeOfCare?
- 6 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 an EpisodeOfCare?
Being implemented as part of CCR0219. Not in production or test yet.
GET [task.base]/Task/?status=requested&episodeOfCare=<episode of care reference>This approach retrieves all tasks associated with a specific EpisodeOfCare, regardless of their current responsible, owner, or other attributes. It’s particularly helpful in scenarios where the EpisodeOfCare has been transferred to a new team (e.g., the EpisodeOfCare.team has been updated).
By retrieving all tasks linked to the EpisodeOfCare, your solution can:
Identify all tasks related to the episode, ensuring nothing is missed.
Reassign tasks to the new team if needed, ensuring continuity of care and proper task ownership.
This method ensures that tasks remain aligned with the current team responsible for the episode, even after changes in team assignments.
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=-statusHow do I get a list of ClinicalImpression resources referenced in Task resources for my CareTeam?
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: https://ehealth.sundhed.dk/fhir/CodeSystem-ehealth-system.html
Details about co-existence tags can be found here: Multitenancy