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.
GuidanceResponse carries or references all information relating to the CDSS response.
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
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
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.
GuidanceResponse returned to the EMS now contains references to both an
Observation and a
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.