[Feature] Add ability to open web links/URLs in the default Android browser from a FHIR Questionnaire

[AnnieMungai]

Background
In Indonesia Kaders (CHWs), when conducting home visits, will navigate from the OpenSRP2 Job Aids app to URLs in the Android default browser from links in Questionnaires. This will allow the Kader to view additional information on the web.

User story
I am Kader conducting a home visit. While I am conducting a via the Job Aids app, I want to get more information to help me provide additional counseling to the client. This information is on a video on a platform such as YouTube. I want to be able to navigate to YouTube videos from a URL on the app, that I can watch with the client, access the information, and get back to the Job Aids app and continue with the other segments of the home visit.

Required

• Embed links in the app's questionnaires that will allow the Kader to access videos with more information on a different web app such as YouTube.

Acceptance Criteria

• At the tap of a link within the form, Kader can navigate to a URL in the default Android browser.

Implementation Plan

• Extend the SDC to understand external URL links and open them in the default device browser

[pld]

@f-odhiambo I've assigned this to you to add details on the implementation plan. Let us know if anything about the scope is not clear

[FikriMilano]

@f-odhiambo @pld here's a quick implementation that I did, kindly review google/android-fhir#2732

web.link.sdk.2.mp4

[FikriMilano]

Here's what we need todo to the questionnaire item:

    {
      "linkId": "1",
      "text": "Normal text <a href=\"https://www.youtube.com/watch?v=sCnDfa-0FAg&t=1818s\">link text</a>",
      "type": "display"
    }

[f-odhiambo]

@pld I think this is done based on the above work by @FikriMilano low effort however we will need some clarity on whether the link is static or dynamic to complete the request for this ticket
CC @AnnieMungai

[AnnieMungai]

@f-odhiambo - these will be static links.

@FikriMilano for the shared solution - if someone wants to get back to the app, what happens?

[FikriMilano]

@AnnieMungai tap the bottom-right button, as usual in Android

[joyce-x-chen]

Update: UNICEF had mentioned a web app on the last call, but upon further discussion (great job probing further @AnnieMungai), they clarified that there are 2 apps in use.

• ASIK - available on Android and iOS
• another web-based application

The checklist they wanted us to link to is ASIK, so we agreed that we will NOT integrate with ASIK and the job aids app will only prompt the kader to complete the checklist. No linking or integration required.

[AnnieMungai]

@update - I have amended the original ticket to remain within scope and meet client requirements after discussions on 22nd Nov.
We are only required to have links on questionnaires that open web apps like Youtube.

[FikriMilano]

Wow, good job in preventing that from spiraling out of scope :D
@joyce-x-chen @AnnieMungai

[FikriMilano]

The linking feature has been merged in SDK google/android-fhir#2732

[pld]

great! can we upgrade the release to use a version of the SDK with this included?

[FikriMilano]

Yep, I'll reach out to @ndegwamartin