Adding a New Tracker Program

Table of contents:

Add a new program

To add a new program, click the ADD PROGRAM (1) button as shown below.

From the popup window (Create New Program), set the Program Type(*), to Tracker Program (2) from the dropdown list.

Once Tracker Program has been selected, you will be presented with the following fields to populate;

Please note, all fields marked with an asterisk (*) are mandatory.

Basic settings

Program Type*: Tracker Programs or HNQIS 2.0 Programs.
Program Data Element Prefix*: This is required to avoid conflicts with the metadata generated that is automatically generated by the PCA. Please note the text entered must be unique in the DHIS2 server. The name you choose should be self-explanatory and related to the program.
Program Name*: Name assigned to the Program.
Program Short Name*: Short version of the Program Name, sometimes created by replacing words with acronyms.
Tracked Entity Type*: Once have you selected a Tracked Entity Type, the program Tracked Entity Attributes are automatically selected.

Please note that this field is disabled when creating HNQIS Programs and is not required despite the presence of the mandatory(*).The Tracked Entity Type that will be assigned to the Program.

Icons:

We recommend you add a suitable Icon to the new Program, there is a wide range of icons to choose from, pick the most relevant one and click SELECT ICON to insert it.

You can change the colour of the Icon from the pop-up window, as you select a colour you will see a live preview of how it looks, click off the colour palette to apply the selected colour.

Please note if you do not set an Icon, PCA will display the default DHIS2 icon.

In Example 2 (Adding an Icon to a new Program) you can see the Mosquito Icon has been styled with a yellow background, if you need to remove either the icon or styling, simply click the red icon adjacent to the relevant buttons.

Please note, Icon settings are the same for both Tracker and HNQIS 2.0 programs.

Please note that this field is disabled when creating HNQIS Programs and is not required despite the presence of the mandatory(*).The Tracked Entity Type that will be assigned to the Program.

ICON - See below for full details

ADD ICON (Button): Use to add an Icon that will appear on the home screen List of programs.
SELECT COLOR (Button): Use to style the Icon with a colour.
CLOSE (Button): To exit without saving changes or creating a new Program.
SUBMIT (Button): To save changes and create a new Program click SUBMIT.

Tracker Program Settings

Category combination: You can select an option from the dropdown.
Tracked Entity Attributes: The attributes will be automatically selected based on the chosen Tracked Entity Type. Additionally, you have the flexibility to include additional Tracked Entity Attributes (TEAs)

Tracked Entity Attributes Form

The previously Tracked Entity Attributes must be displayed in this section.

It must be four columns for each TEA:

Display in list: The value of the selected TEA will be displayed in the Tracked Entity Instances list.
Mandatory: The TEA must be filled to complete event.
Date in future: The TEA will allow selecting a future date
Searchable: The TEA allows to be used as a search filter in the Tracked Entity Instances list.

Use Form Sections

Toggle the "Use forms section" switch

Adding a new section

To add a new section, click on the “ADD NEW SECTION”.

Enter a Form Section Name.
Click on the “Save” button.

Editing a section

To edit a section name, click on the “Pencil” icon.

Change the name section.
Click on the “Save” button

Removing a section

To delete a section, just click on the "Trash" icon.

Changing the order sections

To rearrange the order of the sections, click on the dots to the left of the section and drag the section to the desired position.

Assigning a TEA to a Section

To include a Tracked Entity Attribute (TEA) within a Section, simply click the downward arrow icon and then drag the desired TEA into the selected section.

Removing a TEA from a Section

To remove a Tea from a section, click on the “X” icon.

The TEA should be displayed in the available attributes section.

Saving a New Program

To save all changes click the SUBMIT button, you will see a green confirmation notification to confirm the new Program has been created successfully and returned to the PCA Home screen.

Your new Program will appear at the top of the List of programs on the Home screen, please check that the icon and name of the Program are correct, if not you can edit them, click here for full details of how to edit Programs.