Step by Step Guide to Indicator Mapping

Accessing the App

To access the Indicator Mapping App, you will need to have access to GeoAlign (https://geoalign.datim.org/). If you do not have to GeoAlign, please open a ticket with DATIM Support.

Once logged in, start typing "Indicator Mapping" in the “Search apps” field or by clicking on the App menu and Navigating.

In-App Navigation

When using the app, you will see icons and summary information below the DHIS2 header.

In the top left, you will see your country name and the period you have selected.

Clicking on the Map or Home icon will bring you back to the Summary Page where you can see an overview of your mappings.

Clicking the Question icon will bring up a link to this Guide to Indicator Mapping.

Summary Page

When you log into the Indicator Mapping App, you will see a summary page which provides an overview of the status of your mappings for each indicator.

Note: when you first log on, the app will initiate a check between the mappings you have submitted and the mappings that are currently saved within the app. During this time, the app will display a loading bar. You can use the app and edit mappings while this check is processing.

From the summary page, you can perform the following actions:

Select Period

By default, the app will load your current mappings. If you wish to view or edit your prior period mappings, you can select them with the period drop down.

See Indicators

In the leftmost column, you can see the indicators that are included in the selected period. Hovering over the indicator code will display a description of each indicator.

In 2021-2022, Data will be collected on the following indicators.

HTS_TST: Number of individuals who received HIV Testing Services (HTS) and received their test results
PMTCT_ART: Number of HIV-positive pregnant women who received Antiretroviral Therapy (ART) to reduce the risk of mother-to-child- transmission during pregnancy
PMTCT_STAT: Number of pregnant women with known HIV status at antenatal care
TB_PREV: Proportion of ART patients who completed a standard course of TB preventive therapy within the reporting period
TX_CURR: Number of adults and children currently receiving ART
TX_NEW: Number of adults and children newly enrolled on ART
TX_PVLS (Numerator): Number of adults and pediatric ART patients with suppressed viral load results documented in the medical or laboratory records/LIS within the past 12 months
TX_PVLS (Denominator): Number of adults and pediatric ART patients with a viral load result documented in the medical or laboratory records/LIS within the past 12 months

Select Disaggregation Type

We have “Fine” and “Coarse” disaggregation options.

You will submit EITHER “Fine” OR “Coarse” disaggregations. On the summary page in the second column, you can select the disaggregation type that you will provide.

Changing the disaggregation type will change the mappings you are submitting but will not cause you to lose mappings you have entered within the Indicator Mapping App. For example, if you enter mappings for 'HTS_TST' with disaggregation type 'Fine', but later decide to use the 'Coarse' disaggregation type, any mappings you have entered for 'Fine' will remain saved in the app, but only mappings for the disaggregation type that you have selected ('Coarse') will be submitted. You can change between disaggregation types whenever is appropriate but be aware that you will submit the disaggregation type selected.

Countries are requested to provide “Fine” disaggregations where possible. If it is not possible to submit “Fine” disaggregations, reach out to your PPM.

PEPFAR/MoH Data Alignment Activity currently includes the following eight MER indicators as provided below:

Short Name	Fine Disaggregations	Coarse Disaggregations
HTS_TST	Age (<1,1-9,10-14,15-19,20-24,25-29,30-34,35-39,40-44, 45-49,50+,Unknown) Sex (Female, Male) Test Status (Positive, Negative)	Age (<15, 15+, Unknown) Sex (Female, Male, Unknown) Test Status (Positive, Negative)
PMTCT_ART	Age (<10,10-14,15-19,20-24,25-29,30-34,35-39,40-44, 45-49,50+, Unknown) New/Already on ART (New, Already Enrolled)	Total
PMTCT_STAT	Age (<10,10-14,15-19,20-24,25-29,30-34,35-39,40-44, 45-49,50+, Unknown) Test Status (Known Positive, Newly Tested Positive, New Negative, Recent Negative)	Test Status (Known Positive, Newly Tested Positive, New Negative, Recent Negative)
TB_PREV	N/A	Age (<15, 15+, Unknown) Sex (Female, Male, Unknown) ART Start (Newly Enrolled, Previously Enrolled, Unknown)
TX_CURR	65+ Age (<1,1-9,10-14,15-19,20-24,25-29,30-34,35-39,40-44, 45-49,50-54, 55-59,60-64,65+, Unknown) Sex (Female, Male) -------------------------------------------------------------- 50+ Age (<1,1-9,10-14,15-19,20-24,25-29,30-34,35-39,40-44, 45-49,50+, Unknown) Sex (Female, Male)	Age (<15, 15+, Unknown) Sex (Female, Male, Unknown)
TX_NEW	Age (<1,1-9,10-14,15-19,20-24,25-29,30-34,35-39,40-44, 45-49,50+, Unknown) Sex (Female, Male)	Age (<15, 15+, Unknown) Sex (Female, Male, Unknown)
TX_PVLS (Num.)	Age (<1,1-9,10-14,15-19,20-24,25-29,30-34,35-39,40-44, 45-49,50+, Unknown) Sex (Female, Male)	Age (<15, 15+, Unknown) Sex (Female, Male, Unknown)
TX_PVLS (Den.)	Age (<1,1-9,10-14,15-19,20-24,25-29,30-34,35-39,40-44, 45-49,50+, Unknown) Sex (Female, Male)	Age (<15, 15+, Unknown) Sex (Female, Male, Unknown)

Please refer to the PEPFAR DATIM Support site for a more detailed list of indicators and disaggregations, We request that they provide mappings to the Fine disaggregations if possible.

View Mapping Status

The Mapping Status column summarizes whether your mappings have been submitted. When you first log on, when you select a new period, the app will initiate a check between the mappings you have submitted and the mappings that are currently saved within the app. During this time, the status will display as a loading bar. Similarly, a loading bar will be display after you hit Submit and your submission is processing. You can use the app and edit mappings while this process in ongoing.

When the check of the mapping status is complete, you will see the following statuses:

Submitted: these mappings have been successfully submitted, and they will be available in the Data Submission App.
In progress: these mappings have not been submitted or have had changes since the last submission. In order to make them available within the Data Submission App, you will need to submit.
Errors: these mappings have problems that will prevent submission. Examples of errors could be missing information (for example a missing name) or invalid characters (for example accented characters in an id field)
Empty: there are no mappings for this given indicator saved in the Indicator Mapping App.

In some cases, your mapping statuses may not be available. This could occur, for instance, due to a server error. In this case, you will see an warning message:

If mapping statuses are not available, you will see the following statuses:

Unavailable: mappings exist in the Indicator Mapping App, but the status is not currently available.
Empty: there are no mappings for this given indicator saved in the Indicator Mapping App.

You can log onto the Indicator Mapping App later, and try to see your mapping statuses if needed. If you consistently have problems retrieving your mapping statuses, please reach out to DATIM Support.

Navigate to Edit Page for Indicator

In order to view, enter, or edit your mappings for a given indicator, you can click on the 'View/Edit' button next to the relevant indicator. If you have Read Only access to the app, this button will be called 'View'. This will take you to Edit Page (see Edit Page section for more details on how to edit your mappings).

Download Mappings in CSV Format

Click the 'Download' button as shown below. You will be able to find the downloaded csv file in your downloads folder.

Downloaded csv will have the following format with the data you entered:

Note that downloaded mappings will only include mappings for the disaggregation types that you have selected. For instance, if you have selected 'Coarse' for 'HTS_TST' indicator, the downloaded mappings will only display mappings for the 'Coarse' disaggregation type.

Submit Mappings

When you are finished entering your mappings, you can submit them. Submitting means that you consider your work final. Submitted changes can be used to process your Results File in the Data Import App. You can only submit changes for ALL indicators at once.

When you are ready to submit, click the 'Submit' button.

You will be asked to confirm that you wish to submit. As explained in the dialog message, submitting can take a few minutes to process, so it is recommended that you complete all your changes within the Indicator Mapping App before hitting Submit.

Please note that the 'Submit' button will be disabled and you will not be able to submit if any of the following are true:

all of your mappings are already submitted or empty (there is no need to submit again)
any of your mappings have errors (errors need to be fixed before submitting)
you have Read Only access to the Indicator Mapping App (only users with Write access to the app can submit. Please reach out to DATIM Support if you believe that you should have Write access but do not)

After submitting, the mapping statuses will update to loading bars, and you should receive an initial success message within 30 seconds:

The submission can take a few minutes to process. You do not need to keep the app open if you do not wish, but it may be successful to confirm that the submission is processed successfully, so you know that your mappings will be successful in the Data Import App. If the submission is successful, your mapping statues will update to Submitted (if they are not empty):

If the submission process is still processing after 5 minutes, you will get a warning message. This message does not mean something has gone wrong, but the submission is taking longer to process, so you should close the app and try accessing later to verify the mapping statuses.

If something goes wrong with the submission, you will receive an error message. It is suggested that you first check your Internet connection and try submitting again. If you continue to experience problems, there could be other issues, and we ask that you reach out to DATIM Support.

Edit Page

When you click on 'View/Edit' for a given indicator, you will be brought to the edit page for that indicator where you can enter your mappings.

Note that if you have Read Only access to the app, you will only be able to view the mappings and not edit them.

As long as you are connected to the Internet, your edits will save automatically every 30 seconds, or when you return to the Summary Page. (See Save and Return below for more details)

Find DATIM Indicator/Disaggregation and Begin Editing

Once you open up the Edit Page for a given indicator, you will need to find the disaggregations for which you intend to provide mappings. You can either scroll down the page to find a disaggregation, or you can click on any disaggregation and then select the one you want to navigate to, the page view will then scroll to the selected disaggregation.

Note: Not all disaggregations need to be filled out. For example, if your data is disaggregated by male and female, you do not need to fill out Unknown Sex.

Enter MoH Indicator Name / MoH Indicator ID

It is required to provide BOTH Name AND ID

Name: A real-language description that someone unfamiliar with the project can understand

Example: Women who received HIV Testing Services (HTS) and received their test results
Note: name should be a description, the “name” in your system may not be sufficient if it does not provide a clear description. For example, “W-HIVtest” would not provide enough information

ID: An ID to help identify an Indicator/Disaggregation

letters, numbers, periods, hyphens, and underscores are acceptable (no accents, no spaces, no non-Western alphabets)
Acceptable: abc12_34.A-B, element_1
Not Acceptable: élément_1, element 1

Please Note that:

If MoH is using DHIS2, the ID field should be the DHIS2 uid.
Data Submitted in results file will need to use the ID provided here on Indicator Mapping.

Name:

ID:

Note that for IDs, Invalid characters, accents, and space are not acceptable and will give an error message. Allowable characters are unaccented Latin alphabet letters (A-Z and a-z), periods (.), underscores (_) and hyphens (-)

Both Name and ID for indicator and disaggregation must be filled (or both should empty if there is no data to enter). Filling one field (either Name or ID) will require filling the other.

Note: if you do not use a consistent name for each ID, you will receive a warning message that reads "Inconsistent Name for ID".

For example, below the first row uses an ID of 'ID1' and the name is entered as 'Name 1'. The second row also has and ID of 'ID1', but the name is entered as 'Name One'.

The warning message alerts you that there is an inconsistency in the names used. In this example, you could change both names to 'Name 1' to make the warning message disappear. This warning message is to help you check your mappings. You will be allowed to submit your mappings even with inconsistent names, but it is recommended that you clean up the names. The inconsistency for the name does not have to be in the same disaggregation or even indicator.

Enter MoH Disaggregation Name / MoH Disaggregation ID (if relevant)

Fill in Disaggregation Name and ID as follows.

MoH Disaggregation Name:

MoH Disaggregation ID:

Note: Both MoH Disaggregation Name and MoH Disaggregation ID can be left blank if there is no information to provide.

MoH Disaggregation Name and MoH Disaggregation ID have the same restrictions on character types and requirements around completeness and consistency of information. You can therefore see the same errors and warnings as you see for MoH Indicator Name and MoH Indicator ID (see Enter MoH Indicator Name / MoH Indicator ID for more details)

Add/Remove Lines

Use the 'Add row' button to add a line for the disaggregation if your local systems have more than one Indicator or Disaggregation matching a DATIM Disaggregation.

For example, if you are working with Positive | <15 | Female disaggregation and your local system has

Positive | <10 | Female and
Positive | 11-14 | Female

Then you will need to add a line so that you can enter both disaggregations against the DATIM disaggregation Positive | <15 | Female

You can remove additional lines using the trash can button to the right of each row. If you do not have any mappings for a given disaggregation, you do not need to add an empty row. Empty rows will be removed when you navigate back to the Summary Page.

Select Calculation Type (Add or Subtract)

For an Indicator/Disaggregation, calculating values, for example by adding finer disaggregates, is acceptable.

e.g. [HTS_TST<15] = [Under 10]+[11 to 14]

You will find ‘ADD’ as the default option. You can always choose it on the drop down if saved otherwise.

Calculation by Subtraction is acceptable but It will be flagged for review with your SI advisor.

e.g. [HTS_TST NEG] = [TOT] – [POS]

Similarly, choose 'SUBTRACT' from the drop down

Any calculation of data using multiplication and division is not allowed by the app.

Save and Return

If you make edits, your work will automatically be saved every 30 seconds as long as you are connected to the Internet.

When you are finished making changes for a given indicator or wish to close the Indicator Mapping App, you should click on the 'Save and Return' button in the bottom right hand corner of the app. This will commit any final changes that you have made since the last time the app automatically saved.

Once you are back on the Summary Page, you can select a different indicator or close the app.

You can also click on the Home icon or the Mapping icon to save and return back to the Summary Page.

Note: Saving your work means that you are working on your submission, but these changes are not final and available within the Data Submission App, so you cannot use “saved” changes to process your results file. Changes must be submitted before they are final and can be used to process your results file in the Data Submission App (see Submit for more details)

Note that if you have Read Only access to the app, the button will say only 'Return' as you will not be able to make any changes that could be saved.

Please reach out to your DATIM Support / PPM if you face any problem or if you have questions.

3.1 > Guide to Indicator Mapping