© 2008 by Justin Miranda; made available under the EPL v1.0 | 18 March 2008 Using Eclipse BIRT in … seriously! Justin Miranda

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Apologies 2

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Partners In Health 3

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Where we work 4

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Rwinkwavu, Rwanda 5

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Inshuti Mu Buzima Rwinkwavu, Rwanda 6

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 What we do 7

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 8 Health Facility BeforeAfter Health Facilities Before After

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 9 Quality Health Care

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v Medication

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Food 11

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Community Health Workers 12 Housing BeforeAfter

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v Education

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Mountains Beyond Mountains 14

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Real World Challenges 15

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v HTTP Packet Slow Internet Power SurgesViruses

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Power Outage 17

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 18

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v Power Outages (very common where we work)

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Multiple Languages 20

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 We work in remote locations … 21

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v … really remote.

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v Paper… lots of it!

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 What the heck is OpenMRS? 24

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v Open Source Medical Record System

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Community 26 Community

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Collaboration 27

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Architecture 28

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Buzzword Soup 29 Tomcat

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Eclipse IDE 30

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v BIRT RCP Designer 31

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Why did we choose BIRT? 32

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Feature-Rich Design Tool 33

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Multiple Output Types 34.pdf.doc.xls.html … and more

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Extensibility 35

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Configurability 36

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Power Outage 37

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Built-in Surge Protection 38 … that is a joke

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 So how does OpenMRS use BIRT? 39  BIRT Runtime Engine API  BIRT Design Engine API Integration Extension  Open Data Access API  BIRT RCP Designer Design

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v Simple Charts

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 41

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v Data Quality Reports

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v Form Completeness

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Complex Reports 44

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v Enrollments By Gender and Age

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Patient Summary 46

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v Clinical Summary

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Critical Reports 48

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v Patients Lost to Follow-Up (Translation: Patients who have missed multiple visits)

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 How do we integrate & extend BIRT? 50

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Complex Data Model 51 WTF?

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Simple Approach DatePatientWeightHeightXRay MondaySmith190 lbs.71 in.null TuesdayJones180 lbs.74 in. 52 Observation Problems  How do I add a new observation type (i.e. Pulse)?  What if weight, height, and X-ray observations were taken on different days?  How do I store multiple Weights for a patient?

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 How do I add Pulse? 53 DatePatientWeightHeightXRay…Pulse MondaySmith190 lbs.71 in. …null TuesdayJones180 lbs.74 in. …null alter table observation add column pulse integer(10);

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Concept Dictionary 54 DatePatientConceptValue MondaySmithWeight190 FridaySmithHeight71 TuesdayJonesWeight180 TuesdayJonesHeight74 ConceptDataTypeUnits WeightNumericPounds HeightNumericInches XrayComplexNone DatePatientWeightHeightXRay MondaySmith190 lbs.71 in.null TuesdayJones180 lbs.74 in. DataMeta Data Observation Concept

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 55

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 How do I add Pulse? 56 DatePatientConceptValue MondaySmithWeight190 FridaySmithHeight71 TuesdayJonesWeight180 TuesdayJonesHeight74 FridaySmithWeight191 ConceptDataTypeUnits WeightNumericPounds HeightNumericInches XrayComplexNone PulseNumericBeats Per Minute ObservationConcept

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 How does this make the data model less complex? 57 SELECT obs.value FROM patient, obs, concept WHERE patient.patient_id = obs.patient_id ANDconcept.concept_id = obs.concept_id ANDconcept.concept_name = ‘WEIGHT’ AND patient.patient_id = ? ORDER BY obs.obsdatetime DESC LIMIT 1 Ugh!

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 But OpenMRS makes it simple! 58 OpenMRS Logic Service lbs “LAST WEIGHT” LogicService.evaluate(patients, “LAST WEIGHT”) Nice!

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Integrating BIRT 59

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Architecture 60

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 OpenMRS uses DEAPI and REAPI 61 Design Engine API ReportDesign (.rptdesign) OpenMRS BIRT Report Module DataSet (.csv) 1 Report Engine API 3 ReportDoc (.rptdocument) Export Dataset Prepare Dataset Run Report 2 4 Modify Report

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Export Dataset PatientIDLAST CD4 COUNT LAST WEIGHT HIV POSITIVE ENROLLED DATE TRUE01/01/ TRUE02/01/ TRUE03/01/ TRUE03/07/ FALSE03/10/ TRUE03/18/ DataSet_03_18_2008.csv

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 OpenMRS Report Module 63 Design Engine API ReportDesign (.rptdesign) OpenMRS BIRT Report Module DataSet (.csv) 1 Report Engine API 3 ReportDoc (.rptdocument) Export Dataset Prepare Dataset Run Report 2 4 Modify Report

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Prepare Dataset (Design Engine API) 64 ReportDesign (.rptdesign)... /tmp/birt/reports/datasets select * from DataSet_03_18_2008.csv... Design Engine API OpenMRS BIRT Report Module BirtReportService.prepareDataset() DataSourceHandle.setProperty() OdaDataSetHandle.setQueryText() ReportDesignHandle.save()

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 OpenMRS Report Module 65 Design Engine API ReportDesign (.rptdesign) OpenMRS BIRT Report Module DataSet (.csv) 1 Report Engine API 3 ReportDoc (.rptdocument) Export Dataset Prepare Dataset Run Report 2 4 Modify Report

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Run Report (Report Engine API) 66

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Extending BIRT 67

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 OpenMRS ODA Plugin 68 Report Designer SQL Flat File XML Web Service (SOAP) Data OpenMRS (REST) XML Data CSV Data OpenMRS Logic REST API ??

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Select OpenMRS Data Source 69

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Configure Connection 70

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Create Data Set 71

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v OpenMRS Logic REST API GET COLUMNS PATIENT ID CD4 COUNT WEIGHT... Report Designer SQL Flat File XML Web Service (SOAP) OpenMRS (REST) Get Columns

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Select Columns 73

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Report Designer Execute Query 74 OpenMRS (REST) OpenMRS Logic REST API GET PATIENT ID, LAST WEIGHT, LAST CD4 COUNT FROM PATIENT SQL Flat File XML Web Service (SOAP)

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Preview Data Set 75

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Back to the Real World 76

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v  Diagnosed with HIV and TB  Started on ARV Regimen  Started on TB Regimen  Started on Food Program Joseph Jeune

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Sept March 2003

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 We need your help … join OpenMRS! 79

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Thank You 80 Thank you to the Eclipse and BIRT Communities!

Using Eclipse BIRT in the Real World … Seriously | © 2008 by Justin Miranda; made available under the EPL v1.0 Resources  Partners In Health –  OpenMRS –  OpenMRS IRC – irc.freenode.net #openmrs  Eclipse BIRT –  BIRT Exchange –  BIRT World -  BIRT Newsgroup - news://news.eclipse.org/eclipse.birtnews://news.eclipse.org/eclipse.birt 81