View source for 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.

==Reporting to DHIS2==
This module is intended to facilitate reporting of aggregate data, such as the number of health workers at a clinic, from iHRIS to DHIS2.  

Once the facilities in iHRIS are linked with the DHIS2 metadata, the DHIS2 facility codes and uid will be available in your report.  In your report relationship, once you have joined in the iHRIS Facility, simply join in the DHIS2 Organizational Unit to make these fields available.

You may want to develop and XSLT to transform the iHRIS report into the DHIS2 DXF format.  Discussion on how to do this is out of scope for this document, however you may wish to view this [http://bazaar.launchpad.net/~intrahealth+informatics/ihris-student-tracking/trunk/view/head:/modules/DHIS2_StudentStatus/sources/student_status.xsl related example]

==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 [http://www.dhis2.org/doc/snapshot/en/user/html/ch19.html#d5e2772 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"
[[Image:config_dhis_meta.png|center|config_dhis_meta.png]] 
Clicking on this link will take you to a page where you can upload the DHIS2 metadata export. 
[[Image:config_dhis_meta_upload.png|center|config_dhis_meta_upload.png]] 

Once you have uploaded the DHIS2 Metadata, clicking on the "Organizational Units" and "Data Elements" links will show you the available metadata from DHIS2.

Notes:
*it may take a short amount of time for the caches of the DHIS metadata to be rebuilt after an upload.
*the maximum file upload size in php.ini as well as max post size need to be at least as big as the size of the Export.xml
*the max_allowed_packet in mysql's my.cnf needs to be at least as big as the size of Export.xml

==Linking Facilities==
Once you have uploaded the DHIS2 metadata, you can link this facilities in iHRIS. 
*Click the "Administer Database" section
*Click on "Office/Facility"
*select the facility that you wish to link
*Click on "Update This Information"
*Select the DHIS2 Organizational Unit you wish to link to
*Click "Confirm"
*Click "Save"
[[Image:dhis_link_facility.png|center|dhis_link_facility.png]]

==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'>
<span type='module' ifenabled='true' name='DHIS_FacilityMap'>
 <span type="form" name="facility:dhis_orgunit" showhead="default" />
</span>
</source>
which will display the field which links the DHIS2 Organizational Unit to the iHRIS Facility forms.  

You can see an example of this [http://bazaar.launchpad.net/~intrahealth+informatics/ihris-common/4.1-dev/view/head:/modules/Facility/templates/en_US/lists_form_facility.html here] on lines 9-11. 

If your site does not include either of these html templates, you should not need to make any changes.
[[Category: DHIS]][[Category:Review2014]]