openIMIS components: Web Application v1.3.0 and later. 

Implementation roles required: IMIS Administrator, Scheme Administrator


Implementation-related information can be configured in different ways. The user documentation explains bulk upload/download functionality of in general. In this page, we give examples of register files that can use by the functionality. 

The bulk upload/download functionality can be accessed through the menu Tools → Registers.

Upload diagnoses 

Because the diagnoses list can be quite long, the configuration of the diagnoses in openIMIS Web Application can be done only by uploading the list encoded as an XML document. 

DTD definition of the XML file for uploading/downloading of diagnoses is:

<!DOCTYPE Diagnoses [
	<!ELEMENT Diagnoses (Diagnosis*)>
	<!ELEMENT Diagnosis (DiagnosisCode, DiagnosisName)>
	<!ELEMENT DiagnosisCode (#CDATA)>
	<!ELEMENT DiagnosisName (#CDATA)>
]>

An example of an XML file that uses and conforms to this DTD follows.

<?xml version="1.0" encoding="utf-8"?>
<Diagnoses>
	<Diagnosis>
		<DiagnosisCode>A00</DiagnosisCode>
		<DiagnosisName>Cholera</DiagnosisName>
	</Diagnosis>
	<Diagnosis>
		<DiagnosisCode>A01</DiagnosisCode>
		<DiagnosisName>Typhoid and paratyphoid fevers</DiagnosisName>
	</Diagnosis>
	<Diagnosis>
		<DiagnosisCode>A02</DiagnosisCode>
		<DiagnosisName>Other salmonella infections</DiagnosisName>
	</Diagnosis>
	<Diagnosis>
		<DiagnosisCode>A03</DiagnosisCode>
		<DiagnosisName>Shigellosis</DiagnosisName>
	</Diagnosis>
	<Diagnosis>
		<DiagnosisCode>A04</DiagnosisCode>
		<DiagnosisName>Other bacterial intestinal infections</DiagnosisName>
	</Diagnosis>
	<Diagnosis>
		<DiagnosisCode>A05</DiagnosisCode>
		<DiagnosisName>Other bacterial foodborne intoxications, not elsewhere classified</DiagnosisName>
	</Diagnosis>
	<Diagnosis>
		<DiagnosisCode>A06</DiagnosisCode>
		<DiagnosisName>Amebiasis</DiagnosisName>
	</Diagnosis>
</Diagnoses>

A ready to use ICD10 first-level diagnoses list can be downloaded here: ICD10.xml

To upload the diagnoses list please follow the instruction in the user manual

If there are errors in the diagnoses list or you want to add/remove diagnoses, the easier is to download the current list, do the modifications and upload the list again. 

Upload locations

The list of locations can be configured in different ways. The simplest and intuitive way is through the user interface. In this section, we explain how to configure the locations by uploading the list formatted as an XML document.

DTD definition of the XML file for uploading/downloading of locations is:

<!DOCTYPE Locations [
	<!ELEMENT Locations (Regions, Districts, Municipalities, Villages)>
	<!ELEMENT Regions (Region*)>
	<!ELEMENT Region (RegionCode, RegionName)>
	<!ELEMENT RegionCode (#CDATA)>
	<!ELEMENT RegionName (#CDATA)>
	<!ELEMENT Districts (District*)>
	<!ELEMENT District (RegionCode, DistrictCode, DistrictName)>
	<!ELEMENT RegionCode (#CDATA)>
	<!ELEMENT DistrictCode (#CDATA)>
	<!ELEMENT DistrictName (#CDATA)>
	<!ELEMENT Municipalities (Municipality*)>
	<!ELEMENT Municipality (DistrictCode, MunicipalityCode, MunicipalityName)>
	<!ELEMENT DistrictCode (#CDATA)>
	<!ELEMENT MunicipalityCode (#CDATA)>
	<!ELEMENT MunicipalityName (#CDATA)>
	<!ELEMENT Villages (Village*)>
	<!ELEMENT Village (MunicipalityCode, VillageCode, VillageName, MalePopulation?, FemalePopulation?, OtherPopulation, Families?)>
	<!ELEMENT MunicipalityCode (#CDATA)>
	<!ELEMENT VillageCode (#CDATA)>
	<!ELEMENT VillageName (#CDATA)>
	<!ELEMENT MalePopulation (#CDATA)>
	<!ELEMENT FemalePopulation (#CDATA)>
	<!ELEMENT OtherPopulation (#CDATA)>
	<!ELEMENT Families (#CDATA)>
]>

An example of an XML file that uses and conforms to this DTD follows.

<?xml version="1.0" encoding="utf-8"?>
<Locations>
  <Regions>
    <Region>
      <RegionCode>R1</RegionCode>
      <RegionName>Ultha</RegionName>
    </Region>
    <Region>
      <RegionCode>R2</RegionCode>
      <RegionName>Tahida</RegionName>
    </Region>
  </Regions>
  <Districts>
    <District>
      <RegionCode>R1</RegionCode>
      <DistrictCode>R1D1</DistrictCode>
      <DistrictName>Rapta</DistrictName>
    </District>
    <District>
      <RegionCode>R2</RegionCode>
      <DistrictCode>R2D1</DistrictCode>
      <DistrictName>Rajo</DistrictName>
    </District>
  </Districts>
  <Municipalities>
    <Municipality>
      <DistrictCode>R2D1</DistrictCode>
      <MunicipalityCode>R2D1M1</MunicipalityCode>
      <MunicipalityName>Jaber</MunicipalityName>
    </Municipality>
    <Municipality>
      <DistrictCode>R1D1</DistrictCode>
      <MunicipalityCode>R1D1M2</MunicipalityCode>
      <MunicipalityName>Jamu</MunicipalityName>
    </Municipality>
    <Municipality>
      <DistrictCode>R1D1</DistrictCode>
      <MunicipalityCode>R1D1M3</MunicipalityCode>
      <MunicipalityName>Adhi</MunicipalityName>
    </Municipality>
  </Municipalities>
  <Villages>
    <Village>
      <MunicipalityCode>R2D1M1</MunicipalityCode>
      <VillageCode>R2D1M1V1</VillageCode>
      <VillageName>Utha</VillageName>
      <MalePopulation>0</MalePopulation>
      <FemalePopulation>0</FemalePopulation>
      <OtherPopulation>0</OtherPopulation>
      <Families>0</Families>
    </Village>
	<Village>
      <MunicipalityCode>R1D1M2</MunicipalityCode>
      <VillageCode>R1D1M2V1</VillageCode>
      <VillageName>Jamula</VillageName>
      <MalePopulation>0</MalePopulation>
      <FemalePopulation>0</FemalePopulation>
      <OtherPopulation>0</OtherPopulation>
      <Families>0</Families>
    </Village>
	<Village>
      <MunicipalityCode>R1D1M3</MunicipalityCode>
      <VillageCode>R1D1M3V1</VillageCode>
      <VillageName>Rathula</VillageName>
      <MalePopulation>0</MalePopulation>
      <FemalePopulation>0</FemalePopulation>
      <OtherPopulation>0</OtherPopulation>
      <Families>0</Families>
    </Village>
  </Villages>
</Locations>

To upload the location list please follow the instruction in the user manual

If there are errors in the location list or you want to add/remove locations, the easier is to edit from the user interface by accessing Administration → Locations from the menu. 

Upload health facilities

As for the locations, the health facilities can be configured in different ways and the most intuitive and simple way is through the user interface. In this section, we explain how to configure the health facilities by uploading the list formatted as an XML document.

DTD definition of the XML file for uploading/downloading of health facilities is:

<!DOCTYPE HealthFacilities [
	<!ELEMENT HealthFacilities (HealthFacilityDetails, CatchmentsDetails)>
	<!ELEMENT HealthFacilityDetails (HealthFacility*)>
	<!ELEMENT HealthFacility (LegalForm, Level, Sublevel, Code, Name, Address, DistrictCode, DistrictName, Phone, Fax, Email, CareType, AccountCode, ItemPriceListName, ServicePricelistName)>
	<!ELEMENT LegalForm (D|C|G|P)> 	<!-- District organization | Charity | Government | Private organization -->
	<!ELEMENT Level (D|C|H)> 			<!-- Dispensary | Health Centre | Hospital -->
	<!ELEMENT SubLevel (I|N|R)>		<!-- Integrated | No Sublevel | Reference -->
	<!ELEMENT Code (#CDATA)>
	<!ELEMENT Name (#CDATA)>
	<!ELEMENT Address (#CDATA)>
	<!ELEMENT DistrictCode (#CDATA)>
	<!ELEMENT DistrictName (#CDATA)>
	<!ELEMENT Phone (#CDATA)>
	<!ELEMENT Fax (#CDATA)>
	<!ELEMENT Email (#CDATA)>
	<!ELEMENT CareType (I|O|B)>		<!-- In-Patient | Out-Patient | Both -->
	<!ELEMENT AccountCode (#CDATA)>
	<!ELEMENT ItemPriceListName (#CDATA)>
	<!ELEMENT ServicePriceListName (#CDATA)>
	<!ELEMENT CatchmentsDetails (Catchment*)>
	<!ELEMENT Catchment (HFCode, VillageCode, VillageName, Percentage)>
	<!ELEMENT HFCode (#CDATA)>
	<!ELEMENT VillageCode (#CDATA)>
	<!ELEMENT VillageName (#CDATA)>
	<!ELEMENT Percentage (#CDATA)>
]>

An example of an XML file that uses and conforms to this DTD follows.

<?xml version="1.0" encoding="utf-8"?>
<HealthFacilities>
  <HealthFacilityDetails>
    <HealthFacility>
      <LegalForm>G</LegalForm>
      <Level>H</Level>
      <SubLevel />
      <Code>JMHOS001</Code>
      <Name>Jambero District Hospital</Name>
      <Address>Lantern Road 21 P.O.Box 3425</Address>
      <DistrictCode>R1D2</DistrictCode>
      <DistrictName>Jambero</DistrictName>
      <Phone />
      <Fax />
      <Email />
      <CareType>B</CareType>
      <AccountCode>DL0002</AccountCode>
      <ItemPriceListName>Ultha Govt. Hospital List</ItemPriceListName>
      <ServicePriceListName>Ultha Govt. Hospital List</ServicePriceListName>
    </HealthFacility>
    <HealthFacility>
      <LegalForm>G</LegalForm>
      <Level>C</Level>
      <SubLevel />
      <Code>JMHC001</Code>
      <Name>Jamini Health Centre</Name>
      <Address>Reduci road 42</Address>
      <DistrictCode>R1D2</DistrictCode>
      <DistrictName>Jambero</DistrictName>
      <Phone />
      <Fax />
      <Email />
      <CareType>O</CareType>
      <AccountCode />
      <ItemPriceListName>Ultha Govt. Health Centre List</ItemPriceListName>
      <ServicePriceListName>Ultha Govt. Health Centre List</ServicePriceListName>
    </HealthFacility>
    <HealthFacility>
      <LegalForm>G</LegalForm>
      <Level>D</Level>
      <SubLevel />
      <Code>JMDP001</Code>
      <Name>Huda Dispensary</Name>
      <Address>Jolywel road 675</Address>
      <DistrictCode>R1D2</DistrictCode>
      <DistrictName>Jambero</DistrictName>
      <Phone />
      <Fax />
      <Email />
      <CareType>O</CareType>
      <AccountCode />
      <ItemPriceListName>Ultha Govt. Dispensary List</ItemPriceListName>
      <ServicePriceListName>Ultha Govt. Dispensary List</ServicePriceListName>
    </HealthFacility>
  </HealthFacilityDetails>
  <CatchmentDetails>
    <Catchment>
      <HFCode>JMDP001</HFCode>
      <VillageCode>R1D2M2V1</VillageCode>
      <VillageName>Agilo</VillageName>
      <Percentage>100</Percentage>
    </Catchment>
    <Catchment>
      <HFCode>JMDP001</HFCode>
      <VillageCode>R1D2M1V1</VillageCode>
      <VillageName>Holobo</VillageName>
      <Percentage>100</Percentage>
    </Catchment>
    <Catchment>
      <HFCode>JMDP001</HFCode>
      <VillageCode>R1D2M1V2</VillageCode>
      <VillageName>Octo</VillageName>
      <Percentage>100</Percentage>
    </Catchment>
    <Catchment>
      <HFCode>JMDP001</HFCode>
      <VillageCode>R1D2M1V3</VillageCode>
      <VillageName>Raberjab</VillageName>
      <Percentage>100</Percentage>
    </Catchment>
  </CatchmentDetails>
</HealthFacilities>

To upload the health facilities list please follow the instruction in the user manual

If there are errors in the location list or you want to add/remove locations, the easier is to edit from the user interface by accessing Administration → Health Facilities from the menu.


Previous stepWA6. Building of registers

Go to parentWA6. Building of registers

Table of contentsInstallation Guide

Next stepWA6.2 Use the Database Import Tool