FHIR Chat · instructions for rendering the responses by linkId

Stream: questionnaire

Topic: instructions for rendering the responses by linkId

Diane (Sep 23 2021 at 03:52):

Is there an extension to provide instructions about how to present the questionnaire responses to end users by individual linkId?

We want the presentation of the data to the end users to be standardized, so we were wondering if there is any way to annotate this in FHIR sdc?

Right now, I have an arrayish structure in my software application that captures how each linkID of the FHIR questionnaire responses should be displayed to end users similar to this:

var renderingInst= [
               {'linkId':'1', 'desc':'Study Title', 'responseRenderType':'LabelWithData'},
               {'linkId':'2', 'desc':'Researcher', 'responseRenderType':'ShowHeader'},
               {'linkId':'2.1', 'desc':'Researcher Name', 'responseRenderType':'DataNoLabel'},
               {'linkId':'2.2', 'desc':'Researcher Hospital', 'responseRenderType':'DataNoLabel'},
               {'linkId':'2.3', 'desc':'Researcher eMail', 'responseRenderType':'DataNoLabel'},
               etc.
      ]

Then, the software application looks at renderingInst by linkID for rendering instructions to get something like:

Study Title: This is a study about COVID19 symptoms by variant

Researcher
Dr. Juan Doe
West Valley University Hospital
juan.doe.md@wvuhospital.org

We would like our questionnaire response rendering instructions so be stored in the questionnaire items and carry over to the questionnaire response so that we could move toward standardization of how the questionnaire responses are rendered, even if someone doesn't use my software application.

I looked at https://www.hl7.org/fhir/extension-designnote.html but it looks like the contents of the extension do not carry over to the questionnaire response, otherwise this would ideal.

Has anyone ever tried to annotate how the questionnaire response data itself should be rendered on an item by item basis?

Brian Postlethwaite (Sep 23 2021 at 16:44):

Is this a request for "styling" some form of printed or otherwise output for the entered content?
e.g. as a PDF or generic HTML layout?
Such as what I've got showing up here for this narrative?
https://sqlonfhir-r4.azurewebsites.net/fhir/QuestionnaireResponse/boe-test
(I was planning on just implementing a loose interpretation on the input format, i.e. tables/grids etc as defined, not some specific layout totally different to the entry format)
or this one
https://sqlonfhir-r4.azurewebsites.net/fhir/QuestionnaireResponse/78f0109c2f6e44fc811b262f481c883f

Lloyd McKenzie (Sep 23 2021 at 17:24):

The gist of this seems to be "should the item.text be displayed when rendering a completed form". We have the ability to control whether an item as a whole should be rendered (so you can suppress certain instructions to the user, or only show calculated scores once editing is finished). But no one's ever asked to have the item.text suppressed in a rendered form. Do you have any other instructions beyond the 3 values in your example (LabelWithData, ShowHeader, DataNoLabel)?

Diane (Sep 23 2021 at 20:32):

@Brian Postlethwaite I like what you are doing for the layouts. Looks really nice. But, I was heading in the direction that Lloyd was mentioning. @Lloyd McKenzie Right now, we have: show LabelWithData (this is the default), showDataNoLabel, showHeader (default which renders the group header) and suppressHeader. We have also implemented whether to suppress or enable the group header from repeating on repeating groups of questions.

Lloyd McKenzie (Sep 23 2021 at 23:33):

Ok, so essentially 3 values per item - "display always, display on first repetition, or don't display" for the item text. (Whether the middle one is relevant depends somewhat on what the control mechanism is - if you're doing a grid view or something, the label would only be displayed once regardless. That's something we could add as a new extension. Care to submit a change request?