The following section provides detailed instructions and descriptions for the inclusion of the Rapid Diagnostic Toolkit application into the user workflow of a CommCare based application. For users wishing to include the Rapid Diagnostic Toolkit into an application built in an alternate digital health platform please see the Digital Health Software Toolkit callout configuration section below.
Table of Contents
...
To link from your Commcare application to the Rapid Diagnostics Toolkit, you need to have access to the advanced feature, Android App Callout. This feature is available to all CommCare app builders with an Advanced or higher plan or with a self-hosted instance. For those users, the Rapid Diagnostics Toolkit is free to use through an open source software license.
...
rdt_session_id = hidden value session_id
rdt_config_provision_mode =
'CRITERIA_SET_AND' If, for example, users should be allowed to pick any test which supports a Malaria Diagnosis, they can request the following, which will filter for all available criteria.
‘CRITERIA_SET_OR’ if Alternatively, a session can be requisitioned to choose any test which meets one of the provided options
rdt_config_flavor_one = hidden value flavor_one
rdt_config_flavor_two = hidden value flavor_two
rdt_config_translator_session = 'xform_response'
rdt_config_translator_result = 'xform_response'
rdt_config_classifier_mode =
'PRE_POPULATE' - This setting will pre populate the select list to the user with the scanner interpreted result from the RDT image. The user can then confirm the results or update it what they determine the result to be
‘BLIND’ - This setting will save the the scanner interpreted result but hide them from the user when they capture the user interpreted result
FLAG_ANDROID_CALLING_PACKAGE = 'org.commcare.dalvik'
rdt_config_provision_mode_data =
Space separated list of test IDs used by the organization. Currently supported RDT IDs and information below:
‘sd_bioline_mal_pf_pv’ - SD Bioline Malaria Ag Pf/Pv
‘sd_standard_q_mal_pf_ag’ - SD Standard™ Q Malaria P.f Ag
‘sd_bioline_mal_pf’ - SD Bioline Malaria Ag Pf
‘carestart_mal_pf_pv’ - CareStart™ Malaria Pf/Pv (HRP2/pLDH) Ag Combo RDT
‘firstresponse_mal_pf_pv’ - First Response® Malaria Ag P.f./P.v. (HRP2/pLDH) Card Test
'firstresponse_mal_pf' - First Response® Malaria Ag P.f (HRP2) Card Test
rdt_input_translate = 'provision_flat'
...
If a Cloudworks backend is to be used, the following two addition configuration variables variable will need to be configured as Extra values during the Provisioning step.
rdt_config_cloudworks_dns- The DSN URL of the Cloudworks server
The In additional the following values are optional to provide but will change the behavior of cloudworks.
rdt_config_cloudworks_context - A unique identifier which can be used to connect test data to a specific session or individual in the future. Should be a non-identifiable field like a case id
...