{"type":"doc","content":[{"type":"table","content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Primary mentor","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Rowan Seymour","type":"text","marks":[{"type":"link","attrs":{"href":"https://wiki.openmrs.org/display/~rowanseymour"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Backup mentor","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"TBD","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Assigned to","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"TBD","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Background","type":"text"}]},{"type":"paragraph","content":[{"text":"It is challenge for developers, especially those working on large distributions, to maintain test data which is consistent with their production environments. For example, developers may want to write unit tests for an indicator report that includes most of the metadata and concepts used by the distribution. ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Metadata Deploy","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/spaces/Archives/pages/25475917"}}]},{"text":" module addresses this challenge for a lot metadata types - but doesn't include concepts, as these don't lend themselves to being described in code. Also distributions commonly deploy concepts via a SQL dump (e.g. CIEL) ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PIH team have written code to generate a MariaDB copy of a production database but there's no easy way to specify what content should be included.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"This project would seek to provide a mechanism by which developers can easily generate a test dataset file for use in unit tests, which includes a configurable subset of their entire concept dictionary. It's important that developers can configure what is included in the final dataset file so that they can keep it as small as possible to keep unit test times as fast as possible - it's obviously not feasible to load an entire dictionary like CIEL into memory for each unit test.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Project Champions","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"TBD","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Skills Needed","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Java coding proficiency","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Basic SQL knowledge","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Objectives","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Produce a Maven plugin which can generate concept test data","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Plugin should be configurable in terms of which locales to include, which reference term sources.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Plugin should be modular and support different sources of concept details (JDBC, OpenConceptLab API)","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Extra Credit","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[ Possibly ] work with OpenConceptLab to provide API support on their end","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Contact","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Leave a comment below","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Design Proposal","type":"text"}]},{"type":"paragraph","content":[{"text":"It's common for an OpenMRS distribution to list the concepts it uses in classes of static constants, e.g.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Example dictionary class","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"public class Dictionary {\n public static final String ABACAVIR = \"70056AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA\";\n public static final String ADULT_INPATIENT_SERVICE = \"160536AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA\";\n public static final String ANTENATAL_CASE_NUMBER = \"161655AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA\";\n ...\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Classes like this would be the inputs for the plugin. The plugin when invoked would:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Parse out all of the constant fields of such classes","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Include dependent concepts (e.g. set members and answers)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Connect to database and fetch data for all of those concepts","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Serialize to an XML dataset file","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The output file would use the XML dataset format currently used to provide test data in uni tests, e.g.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Example output dataset file","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"html/xml"},"content":[{"text":"\n \n \n \n \n \n \n \n \n ...\n\n\t","type":"text"}]},{"type":"paragraph","content":[{"text":"The plugin itself could be configured in a project's POM something like this example:","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Example plugin configuration","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"html/xml"},"content":[{"text":"\n org.openmrs.contrib.maven\n conceptdataset-maven-plugin\n 1.0\n \n \n org.openmrs.module.kenyaemr.Dictionary\n \n jdbc:mysql://localhost/openmrs\n ${basedir}/src/test/resources/test-concepts.xml\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"And when run would request database credentials, e.g.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"mvn conceptdataset:generate\nEnter database username: root\nEnter database password: ********","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}],"version":1}

Browser not supported