Wiki Spaces


Get Help from Others

Q&A: Ask OpenMRS
Discussion: OpenMRS Talk
Real-Time: IRC Chat | Slack


Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


  1. Download the module from the repository and install it.
  2. Go through global properties and save all registration properties, in particular registration.rwandaLocationCode and registration.primaryIdentifierType -- the rwandaLocationCode is expected to be three digits.
  3. Then for   This module depends on the idgen, rwandaaddresshierarchy, and namephonetics modules, so these must be downloaded and installed prior to installing primary care.  Idgen provides an architecture for assigning ID numbers to patients during registration.  Rwandaaddresshierarchy contains the entire address structure for the country of Rwanda, and provides an architecture for structured and unstructured addresses.  Addresshierarchyrwanda will also very soon provide an htmlformentry custom tag that essentially renders its ajax-style rwanda address portlet and then records the user-selected values to the database.  Finally, namephonetics ensures that searches by name are smart about common phonemes in the Kinyarwanda language.
  4. Then, to prepare primary care-issued IDs, first make sure all idgen tables are empty, if migrating from a test database.
  5. Create a Primary Care ID Type – choose the Rwandan ID validator.
  6. Go over to into the idgen module administration pages, choose Primary Care Typethe primary care ID type you just created, and Local Identifier Generator
  7. Here's the base character set: 0123456789ACEFHJKMNPUWXY, First identifier base is: 00001, and the length is 10.
  8. Click 'view', and test by exporting a couple of identifiers;.
  9. Check the relationship type used during registration to record a patient's mothers and father's name (global property registration.parentChildRelationshipTypeId). If empty select it in the database.Maybe you need to add this global property is empty, check the database to determine the ID of the parent to child relationship type (or create one).
  10. Go through global properties and save all registration properties, in particular registration.rwandaLocationCode and registration.primaryIdentifierType -- the Rwanda location code is expected to be the three-digit code assigned to each health center by the Rwanda Ministry of Health.  The primaryIdentifierType should be the identifier type that you just created for primary care registration IDs.
  11. You may need to add the core openmrs global property concept.temperature.
  12. Maybe you You may need to add two privileges to the default user role – Manage Identifier Sources, and Generate Batch of Identifiers.
  13. In the name phonetics Generate Phonetics for All Patients page, select Double Metaphone for Given Name, and Kinyarwanda Soundex for Family Name.
  14. Generate name phonetics on this same page. (NOTE: this can run for a couple of hours, if you have thousands of names in your database).
  15. In Rinkwavu, we have overwritten a couple of core openmrs text properties.  To do this, in your runtime properties file, add the following line:   custom.messages=<<path>>/set their global, where you set the <<path>> to wherever you want to create a file.  Then in the custom_messages file, add the following lines:
  16. PersonName.givenName=Christian Name
    PersonName.familyName=Kinyarwanda Name (Christian name, KINYARWANDA name)