-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
3 changed files
with
22 additions
and
19 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,34 +1,35 @@ | ||
# dhis2-downloader | ||
# DHIS2 Data Downloader | ||
|
||
An Electron application with React | ||
## Introduction | ||
|
||
## Recommended IDE Setup | ||
The DHIS2 (District Health Information Software 2) Data Downloader is a React-based Electron application that allows users to connect to a DHIS2 instance, select | ||
|
||
- [VSCode](https://code.visualstudio.com/) + [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) + [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) | ||
### Features | ||
|
||
## Project Setup | ||
- Main - Allows downloading HMIS data with selected date range, data elements, organization levels, organization units, and disaggregated dimensions (supporting chunked downloads with an increased speed than the Colab API) | ||
|
||
### Install | ||
- **HMIS Data Dictionary**: The downloader allows users to search the relevant terms and get the 11-letter JSON ID for Data Elements, Indicators, and Category Combos. Additionally, it converts the JSON IDs to readable names for Indicators when the numerator and denominator are available. | ||
|
||
```bash | ||
$ npm install | ||
``` | ||
- **Record Downloading History**: The downloader can record the successful downloading requests and re-download requests during the login session. | ||
|
||
### Development | ||
## Build on Your Desktop | ||
|
||
```bash | ||
$ npm run dev | ||
``` | ||
$ git clone https://github.com/ccxzhang/dhis2-downloader.git | ||
$ cd dhis2-downloader | ||
$ npm install | ||
|
||
### Build | ||
# Start the app | ||
$ npm run start | ||
|
||
```bash | ||
# For windows | ||
$ npm run build:win | ||
|
||
# For macOS | ||
$ npm run build:mac | ||
|
||
# For Linux | ||
$ npm run build:linux | ||
``` | ||
|
||
## Acknowledgements | ||
|
||
We would like to thank Damola Sheriff Olajide with the West African Health Organization who provided the software [prototype](https://github.com/dolajide/dhis2-poc) for the FASTR Data Downloader. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters