2nd DSTU Draft For Comment

This page is part of the FHIR Specification (v0.4.0: DSTU 2 Draft). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2

6.18.12 Resource StructureDefinition - Operations

This resource has 1 operation associated with it. For more information about operations, including how they are invoked, see Operations.

6.18.12.1 Build Questionnaire

Generates a Questionnaire instance based on a specified Profile, creating questions for each core element or extension element found in the StructureDefinition.

If the operation is not called at the instance level, one of the identifier, profile or url 'in' parameters must be provided. (If called at the instance level, these parameters will be ignored. If more than one is specified, servers may raise an error or may resolve with the parameter of their choice.)

The response will contain a Questionnaire instance based on the specified Profile and/or an OperationOutcome 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.

Formal Definition (as a OperationDefinition).

URL: [base]/StructureDefinition/$questionnaire

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

In Parameters:
NameCardinalityTypeProfileDocumentation
identifier0..1uri

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

profile0..1token

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

url0..1uri

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

supportedOnly0..1boolean

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

Out Parameters:
NameCardinalityTypeProfileDocumentation
return1..1Questionnaire

The questionnaire form generated based on the StructureDefinition.

Note: as this the only out parameter, it is a resource, and it has the name 'return', the result of this operation is returned directly as a resource

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