FHIRcast logo

FHIRcast
3.0.0-ballot - STU 3 Ballot International flag

FHIRcast, published by HL7 International / Infrastructure And Messaging. This guide is not an authorized publication; it is the continuous build for version 3.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhircast-docs/ and changes regularly. See the Directory of published versions

DiagnosticReport-select Event

Event-name: DiagnosticReport-select

eventMaturity 2 - Tested

Workflow

A DiagnosticReport-select request will be made to the Hub when a Subscriber desires to indicate that one or more FHIR resources contained in the DiagnosticReport context’s content are to be made visible, in focus, or otherwise “selected”. It is assumed that a FHIR resource (e.g., Observation) with the specified id is contained in the specified anchor context's content, the Hub MAY or MAY NOT provide validation of its presence.

This event allows other Subscribers to adjust their UIs as appropriate. For example, a reporting system may indicate that the user has selected a particular observation associated with a measurement value. After receiving this event an image reading application which created the measurement may wish to change its user display such that the image from which the measurement was acquired is visible.

If one or more resources are noted as selected, any other resource which had been selected is assumed to be no longer selected (i.e., an implicit unselect of any previously selected resource). Additionally, a Subscriber may indicate that all selections have been cleared by posting a DiagnosticReport-select with an empty select array.

Context

Key Cardinality Description
report 1..1 FHIR DiagnosticReport resource specifying the anchor context in which the selection is being made. Note that only the resource.resourceType and resource.id of the anchor context are required to be present.
select 1..1 Contains zero or more references to selected resources in a resources array. If a reference to a resource is present in the resources array, there is an implicit unselect of any previously selected resource. If no resource references are present in the resources array, this is an indication that any previously selected resource is now unselected.

The following profile provides guidance as to which resource attributes should be present and considerations as to how each attribute should be valued in a DiagnosticReport-select request:

Examples

DiagnosticReport-select Example

The following example shows the selection of a single Observation resource in an anchor context of a diagnostic report.

{
  "timestamp": "2019-09-10T14:58:45.988Z",
  "id": "78ef1125-7f8b-4cbc-bc59-a2a02f7e04",
  "event": {
    "hub.topic": "fdb2f928-5546-4f52-87a0-0648e9ded065",
    "hub.event": "DiagnosticReport-select",
    "context": [
      {
        "key": "report",
        "resource": {
          "resourceType": "DiagnosticReport",
          "id": "2402d3bd-e988-414b-b7f2-4322e86c9327",
          "status": "unknown",
          "code" : {
            "coding" : [
              {
                "system" : "http://loinc.org",
                "code" : "19005-8",
                "display": "Radiology Imaging study [Impression] (narrative)"
              }
            ]
          }
        }
      },
      {
        "key": "select",
        "resources": [
          {
            "resourceType": "Observation",
            "id": "40afe766-3628-4ded-b5bd-925727c013b3"
          }
        ]
      }
    ]
  }
}

Change Log

Version Description
0.1 Initial draft
1.0 Updated for STU3