hisptz / action-tracker-standalone

The action tracker is a management tool that helps improve effective coverage of priority interventions at district and community level, covering various interventions such as maternal, newborn, and child health (MNCH), HIV, and nutrition.

STAND-ALONE ACTION TRACKER

1. Introduction

2. Admin Guide

3. Developer Guide

   3.1. Installations

1. Introduction

The action tracker is a management tool that helps improve effective coverage of priority interventions at district and community level, covering various interventions such as maternal, newborn, and child health (MNCH), HIV, and nutrition. This process ensures appropriate equity analysis at the sub-national level with the aim of identifying underserved populations and the specific bottlenecks they face in accessing life-saving healthcare. Alongside Bottleneck analysis that analyses hindrances to achieving desired coverage, action tracking allows program implementers to register and track actions based on suggested solutions from root causes, or the ones which are not originating from Bottleneck analysis.

Stand-Alone Action tracker is an application developed to operate and installed in DHIS 2 action, and aimed to operate without the existence of set up Bottleneck Analysis. Stand Alone Action tracker must be installed in DHIS 2 system by user with administrative privilege and configure data entry and report based on in-country needs. Users at sub-national levels will be using action tracker to register actions and track the status of their implementation of tasks based on the roles they are assigned in the application and DHIS 2 system in general. The application is developed using DHIS 2 tracker implementation, that gives the possibility of migrating registered actions and their implementations from stand alone action tracker to Bottleneck Analysis (BNA) linked action tracker. Stand Alone Action Tracker differs from BNA linked Action tracker by allowing to set some fields from BNA linked action tracker as optional, that gives possibility of registration and tracking of tasks that are not necessarily obtained from Bottleneck Analysis of interventions.

2. Admin Guide

Installations

Download the latest version of the App via

https://github.com/hisptz/action-tracker-standalone/releases

Go to your DHIS2 action with the organisation units already in place,then install the downloaded app via App Management

After you have installed the app into DHIS2 action here are few steps you need to take before using it.

1. Search Users Apps in DHIS2 menu, click it then go to user role.Select the user role of a person(s) dealing with action tracking and assign all authorities starting with SAT_ to it.

2. Search Stand Alone Action Tracker app and click it, you will be required to go to Setting where you will fill in 'Planning Organisation Unit' field as per your use case.

3. Search for maintainance app in DHIS2 menu,click it and open programs,then click into 'Actions' program and assign orgnization units of your use case.Do the same for 'Bottleneck' program too.

3. Developer Guide

3.1. Installations

3.1.1.The DHIS2 CLI installation guide for Linux operating systems.

3.1.1.1.Yarn installation:

$ curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
$ echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sourcechh::s.list.d/yarn.list

$ sudo apt update && sudo apt install yarn

# If you are using nvm you can avoid the node installation by running
$ sudo apt update && sudo apt install --no-install-recommends yarn

# To verify yarn installation, run
$ yarn --version

3.1.1.2.d2-cli installation:

$ yarn global add @dhis2/cli

# To verify d2 is installed
$ d2 --help

NOTE: If the  "d2: command not found"  then run the below commands:

# Check path to yarn packages
$ yarn global bin

# Add yarn installed packages to path
# Example: export PATH=$PATH:/home/dhis/.yarn/bin 
$ export PATH=$PATH:<path_to_yarn_packages>

# Check if yarn is installed
 $ d2 --help

3.1.2.The DHIS2 CLI installation guide for MacOS.

3.1.2.1.Installing d2-app-scripts

$ yarn global add @dhis2/cli-app-scripts

# To verify d2-app-scripts is installed
$ d2 --help

# Add yarn installed packages to path
$ export PATH=$PATH:<path_to_yarn_packages>

3.1.2.2.Bootstrapping

To create a new template application (or upgrade and existing React app), use the d2-app-scripts init command.

$ d2-app-scripts init app-name
$ cd app-name

#To start app
$ yarn start

3.1.2.3.Proxying to remote server

Local server should whitelist localhost:4200 in system settings

Chrome

As of mid-July 2020, the Chrome (and Chromium) stable release channel has started to disable cross-site cookies by default. Mozilla Firefox has pushed this change to their beta channel and will likely release it to the stable channel soon.

# To enable proxying to remote server developer needs to edit SameSite Cookie Attribute when debugging app or developing app

1. Open chrome browser
2. Paste chrome://flags/#same-site-by-default-cookies in address bar
3. Set SameSite Flag to disabled

Mozilla

Firefox stable channel does not yet enforce this cookie policy, so for the moment everything should continue to work. Currently there doesn’t appear to be an easy way to disable the policy in Firefox Beta.

Safari

To disable SameSite Cookie in Safari:
1. Open Safari 
2. Go to Preferences
3. Navigate to privacy
4. Uncheck “Prevent cross-site tracking” option

action-tracker-standalone's Issues

Download PDF or Excel file fails

When clicking the “Download” button, the alert “Preparing a PDF/excel file” notification appears but the file is not downloaded

Period selector shows all periods (even invalid types)

The period selector shows both relative and fixed periods but all relative periods are invalid.

Auto assignment of programs to Organisation Units

When trying to add a new bottleneck to an intervention, the error below appears on a local instance (localhost)
Although it does work on the testing instance (as the intervention was created with “Testing Indicator 1”): https://dhis2academy.hisptz.com/unicefappsdev/dhis-web-commons/security/login.action , but not on localhost or debug.dhis2.org (with Sierra Leone default program indicators)

Edit Action Status fails

When editing an action item and clicking “Save Action Status” it doesn’t work ( the button doesn’t make the change and the modal persists)

Action Status Failing to Download

When trying to delete an action item a success alert appears but the action status is not deleted from the table

Start/End Dates for Action status out of Action item boundary

Start/End Date and Action Dates: even if the date is 2018 for start/end of the action item, the action status dates don’t change (here is 2016 - might be a default data of “Testing Indicator 1”?)

Event UIDs and filters can not be specified at the same error on viewing solutions

After creating a bottleneck, an error with the message (Event UIDs and filters can not be specified at the same) pops up and the solutions table does not appear.

Invalid period alerts do not autohide

Invalid period alerts are permanent and don’t auto-hide

Application Logger

Implementing an application logger that collects logs whenever the app crashes or runs into a problem

Indicator Selector is not paginated

The Indicator selector only lists 50 first indicators.