BCG reminder popup update

[rowo]

PATH team has proposed to change the BCG scar reminder into a yes/no question on whether BCG scar is present. If present, reminder doesn’t appear again. If not present, keep reminding until BCG 2 dose is recorded BCG 2 dose should become due.

Further notes/questions:

• Add a dismiss option to cover if child is not present which keeps reminder going next time
• If no, BCG2 needs to be given - do we want to show the reminder in the vaccine card for BCG 2? CG: Yes, that is how I envisioned it.
• If yes, they don’t have to do anything else, but question is whether we need to show their answer, i.e. scar is present, so no BCG2 dose needed? CG: Yes, if possible to show their response, it can be a simple BCG scar present with tick mark.

Popup update

• Guidelines are specifically against three option dialogs (yes/no/dismiss), so I figured a choice then OK would work. If Yes/No aren't selected, the OK option is inactive. Once Yes or No is selected, the OK becomes active.

Popup if answer Yes

• We can also make this dialog dismissed by tapping/swiping outside the window with or without the OK button.

Popup if answer No

• @paulnindi @cagulas what would this box say? What would the timeline be on BCG 2? I think a service reminder on the card is ideal.

[cafootitt]

@rowo Thanks for this. I made some comments in the issue above. For the wording on BCG 2, I think that's fine for now. I think having the service reminder appear in the vaccine card next would make sense (BCG 2). The expiration on this would be 1 year, and I assume making it overdue after 10 days would also be ok.

One suggestion is that we might not be able to allow edits, so a "back" button on the confirmation window or something that takes them back to the first question might be a good idea.

[rowo]

Here are two approaches to incorporate a back or undo:

1. Snackbar

Seems like this is the more traditional way of providing an undo option on an Android device.

2. Notification

Following material guidelines, I had to change the wording a bit when adding the "go back" option.

[cafootitt]

I think I prefer the 2nd option, because for this we can require the user to make a selection (by making the outside area untappable), which might prevent accidental data entry. We discussed previously that BCG 2 happens at 12 weeks, so instead of creating a new 12-weeks grouping on the vaccine card, we would put BCG 2 reminder next to BCG in the birth grouping.

@paulnindi What is your feedback?

[cafootitt]

@hallix Assigning you for now, as this is a new feature issue that we think would be great for you to work on. Roger will post final mockups when they're done.

[paulnindi]

@cagulas I side with you. Second option looks more appealing and its a good idea to have the reminder appearing on the birth grouping

[paulnindi]

oh sorry mistakenly closed.. :)

[rowo]

@paulnindi :D

@cagulas So final mockups just means the BCG reminder in the birth group? Did you discuss any other changes on the call or with Paul?

[cafootitt]

Correct, no other changes were discussed.

[rowo]

Final propose updates to BCG screens:

Change the current BCG dialog:

To a larger dialog that is in a question format:

• Dismiss option = child is not present, which keeps reminder going next time

If answer is no:

• This dialog box confirms the answer with a followup action: a BCG 2 dose is required so a reminder will be created.
• "Go back" will undo the last "No" answer on the first dialog

If previous step verified and BCG 2 reminder is created:

• BCG 2 button is created in birth button group. Expiration = 1 year, due immediately and overdue after 10 days. @cagulas please confirm and edit if needed
• Update label to BCG 1 dose = "BCG: no scar" @cagulas this sound ok? Can also just leave it as is.

If answer is "yes" there is a scar from first dialog:

• Dialog confirms that no further reminders are necessary for BCG

If BCG reminders are turned off, the BCG button gets an update:

• BCG: scar [date scar recorded]

[cafootitt]

We will not allow the user to tap outside the 2nd dialog (Turn off BCG reminder and Create BCG reminder) to close it. User can tap outside the 1st dialog, which is the same as hitting dismiss.

Let's make the reminder say "Turn off check BCG scar reminder" instead.

[cafootitt]

OpenMRS concept to use:

ID: 160265 Label: BCG scar present on examination Datatype: Coded Answer choices: Yes, No, Unknown

[cafootitt]

After discussing with @rowo, let's create a new box for the BCG scar with date that scar was confirmed, e.g. "BCG scar 21/2/2018".

So in summary, every child would eventually have 3 boxes in the birth group, OPV 0, BCG, and either BCG scar or BCG 2.

This issue should be ready to implement now. Let me or Roger know if there are any questions.

[faith-mutua]

The birth group isn't updated with the third box - BCG scar, if I confirm that the child has a scar.

[cafootitt]

Results from 13 April release QA:

• [x] Let's make the reminder say "Turn off check BCG scar reminder" instead. This was missed in the 9th Feb comment.
• [x] Please add a full stop (period) to the end of the two sentences: "BCG scar is present so no BCG 2 is necessary." and "Child does not have a BCG scar so BCG 2 is necessary."
• [x] Comment from 21 Feb was also missed. For children who have a scar, a new box gets created instead of the BCG 1 box getting updated.

Still need to test the syncing to OpenMRS and the scheduling of this service.

[cafootitt]

Lgtm

The parent vaccine concept for BCG 2 is not appearing in OMRS though.