[R4][DiagnosticReport][DocumentReference] support search by _lastUpda…

…ted (#1032)

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 `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`

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`| 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_
 
@@ -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 `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`