Using Eclipse BIRT in

© 2008 by Justin Miranda; made available under the EPL v1.0 | 18 March 2008

Using Eclipse BIRT in

… seriously!

Justin [email protected]

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

Apologies

2


PartnersIn Health

3


Where we work

4


Rwinkwavu, Rwanda

5


Inshuti Mu Buzima Rwinkwavu, Rwanda6


What we do

7


Health Facility

Before After

Health Facilities

Before After


Medication


Food

11

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

Housing

Before After


Education


Mountains Beyond Mountains

14


Real World Challenges

15


HTTP Packet

Slow Internet

Power SurgesViruses


Power Outage

17


Power Outages (very common where we work)


Multiple Languages

20


We work in remote locations …

21


Paper … lots of it!


What the heck is OpenMRS?

24


Open Source Medical Record System


Community

26

Community


Collaboration

27


Architecture

28


Buzzword Soup

29

Tomcat


Eclipse IDE

30


BIRT RCP Designer

31


Why did we choose BIRT?

32


Feature-Rich Design Tool

33


Multiple Output Types

34

.pdf .doc .xls .html

… and more


Extensibility

35


Configurability

36


Power Outage

37


Built-in Surge Protection

38

… that is a joke


So how does OpenMRS use BIRT?

39

BIRT Runtime Engine API BIRT Design Engine API

Integration

Extension Open Data Access API

BIRT RCP DesignerDesign


Simple Charts


Data Quality Reports


Form Completeness


Complex Reports

44


Enrollments By Gender and Age


Patient Summary

46


Clinical Summary


Critical Reports

48


Patients Lost to Follow-Up(Translation: Patients who have missed multiple visits)


How do we integrate & extend BIRT?

50


Complex Data Model

51

WTF?


Simple Approach

Date Patient Weight Height XRayMonday Smith 190 lbs. 71 in. null

Tuesday Jones 180 lbs. 74 in. <xml>

52

Observation

ProblemsHow 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?


How do I add Pulse?

53

Date Patient Weight Height XRay … PulseMonday Smith 190 lbs. 71 in. <xml> … nullTuesday Jones 180 lbs. 74 in. <xml> … null

alter table observation add column pulse integer(10);


Concept Dictionary

54

Date Patient Concept ValueMonday Smith Weight 190

Friday Smith Height 71

Tuesday Jones Weight 180

Tuesday Jones Height 74

Concept DataType UnitsWeight Numeric Pounds

Height Numeric Inches

Xray Complex None

Date Patient Weight Height XRayMonday Smith 190 lbs. 71 in. null

Tuesday Jones 180 lbs. 74 in. <xml>

DataMeta Data

Observation

ObservationConcept


How do I add Pulse?

56

Date Patient Concept ValueMonday Smith Weight 190

Friday Smith Height 71

Tuesday Jones Weight 180

Tuesday Jones Height 74

Friday Smith Weight 191

Concept DataType UnitsWeight Numeric Pounds

Height Numeric Inches

Xray Complex None

Pulse Numeric Beats Per Minute

Observation Concept


How does this make the data model less complex?

57

SELECT obs.value

FROM patient, obs, concept

WHERE patient.patient_id = obs.patient_id

AND concept.concept_id = obs.concept_id

AND concept.concept_name = ‘WEIGHT’

AND patient.patient_id = ?

ORDER BY obs.obsdatetime DESC LIMIT 1

Ugh!


But OpenMRS makes it simple!

58

OpenMRSLogic Service 191.0 lbs“LAST WEIGHT”

LogicService.evaluate(patients, “LAST WEIGHT”)

Nice!


Integrating BIRT

59


Architecture

60


OpenMRS uses DEAPI and REAPI

61

Design Engine API

<xml>ReportDesign(.rptdesign)

OpenMRS BIRT Report Module

<csv>DataSet

(.csv)

1

Report Engine API

3

<xml>ReportDoc

(.rptdocument)

Export Dataset

Prepare Dataset

Run Report

2

4Modify Report


Export Dataset

PatientID LAST CD4 COUNT

LAST WEIGHT

HIV POSITIVE

ENROLLED DATE

1 390 55.0 TRUE 01/01/2008

2 500 59.0 TRUE 02/01/2008

3 203 53.0 TRUE 03/01/2008

4 429 50.0 TRUE 03/07/2008

5 1023 81.0 FALSE 03/10/2008

6 139 49.0 TRUE 03/18/2008

62

DataSet_03_18_2008.csv


OpenMRS Report Module

63

Design Engine API



<csv>DataSet

(.csv)

1

Report Engine API

3

<xml>ReportDoc

(.rptdocument)

Export Dataset

Prepare Dataset

Run Report

2

4Modify Report


Prepare Dataset (Design Engine API)

64


<?xml version="1.0" encoding="UTF-8"?><report> ...

<data-sources> <oda-data-source>

<property name="HOME"> /tmp/birt/reports/datasets

</property> </oda-data-source></data-sources><data-sets> <oda-data-set>

<property name="queryText"> select * from DataSet_03_18_2008.csv </property>

</oda-data-set></datasets>

...</report>

Design Engine API


BirtReportService.prepareDataset()

DataSourceHandle.setProperty()

OdaDataSetHandle.setQueryText()

ReportDesignHandle.save()


OpenMRS Report Module

65

Design Engine API



<csv>DataSet

(.csv)

1

Report Engine API

3

<xml>ReportDoc

(.rptdocument)

Export Dataset

Prepare Dataset

Run Report

2

4Modify Report


Run Report (Report Engine API)

66


Extending BIRT

67


OpenMRS ODA Plugin

68

Report Designer

SQL Flat FileXMLWeb

Service(SOAP)

Data

OpenMRS(REST)

XMLData

CSVData

OpenMRSLogic

REST API??


Select OpenMRS Data Source

69


Configure Connection

70


Create Data Set

71


OpenMRSLogic

REST API

GET COLUMNS

<Columns> <Column>PATIENT ID</Column> <Column>CD4 COUNT</Column> <Column>WEIGHT</Column> ...</Columns>

Report Designer

SQL Flat FileXMLWeb

Service(SOAP)

OpenMRS(REST)

Get Columns


Select Columns

73


Report Designer

Execute Query

74

OpenMRS(REST)

OpenMRSLogic

REST API

GET PATIENT ID, LAST WEIGHT, LAST CD4 COUNT FROM PATIENT

<?xml version="1.0" encoding="utf-8"?><dataset entity="PATIENT"> <columns> <column token="PATIENT ID"/> <column token="LAST WEIGHT"/> <column token="LAST CD4 COUNT"/> </columns> <rows> <row> <value>1</value> <value>180</value> <value>209</value> </row> <row> <value>2</value> <value>200</value> <value>198</value> </row> </rows></dataset>

SQL Flat FileXMLWeb

Service(SOAP)


Preview Data Set

75


Back to the Real World

76


Diagnosed with HIV and TB Started on ARV Regimen Started on TB Regimen Started on Food Program

Joseph Jeune


Sept 2003

78

March 2003


We need your help … join OpenMRS!

79

[email protected]


Thank You

80

Thank you to the Eclipse and BIRT Communities!


Resources

Partners In Health – www.pih.org OpenMRS – www.openmrs.org OpenMRS IRC – irc.freenode.net #openmrs Eclipse BIRT – http://www.eclipse.org/birt BIRT Exchange – http://www.birt-exchange.com BIRT World - http://birtworld.blogspot.com BIRT Newsgroup - news://news.eclipse.org/eclipse.birt

81

http://www.pih.org/

http://www.openmrs.org/

http://www.eclipse.org/birt

http://www.birt-exchange.com/

http://birtworld.blogspot.com/

news://news.eclipse.org/eclipse.birt

Using Eclipse BIRT in

Documents

Transcript of Using Eclipse BIRT in