Recent HIV infection tests can provide real-time data about recent infections to identify
hot spots of current HIV transmission.
In Uganda, this program is being rolled out with an initial 6 month pilot of 80 facilities from October 2019
HTS records are sent by UgandaEMR to a secure server currently hosted in the CPHL data center. Authentication details have to be created within the MIRTH server for each site that is configured to send data as per the steps below.
- Download and install the Mirth Connect Administrator Launcher tool.
- Using the MIRTH admin tool, connect to https://ughim.cphluganda.org/recency!(/assets/Screenshot 2019-10-14 at 11.11.38.png)
Under channels menu (from left side of the admin panel), right click and select Edit Channel named http-listener-file-writer. You will be given the edit windows shown below. Select the Source tab and click the New button under HTTP Authentication. Provide the DHIS2 UUID as the username and a password. We recommend six character password that is alphanumeric.
To save the credentials added, you will have to attempt to navigate away from the edit window. The interface will request to save changes. Click Yes.
Go back to the channels, right click on the http-listener-file-writer and select Deploy Channel.
The recency program only requires an upgrade to UgandaEMR 3.0.0 which is available from the EMR portal at
Once UgandaEMR has been upgraded, follow the steps below to complete the configuration changes.
- Login as a user with administrator privileges
- Click legacy administration link as circled in the image below
- In the Maintenance section click Settings
- Click Ugandaemr and enter the DHIS2 uuid for the facility. This will be used as the username when submitting data to the central server
- Click Ugandaemr sync to configure the settings for the recency server as below which are provided for your facility
- Recency Server URL - https://ughim.cphluganda.org/recency/uploads/
- Recency Server Password
- Hts Recency - set to true to enable the entry of Recency specific data on the HTS client card
- Restart UgandaEMR instance to enable the system to register the newly added variable in (4) and (5) above.
HIV Recency Testing is an extension of the national HIV Testing Algorithm, and is done for patients above 15 years whose HIV results are positive.
The clients are requested to give consent for Recency testing and/or storage of their blood samples for future research.
This data is entered following the steps in HIV Testing Services Client Card which also includes the Recency Addendum
The reporting tools include the national HMIS tools are:
- HMIS ACP 019 HIV Testing Services Register
- HMIS 105 Health Unit Outpatient Monthly Report - Section 4
- MER Indicators - HTS_RECENT, HCT_TST_Facility
HTS Client Card Export - CSV file containing all the fields entered on the HTS Card
- Recency Data Export - CSV file with recency data fields
This is an automated process that occurs every hour until a successful submission is done in a day. Due to the small numbers involved, all the HTS records are sent each time, a process which will be improved as the program proceeds
- Restart the UgandaEMR instance at the facility. This is key after
- Observe the UgandaEMR alerts. Check if there are errors related to the following.
- The UgandaEMR instance at the facility needs to have an internet connection for at least one hour within a day.
- 401 authentication error: This implies that either the recency server URL, username and or password are incorrect. Double check these values and also verify the credentials in Mirth.
- Reduce the scheduled sync frequency to 10 minutes, restart UgandaEMR and observe the behaviour.