FHIR © HL7.org  |  Server Home  |  XIG Home  |  XIG Stats  |  Server Source  |  FHIR  

FHIR IG Statistics: OperationDefinition/DTR-Questionnaire-next-question

Packagehl7.fhir.us.davinci-dtr
Resource TypeOperationDefinition
IdDTR-Questionnaire-next-question
FHIR VersionR4
Sourcehttp://hl7.org/fhir/us/davinci-dtr/https://build.fhir.org/ig/HL7/davinci-dtr/OperationDefinition-DTR-Questionnaire-next-question.html
URLhttp://hl7.org/fhir/us/davinci-dtr/OperationDefinition/DTR-Questionnaire-next-question
Version2.2.0-ballot
Statusactive
Date2025-07-25T15:29:13+00:00
NameDTRNextQuestion
TitleDTR Next Question Operation
Realmus
Authorityhl7
DescriptionThe Next Question operation is used for *adaptive questionnaires*. For specific details, see the [SDC Next Question operation](http://hl7.org/fhir/uv/sdc/OperationDefinition/Questionnaire-next-question).
Typetrue
Kindoperation

Resources that use this resource

No resources found


Resources that this resource uses

No resources found


Narrative

Note: links and images are rebased to the (stated) source

Generated Narrative: OperationDefinition DTR-Questionnaire-next-question

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

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INresource1..1Parameters (DTR Next Question Input Parameters)

The DTR Adaptive QuestionnaireResponse Profile of the QuestionnaireResponse resource with a contained Questionnaire. When invoking the operation for the first time, neither the QuestionnaireResponse nor the contained Questionnaire will have any items, as no questions are yet known. In subsequent calls, the QuestionnaireResponse will include answers to all required questions asked so far and the contained Questionnaire will remain the same as provided back from the operation in the preceding response.

OUTreturn1..1Parameters (DTR Next Question Output Parameters)

The DTR Adaptive QuestionnaireResponse Profile of the QuestionnaireResponse resource with a contained Questionnaire. The Server updates the QuestionnaireResponse's contained Questionnaire by appending with the next question or questions ittems and any score or instruction items and returns the QuestionnaireResponse (with all answers completed thus far plus any calculated scores) as this parameter. When the questionnaire is complete, the Server updates the status of the QuestionnaireResponse resource parameter to complete.

To return a calculated score for the questionnaire or group of items, the service may return a readOnly question with the score value in the corresponding QuestionnaireResponse.item. The extension questionnaire-hidden can be included on the Questionnaire.item to indicate to the client that it should not be displayed to the end user


Source

{
  "resourceType": "OperationDefinition",
  "id": "DTR-Questionnaire-next-question",
  "text": {
    "status": "generated",
    "div": "<!-- snip (see above) -->"
  },
  "extension": [
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
      "valueCode": "cds"
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
      "valueInteger": 2,
      "_valueInteger": {
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
            "valueCanonical": "http://hl7.org/fhir/us/davinci-dtr/ImplementationGuide/hl7.fhir.us.davinci-dtr"
          }
        ]
      }
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
      "valueCode": "trial-use",
      "_valueCode": {
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
            "valueCanonical": "http://hl7.org/fhir/us/davinci-dtr/ImplementationGuide/hl7.fhir.us.davinci-dtr"
          }
        ]
      }
    }
  ],
  "url": "http://hl7.org/fhir/us/davinci-dtr/OperationDefinition/DTR-Questionnaire-next-question",
  "version": "2.2.0-ballot",
  "name": "DTRNextQuestion",
  "title": "DTR Next Question Operation",
  "status": "active",
  "kind": "operation",
  "date": "2025-07-25T15:29:13+00:00",
  "publisher": "HL7 International / Clinical Decision Support",
  "contact": [
    {
      "name": "HL7 International / Clinical Decision Support",
      "telecom": [
        {
          "system": "url",
          "value": "http://www.hl7.org/Special/committees/dss"
        }
      ]
    }
  ],
  "description": "The Next Question operation is used for *adaptive questionnaires*.  For specific details, see the [SDC Next Question operation](http://hl7.org/fhir/uv/sdc/OperationDefinition/Questionnaire-next-question).",
  "jurisdiction": [
    {
      "coding": [
        {
          "system": "urn:iso:std:iso:3166",
          "code": "US"
        }
      ]
    }
  ],
  "code": "next-question",
  "comment": "To return a calculated score for the questionnaire or group of items, the service may return a `readOnly` question with the score value in the corresponding QuestionnaireResponse.item.  The extension `questionnaire-hidden` can be included on the Questionnaire.item to indicate to the client that it should not be displayed to the end user",
  "base": "http://hl7.org/fhir/uv/sdc/OperationDefinition/Questionnaire-next-question",
  "resource": [
    "Questionnaire"
  ],
  "system": false,
  "type": true,
  "instance": false,
  "parameter": [
    {
      "name": "resource",
      "use": "in",
      "min": 1,
      "max": "1",
      "documentation": "The [DTR Adaptive QuestionnaireResponse Profile](StructureDefinition-dtr-questionnaireresponse-adapt.html) of the QuestionnaireResponse resource with a *contained* Questionnaire.  When invoking the operation for the first time, neither the QuestionnaireResponse nor the contained Questionnaire will have any items, as no questions are yet known.  In subsequent calls, the QuestionnaireResponse will include answers to all required questions asked so far and the contained Questionnaire will remain the same as provided back from the operation in the preceding response.",
      "type": "Parameters",
      "targetProfile": [
        "http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/dtr-next-question-input-parameters"
      ]
    },
    {
      "name": "return",
      "use": "out",
      "min": 1,
      "max": "1",
      "documentation": "The [DTR Adaptive QuestionnaireResponse Profile](StructureDefinition-dtr-questionnaireresponse-adapt.html) of the QuestionnaireResponse resource with a *contained* Questionnaire.  The Server updates the QuestionnaireResponse's contained Questionnaire by appending with the next question or questions ittems and any score or instruction items and returns the QuestionnaireResponse (with all answers completed thus far plus any calculated scores) as this parameter.  When the questionnaire is complete, the Server updates the status of the QuestionnaireResponse resource parameter to `complete`.",
      "type": "Parameters",
      "targetProfile": [
        "http://hl7.org/fhir/us/davinci-dtr/StructureDefinition/dtr-next-question-output-parameters"
      ]
    }
  ]
}