[R4] ServiceRequest support _revincludes:Provenance:target (#1045)

content/millennium/r4/clinical/care-provision/service-request.md

@@ -58,6 +58,7 @@ Search for ServiceRequests that meet supplied query parameters:
   `code`                  | N                               | [`token`]      | What is being requested/ordered. Example: `code=https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/200|22337316`
  `_lastUpdated`           | N                               | [`date`]      | An explicit or implied date-time range within which the most recent clinically relevant update was made to the service request. Must include a time, and must be prefixed by `ge` or `le`. Example: `ge2014-05-19T20:54:02.000Z`
  [`_count`]               | N                               | [`number`]    | The maximum number of ServiceRequests to retrieve in a page. Example: `50`
+ `_revinclude`            | N                               | [`token`]     | Provenance resource entries to be returned as part of the bundle. Example: `_revinclude=Provenance:target`
 
 Notes:
 
@@ -67,6 +68,12 @@ Notes:
       * once with a prefix `ge` or `le` representing the earliest date or latest date. (e.g. `date=ge2015-01-01`, `date=le2016-01-01`)
       * twice with the prefixes `ge`, `le` to indicate a specific range. (e.g. `date=ge2015-01-01&date=le2016-01-01`)
 
+  * 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` parameters. Example: `_id=214938095&_revinclude=Provenance:target`
+
+  * When `_revinclude` is provided in a request to the closed endpoint, the OAuth2 token must include the scope corresponding to the Authorization Type, such as `user/Provenance.read`, `patient/Provenance.read` or `system/Provenance.read`.
+
 ### Headers
 
 <%= headers fhir_json: true %>
@@ -93,6 +100,27 @@ Notes:
 <%= json(:R4_SERVICE_REQUEST_PATIENT_ACCESS_BUNDLE) %>
 <%= disclaimer %>
 
+### Example Search by _id with RevInclude
+
+
+### Authorization Types
+
+<%= authorization_types(provider: true, patient: true, system: true) %>
+
+
+### Headers
+
+<%= headers %>
+#### Request
+
+    GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/ServiceRequest?_id=309358493,309307167&_revinclude=Provenance:target
+
+#### Response
+
+<%= headers status: 200 %>
+<%= json(:R4_SERVICE_REQUEST_SEARCH_BY_REVINCLUDE) %>
+<%= disclaimer %>
+
 ### Errors
 
 The common [errors] and [OperationOutcomes] may be returned.