MERtide

A tool for creation of PEPFAR Monitoring, Evaluation, and Reporting (MER) forms in DHIS 2.

Repo Owner: Ben Guaraldi @benguaraldi

Getting Started

In order to run MERtide, you only need Python 3.x with these libraries, most of which should be installed by default: base64, collections, copy, csv, defaultdict, getopt, hashlib, json, operator, os, random, re, requests, string, sys, urllib, xml, zipfile, and zlib.

You will need your /opt/dhis2/dish.json to contain the admin user/password info for your DHIS2 instance. A template file exists in the repo

The proper data elements and category option combos must exist in your targeted DHIS2 instance for MERTide to run. For this repo upload public_metadata.xml found in the samples folder.

To run MERtide, use a command like this:

python3 mertide.py -i controlfile.csv -d disaggs/

The -i refers to the CSV control file and the -d refers to the directory of HTML templates for disaggs.

Authors

• Jim Grace - Initial working version - jimgrace
• Ben Guaraldi - Validation rules and other work for v2 - benguaraldi
• Tim Harding - Control file and disagg file formats, subject-matter expertise, many other contributions - hardingt
• Greg Wilson - Javascript for form interactivity and off-line functionality - Awnage
• Kyle Pittleman - Error handling, additional output files, and other features - kpittleman

Funded by PEPFAR. Created by HISP US and BAO Systems for use on PEPFAR DATIM.

License

This project is licensed under the new BSD License. See the LICENSE.md file for details.

Support

Options:

<<<<<<< HEAD -n, --noconnection: Parse CSV even if there is no connection to DHIS2

-f formuid1234,formid2468, --forms=formuid1234,formid2468: Only include forms with uid formuid1234 and formuid2468

--nofavorites: Do not output favorites

--html: Outputs static HTML versions of the forms for uploading directly to DHIS2

--favoriteisoquarter=2019Q1: Year and Quarter in which to create favorites override (Defaults to current quarter)

-h, --help: Prints this message

-n, --noconnection: Parse CSV even if there is no connection to DHIS2

-f formuid1234,formid2468, --forms=formuid1234,formid2468: Only include forms with uid formuid1234 and formuid2468

--nofavorites: Do not output favorites

--html: Outputs static HTML versions of the forms for uploading directly to DHIS2

--favoriteisoquarter=2019Q1: Year and Quarter in which to create favorites override (Defaults to current quarter)

-h, --help: Prints this message

Sample Files

samples/control_files: Contains the .csv form files

• equals.csv: R = indicator ctl_rules

• greaterthan.csv: R > indicator ctl_rules

• lessthan.csv: R < indicator ctl_rules

• muex.csv, muex2.csv: Mutually exclusive ctl_rules

samples/disagg_files: Contains the .html files for each indicator in the control file

mertidecommand.sh: Command line templates to run mertide

c5fa1596a93c94079696248257374b28821c0e47