FHIR resource link

https://www.hl7.org/fhir/questionnaireresponse.html

https://build.fhir.org/questionnaireresponse.html

FHIR definition

PSI use case

FHIR required properties

PSI required properties*

Extensions

Sample payload

(minimum set)

 A structured set of questions and their answers. The questions are ordered and grouped into coherent subsets, corresponding to the structure of the grouping of the questionnaire being responded to.

PSI use case

Storing of ‘conversation branches’ on bots or application ‘events’ (websites or applications like WFA)

PII

Bots: should NEVER use Q. Response to store personal data.

Web/ Apps: If collected, it should be temporary, for internal processing, and NEVER send to the server AND should be explicitly declared on the associated Questionnaire

required properties*
(see details below)

status [fhir]
item [fhir]
questionnaire resource id [psi] (proposed as mandatory for ver FHIR 5.0)
authored [psi] dateTime, author and source

Extensions

Live: NONE

UNDER CONSIDERATION:
Add a SumittedDataTime timestamp for each response?
(to be able to track the time spend in between question)

OR KEEP IN MATOMO ONLY?

As of Sept 5th, we are leaning NOT in FHIR, only in Matomo.

Sample payload

tags

countryISO & projectID

questionnaire

Questionnaire resource ID [LINK]

status

To be used in analytics to filter out transactions

in-progress: partial posting, which should normally progress to another status like completed, amended or stopped.

amended: rarely used for bots.

stopped: when the user timeouts (more than X minutes) - is this feasible?

entered-in-error: for those ‘events' that need to be marked as deleted.

completed: ideal status for most entries. For Bots it means that the end of the branch was reached

subject

[added Mar 10/2023]

Refers to the patient or practitioner (client) resource id that the voucher was assigned to.

"subject": {
    "reference": "fhir/Patient/446",
    "type": "Patient"
},

authored

timestamp for the conversation (sTART OR finished time)

author

The individual or device that received and recorded the answers

WFA: Practitioner ID

BOTS/Web: Does each bot / web site is represented by a practioner

Reference(Device | Practitioner | PractitionerRole | Patient | RelatedPerson | Organization)

source

The individual or device that answered the questions

Reference(Device | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson)

item

Group of questions and answers -

• For Bot - the conversation branch

• For web app; a form