{"type":"doc","content":[{"type":"paragraph","content":[{"text":"The following steps were outlined by Tammy Dugan on the developers' mailing list.","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"The following should be the complete solution for extending an OpenMRS table through a module:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"add appropriate code in sqldiff.xml (or liquibase.xml, for more info see : ","type":"text"},{"text":"https://openmrs.atlassian.net/wiki/display/docs/Module+liquibase+File","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/display/docs/Module+liquibase+File"}}]},{"text":" ) to add the column to the table","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"add an entry for the module's Encounter.hbm file under mappingFiles in config.xml","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"create an empty service to call the module's encounter that extends OpenMRS's EncounterService object","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"create an hbm file for the module's encounter with the following mapping format\n","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n \n \n \n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"\nFor this hbm file to work, the following xml must exist in the OpenMRS Encounter.hbm file:\n","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"If this xml does not exist in the OpenMRS Encounter.hbm file, you will need to add it and create a custom build of OpenMRS.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"create an encounter class that extends the OpenMRS encounter class.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Make sure to override the constructors from the super class and add getters, setters, and instance variables for the columns you are adding.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"create an empty EncounterDAO class that extends OpenMRS EncounterDAO","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"create an EncounterServiceImp class that extends OpenMRS EncounterServiceImp and implements your module's EncounterService class.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Create an empty parameter constructor and create a method like the following:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\npublic void setTestDAO(org.openmrs.module.atdproducer.db.EncounterDAO dao){\n this.dao = dao;\n super.setEncounterDAO(this.dao);\n}\n","type":"text"}]},{"type":"paragraph","content":[{"text":"The method name should match the property xml wrapped around the hibernate implementation class in the moduleApplicationContext.xml file. Mine looks like this:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"add an entry in moduleApplicationContext just like you would for any other service and point to your service interface class, service implementation class, and hibernate implementation class for the added columns.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"create a HibernateEncounterDAO that extends OpenMRS's HibernateEncounterDAO and implements your module's EncounterDAO. Create an empty constructor and a method that looks like the following:\n","type":"text"}]},{"type":"codeBlock","content":[{"text":"\npublic void setSessionFactory(SessionFactory sessionFactory) {\n this.sessionFactory = sessionFactory;\n super.setSessionFactory(this.sessionFactory);\n}\n","type":"text"}]},{"type":"paragraph","content":[{"text":"\nTo make sure you return the correct type of encounter objects when you call your empty EncounterService class, you must override every method in OpenMRS's HibernateEncounterDAO that returns Encounter objects and convert them to your encounter objects. Here is an example method:\n","type":"text"}]},{"type":"codeBlock","content":[{"text":"\npublic Set getEncounters(Patient who, Location where) {\n Set openMRSEncounters = super.getEncounters(who,\n where);\n return convertOpenMRSEncToModuleEnc(openMRSEncounters);\n}\n\nprivate Set convertOpenMRSEncToModuleEnc(Set openMRSEncounters)\n{\nSet moduleEncounters = new HashSet();\n\nfor (org.openmrs.Encounter currOpenMRSEncounter : openMRSEncounters){ moduleEncounters.add(this.getEncounter(currOpenMRSEncounter\n .getEncounterId())); }\nreturn moduleEncounters;\n}\n","type":"text"}]}]}]}],"version":1}

Browser not supported