OpenMRS Module

The OpenMRS system supports a module system. Modules are compiled into jar files with an .omod suffix and stored in the modules directory.

Creating a simple module

To first setup and create a simple module follow OpenMRS's guide.

Inserting a Link to the module to Adminpage

  • In your config.xml file under metadata folder uncomment the section titled <!-- Extensions -->,
<!-- Extensions -->

<extension>
<point>org.openmrs.admin.list</point>
<class>@MODULE_PACKAGE@.extension.html.AdminList</class>
</extension>
<!-- /Extensions -->
  • Be sure to that your replace all references to basicmodule with the new name of your project which you may select.
  • Switch into Java perspective which is located in the upper right hand corner of eclispe below the eixt botton.
  • Edit your AdminList.java file in extention html to insert this line of code in to the function public Map<String, String> getLinks() before your return the map but after you declare it.
map.put("module/yourmodulename/somepage.htm", "some link text");
  • To make this link display text or functions, under your web folder → module → create a somepage.jsp file
  • Each page must be saved as a .jsp file but the OpenMRS controller translates request suffixes so you must refer to them in client side code as .htm .