southsudanemr/openmrs-module-initializer
Domain:
healthcareRecord type:
software
Creator:
sou
Host:
used to initialize all the metadata used by the south sudan emr
# OpenMRS Initializer module
### Introduction
The Initializer module is an API-only module that processes the content of the **configuration** folder when it is found inside OpenMRS' application data directory:
.
├── modules/
├── openmrs.war
├── openmrs-runtime.properties
├── ...
└── configuration/
The configuration folder is subdivided into _domain_ subfolders:
```bash
configuration/
├── addresshierarchy/
├── concepts/
├── drugs/
├── globalproperties/
├── idgen/
├── jsonkeyvalues/
├── locations/
├── messageproperties/
├── metadatamappings/
├── metadatasharing/
├── personattributetypes/
├── privileges/
├── programs/
├── programworkflows/
├── programworkflowstates/
└── roles/
```
Each domain-specific subfolder contains the metadata and configuration information that is relevant to the subfolder's domain. Although several file types are supported for providing metadata, CSV files are the preferred format and all domain should aim at being covered through parsing CSV files.
### Objectives
* This module allows to preload an OpenMRS installation with **maintained and versioned data and metadata**.
* Initializer processes **CSV files** upon startup.
* Each line of those CSV files represents an **OpenMRS object to be created or edited**.
Even though using CSV files is the preferred approach, some data or metadata domains rely on other file formats to be imported. You will encounter those other formats in the list below.
### Supported domains and loading order
We suggest to go through the following before looking at specific import domains:
* Conventions for CSV files
This is the list of currently supported domains in respect to their loading order:
1. Message properties key-values (.properties files)
1. Generic JSON key-values (JSON files)
1. Metadata Sharing packages (ZIP files)
1. Metadata Mappings (CSV files)
1. Privileges (CSV files)
1. Roles (CSV files)
1. Global properties (XML files)
1. Locations (CSV files)
1. Concepts (CSV files)
1. Programs (CSV files)
1. …