DATIM

3.1 > Guide to Indicator Mapping

Chris Nemarich -

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.

Login using your Username and Password.

mceclip0.png  

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

mceclip1.png

In-App Navigation

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

mceclip2.png

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.

mceclip4.png

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.

mceclip3.png

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

Select Period

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

mceclip5.png

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.

mceclip7.png

In 2020, 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

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.

mceclip10.png

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.


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

 

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

 

Age (<15, 15+, Unknown)

Sex (Female, Male, Unknown)

ART Start (Newly Enrolled, Previously Enrolled, Unknown)     

TX_CURR

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)

 

Note the follow changes to disaggregations in 2020:

HTS_TST

  • We are no longer collecting a separate Total disaggregation for this indicator.

PMTCT_STAT / Coarse and Fine Disaggregations

  • We are now collecting information for a new test status: Recent Negative

TB_PREV / Coarse Disaggregations

  • Disaggregations are no longer separated between Age/Sex and ART Start. For example in 2019, we had separate disaggregations for '<15 | Female' and 'Previously Enrolled on ART | IPT'. In 2020, we have, for example, 'Previously Enrolled | <15 | Female' combined into one disaggregation.

If you had relevant mappings for the disaggregations that were updated in 2020, you will need to remap these.

If you cannot provide the additional detail required in the 2020 Fine Disaggregations, you will need to remap using Coarse Disaggregations. 

 

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.

mceclip3.png

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

mceclip9.png

  • 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:

mceclip12.png

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

mceclip11.png

  • 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)

mceclip13.png

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.

mceclip14.png

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

mceclip15.png

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.

mceclip17.png

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.

mceclip16.png

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:

mceclip18.png

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):

mceclip19.png

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.

mceclip21.png

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.

 mceclip20.png

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.

mceclip22.png

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 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.

mceclip23.png

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:

mceclip0.png

ID:

mceclip1.png

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 (-)

 mceclip2.png

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.

mceclip3.png

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'. 

mceclip1.png

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:

mceclip4.png

MoH Disaggregation ID:

mceclip5.png

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.

mceclip6.png

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.

 mceclip7.png

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.

mceclip8.png

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

mceclip9.png

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.

mceclip11.png

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.

mceclip12.png

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.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

Powered by Zendesk