...

{
    "resourceType": "StructureDefinition",
    "id": "80557",
    "meta": {
        "versionId": "1",
        "lastUpdated": "2020-12-16T09:25:25.068+00:00",
        "profile": [
            "http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-definedquestion"
        ]
    },
    "url": "http://ehealth.sundhed.dk/DefinedQuestion/d3db2ad6-b45e-4d21-81db-bcd0ce5d15a3",
    "version": "1",
    "name": "Hvilket af nedenstående udsagn beskriver din situation bedst? \n\nAngiv dit svar:",
    "title": "Hvilket af nedenstående udsagn beskriver din situation bedst? \n\nAngiv dit svar:",
    "status": "active",
    "publisher": "IT Telecare Nord",
    "purpose": "Genbrugeligt spørgsmål til spørgeskema",
    "kind": "logical",
    "abstract": true,
    "type": "StructureDefinition",
    "differential": {
        "element": [
            {
                "id": "StructureDefinition",
                "path": "StructureDefinition.type",
                "definition": "Hvilket af nedenstående udsagn beskriver din situation bedst? \n\nAngiv dit svar:"
            }
        ]
    }
}

...

Upload

...

an External Questionnaire

...

Definition to the

...

To be able to share questionnaire responses to KIH, a QFDD for the FHIR Questionnaire must be uploaded to the infrastructure. Furthermore the Questionnaire must reference the uploaded QFDD in Questionnaire.identifier by an identifier with the following properties:

Questionnaire.identifier must contain the unique QFDD document id:

• Identifier.system set to “urn:oid:<Attribute root in QFDD /ClinicalDocument/id>”

• Identifier.value set to “<Attribute extension in QFDD /ClinicalDocument/id>“

OBS:

• The QFDD must be uploaded to the infrastructure before document registering of QRD.

• The Questionnaire.identifier can contain multiple identifiers but only the identifier for QFDD is allowed to have an Identifier.system starting with prefix: “urn:oid:”

If using KAM questionnaire editor to create questionnaires, the QFDD reference is set be the following field.

...

Upload QFDD/Questionnaire definition via KAM

It is possible to upload QFDD via KAM Questionnaire editor by navigating to “Administration af spørgeskemadefinitionener/QFDD'er“.

OBS: The QFDD must be officially published before uploading to the infrastructure, as questionnaire responses should only be shared for published QFDD’s.

Upload QFDD/Questionnaire definition via endpoint

Besides uploading through KAM it is possible to upload directly via POST call to endpoint: <insert link>.

The QFDD is uploaded as a DocumentReference to Document-transformation service.

The requirements for the DocumentReference:

DocumentReference.status must be current.

DocumentReference.type must be Coding for QFDD type: system = "http://loinc.org" and value = "74468-0").

DocumentReference.description the title. If not assigned, the title from the QFDD document is used.

DocumentReference.content.attachment.data must contain the QFDD xml content.

...

Infrastructure

As mentioned in Prerequisites for document registering of QuestionnaireResponse resources to national document sharing infrastructure, the corresponding questionnaire definition must be available as format Questionnaire Forms Definition Document (QFDD) and accessible to external systems in general. In addition, the QFDD must be available within the eHealth Infrastructure and it must be referenced from a Questionnaire that represents the same definition of the questionnaire.

The steps involved are:

1. Upload the QFDD representation of the questionnaire

2. Associate a Questionnaire with the uploaded QFDD representation

Uploading the QFDD

The QFDD must be represented in a DocumentReference and uploaded to the Document-transformation service by the operation $upload-qfdd.

The requirements for the DocumentReference:

• DocumentReference.status must be current.

• DocumentReference.type must be Coding for QFDD (system = "http://loinc.org" and value = "74468-0").

• DocumentReference.description should contain the title of the questionnaire. If not assigned, the title from the QFDD document is used (in the service operation $upload-qfdd).

• DocumentReference.content.attachment.data must contain the QFDD (as its xml representation).

Associating a Questionnaire with the QFDD

There must be a Questionnaire that represents the same questionnaire as defined in the QFDD.

To associate a Questionnaire with a QFDD, the Questionnaire.identifier must contain the unique document id of the QFDD:

• Identifier.system set to “urn:oid:<Attribute root in /ClinicalDocument/id of the QFDD>"

• Identifier.value set to “<Attribute extension in /ClinicalDocument/id of the QFDD>"

Maintaining Questionnaire Terminology (Danish: Spørgeskemakodebank)

When creating Questionnaires for the purpose of Document Sharingdocument sharing, it is required that various questionnaire elements (groups, questions, answers etc.) are configured with coded values and ids.

The coded values are maintained in the Questionnaire Terminology Service as codes on CodeSystems and the concepts in CodeSystem resources and ids must refer to NamingSystems registered on NamingSystem resources created in the Questionnaire Terminology Service.

These resource can be maintained by users with the Questionnaire Editor role, which contains has the permissions for creating/update resources on the Questionnaire Terminology Service.

...