Interactions
The key interactions for the Clinical Decision Support API are represented in the diagrams below.
Invoke ServiceDefinition.$evaluate and GuidanceResponse
The triage journey starts with the system user, simply referred to as ‘user’ in this Guide, requesting decision support through the EMS.
The core of the triage journey is invoking the ServiceDefinition
via the $evaluate
operation by the EMS. This will return a GuidanceResponse
resource from the CDSS. For more on choosing the ServiceDefinition
, see the ServiceDefinition: Implementation Guidance.
This interaction is expected to be repeated multiple times during the triage journey as the EMS presents responses to CDSS questions until a result is reached.
The GuidanceResponse
carries or references all information relating to the CDSS response.
View the Evaluate ServiceDefinition and GuidanceResponse sections for detailed guidance.
Questionnaire / QuestionnaireResponse interaction
The CDSS determines the next question to ask and populates a Questionnaire
resource accordingly.
A reference to this Questionnaire
is included within the returned GuidanceResponse
.
The EMS presents the question to the user and the user responds via the EMS.
This response is used to populate a QuestionnaireResponse
resource, a reference to which is returned to the CDSS within the next ServiceDefinition.$evaluate
operation in the triage journey.
This interaction is expected to be repeated multiple times during the triage journey as different questions are presented to the user from the CDSS.
View the Get Questionnaire section for more information.
The CDSS evaluates the returned QuestionnaireResponse
and uses its content to create an assertion which is carried within an Observation
resource.
The CDSS determines whether there is enough information to arrive at a result. If not, another Questionnaire
is populated with the next question to be answered.
The GuidanceResponse
returned to the EMS now contains references to both an Observation
and a Questionnaire
resource.
View the ServiceDefinition and GuidanceResponse sections for more information.
Arriving at a result
The EMS invokes a ServiceDefinition.$evaluate
operation referencing a QuestionnaireResponse
and any previous assertions (Observation
resources) for the CDSS to evaluate.
The CDSS creates another assertion from the QuestionnaireResponse
and determines whether a result can be provided.
The result is sent to the EMS within the GuidanceResponse
and the EMS displays the result to the User.
View the Result section for more information.