Interactive datastore import export tool based on DHIS2 platform aim at extending import and export capabilities for datastore contents
- NodeJs (10 or higher)
- npm (6.4.0 or higher), can be installed by running
apt install npm
- git, can be installed by running
apt install git
Clone repository
git clone https://github.com/hisptz/datastore-import-export-app.git
Navigate to application root folder
cd datastore-import-export-app
Install all required dependencies for the app
npm install
To start development server
npm start
Navigate to http://localhost:4200.
This command will require proxy-config.json file available in the root of your source code, usually this file has this format
{
"/api": {
"target": "https://play.dhis2.org/2.29/",
"secure": "false",
"auth": "admin:district",
"changeOrigin": "true"
},
"/": {
"target": "https://play.dhis2.org/2.29/",
"secure": "false",
"auth": "admin:district",
"changeOrigin": "true"
}
}
We have provided proxy-config.example.json
file as an example, make a copy and rename to proxy-config.json
To build the project run
npm run build
The build artifacts will be stored in the dist/
, this will include a zip file ready for deploying to any DHIS2 instance.
Run ng test
to execute the unit tests via Karma.
Run ng e2e
to execute the end-to-end tests via Protractor.
To get more help on the Angular CLI use ng help
or go check out the Angular CLI README.
The app allows transfer of namespaces between two dhis2 instances, both installed with the datastore import/export app. A file containing the data in json format from one instance is imported into the second instance for creation of new namespaces and updating existing namespaces.
One way is to check desired namespaces on the left most column. Once one or more namespaces are checked. An export button will become active and once clicked a file will be downloaded. Another way is to click on the namespace on the left column. On the middle column above the list of keys an export button will be visible. Click on the button to download a json file with the namespace. To import the file click on the import button on the left most column above the list of namespaces. Select the file that exported another instance then import it to your instance.
Figure 1: Exporting a namespace
Figure 2: Importing namespaces from a file exported from another instance
The Datastore import/export application has been used in implementation of Bottleneck Analysis, Scorecard, and customized program dashboard configurations in national HMIS, Multi-Sectoral Nutrition Information System and District Case Monitoring System in Tanzania during migration of metadata configurations from development/training instance to the live systems.