July 17 UI/UX Design Call about a generalized result viewer

I would like to propose that at this Thursday’s design call we discuss a proposal from @mksrom to create something like a generalized Results Table component.

It would be a configurable table that would show, for whatever concepts are configured, the obs across encounters. It’s kind of like the obs across encounters widget, but where the concepts are the rows and the dates are the columns, like the test results viewer.

If you are a BA, product manager, UX person, etc., and you think something like this could be useful to your users, please come to the call and tell us about it.

@grace @slubwama @fanderson @ddesimone @kmuiruri @michaelbontyes

6 Likes

Hi @bistenes so the proposal is to move from

If that is so, how are we planning to show a panel of test results like those of Full Haemogram or Thyroid function tests, Microbiology results?

@bistenes so we’ve discussed this in the design call. As much as possible, we would like to have this component to be made reusable across the patient chart. People present in the call were agreeing that this is necessary component, that will directly benefit existing implementations (for Prenatal views for instance).

This should be:

  • one column per encounter (from a configurable list of encounter types)
  • configurable to specify a list of concepts for which the associated obs will be displayed.
  • able to render at least Numeric, Coded and Text data types.
  • support all O3 supported screen types and sizes.
  • configurable to specify a max number of encounter to display.
  • optional: able to show data from encounters attached to only a current (enrolled) program or if none, from the most recent program.

Q: What if multiple obs of a given concept are available recorded in the encounter? (maybe concatenate the answers?)

Q: What if a text obs is too long? (maybe hoover to see full text?)

Q: Should this table be only one column (full chart width) or should it support 2 columns view in the patient chart?

Q: How to handle horizontal scrolling if any?

(cc @ibacher )

1 Like

Hi @bistenes, thank you so much for this post! @mksrom brought this up on last week’s design call, and myself, @veronica, @fanderson and Dr Ray Simkus were in attendance and had thoughts. All agreed this is a solid idea for a new reusable component. Basically - I’m thinking, it would be awesome for this to be effectively another re-useable widget just like this guy: openmrs-esm-patient-chart/packages/esm-generic-patient-widgets-app at main · openmrs/openmrs-esm-patient-chart · GitHub

Re. Real-world use cases:

PIH ANC: Fiona immediately brought up this similar real-world example: PIH has a similar form for ANC visits:

Clinical Views: What came to mind for me and Vero was the Clinical Views summary cards - not just the ones shown in this screen (which have way too much white space in our opinion - we’d/I’d strongly like to see more information density in the app, especially in specialty-specific views), but also in other possible applications of the table component you’re proposing.

Checklists/Workflows/Careplans: Another item that came to mind was the clinical concept (not the FHIR one) of careplans, or care checklists. E.g. if a patient is in an artificial limb program, there’s quite a complicated set of checklist items that need to be done over the course of several visits. This component could really help track such checklists over time.

Answering Some Questions

Re. @mherman22 's question above - this also came up on the call. No, please don’t re-use or re-place or closely emulate the Test Results app. The reason I feel this way is because the Test Results viewer is so specialized, and also still quite imperfect so subject to many changes in the near future, and I think you want to keep all of that nuance separated from this re-useable table component.

Re. @mksrom 's Q’s above:

Q: What if multiple obs of a given concept are available recorded in the encounter? (maybe concatenate the answers?)

  • Yes, concatenate sounds good; so long as you use some kind of obvious separator. I’d recommend not only using commas, because we are now properly using commas for French numeric values with decimals, so a lab test with a result of e.g. 4.3 in French is 4,3.

Q: What if a text obs is too long? (maybe hoover to see full text?)

  • With the exception of help-text, I’m generally suspicious of hovering, because (a) most clinicians in our contexts are too busy to hover or think of doing so, and (b) it’s not great on tablet (and as I’ve said before it’s reasonable to assume a third of our clinical users are using tablets). We’d have to see the examples

Q: Should this table be only one column (full chart width) or should it support 2 columns view in the patient chart?

  • Yes, it should ideally support the 2 columns view, for smaller sets. Though I’d say this is a nice-to-have, not an immediate must. Here’s why: (1) opportunity to increase information density (though at the cost of likely fewer encounters over the horizontal time axis), and (2) an example I’m thinking of: We know that NCD clinics are rapidly on the rise. In an NCD clinic’s Clinical View page, for example, you may want multiple tables: One showing diabetes/blood-glucose-related issues and lab tests; and a separate one for Cardiac measures/items. Would be nice to be able to see those both side by side. But I’m just inventing things here, so 1 column is very okay to start.

Q: How to handle horizontal scrolling if any?

  • This is a great question. My main ask is: please no disappearing horizontal scroll bar. If the table needs to horizontally scroll, then the scroll bar should always be there. The reason: The vast, vast, vast majority of our clinical users have never used a device like a newer Mac that has the disappearing/intuitive trackpad feel. Therefore they’re highly likely to never notice that there is a tiny grey horizontal scroll bar upon hovering. The laptops in use are unlikely to have good horizontal scrolling trackpad experience built into the trackpad hardware other than the usual click-drag. (Brought up the same issue just recently with the new Immunization History View.)

Hope this helps, super super interested to see this progress and as always very happy to discuss further. Thank you very much @bistenes and @mksrom for pushing this forward!

3 Likes

I’m so sorry I missed this last week! My bad. I forgot to mark it in my calendar and was traveling. Thank you so much @mksrom for filling in impromptu, and everyone else for the useful feedback.

100% agreed that this should stay totally separate from the lab results viewer. I think we’re on the same page about everything. Looking forward to implementing this.

1 Like

Came across one more example today that perfectly reflects what I was imagining when I said “Checklists/Workflows/Careplans” - here’s a screenshot of a similar idea for detailed program checklists in Bahmni, called the “Patient Monitoring Scheduling Tool”. Looks like this example is for a TB Drug study. Research protocol is a good application for this idea.

Hi @bistenes ! I heard this is built now - sorry I probably have missed some demos. Can you share a screenshot or link to PRs with the screen recordings, so people following this can see where this got to? Excited to see! :smiley:

I also hear it’s read-only, but that there’s demand for editability and direct data entry in the cells. Interesting!

Yes! Sorry I didn’t provide an update here. Here is the PR, which includes an example config snippet, as well as a video.

Here’s a link directly to the video, for convenience.

Yes, regarding data entry, I think there is some design conversation that should happen. My feeling is that it is worth discussing whether we want to break the paradigm of “all data entry happens in the workspace” with this widget. I have no strong feeling either way, but would just like us to be cognizant that that is what “direct data entry in the cells” entails. Anyway it seems like there is some demand for that feature.

If we do so, then we should provide clear affordances indicating to the user that, unlike everything else in the chart review zone, these cells are directly editable. I would like for a designer to be consulted about what that should look like, if possible.

CC @michaelbontyes @mksrom

2 Likes