This is the Continuous Integration Build of FHIR (will be incorrect/inconsistent at times).
See the Directory of published versions
Patient Administration Work Group | Maturity Level: N/A | Standards Status: Informative | Compartments: Patient, Practitioner |
This is the narrative for the resource. See also the XML, JSON or Turtle format.
Note that this is the formal definition for the everything operation as an OperationDefinition on EpisodeOfCare. See the Operation documentation
Generated Narrative: OperationDefinition EpisodeOfCare-everything
URL: [base]/EpisodeOfCare/[id]/$everything
Use | Name | Scope | Cardinality | Type | Binding | Documentation |
IN | _since | 0..1 | instant | Resources updated after this period will be included in the response. The intent of this parameter is to allow a client to request only records that have changed since the last request, based on either the return header time, or or (for asynchronous use), the transaction time | ||
IN | _type | 0..* | code | One or more parameters, each containing one or more comma-delimited FHIR resource types to include in the return resources. In the absense of any specified types, the server returns all resource types | ||
IN | _count | 0..1 | integer | See discussion below on the utility of paging through the results of the $everything operation | ||
OUT | return | 1..1 | Bundle | The bundle type is "searchset" |
The key difference between this operation and simply searching the episodeofcare compartment is that it frees the client from needing to determine what it could or should ask for, particularly with regard to included resources.
It is assumed that the server has identified and secured the context appropriately, and can either associate the authorization context with a single episodeofcare, or determine whether the context has the rights to the nominated episodeofcare, if there is one, or can determine an appropriate list of episodeofcares to provide data for from the context of the request. If there is no nominated episodeofcare (GET /[base]/EpisodeOfCare/$everything) and the context is not associated with a single episodeofcare record, the actual list of episodeofcares is all episodeofcares that the user associated with the request has access to. In such cases, the server may choose to return an error rather than all the records. Specifying the relationship between the context, a user and episodeofcare records is outside the scope of this specification (though see The SMART App Launch Implementation Guide).
When this operation is used to access multiple episodeofcare records at once, the return bundle could be rather a lot of data; servers may choose to require that such requests are made asynchronously, and associated with bulk data formats. Alternatively, clients may choose to page through the result set (or servers may require this). Paging through the results is done the same as for Searching, using the _count parameter, and Bundle links. Unlike searching, there is no inherent user-display order for the $everything operation. Servers MAY consider sorting the returned resources in descending order of last record update.
The _since parameter is provided to support periodic queries to get additional information that has changed about the episodeofcare since the last query. This means that the _since parameter is based on record time. The value of the _since parameter should be set to the time from the server. If using direct response, this is the timestamp in the response header. If using the async interface, this is the transaction timestamp in the json response. Servers should ensure that the timestamps a managed such that the client does not miss any changes. Clients should be able to handle getting the same response more than once in the case that the transaction falls on a time boundary. Clients should ensure that the other query parameters are constant to ensure a coherent set of records when doing periodic queries.
Usage note: every effort has been made to ensure that the examples are correct and useful, but they are not a normative part of the specification.