As of BIRT 2.0, the BIRT ODA run-time framework has been migrated to the Eclipse Data Tools Platform (DTP) project.
It is replaced by the org.eclipse.datatools.connectivity.oda.dataSource extension point.
BIRT 2.0 provides a DTP-to-BIRT ODA adapter plug-in to support
existing ODA run-time extensions that implemented this extension point.
<!ELEMENT extension (dataSource , dataSet+)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
<!ELEMENT dataSource (traceLogging? , properties?)>
<!ATTLIST dataSource
id CDATA #REQUIRED
odaVersion CDATA "2.0"
defaultDisplayName CDATA #IMPLIED
displayNameID CDATA #IMPLIED
driverClass CDATA #REQUIRED
setThreadContextClassLoader (true | false) "false">
The definition of a type of ODA data source extension for use at design time and run-time.
<!ELEMENT dataSet (dataTypeMapping+ , properties?)>
<!ATTLIST dataSet
id CDATA #REQUIRED
defaultDisplayName CDATA #IMPLIED
displayNameID CDATA #IMPLIED>
The definition of a type of data set supported by this dataSource extension.
<!ELEMENT dataTypeMapping (alternativeOdaDataType*)>
<!ATTLIST dataTypeMapping
nativeDataType CDATA #IMPLIED
nativeDataTypeCode CDATA #REQUIRED
odaScalarDataType (Date|Double|Integer|String|Time|Timestamp|Decimal) "String">
A single mapping from a data provider's native data type to one or more ODA data types. Each native data type must be mapped to a primary ODA scalar data type. The driver can optionally provide a list of alternate ODA data types to which it is capable of converting a native data type. This data type mapping facilitates all ODA consumers to map from the same set of ODA data types to its own application-specific data types.
<!ELEMENT alternativeOdaDataType EMPTY>
<!ATTLIST alternativeOdaDataType
odaScalarDataType (Date|Double|Integer|String|Time|Timestamp|Decimal) >
Provide an alternative mapping to an ODA scalar data type.
<!ELEMENT traceLogging EMPTY>
<!ATTLIST traceLogging
logLevel CDATA "WARNING"
logFileNamePrefix CDATA #IMPLIED
logDirectory CDATA #IMPLIED
logFormatterClass CDATA #IMPLIED>
Configures the ODA run-time driver's trace logging settings for the data source extension.
The configured values are passed through to the driver's implementation of the IDriver.setLogConfiguration
method.
It is up to individual ODA driver on how to honor any of these trace logging attributes as appropriate.
Note: The trace logging configuration specified in the plug-in PDE .options file would take precedence over those configured in this element, if the debug tracing flag is set to "true".
The ODA plug-in's PDE tracing options, listed below for cross reference, match the attributes of this element.
<plug-in Id>/debug = true/false
<plug-in Id>/traceLogging/logLevel
<plug-in Id>/traceLogging/logFileNamePrefix
<plug-in Id>/traceLogging/logDirectory
<plug-in Id>/traceLogging/logFormatterClass
<!ATTLIST property
name CDATA #REQUIRED
defaultDisplayName CDATA #IMPLIED
displayNameID CDATA #IMPLIED
type (string|choice) "string"
canInherit (true | false) "true"
defaultValue CDATA #IMPLIED
isEncryptable (true | false) "false">
A property whose value can be edited using the BIRT Designer at design-time. Its value is then passed to the ODA runtime driver during report generation.
<!ELEMENT propertyGroup (property+)>
<!ATTLIST propertyGroup
name CDATA #REQUIRED
defaultDisplayName CDATA #IMPLIED
displayNameID CDATA #IMPLIED>
A grouping of one or more properties in the BIRT Designer. The group attributes are for display only. All properties listed under a propertyGroup are handled as scalar properties at run-time.
<!ELEMENT propertyVisibility EMPTY>
<!ATTLIST propertyVisibility
name CDATA #REQUIRED
visibility (change|lock|hide) >
Used to set the visibility level of the named property when it is shown in the BIRT Designer's property sheet.
<!ELEMENT choice EMPTY>
<!ATTLIST choice
name CDATA #REQUIRED
value CDATA #IMPLIED
defaultDisplayName CDATA #IMPLIED
displayNameID CDATA #IMPLIED>
Choice of property values.
<!ELEMENT properties (property* , propertyGroup* , propertyVisibility*)>
A collection of property definitions in a data source extension or its supported data set definitions.
<extension id=
"Id"
name=
"Name"
point=
"org.eclipse.birt.data.oda.dataSource"
>
<dataSource odaVersion=
"2.0"
driverClass=
"org.eclipse.birt.report.data.oda.jdbc.OdaJdbcDriver"
id=
"org.eclipse.birt.report.data.oda.jdbc"
>
<properties>
<propertyGroup defaultDisplayName=
"Connection Properties"
name=
"connectionProperties"
>
<property type=
"string"
defaultDisplayName=
"JDBC Driver Class"
canInherit=
"true"
name=
"odaDriverClass"
/>
<property type=
"string"
defaultDisplayName=
"JDBC Driver URL"
canInherit=
"true"
name=
"odaURL"
/>
<property type=
"string"
defaultDisplayName=
"Data Source"
canInherit=
"true"
name=
"odaDataSource"
/>
<property type=
"string"
defaultDisplayName=
"User Name"
canInherit=
"true"
name=
"odaUser"
/>
<property type=
"string"
defaultDisplayName=
"Password"
canInherit=
"true"
name=
"odaPassword"
/>
</propertyGroup>
</properties>
</dataSource>
<dataSet defaultDisplayName=
"JdbcSelectDataSet""
id=
"org.eclipse.birt.report.data.oda.jdbc.JdbcSelectDataSet"
>
<dataTypeMapping nativeDataType=
"BIT"
nativeDataTypeCode=
"-7"
odaScalarDataType=
"Integer"
/>
<dataTypeMapping nativeDataType=
"TINYINT"
nativeDataTypeCode=
"-6"
odaScalarDataType=
"Integer"
/>
<dataTypeMapping nativeDataType=
"SMALLINT"
nativeDataTypeCode=
"5"
odaScalarDataType=
"Integer"
/>
<dataTypeMapping nativeDataType=
"INTEGER"
nativeDataTypeCode=
"4"
odaScalarDataType=
"Integer"
/>
<dataTypeMapping nativeDataType=
"BIGINT"
nativeDataTypeCode=
"-5"
odaScalarDataType=
"Decimal"
/>
<dataTypeMapping nativeDataType=
"FLOAT"
nativeDataTypeCode=
"6"
odaScalarDataType=
"Double"
/>
<dataTypeMapping nativeDataType=
"REAL"
nativeDataTypeCode=
"7"
odaScalarDataType=
"Double"
/>
<dataTypeMapping nativeDataType=
"DOUBLE"
nativeDataTypeCode=
"8"
odaScalarDataType=
"Double"
/>
<dataTypeMapping nativeDataType=
"NUMERIC"
nativeDataTypeCode=
"2"
odaScalarDataType=
"Decimal"
/>
<dataTypeMapping nativeDataType=
"DECIMAL"
nativeDataTypeCode=
"3"
odaScalarDataType=
"Decimal"
/>
<dataTypeMapping nativeDataType=
"CHAR"
nativeDataTypeCode=
"1"
odaScalarDataType=
"String"
/>
<dataTypeMapping nativeDataType=
"VARCHAR"
nativeDataTypeCode=
"12"
odaScalarDataType=
"String"
/>
<dataTypeMapping nativeDataType=
"LONGVARCHAR"
nativeDataTypeCode=
"-1"
odaScalarDataType=
"String"
/>
<dataTypeMapping nativeDataType=
"DATE"
nativeDataTypeCode=
"91"
odaScalarDataType=
"Date"
/>
<dataTypeMapping nativeDataType=
"TIME"
nativeDataTypeCode=
"92"
odaScalarDataType=
"Time"
/>
<dataTypeMapping nativeDataType=
"TIMESTAMP"
nativeDataTypeCode=
"93"
odaScalarDataType=
"Timestamp"
/>
<dataTypeMapping nativeDataType=
"BINARY"
nativeDataTypeCode=
"-2"
odaScalarDataType=
"String"
/>
<dataTypeMapping nativeDataType=
"VARBINARY"
nativeDataTypeCode=
"-3"
odaScalarDataType=
"String"
/>
<dataTypeMapping nativeDataType=
"LONGVARBINARY"
nativeDataTypeCode=
"-4"
odaScalarDataType=
"String"
/>
<dataTypeMapping nativeDataType=
"BOOLEAN"
nativeDataTypeCode=
"16"
odaScalarDataType=
"Integer"
/>
</dataSet>
</extension>
Copyright (c) 2004-2005 Actuate Corporation. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html