FHIR resource link

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

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

FHIR definition

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

REQUIRED [psi]

countryISO & projectID

questionnaire

REQUIRED [psi]

Questionnaire resource ID [LINK]

status

REQUIRED [fhir]

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

authored

REQUIRED [psi]

timestamp for the conversation (sTART OR finished time)

author

REQUIRED [psi]

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

REQUIRED [psi]

The individual or device that answered the questions

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

item

REQUIRED [fhir]

Group of questions and answers -

• For Bot - the conversation branch

• For web app; a form