Jump to: navigation, search

Difference between revisions of "Ecore ODA Driver"

Line 1: Line 1:
 
== Introduction ==
 
== Introduction ==
  
The Ecore ODA Driver was created to allow an [[EMF ECore]] model to serve as an [[Connectivity#Open Data Access (ODA) Framework|ODA]] data source. The primary consumer of ODA data sources is [[BIRT Project|BIRT]]. Any ODA drivers registered with the platform show up within BIRT as data source types, each with a wizard to allow for the entry of connection information. In the case of the Ecore ODA Driver, the only information required is the path to a serialized Ecore model of a registered model type. (If you aren't familiar with registering EMF models, see this question in the [[EMF-FAQ#I get a PackageNotFoundException: e.g., "Package with uri 'http://com.example.company.ecore' not found." What do I need to do?|EMF FAQ]].)
+
The Ecore ODA Driver was created to allow an [[EMF ECore]] model to serve as an [[Connectivity#Open Data Access (ODA) Framework|ODA]] data source. This makes it simple for [[BIRT Project|BIRT]] reports to draw data from Ecore models.
  
 
== Installation ==
 
== Installation ==
  
The Ecore ODA Driver is only available from [[#CVS|CVS]]. The driver has a number of dependencies that may be un-met in your workspace: [[Connectivity|Datatools Connectivity]], [http://www.eclipse.org/modeling/emft/?project=search#search EMF Search], [http://www.eclipse.org/modeling/emf/?project=transaction#transaction EMF Transaction], and [http://www.eclipse.org/modeling/emf/?project=query#query EMF Query]. You will also need to install the EMF Model Query OCL Integration feature (or the "Next" button on the New Data Source Wizard for the Ecore ODA Data Source will be disabled) and the Data Tools Platform Enablement for JDBC (or you will see assertion failures in the ConnectionProfileManager for a missing generic db JDBC profile).
+
The Ecore ODA Driver is only available from [[#CVS|CVS]]. The driver has a number of dependencies that may be un-met in your workspace:  
 +
 
 +
{| class="wikitable"
 +
|-
 +
! Dependency
 +
! Update Site
 +
! Path
 +
|-
 +
| [[Connectivity|Datatools Connectivity]]
 +
| [http://download.eclipse.org/releases/ganymede/ http://download.eclipse.org/releases/ganymede/]
 +
| Enabling Features/Data Tools Platform Connectivity
 +
|-
 +
| Data Tools Platform Enablement for JDBC
 +
| [http://download.eclipse.org/releases/ganymede/ http://download.eclipse.org/releases/ganymede/]
 +
| Enabling Features/Data Tools Platform Enablement for JDBC
 +
|-
 +
| [http://www.eclipse.org/modeling/emft/?project=search#search EMF Search]
 +
| [http://download.eclipse.org/releases/ganymede/ http://download.eclipse.org/releases/ganymede/]
 +
| Models and Model Development/EMF Search SDK
 +
|-
 +
| [http://www.eclipse.org/modeling/emf/?project=transaction#transaction EMF Transaction]
 +
| [http://download.eclipse.org/releases/ganymede/ http://download.eclipse.org/releases/ganymede/]
 +
| Enabling Features/EMF Model Transaction
 +
|-
 +
| [http://www.eclipse.org/modeling/emf/?project=query#query EMF Query]
 +
| [http://download.eclipse.org/releases/ganymede/ http://download.eclipse.org/releases/ganymede/]
 +
| Enabling Features/EMF Model Query
 +
|-
 +
| EMF Model Query OCL Integration
 +
| [http://download.eclipse.org/releases/ganymede/ http://download.eclipse.org/releases/ganymede/]
 +
| Enabling Features/EMF Model Query OCL Integration
 +
|-
 +
| BIRT Report Designer
 +
| [http://download.eclipse.org/releases/ganymede/ http://download.eclipse.org/releases/ganymede/]
 +
| Charting and Reporting/Eclipse BIRT Report Designer Framework
 +
|}
  
 
== Using the Driver ==
 
== Using the Driver ==
 +
 +
The primary consumer of ODA data sources is [[BIRT Project|BIRT]]. Any ODA drivers registered with the platform show up within BIRT as data source types, each with a wizard to allow for the entry of connection information. In the case of the Ecore ODA Driver, the only information required by the connection is the path to a serialized Ecore model of a registered model type. (If you aren't familiar with registering EMF models, see this question in the [[EMF-FAQ#I get a PackageNotFoundException: e.g., "Package with uri 'http://com.example.company.ecore' not found." What do I need to do?|EMF FAQ]].)
 +
 
Toolwise, the primary beneficiary of the Ecore ODA driver is [http://www.eclipse.org/birt/phoenix/ BIRT], which you've presumably installed. To use the Ecore ODA Driver, un the BIRT Report Designer and create a new report.  You might want to install the EMF Examples from [http://www.eclipse.org/modeling/emf/updates] and create an instance of an .extlibrary file if you don't already have a serialized EMF model to use as your report data source.  When adding a Data Source, a new type will display <tt>Ecore ODA Data Source</tt> and the wizard will allow you to choose a file.  Selecting and naming this Data Source and giving the name of a file will allow you to enter a new Data Set.
 
Toolwise, the primary beneficiary of the Ecore ODA driver is [http://www.eclipse.org/birt/phoenix/ BIRT], which you've presumably installed. To use the Ecore ODA Driver, un the BIRT Report Designer and create a new report.  You might want to install the EMF Examples from [http://www.eclipse.org/modeling/emf/updates] and create an instance of an .extlibrary file if you don't already have a serialized EMF model to use as your report data source.  When adding a Data Source, a new type will display <tt>Ecore ODA Data Source</tt> and the wizard will allow you to choose a file.  Selecting and naming this Data Source and giving the name of a file will allow you to enter a new Data Set.
  

Revision as of 12:27, 10 April 2008

Introduction

The Ecore ODA Driver was created to allow an EMF ECore model to serve as an ODA data source. This makes it simple for BIRT reports to draw data from Ecore models.

Installation

The Ecore ODA Driver is only available from CVS. The driver has a number of dependencies that may be un-met in your workspace:

Dependency Update Site Path
Datatools Connectivity http://download.eclipse.org/releases/ganymede/ Enabling Features/Data Tools Platform Connectivity
Data Tools Platform Enablement for JDBC http://download.eclipse.org/releases/ganymede/ Enabling Features/Data Tools Platform Enablement for JDBC
EMF Search http://download.eclipse.org/releases/ganymede/ Models and Model Development/EMF Search SDK
EMF Transaction http://download.eclipse.org/releases/ganymede/ Enabling Features/EMF Model Transaction
EMF Query http://download.eclipse.org/releases/ganymede/ Enabling Features/EMF Model Query
EMF Model Query OCL Integration http://download.eclipse.org/releases/ganymede/ Enabling Features/EMF Model Query OCL Integration
BIRT Report Designer http://download.eclipse.org/releases/ganymede/ Charting and Reporting/Eclipse BIRT Report Designer Framework

Using the Driver

The primary consumer of ODA data sources is BIRT. Any ODA drivers registered with the platform show up within BIRT as data source types, each with a wizard to allow for the entry of connection information. In the case of the Ecore ODA Driver, the only information required by the connection is the path to a serialized Ecore model of a registered model type. (If you aren't familiar with registering EMF models, see this question in the EMF FAQ.)

Toolwise, the primary beneficiary of the Ecore ODA driver is BIRT, which you've presumably installed. To use the Ecore ODA Driver, un the BIRT Report Designer and create a new report. You might want to install the EMF Examples from [1] and create an instance of an .extlibrary file if you don't already have a serialized EMF model to use as your report data source. When adding a Data Source, a new type will display Ecore ODA Data Source and the wizard will allow you to choose a file. Selecting and naming this Data Source and giving the name of a file will allow you to enter a new Data Set.

CVS

The Ecore ODA Driver and UI can be checked out of CVS from the Datatools_Project Repository of dev.eclipse.org with a path of org.eclipse.datatools.incubator/plugins.

Browse: ViewCVS