openinfoman-whomds

CSD Stored Functions related to WHO Minimum Data Set (MDS) for Health Worker Registries. The WHO MDS data dictionary can be found here

The representation/mapping of the WHO MDS onto CSD is in the following table:

Faciltiy Data Set	Data Element	XPath Expression in CSD Document
		Relative to /CSD/facilityDirectory/facility
Name	Name	primaryName
Facility type and ownership	Type	codedType/@code
	Ownership	organizations/organization/@urn
Facility Address	Country	address/addressLine[@component='country']
	Town / city	address/addressLine[@component=’city’]
	Street address	address/addressLine[@component=’streetAddress’]
	Postal Code	address/addressLine[@component=’postalCode’]
Telephone number	Number	contactPoint/codedType[@code='BP'  and @codingScheme=’urn:ihe:iti:csd:2013:contactPoint’]
GPS coordinates	Latitude	geocode/latitude
	Longitude	geocode/longitude

Helath Worker Data Set	Data Element	XPath Expression in CSD Document
		Relative to /CSD/providerDirectory/provider
Identification Number	Number	otherID/@code
	Date of Issue	otherID/@issueDate
	Date of Expiration	otherID/@expirationDate
	Place of Issue	otherID/@assigningAuthorityName
Full Name	First name	demographic/name/forename
	Last name	demographic/name/surname
	Middle name	demographic/name/otherNames[@type='middle']
	Maiden name	demographic/name/otherNames[@type='maiden']
	Other name 1	demographic/name/otherNames[@type='other_1']
	Other name 2	demographic/name/otherNames[@type='other_2']
	Other name 3	demographic/name/otherNames[@type='other_3']
Birth History	Place of birth country	demographic/extension[@urn="urn:who.int:hrh:mds" and @type='birth']/country
	Place of birth town	demographic/extension[@urn="urn:who.int:hrh:mds" and @type='birth']/town
	Father’s name	demographic/extension[@urn="urn:who.int:hrh:mds" and @type='birth']/fatherName
	Mother’s name	demographic/extension[@urn="urn:who.int:hrh:mds" and @type='birth']/motherName
	Photograph	demographic/extension[@urn="urn:who.int:hrh:mds"  and @type='photograph']/image
	Date of birth	demographic/dateOfBirth
	Sex at birth	demographic/gender
Citizenship, Country of Residence, and Language	Citizenship at birth	demographic/extension[@urn="urn:who.int:hrh:mds" and @type='citizenship']/birth
	Citizenship at present country of residence	demographic/extension[@urn="urn:who.int:hrh:mds" and @type='citizenship']/residence
	Ability in written languages	language[@code]/@written-ability
	Ability in spoken languages	language[@code]/@spoken-ability
Physical	Country	demographic/address/addressLine[@component='country’]
Address	City/Town	demographic/address/addressLine[@component='city']
	Street Address	demographic/address/addressLine[@component=’streetAddress']
	Postal Code	demographic/address/addressLine[@component=’postalCode']
Contact Information	Telephone number	demographic/contactPoint/codedType[@code='BP'  and @codingScheme=’urn:ihe:iti:csd:2013:contactPoint’]
	Email address	demographic/contactPoint/codedType[@code='EMAIL' and @codingScheme=’urn:ihe:iti:csd:2013:contactPoint’]
	Emergency contact name	demographic/contactPoint/codedType[@code='EMERGENCY'  and @codingScheme= ‘urn:who.int:hrh:mds’]
Professional License and Certification	Document type	credential/codedType/@code
	Document category	credential/codedType/@category
	Issuing institution	credential/issuingAuthority
	Date of issue	credential/credentialIssueDate
	Date of expiration	credential/credentialRenewalDate
	Photograph	credential/extension[@urn =’urn:who.int:hrh:mds’ and @type='photograph']/image
Employment Status	Employment status	record/@status
	Occupational category	codedType/@code
	Employment title	codedType[@code]
Disciplinary action	Complaints	credential/extension[@urn = ‘urn:who.int:hrh:mds’ and @type='complaints']/@value
Data Submission Institution	Name of the institution	record/@sourceDirectory
	Date and time of submission	record/@updated

Ubuntu Installation

You can easily install on Ubuntu 14.04 and Ubuntu 14.10 using the following commands

sudo add-apt-repository ppa:openhie/release
sudo apt-get update
sudo apt-get install openinfoman-whomds

Once installed, you should be able to access OpenInfoMan at:

http://localhost:8984/CSD

Manual Installation

Assumes that you have installed BaseX and OpenInfoMan according to:

https://github.com/openhie/openinfoman/wiki/Install-Instructions You will need BaseX 8.0 that supports the map:for-each() function. This is available as of Oct 28, 2014.

Directions

To get the libarary:

cd ~/
git clone https://github.com/openhie/openinfoman-whomds

Stored Functions

To install the stored functionsyou can do:

cd ~/basex/resources/stored_query_definitions
ln -sf ~/openinfoman-whomds/resources/stored_query_definitions/* .

Be sure to reload the stored functions:

https://github.com/openhie/openinfoman/wiki/Install-Instructions#Loading_Stored_Queries

WHO MDS Endpoints/Adapter User Interface

You can a user interface under the CSD adapters with

cd ~/basex/webapp
ln -sf ~/openinfoman-whomds/webapp/openinfoman_whomds_bindings.xqm