From c9f0f72a00852b580916019a02b3318ca98c8e8c Mon Sep 17 00:00:00 2001 From: Someshwara Nazare Date: Wed, 10 Jan 2024 10:34:45 +0530 Subject: [PATCH 1/3] [R4][DiagnosticReport][DocumentReference] support search by _lastUpdated --- .../r4/clinical/diagnostics/diagnostic-report.md | 7 +++++++ .../r4/foundation/documents/document-reference.md | 7 +++++++ 2 files changed, 14 insertions(+) diff --git a/content/millennium/r4/clinical/diagnostics/diagnostic-report.md b/content/millennium/r4/clinical/diagnostics/diagnostic-report.md index b62c0658c..94f1d4ee0 100644 --- a/content/millennium/r4/clinical/diagnostics/diagnostic-report.md +++ b/content/millennium/r4/clinical/diagnostics/diagnostic-report.md @@ -73,6 +73,7 @@ Search for DiagnosticReports that meet supplied query parameters: `patient` | This or `_id` | [`reference`] | The subject of the report if a patient. Example: `12345` `encounter` | N | [`reference`] | The Encounter when the order was made. Must represent an Encounter resource. Example: `encounter=1621910` `date` | N | [`date`] | Date range into which the diagnostic report falls (effectiveDateTime). Either 1 or 2 date/times can be given. Example: `date=ge2020-01-01T08:00:00.000Z&date=le2020-01-31T17:00:00.000Z` + `_lastUpdated` | N | [`date`] | Date range in which the diagnostic report was last updated. Either 1 or 2 date/times can be given. Example: `_lastUpdated=gt2014-09-24` or `_lastUpdated=lt2015-09-24T12:00:00.000Z` `_count` | N | [`number`] | The maximum number of results to return. Defaults to `10` and a maximum of `100` documents can be returned. `category` | N | [`token`] | The diagnostic discipline/department which created the report. Example: `http://terminology.hl7.org/CodeSystem/v2-0074|LAB` or `http://loinc.org|LP29684-5` `code` | N | [`token`] | The specific code for describing the report. Example: `http://loinc.org|24323-8` @@ -88,6 +89,12 @@ _Implementation Notes_ * It must be provided with `le` or `lt` and `ge` or `gt` prefixes to search for report(s) within a specific range. * The `time` component is required for both parameters. +* The `_lastUpdated` parameters may be provided up to two times, and must use the `eq`, `ge`, `gt`, `le`, or `lt` prefixes. When a value is provided without a prefix, an implied `eq` prefix is used. When provided twice, the lower value must have a `ge` or `gt` prefix and the higher value must have an `le` or `lt` prefix. The lower value date/time should be of occurance before than the higher value date/time occurance. + +* The `date` and `_lastUpdated` parameters may not be provided together. + +* The `_lastUpdated` query will only qualify clinically significant updates. For example, changes to the value or code, and other significant fields. Minor updates, like some non-clinically relevant note updates, will not qualify. + * When searching with the `encounter` parameter: * Patient level documents are filtered out from responses when the encounter id is zero/blank. * May include a single value or comma separated list of references. Example `encounter=12345,67890` diff --git a/content/millennium/r4/foundation/documents/document-reference.md b/content/millennium/r4/foundation/documents/document-reference.md index 16fb30272..156b5c460 100644 --- a/content/millennium/r4/foundation/documents/document-reference.md +++ b/content/millennium/r4/foundation/documents/document-reference.md @@ -75,6 +75,7 @@ Search for DocumentReferences that meet supplied query parameters: `_revinclude` | No | [`token`] | Provenance resource entries to be returned as part of the bundle. Example: `_revinclude=Provenance:target` `date` | No | [`date`] | When this document reference was created. Example: `date=ge2020-01-01T08:00:00.000Z&date=le2020-01-31T17:00:00.000Z` `period` | No | [`date`] | Time of service that is being documented. Example: `period=ge2017-01-01&period=lt2017-01-05` + `_lastUpdated`| N | [`date`] | Date range in which the document was last updated. Either 1 or 2 date/times can be given. Example: `_lastUpdated=gt2014-09-24` or `_lastUpdated=lt2015-09-24T12:00:00.000Z` _Implementation Notes_ @@ -98,6 +99,12 @@ _Implementation Notes_ - When searching with the `period` parameter: - It must be provided twice, once with the `ge` prefix, and once with the `lt` prefix. - Date precision must be consistent. +- The `_lastUpdated` parameters may be provided up to two times, and must use the `eq`, `ge`, `gt`, `le`, or `lt` prefixes. When a value is provided without a prefix, an implied `eq` prefix is used. When provided twice, the lower value must have a `ge` or `gt` prefix and the higher value must have an `le` or `lt` prefix. The lower value date/time should be of occurance before than the higher value date/time occurance. + +- The `date`, `period` and `_lastUpdated` parameters may not be provided together. + +- The `_lastUpdated` query will only qualify clinically significant updates. For example, changes to the value or code, and other significant fields. Minor updates, like some non-clinically relevant note updates, will not qualify. + - When searching with the `_revinclude` parameter: - It may be provided once with the value `Provenance:target`. Example: `_revinclude=Provenance:target` - It may be provided with the `_id` or `patient` parameter. Example: `_id=214938095&_revinclude=Provenance:target` From 39d5bc7960bc87555d3f81de4876c0c5c78baee8 Mon Sep 17 00:00:00 2001 From: Someshwara Nazare Date: Tue, 16 Jan 2024 16:20:19 +0530 Subject: [PATCH 2/3] review changes --- content/millennium/r4/clinical/diagnostics/diagnostic-report.md | 2 +- .../millennium/r4/foundation/documents/document-reference.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/content/millennium/r4/clinical/diagnostics/diagnostic-report.md b/content/millennium/r4/clinical/diagnostics/diagnostic-report.md index 94f1d4ee0..a48a29edd 100644 --- a/content/millennium/r4/clinical/diagnostics/diagnostic-report.md +++ b/content/millennium/r4/clinical/diagnostics/diagnostic-report.md @@ -89,7 +89,7 @@ _Implementation Notes_ * It must be provided with `le` or `lt` and `ge` or `gt` prefixes to search for report(s) within a specific range. * The `time` component is required for both parameters. -* The `_lastUpdated` parameters may be provided up to two times, and must use the `eq`, `ge`, `gt`, `le`, or `lt` prefixes. When a value is provided without a prefix, an implied `eq` prefix is used. When provided twice, the lower value must have a `ge` or `gt` prefix and the higher value must have an `le` or `lt` prefix. The lower value date/time should be of occurance before than the higher value date/time occurance. +* The `_lastUpdated` parameters may be provided up to two times, and must use the `eq`, `ge`, `gt`, `le`, or `lt` prefixes. When a value is provided without a prefix, an implied `eq` prefix is used. When provided twice, the lower value must have a `ge` or `gt` prefix and the higher value must have an `le` or `lt` prefix. * The `date` and `_lastUpdated` parameters may not be provided together. diff --git a/content/millennium/r4/foundation/documents/document-reference.md b/content/millennium/r4/foundation/documents/document-reference.md index 156b5c460..639c53ed9 100644 --- a/content/millennium/r4/foundation/documents/document-reference.md +++ b/content/millennium/r4/foundation/documents/document-reference.md @@ -99,7 +99,7 @@ _Implementation Notes_ - When searching with the `period` parameter: - It must be provided twice, once with the `ge` prefix, and once with the `lt` prefix. - Date precision must be consistent. -- The `_lastUpdated` parameters may be provided up to two times, and must use the `eq`, `ge`, `gt`, `le`, or `lt` prefixes. When a value is provided without a prefix, an implied `eq` prefix is used. When provided twice, the lower value must have a `ge` or `gt` prefix and the higher value must have an `le` or `lt` prefix. The lower value date/time should be of occurance before than the higher value date/time occurance. +- The `_lastUpdated` parameters may be provided up to two times, and must use the `eq`, `ge`, `gt`, `le`, or `lt` prefixes. When a value is provided without a prefix, an implied `eq` prefix is used. When provided twice, the lower value must have a `ge` or `gt` prefix and the higher value must have an `le` or `lt` prefix. - The `date`, `period` and `_lastUpdated` parameters may not be provided together. From a20559b2a915721af3d6f5a1eeb14740ef480ae5 Mon Sep 17 00:00:00 2001 From: Someshwara N <35108040+Someshnsn@users.noreply.github.com> Date: Wed, 31 Jan 2024 11:46:08 +0530 Subject: [PATCH 3/3] Review Changes --- .../millennium/r4/foundation/documents/document-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/millennium/r4/foundation/documents/document-reference.md b/content/millennium/r4/foundation/documents/document-reference.md index 639c53ed9..d13d8495a 100644 --- a/content/millennium/r4/foundation/documents/document-reference.md +++ b/content/millennium/r4/foundation/documents/document-reference.md @@ -75,7 +75,7 @@ Search for DocumentReferences that meet supplied query parameters: `_revinclude` | No | [`token`] | Provenance resource entries to be returned as part of the bundle. Example: `_revinclude=Provenance:target` `date` | No | [`date`] | When this document reference was created. Example: `date=ge2020-01-01T08:00:00.000Z&date=le2020-01-31T17:00:00.000Z` `period` | No | [`date`] | Time of service that is being documented. Example: `period=ge2017-01-01&period=lt2017-01-05` - `_lastUpdated`| N | [`date`] | Date range in which the document was last updated. Either 1 or 2 date/times can be given. Example: `_lastUpdated=gt2014-09-24` or `_lastUpdated=lt2015-09-24T12:00:00.000Z` + `_lastUpdated`| No | [`date`] | Date range in which the document was last updated. Either 1 or 2 date/times can be given. Example: `_lastUpdated=gt2014-09-24` or `_lastUpdated=lt2015-09-24T12:00:00.000Z` _Implementation Notes_