{"type":"doc","content":[{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"outline":{"value":"true"},"indent":{"value":"20px"},"style":{"value":"none"},"printable":{"value":"false"}},"macroMetadata":{"schemaVersion":{"value":"1"},"title":"Table of Contents"}}}},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"BuildingReportsDev"},"legacyAnchorId":{"value":"Buildingcustomizedreportsinsidemodules(ForDevelopers)-BuildingReportsDev"}},"macroMetadata":{"schemaVersion":{"value":"1"},"title":"Anchor"}}}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Reporting API","type":"text"}]},{"type":"paragraph","content":[{"text":"Reporting API has been designed what we consider to be the basis for all of the APIs needed for the reporting. We feel very confident that the classes and interfaces designed will allow you to use and extend the API to:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Define new cohort queries to allow users to calculate a custom metric that is specific to your organization.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Define new data set definitions to expose data sets that are important to your users.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Define new custom data set definitions that can be used in any implementation.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Define a custom report based on your own data set definition.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Build new reporting tools and user interfaces (e.g. a custom Reporting Dashboard for clinicians or an interactive data quality tool for data managers).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Render reports in a standard format (e.g. SDMX-HD).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Render reports in a proprietary format (e.g. .docx).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Define custom logic rules to be used in indicators and cohort queries.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Define new data quality rules to allow data managers to identify problems areas within your form entry process.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Developing a Customised Reporting Module","type":"text"}]},{"type":"paragraph","content":[{"text":"Reports can be created as a module that works in conjunction with the reporting module. The advantage of this method is the portability of the report. It can be shared among different instances of OpenMRS without having to be recreated in the UI.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Save a report definition","type":"text"}]},{"type":"paragraph","content":[{"text":"In general you will add a class which will save your report definition to the database.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"MyReportSetup.java","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"// Tested with reporting module 0.6.3\nPeriodIndicatorReportDefinition rd = new PeriodIndicatorReportDefinition();\nrd.setName(\"myReport\");\nrd.setupDataSetDefinition();\n\n// add cohort queries, indicators, etc. here\n\nReportDefinitionService rds = (ReportDefinitionService) Context.getService(ReportDefinitionService.class);\nrds.saveDefinition(rd);\n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Create a custom web report renderer","type":"text"}]},{"type":"paragraph","content":[{"text":"You can add a custom web report renderer to your report by implementing the following components. The given code is not complete but it should allow you to implement your custom web report renderer.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Implement WebReportRenderer interface","type":"text"}]},{"type":"paragraph","content":[{"text":"MyReportWebRenderer.java","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"// Tested with reporting module 0.6.3\npublic class MyReportWebRenderer extends IndicatorReportWebRenderer implements WebReportRenderer {\n\t\n /**\n * @see org.openmrs.report.ReportRenderer#getLabel()\n */\n\t@Override\n public String getLabel() {\n \treturn \"Web Report\";\n }\n\t\n\t\n\t/**\n\t * @see org.openmrs.module.reporting.web.renderers.WebReportRenderer#getLinkUrl(org.openmrs.module.reporting.report.definition.ReportDefinition)\n\t */\n\t@Override\n\tpublic String getLinkUrl(ReportDefinition arg0) {\n\t\treturn \"module/myreports/render.form\";\n\t}\n\t\n\t/**\n\t * @see org.openmrs.report.ReportRenderer#getRenderingModes(org.openmrs.report.ReportDefinition)\n\t */\n\t@Override\n\tpublic Collection getRenderingModes(ReportDefinition definition) {\n\t\tList ret = new ArrayList();\n\t\tfor (Map.Entry> e : definition.getDataSetDefinitions().entrySet()) {\n\t\t\tString name = e.getKey();\n\t\t\tDataSetDefinition def = e.getValue().getParameterizable();\n\t \tif (\"myReport Data Set\".equals(def.getName())) {\n\t\t\t\tret.add(new RenderingMode(this, this.getLabel() , name, Integer.MAX_VALUE - 10));\n\t \t}\n\t\t}\n\t\treturn ret;\n\t}\n\t\n}\n","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Save WebReportRenderer","type":"text"}]},{"type":"paragraph","content":[{"text":"MyReportSetup.java","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":" \tfinal ReportDesign design = new ReportDesign();\n \tdesign.setName(name);\n \tdesign.setReportDefinition(rd);\n \tdesign.setRendererType(MyReportWebRenderer.class);\n \t\n \tReportService rs = Context.getService(ReportService.class);\n \trs.saveReportDesign(design);\n","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To display results add a Controller and a JSP","type":"text"}]},{"type":"paragraph","content":[{"text":"RenderMyReportController.java","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"// Tested with reporting module 0.6.3\n@Controller\npublic class RenderMyReportController {\n\t\n\t@RequestMapping(\"/module/myreports/render\")\n\tpublic String showReport(Model model, HttpSession session) {\n\t\t\n\t\tString renderArg = (String) session.getAttribute(ReportingConstants.OPENMRS_REPORT_ARGUMENT);\n\t\tReportData data = null;\n\t\ttry {\n\t\t\tdata = (ReportData) session.getAttribute(ReportingConstants.OPENMRS_REPORT_DATA);\n\t\t}\n\t\tcatch (ClassCastException ex) {\n\t\t\t// pass\n\t\t}\n\t\tif (data == null)\n\t\t\treturn \"redirect:../reporting/dashboard/index.form\";\n\t\t\n\t\treturn null;\n\t}\n","type":"text"}]},{"type":"paragraph","content":[{"text":"render.jsp","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"HTML"},"content":[{"text":"<%--\n This page assumes a ReportData object in the session as the attribute '__openmrs_report_data'\n--%>\n\n\n\n\n\n\n

\nIndicator value: ${mapDataSet.columnValuesByKey[\"myKey\"].value} \n

\n","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Getting Started with the basicreportmodule","type":"text"}]},{"type":"paragraph","content":[{"text":"IMPORTANT--","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#800000"}}]},{"text":" ","type":"text"},{"text":"This module does not exist as of . For now, see the following modules for ideas:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#800000"}}]}]},{"type":"paragraph","content":[{"text":"rwandareports","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/PIH/openmrs-module-rwandareports"}}]}]},{"type":"paragraph","content":[{"text":"pihmalawi","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/PIH/openmrs-module-pihmalawi"}}]}]},{"type":"paragraph","content":[{"text":"mdrtb","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/openmrs/openmrs-module-mdrtb"}}]}]}],"version":1}

Browser not supported