​BfArM Digitale Anwendungen - Local Development build (v3.0.2-RC1) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

FHIR® – FAQ

Questionnaire and QuestionnaireResponse

In instances of the FHIR profile QuestionnaireResponse, the element questionnaire references the corresponding instance of the FHIR profile Questionnaire with the URL https://antrag.bfarm.de/de/intern/fragenkataloge/2; however, the instance addressed by this URL is not publicly accessible. Is it possible to use the generic instance with the URL https://diga.bfarm.de/api/fhir/v3.0/Questionnaire for all DiGA instead?

The field QuestionnaireResponse.questionnaire must match the field Questionnaire.canonical and be unique across servers. The FHIR server may store multiple Questionnaire instances (e.g. for DiGA and DiPA). A generic URL is therefore not possible.

A directly accessible URL is not strictly required in this field. The field can be used with the following query, for example, to retrieve the Questionnaire that belongs to a QuestionnaireResponse:

https://diga.bfarm.de/api/fhir/v3.0/Questionnaire?_url=https://antrag.bfarm.de/de/intern/fragenkataloge/2

The link between the questions and answers of the profile instances Questionnaire and QuestionnaireResponse is established via the element linkId. Is the mapping of the values of this ID to individual questions and question sections fixed so that this element can be used for their selection?

The linkId corresponds to the internal ID of the assessments, question blocks and questions in the application portal. The linkId in the Questionnaire always matches the corresponding linkId within the same item level in the QuestionnaireResponse. The linkId can therefore be used for selection within the same item level. It cannot be used across levels, as it is not globally unique.

The IDs do not change when new versions of the question catalog are released. However, new questions with new linkIds may be added, questions may be removed, or the order of questions as well as type, text and possible answers may change.

Besides the element linkId, there is the element text, which can be used to select individual entries in the question catalog. Are the values of this element fixed for specific question sections?

The values of the text field are not fixed. They may change when the question catalog is updated and the BfArM makes changes to the texts (name and description of the assessments, question blocks and questions). The text field should therefore not be used for selection.