Eclipse BIRT Report Object Model (ROM)
ColumnHint Structure
Structure Overview
Provides a number of
report-related data attributes about a result set column.
Details
Display Name: |
Column Hint |
Since: |
1.0 |
Property Summary
- ACLExpression
- action
- alias
- Provides an "alias" name to the column for use within the report.
- analysis
- Determines how the column is used when exporting the data to an OLAP cube.
- columnName
- The name of the result set column for which hints are defined.
- description
- descriptionID
- displayLength
- displayName
- The optional localizable display name for the column.
- displayNameID
- export
- Determines how the column will be used when exporting data.
- format
- The format string used to format the column data when displaying the value in the search result UI.
- heading
- headingID
- helpText
- The optional localizable descriptive text that explains the column to the end user.
- helpTextID
- horizontalAlign
- onColumnLayout
- parentLevel
- Specifies the parent of the column when exporting the data to an OLAP cube.
- searching
- Indicates how the column will be used when searching.
- textFormat
- wordWrap
Description
A column hint defines report-related data attributes
about a retrieved column or a computed column.
Property Detail
Details
Type: |
expression |
Context: |
|
Expression Type: |
None |
Since: |
2.5.2 |
Required: |
No |
Display Name: |
ACL expression |
JavaScript Type: |
|
Default Value: |
None |
Runtime Settable: |
No |
Details
Type: |
Action Structure |
Since: |
2.5.2 |
Required: |
No |
Display Name: |
Action |
JavaScript Type: |
|
Default Value: |
None |
Runtime Settable: |
No |
Provides an "alias" name to the column for use within the report.
Details
Type: |
string |
Since: |
1.0 |
Required: |
No |
Display Name: |
Alias |
JavaScript Type: |
|
Default Value: |
None |
Runtime Settable: |
No |
Description
Provides an "alias" name to the column for use within the
report. Useful if the column names are awkward. Optional.
Determines how the column is used when exporting the data to an OLAP cube.
Details
Type: |
choice (analysisType) |
Since: |
2.5.1 |
Required: |
No |
Display Name: |
Analysis |
JavaScript Type: |
|
Default Value: |
None |
Runtime Settable: |
No |
Choices
Name | Display Name |
Value | Description |
dimension |
Dimension |
dimension |
The column is a dimension. Use the Parent Dimension
property to define the dimension hierarchy. |
attribute |
Attribute |
attribute |
The column provides additional information about a
level. Use the Parent level property to define the level for
which this column is a detail. |
measure |
Measure |
measure |
The column is numeric measure. |
Description
Determines how the column is used when exporting the data
to an OLAP cube. OLAP cubes require that the columns be structured into
dimension hierarchies. Such hierarchies are formed though a sequence of
dimensions. The intersection of hierarchies has one or more numeric measures.
Columns that are neither dimensions nor measures can be detail attributes
associated with a dimension. Whether any given column is actually available for
use with analysis depends on the Export property above.
The name of the result set column for which hints are defined.
Details
Type: |
string |
Since: |
1.0 |
Required: |
Yes |
Display Name: |
Column Name |
JavaScript Type: |
|
Default Value: |
None |
Runtime Settable: |
No |
Description
This property keys the column hint to a column within the
result set. The name is defined either by the data provider, a result set column
definition, or a computed column definition.
Details
Type: |
string |
Since: |
2.5.2 |
Required: |
No |
Display Name: |
Description |
JavaScript Type: |
|
Default Value: |
None |
Runtime Settable: |
No |
Details
Type: |
resourceKey |
Since: |
2.5.2 |
Required: |
No |
Display Name: |
Description Resource Key |
JavaScript Type: |
|
Default Value: |
None |
Runtime Settable: |
Yes |
Details
Type: |
integer |
Since: |
2.5.2 |
Required: |
No |
Display Name: |
Display Length |
JavaScript Type: |
|
Default Value: |
None |
Runtime Settable: |
No |
The optional localizable display name for the column.
Details
Type: |
string |
Since: |
1.0 |
Required: |
No |
Display Name: |
Display Name |
JavaScript Type: |
|
Default Value: |
None |
Runtime Settable: |
No |
Description
The name displayed to the end-user for the column. The
display name can be localized. If the display name is omitted, the column name
itself is displayed instead.
Details
Type: |
resourceKey |
Since: |
1.0 |
Required: |
No |
Display Name: |
Display Name Resource Key |
JavaScript Type: |
|
Default Value: |
None |
Runtime Settable: |
Yes |
Determines how the column will be used when exporting data.
Details
Type: |
choice (exportType) |
Since: |
reserved |
Required: |
No |
Display Name: |
Export |
JavaScript Type: |
|
Default Value: |
if-realized |
Runtime Settable: |
No |
Choices
Name | Display Name |
Value | Description |
none |
No Export Type |
none |
The column cannot be exported. |
if-realized |
If Realized |
if-realized |
The column can be exported only if it is referenced
somewhere in the report. |
always |
Always |
always |
The column can always be exported. This setting acts
like a column reference, and forces the column to be realized even if the
column is not otherwise used within the report. |
Description
Determines how the column will be used when exporting
data.
The format string used to format the column data when displaying the value in the search result UI.
Details
Type: |
string |
Since: |
reserved |
Required: |
No |
Display Name: |
Format |
JavaScript Type: |
|
Default Value: |
None |
Runtime Settable: |
No |
Description
An optional BIRT format string used to format the column
data when displaying the value in the viewing UI, especially within the search
results.
See Also
Details
Type: |
string |
Since: |
2.5.2 |
Required: |
No |
Display Name: |
Heading |
JavaScript Type: |
|
Default Value: |
None |
Runtime Settable: |
No |
Details
Type: |
resourceKey |
Since: |
2.5.2 |
Required: |
No |
Display Name: |
Heading Resource Key |
JavaScript Type: |
|
Default Value: |
None |
Runtime Settable: |
Yes |
The optional localizable descriptive text that explains the column to the end user.
Details
Type: |
string |
Since: |
1.0 |
Required: |
No |
Display Name: |
Help Text |
JavaScript Type: |
|
Default Value: |
None |
Runtime Settable: |
No |
Description
Additional pop-up help text associated with the column.
This descriptive text can explain the purpose of the column to the end user.
The help text can be localized.
Details
Type: |
resourceKey |
Since: |
1.0 |
Required: |
No |
Display Name: |
Help Text Resource Key |
JavaScript Type: |
|
Default Value: |
None |
Runtime Settable: |
Yes |
Details
Type: |
choice (textAlign) |
Since: |
2.5.2 |
Required: |
No |
Display Name: |
Horizontal Alignment |
JavaScript Type: |
|
Default Value: |
None |
Runtime Settable: |
No |
Choices
Name | Display Name |
Value | Description |
left |
Left |
left |
|
center |
Center |
center |
|
right |
Right |
right |
|
justify |
Justify |
justify |
|
Details
Type: |
boolean |
Since: |
2.5.1 |
Required: |
No |
Display Name: |
On Column Layout |
JavaScript Type: |
|
Default Value: |
None |
Runtime Settable: |
No |
Specifies the parent of the column when exporting the data to an OLAP cube.
Details
Type: |
string |
Since: |
reserved |
Required: |
No |
Display Name: |
Parent Level |
JavaScript Type: |
|
Default Value: |
None |
Runtime Settable: |
No |
Description
Used when a column�s Analysis property is set to
Dimension or Detail. For Dimensions, this property establishes the dimension
hierarchy. Lower (more detailed) dimensions identify their parent (more general)
dimensions. For details, this property identifies the dimension for which this
column is a detail attribute.
Indicates how the column will be used when searching.
Details
Type: |
choice (searchType) |
Since: |
reserved |
Required: |
No |
Display Name: |
Searching |
JavaScript Type: |
|
Default Value: |
any |
Runtime Settable: |
Yes |
Choices
Name | Display Name |
Value | Description |
any |
Any |
any |
The column is always searchable, whether it is indexed
or not. |
indexed |
Indexed |
indexed |
The column is searchable if it is indexed. |
none |
No Search Type |
none |
The column is not searchable. |
Description
Indicates how the column will be used when searching.
Details
Type: |
choice (stringFormat) |
Since: |
2.5.2 |
Required: |
No |
Display Name: |
Text Format |
JavaScript Type: |
|
Default Value: |
None |
Runtime Settable: |
No |
Choices
Name | Display Name |
Value | Description |
Unformatted |
Unformatted |
Unformatted |
|
> |
Uppercase |
> |
|
< |
Lowercase |
< |
|
Zip Code |
Zip Code |
Zip Code |
|
Zip Code + 4 |
Zip Code + 4 |
Zip Code + 4 |
|
Phone Number |
Phone Number |
Phone Number |
|
Social Security Number |
Social Security Number |
Social Security Number |
|
Custom |
Custom |
Custom |
|
Details
Type: |
boolean |
Since: |
2.5.2 |
Required: |
No |
Display Name: |
Word Wrap |
JavaScript Type: |
|
Default Value: |
None |
Runtime Settable: |
No |