OperationDefinition-next-question

Source

fhir.argonaut.questionnaire#1.0.0:null (v3.0.2)

resourceType

OperationDefinition

next-question

canonical

http://fhir.org/guides/argonaut/questionnaire/OperationDefinition/next-question

version

1.0.0

status

draft

publisher

The Argonaut Project

name

Argonaut Next Question Operation

date

2018-08-09T07:35:53+10:00

description

The Argonaut Next Question Operation is used for *adaptive questionnaires* forms where the next question is based on previous answers. The result of this operation is to return the next question and optionally the questionnaire scoring for an adaptive questionnaire. This operation uses the [QuestionnaireResponse](http://hl7.org/fhir/STU3/questionnaireresponse.html) resource with a [*contained*](http://hl7.org/fhir/STU3/references.html#contained) [Questionnaire](http://hl7.org/fhir/STU3/questionnaire.html) as both the input and output parameter. The Client initiates and queries for the next question supplying the answer to the previous question. The Server updates the contained Questionnaire in the QuestionnaireResponse in the with the next question. When the questionnaire is complete, the Server updates the status element of the QuestionnaireResponse resource to `completed`. If the questionnaire has exceeded the time limit, the Client or Server may return an [OperationOutcome](http://hl7.org/fhir/STU3/operationoutcome.html) with an error.

code

next-question

system

false

type

true

instance

false

resources

Questionnaire

Usages

Argonaut Adaptive Questionnaire Service CapabilityStatement (depends on)
Argonaut Argo Questionnaire Provider Ehr CapabilityStatement (depends on)

URL: [base]/Questionnaire/$next-question

Parameters

Use Name Scope Cardinality Type Binding Documentation

questionnaire-response

1..1

Resource

The Argo Adaptive QuestionnaireResponse Profile of the QuestionnaireResponse resource with a contained Questionnaire. The url element in the contained Questionnaire identifies which set of questions are being requested. When initiating an adaptive questionnaire, the resource represents only metadata, because it precedes the first question. For subsequent transactions the Client updates the QuestionnaireResponse with the previous question-answer pair and posts it to the Server.

OUT

return

1..1

Resource

The Argo Adaptive QuestionnaireResponse Profile of the QuestionnaireResponse resource with a contained Questionnaire. The Server updates the QuestionnaireResponse's contained Questionnaire with the next question and optionally scoring or other data and returns it as this parameter. When the questionnaire is complete, the Server updates the status element of the QuestionnaireResponse to completed .

Produced 06 Apr 2023