{"type":"doc","content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Requiring modules:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"A module can only access the api/service of another module if it is marked as required. The classloaders restrict this. The reasoning is to make classloading faster and to prevent classloading errors if the other module does not exist in a running openmrs.","type":"text"}]},{"type":"paragraph","content":[{"text":"To denote that the module you are writing depends on, or requires another one, put something like the following in your config.xml file:","type":"text"}]},{"type":"paragraph","content":[{"text":"","type":"text"},{"type":"hardBreak"},{"text":" org.openmrs.module.formentry","type":"text"},{"type":"hardBreak"},{"text":"","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The \"version\" attribute on the require_module element is available as of OpenMRS v1.5.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You probably want to then take the other module's .omod file, put it in your module's lib-common folder, and add it as a library in your eclipse project's build path(Add it to the .classpath of your module and also add to your build.xml to the tab and ant should be able to see it too.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The \"require_modules\" element must be after \"require_version\" and before \"extension\" in the ","type":"text"},{"text":"config.xml","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/spaces/Archives/pages/25477336"}}]},{"text":" file","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"With this example, if at least formentry version 1.8 is not installed, then this module will not start. ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Being aware of other modules:","type":"text","marks":[{"type":"strong"}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"This feature is available starting from OpenMRS v1.9","type":"text"}]}]},{"type":"paragraph","content":[{"text":"There are times when you need to be able to make a module aware of other modules, without requiring them. This means that ","type":"text"},{"text":"if","type":"text","marks":[{"type":"strong"}]},{"text":" the other module is also installed, do some extra features.","type":"text"}]},{"type":"paragraph","content":[{"text":"A specific example: The dev of formimportexport module wants his module to be able to be installed without requiring the user to install the formentry module as well. However, formimportexport has some extra stuff to do to forms if formentry is installed, so it needs to call formentry's API ","type":"text"},{"text":"optionally","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Formimportexport should be aware of formentry, be compiled against formentry.jar, and be able to say something like:","type":"text"}]},{"type":"paragraph","content":[{"text":"if (ModuleFactory.isModuleStarted(\"formentry\"))","type":"text"},{"type":"hardBreak"},{"text":" rebuildXsn();","type":"text"}]},{"type":"paragraph","content":[{"text":"To denote that the module you are writing is aware of another one, put something like the following in your config.xml file:","type":"text"}]},{"type":"paragraph","content":[{"text":"","type":"text"},{"type":"hardBreak"},{"text":" org.openmrs.module.formentry","type":"text"},{"type":"hardBreak"},{"text":"","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Compiling against the module","type":"text"}]},{"type":"paragraph","content":[{"text":"If you have a mavenized module:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In your module's root pom.xml you need something like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n\t\n\t\t\n\t\t\n\t\t\torg.openmrs.module\n\t\t\tthemoduleid-api\n\t\t\t1.0\n\t\t\tjar\n\t\t\tprovided\n\t\t\n\t\t...\n\t\n\n","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In your module's omod/pom.xml you need something like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n\torg.openmrs.module\n\tthemoduleid-api\n\n","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"paragraph","content":[{"text":"If your module is NOT using maven:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Take the other module's .jar or .omod file, put it in your module's lib-common folder, and add it as a library in your eclipse project's build path.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Notes:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The \"aware_of_modules\" element must be between \"require_version\" and \"extension\" in the ","type":"text"},{"text":"config.xml","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/spaces/Archives/pages/25477336"}}]},{"text":" file","type":"text"}]}]}]}],"version":1}