This page is part of the FHIR Specification (v3.2.0: R4 Ballot 1). 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

• Content
• Examples
• Detailed Descriptions
• Mappings
• Profiles & Extensions
• Operations
• R2 Conversions

5.3.12 Resource StructureDefinition - Operations

FHIR Infrastructure Work Group

Maturity Level: 5

Normative

Compartments: Not linked to any defined compartments

Normative Candidate Note: This page is candidate normative content for R4 in the Conformance Package. Once normative, it will lose it's Maturity Level, and breaking changes will no longer be made.

This resource has 2 operations associated with it:

For more information about operations, including how they are invoked, see Operations.

5.3.12.1 Build Questionnaire

Generates a Questionnaire instance based on a specified StructureDefinition, 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 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 instance based on the specified StructureDefinition 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.

The official URL for this operation definition is

 http://hl7.org/fhir/OperationDefinition/StructureDefinition-questionnaire

Formal Definition (as a OperationDefinition).

URL: [base]/StructureDefinition/$questionnaire

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

This is an idempotent operation

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.

5.3.12.1.1 Examples

Request:

GET /fhir/StructureDefinition/daf-patient/$questionnaire

Response:

HTTP/1.1 200 OK
[other headers]

See DAF Patient Questionnaire 

5.3.12.2 Generate Snapshot

Generates a StructureDefinition instance with a snapshot, based on a differential in a specified StructureDefinition. If the operation is not called at the instance level, either definition 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 official URL for this operation definition is

 http://hl7.org/fhir/OperationDefinition/StructureDefinition-generate

Formal Definition (as a OperationDefinition).

URL: [base]/StructureDefinition/$generate

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

This is not an idempotent operation

5.3.12.2.1 Examples

Request:

GET /fhir/StructureDefinition/daf-patient/$generate
Accept: application/json+fhir

Response:

HTTP/1.1 200 OK
Content-Type: application/json+fhir
[other headers]

{
  "ResourceType" : "StructureDefinition",
  ... (including snapshot) ...
}