Linking iHRIS Facilities and DHIS Organizational Units
The 4.1 series development code now has the ability to rapidly link iHRIS facilities with the DHIS2 organizational units. This functionality will be a part of the next release, 4.1.7. This is accomplished with the "DHIS Facility Map" modules.
Enabling the Module
You have two ways to enable the module. Either through the web interface or by adding the following line to your site customization XML file. <source lang='xml'>
<enable name="DHIS_FacilityMap" />
</source>
To enable this module in the web interface, do the following:
- Click on "Configure System"
- Click on "Configure Modules"
- Click on "Sub-Modules" to the right of "iHRIS Common"
- Click on "Sub-Modules" to the right of "DHIS Metadata"
- Check the box to the left of "DHIS Facility Map"
- Click on the "Enable" button
Exporting DHIS Metadata
To obtain the DHIS2 metadata export, see the DHIS2 documentation. You will want to select the "XML" format and "Uncompressed" and you should obtain a file "Export.xml."
Uploading DHIS2 Metadata
The DHIS Facility Map module makes use of the DHIS Metadata module which loads in the "Organizational Unit" and "Data Element" metadata from your DHIS2 installation. Once the DHIS2 module is enabled, you will see a new option under "Configure System" called "Manage DHIS2 MetaData"
Clicking on this link will take you to a page where you can upload the DHIS2 metadata export.
Once you have uploaded the DHIS2 Metadata, clicking on the "Organizational Units" and "Data Elements" links will show you the available metadata from DHIS2.
HTML Templates
If your site customizations include either of the files "view_list_faciltiy.html" or "lists_form_facility.html" you should add the following lines: <source lang='xml'>
</source> which will display the field which links the DHIS2 Organizational Unit to the iHRIS Facility forms.
You can see an example of this here on lines 9-11.
If your site does not include either of these html templates, you should not need to make any changes.
