<status value="draft"/><kind value="operation"/><experimental value="false"/><date value="2023-03-26T15:21:02+11:00"/><publisher value="HL7 (FHIR Project)"/><contact><telecom><system value="url"/><value value="http://hl7.org/fhir"/></telecom><telecom><system value="email"/><value value="fhir@lists.hl7.org"/></telecom></contact><description value="Generates a [Questionnaire](questionnaire.html) instance based on a specified [StructureDefinition](structuredefinition.html), creating questions for each core element or extension element found in the [StructureDefinition](structuredefinition.html). If the operation is not called at the instance level, one of the *identifier*, *profile* or *url* 'in' parameters must be provided. If more than one is specified, servers may raise an error or may resolve with the parameter of their choice. If called at the instance level, these parameters will be ignored. The response will contain a [Questionnaire](questionnaire.html) instance based on the specified [StructureDefinition](structuredefinition.html) and/or an [OperationOutcome](operationoutcome.html) resource with errors or warnings. Nested groups are used to handle complex structures and data types. If the 'supportedOnly' parameter is set to true, only those elements marked as "must support" will be included. This operation is intended to enable auto-generation of simple interfaces for arbitrary profiles. The 'questionnaire' approach to data entry has limitations that will make it less optimal than custom-defined interfaces. However, this function may be useful for simple applications or for systems that wish to support "non-core" resources with minimal development effort."/><jurisdiction><coding><system value="http://unstats.un.org/unsd/methods/m49/m49.htm"/><code value="001"/><display value="World"/></coding></jurisdiction><affectsState value="false"/><code value="questionnaire"/><comment value="**Open Issue**: Ideally, extensions should be populated in the generated [Questionnaire](questionnaire.html) that will support taking [QuestionnaireResponse](questionnaireresponse.html) resources generated from the Questionnaire and turning them back into the appropriate resources."/><resource value="StructureDefinition"/><system value="false"/><type value="true"/><instance value="true"/><parameter><name value="identifier"/><use value="in"/><min value="0"/><max value="1"/><documentation value="A logical identifier (i.e. 'StructureDefinition.identifier''). The server must know the StructureDefinition or be able to retrieve it from other known repositories."/><type value="Identifier"/></parameter><parameter><name value="profile"/><use value="in"/><min value="0"/><max value="1"/><documentation value="The [StructureDefinition](structuredefinition.html) is provided directly as part of the request. Servers may choose not to accept profiles in this fashion"/><type value="StructureDefinition"/></parameter><parameter><name value="url"/><use value="in"/><scope value="type"/><min value="0"/><max value="1"/><documentation value="The StructureDefinition's official URL (i.e. 'StructureDefinition.url'). The server must know the StructureDefinition or be able to retrieve it from other known repositories."/><type value="canonical"/><targetProfile value="http://hl7.org/fhir/StructureDefinition/StructureDefinition"/></parameter><parameter><name value="supportedOnly"/><use value="in"/><min value="0"/><max value="1"/><documentation value="If true, the questionnaire will only include those elements marked as "mustSupport='true'" in the StructureDefinition."/><type value="boolean"/></parameter><parameter><name value="return"/><use value="out"/><min value="1"/><max value="1"/><documentation value="The questionnaire form generated based on the StructureDefinition."/><type value="Questionnaire"/></parameter></OperationDefinition>

URL: [base]/StructureDefinition/$questionnaire

URL: [base]/StructureDefinition/[id]/$questionnaire

Parameters

Use

Name

Scope

Cardinality

Type

Binding

Documentation

identifier

0..1

Identifier

A logical identifier (i.e. 'StructureDefinition.identifier''). The server must know the StructureDefinition or be able to retrieve it from other known repositories.

profile

0..1

StructureDefinition

The StructureDefinition is provided directly as part of the request. Servers may choose not to accept profiles in this fashion

url

type

0..1

canonical

The StructureDefinition's official URL (i.e. 'StructureDefinition.url'). The server must know the StructureDefinition or be able to retrieve it from other known repositories.

supportedOnly

0..1

boolean

If true, the questionnaire will only include those elements marked as "mustSupport='true'" in the StructureDefinition.

OUT

return

1..1

Questionnaire

The questionnaire form generated based on the StructureDefinition.

Open Issue: Ideally, extensions should be populated in the generated Questionnaire that will support taking QuestionnaireResponse resources generated from the Questionnaire and turning them back into the appropriate resources.