Index Symbols Numerics A - Pearsoncmg.com

613

I n d e x

Symbols! formatting symbol 151" (double quotation mark) character

concatenation and 48filter conditions and 268format patterns and 143SQL statements and 88text file data sources and 74

" " as empty string 244" " as literal space character 246% (percent) character 234% operator 164, 165% wildcard character (SQL) 88& formatting symbol 151&& operator 254+ operator 98, 246, (comma) character 73, 246. (period) character 250/ (forward slash) character 249; (semicolon) character 239< formatting symbol 151= operator 268== operator 268, 272> formatting symbol 151? (question mark) character 250, 280@ formatting symbol 151_ wildcard character (SQL) 88{} (curly braces) characters 91| | operator 254, 272… button

chart titles and 430defined 572expression builder and 99externalized text and 547

hyperlink options and 498legend text and 438resource keys and 545run-time connections and 78sorting data and 182text file connections and 76XML files and 77

’ (single quotation mark) character 74, 268

Numerics3-D charts

coloring areas in 420curve fitting and 453formatting 456rotating axes in 456selecting as type 374setting inset values for 422setting series depth in 455spacing series in 457transposing axes values and 411

Aabsolute formatting 158absolute paths 93abstract base class 553accessing

BIRT RCP Report Designer 25BIRT Report Designer 11, 24chart builder 358data 22, 67, 73, 76Data Explorer 64data set fields 127databases 67, 77expression builder 99, 240

birt-print-1.book Page 613 Wednesday, October 4, 2006 5:23 PM

614 I n d e x

accessing (continued)installation demo 5JavaScript functions and operators 138JDBC data sources 67JDBC driver manager 71Navigator 203Property Editor 43report designs 29report elements 28, 527, 529report libraries 526report templates 517, 538sample database 36text file data sources 73, 75XML data sources 76XML editor 29

Action pick list 509actions 508, 509Active Server Pages. See ASPsad hoc reports 275Add Group command 185, 197Add Image button 131Add Library command 526Add Library dialog 526Add Line button 441Add Range button 441Add Region button 465addDate function 254adding

aggregate values 222–223alternate values 173–174background images 379, 418, 490charts 117, 351, 373column bindings 109column headings 121, 134computed fields 99, 128, 129custom formats 148, 149, 151data elements 40, 134data set fields 125, 127, 147data set parameters 281–284database drivers 70database URLs 72design templates 534dynamic text elements 134, 138, 139expressions 238, 239filter conditions. See filter conditionsflat file data sources 75, 76formatting rules 159–161, 162, 163grid elements 118, 333

group header rows 211group headings 199–202, 213groups 185, 195, 197, 207HTML tags 140, 141hyperlinks 497–502images to backgrounds 490, 492images to designs 129, 130, 131images to master pages 487JavaScript expressions 209, 238, 240JDBC data sources 68label elements 134, 139libraries to designs 515, 518, 520list elements 117, 124, 323map rules 173master pages 478, 493, 494, 532multiple data sources 64page breaks 478, 484page headers and footers 57, 118passwords 69pictures to fields 175projects 32report elements 40, 117, 125report parameters 277, 279report sections 118report titles 50, 118, 134, 135resource files 544, 550resource keys 542, 545run-time parameters 280, 281sort keys 182, 194source code 23styles 46, 153, 154, 155summary values 187table elements 40, 117, 120, 519table of contents 215, 503tables to queries 87text elements 134, 140, 519text messages 175, 177user names 69watermarks 491XML data sources 76

addition 243aggregate data. See aggregate valuesaggregate expressions

applying to groups 230creating 224–226creating charts and 385, 405creating column bindings and 107, 110defined 553


I n d e x 615

aggregate expressions (continued)entering in expression builder 226filtering data and 265

aggregate functionsaccessing 226, 241arguments in 225, 227defined 553filter expressions and 227listed 221null values and 228

aggregate valuesadding 222–223calculating 220, 224–226calculating percentages and 231creating summary reports and 234, 235defined 554displaying 210, 219excluding null values from 228filtering 227–229, 265retrieving from groups 229, 231

aggregating data 219, 220, 224, 385aliases 96, 554aligning

background images 492blocks of content 119, 120data in subreports 314elements in tables or grids 165–166report elements 119text 147, 165, 431

alignment, changing 165alignment buttons 431alignment defaults 165Allow blank values property 288, 298Allow null value property 288, 298alternate names. See aliases; display namesalternate values 173–174alternating colors 163–165Always Excluding First value 479Always Excluding Last value 479Always value 479analyzing data 275ancestor classes 554

See also superclassesanchor settings

chart areas 424chart titles 432legends 435plot areas 427

And operator 254Any data type 109Apache Derby driver 69APIs. See application programming

interfacesAppContext objects 76applets 554application programming interfaces

(APIs) 555application window

BIRT RCP Report Designer 26BIRT Report Designer 25

applications 275, 379, 554See also multithreaded applications

Apply Style command 158archive files

See also jar files; war filesBIRT packages in 3downloading 10, 11, 13unpacking 5, 10

area chartsSee also chartschanging series type in 449curve fitting and 453defining axes values for 406defining axis titles for 439defining data series for 389–392formatting data series for 457–458overview 375stacking series in 455

Area Format dialog 426, 427Area Including Axes options 426Area Within Axes options 426arguments 91, 555

See also functions; parametersarrays 555arrow button (Sorting) 182, 194arrow cursor 125Ascending option 183, 187, 195ascending sort order 183, 187, 195ASCII files 543

See also text filesaspect ratios (charts) 467ASPs 553assignment statements 555asterisk (*) character 250attribute paths 93


616 I n d e x

attributesfonts 147, 431run-time connections and 78XML data sets and 92, 95, 260

authentication 77author 486, 487Author# element 487Auto value (content type) 139Auto value (page breaks) 479automatic binding 122AutoText elements 487Available Column Bindings category 241Available Data Sets category 242ave function 221averages 220, 221, 228Avoid value 479axes values

See also chartsadding grid lines for 443, 445adjusting tick position for 444changing 405changing line styles for 444changing spacing around 428changing tick marks for 444creating 371, 405–411defining multiple 410flipping 376formatting 407, 425, 439hiding labels for 442, 447highlighting 440intersecting 408outlining 426positioning data relative to 406positioning tick marks for 443restrictions for 406rotating labels for 446scaling 409–410setting background colors for 426setting interactive options for 507staggering labels for 446transposing 411

axis label format options 448axis labels 407, 415, 445–448

See also data point labelsaxis lines 443–445

See also tick marksaxis markers

See also markers (charts)

creating 440–441formatting 441–442outlining 442

axis rotation 456axis scale options 409, 410Axis section (Format Chart) 371axis titles 439axis types 407

BBackground Color property 47, 163, 164background colors

alternating 163, 164axis labels and 448axis titles and 440background images and 491cascading styles and 154chart areas and 417, 425, 431chart legends and 433chart titles and 431curve-fitting labels and 454customizing 419data point labels and 473group headers and 201, 211marker labels and 443styles and 46

background imagesadding to charts 379, 418adding to master pages 490–492repeating 491, 492repositioning 492selecting 418

Background pick list 417, 418Background repeat property 492bar charts

See also chartschanging bar spacing for 424changing series type in 449coloring data series for 450curve fitting and 453defining axes values for 406defining axis titles for 439defining data series for 389–392formatting data series in 459overview 376stacking series in 455

bar colors 379, 450, 471bars (charts) 424, 459


I n d e x 617

base values (groups) 190, 191Between operator 269BIGDECIMAL type indicator 74binding

data set parameters to report parameters 281–284

data sets to images 132data sets to lists 125, 142data sets to reports 105data sets to tables 122–123, 142parameters to data sources 78parameters to linking fields 316, 327, 331textual elements to data sets 138, 142

Binding page 108, 122, 225binding properties 78, 122

See also column bindingBinding tab 122BIRT xviii, 556BIRT Chart Engine 556BIRT Demo Database 557

See also Classic Models sample databaseBIRT Demo Database package 10BIRT documentation xxi, xxiiBIRT extensions 557

See also extensionsBIRT Functions category 226, 241BIRT open source projects. See projectsBIRT RCP Report Designer

See also BIRT Report Designer; rich client platforms

defined 558documentation conventions for 24downloading packages for 3installing 12–14opening designs from 203prerequisites for 3removing cached pages for 14running projects and 22software requirements for 5starting 15, 25testing installations for 14updating 18

BIRT RCP Report Designer package 18BIRT Report Designer

See also designsalignment defaults for 165automatic binding and 122, 123compatibility with Eclipse 6, 7

configuring 7CSS specification for 156data sources supported for 63default master page for 23defined 557design views for 26–28downloading packages for 3drivers installed with 69filtering data with 262, 265, 272formatting options for 145, 146, 152, 159grouping defaults for 187, 199installing 9–11laying out reports and 22, 115, 117localization process for 542opening designs from 203output formats for 30overview 23predefined styles for 153, 156, 158prerequisites for 4removing cached pages for 14rule evaluation precedence for 162software requirements for 6–7sorting data with 181, 183spacing options in 166, 170starting 11, 15, 24testing installations for 11troubleshooting connections for 80

BIRT Report Designer Full Eclipse Install 5, 11–12

BIRT Report Designer perspective 11BIRT Report Engine 13, 557BIRT Report Engine package 10BIRT Samples package 10, 558BIRT technology 558BIRT Test Suite 558BIRT web site xixBIRT.exe 14, 25blank expressions 395blank lines (delimited text files) 74blank report designs 35blank rows and columns

deleting 120inserting 168, 340

blank space 48, 168See also padding; spacing

blank values 288, 290, 297, 298block-level elements 48Blur event type 509


618 I n d e x

BMP files 379bold text style 147bookmarks 505, 555Boolean expressions 175, 254–255, 555Boolean values 221, 254Border property 215, 346borders

adding to tables 346adjusting spacing for 170, 347cascading styles and 154formatting properties and 145grouping data and 201, 215

Borders property 170bottom n logic filters 267bottom n summary reports 235breakpoints 556bridge class 556bridge driver 69browsers. See web browsersbug reports 8builds 7, 10, 12, 13bulleted lists 134Business Intelligence and Reporting

Tools xviii, 556See also BIRT

buttons. See radio buttonsBy distance pick list 469

Ccache 80, 103Cache and use first option 104cache conflicts 14Cache data set data property 103Cache entire data set option 104Cache Preference options 103cached pages 14caching data 97, 103calculated columns. See computed fieldscalculated values. See computed valuescalculations

aggregation and 219, 220, 222, 224, 227, 385

column bindings and 107computed fields and 98, 99, 127, 128, 129dates and 253, 254defining textual information and 133filter expressions and 267null values in 228

operator precedence and 242percentages and 231–234planning for 55static and dynamic values in 135updating 107, 108verifying 98

callback classes 509Callback option 509Candle Fill pick list 471candlestick markers (charts) 379, 400, 471capitalization 151, 238, 252

See also casecartesian join 87Cascading Parameter Name property 303,

305cascading parameters 301–307, 559cascading style sheets

applying to text elements 140creating styles and 154defined 559formatting reports and 145, 152importing 156, 157reusing 57

cascading styles (BIRT) 154, 156case 151case conversions 183case sensitivity 111, 238, 560case-insensitive searches 252case-insensitive sorting 44, 183catalogs 129category 560

See also chartsCategory (X) Series property 386category axis 406Category Definition property 354category series

See also data serieschanging settings for 369coloring 450, 452defined 382formatting 448grouping data for 405sorting data for 403specifying chart type and 389, 393, 395,

400viewing settings for 369

category series expressions 354Category Series section (Format Chart) 369

birt-print-1.book 18 Wednesday, October 4, 2006 5:23 PM

I n d e x 619

category values 403, 404, 405, 560cells

See also grid elements; table elementsaligning values in 165, 166defined 560displaying group headings and 200, 201dropping 200, 201merging 172placing report elements in 119, 246selecting 49viewing placement of 340

centering background images 492CGI (defined) 563changing

alignment defaults 165chart titles 358, 430column-binding names 106column bindings 111column headings 45, 335column names 97, 351connection properties 65date formats 336default names 64, 65expressions 137formatting rules 161images 129labels 139master pages 486number formats 338output columns 96page headers and footers 487queries 281, 530report elements 527, 538report parameters 289resource files 550resource keys 550styles 158, 519text 245, 487text formats 140

character formats 134See also text attributes

Character Large Objects (CLOBs) 134character patterns 249, 251, 260, 267, 597character sets 76, 560character strings. See stringscharacters

accessing text files and 73converting case 151, 183

defined 560defining custom formats and 148, 151defining descriptive names and 107finding 248, 249, 251grouping by interval 189matching sequence of 88, 249–252matching single 88sorting 183

charAt function 202, 248Chart Area section (Format Chart) 370, 417chart areas 416, 423

setting interactive options for 507chart builder 349, 358, 365chart designs 356, 358, 413chart elements 117, 351, 507, 519, 561

See also chartschart engine 556chart engine package 10Chart Floor pick list 420chart legends. See legendschart preview preferences 413Chart Preview section (Select Data) 356, 412chart style (predefined) 153chart subtypes 365, 374chart title interactivity options 507Chart Title property 358chart types 351, 365, 374Chart Wall property 420Chart.rptdesign 350charting application sample plug-ins 558charting extensions 561charting library. See chart enginecharts

See also chart elements; specific chart type or part

adding to reports 117, 351, 373adding ToolTips to 509adjusting spacing in 416, 421, 427aggregating values for 385–386anchoring areas in 424, 427, 432, 435applying styles to 474assigning resource keys to 546–548building combination 403, 448, 449changing layouts for 416changing output formats for 380creating 349, 423, 429, 443, 451

tutorial for 349–364customizing 415


620 I n d e x

charts (continued)defined 560defining axis type for 407defining series type for 449displaying 350filtering data in 385filtering data rows for 263formatting areas in 416, 474formatting three-dimensional 456formatting values in 367, 387–389grouping data for 404–405hiding areas in 423, 430highlighting areas in 419highlighting values in 440, 509interactive features for 379, 497, 505–511linking to reports 510–511localizing 542, 546, 548missing labels in 446outlining areas in 419overview 349, 381, 415parts described 415previewing 356, 357, 412removing resource keys for 548resizing 357rotating 456selecting data sets for 353, 373, 384setting background colors for 417–418setting background images for 379, 418sorting data for 403specifying inset settings for 422specifying output formats for 365, 379specifying type 351, 365, 374viewing parameters for 385viewing sample data for 384, 413, 414with depth 374, 420, 448, 455

cheat sheet property 536class hierarchy 561class names 561class variables 562

See also instance variables; variablesclasses

aggregating data and 220defined 561formatting data and 148, 149selecting driver 69, 71

Classic Models sample databaseSee also demo databasebuilding charts and 350

building listing reports and 32connecting to 318creating queries for 332specifying as data source 37specifying connection information for 36

–clean option 14, 80client area inset settings 424client sections (charts) 422, 424CLOB fields 136, 138CLOBs 134closing values, plotting 379, 400code

editing 29, 558expressions as 239loading 585referencing columns and 96testing and debugging 23, 558

Code page. See script editorcode points 183, 562Color By pick list 451color palette (charts) 448, 451, 452color picker (charts)

category series and 452chart backgrounds and 417, 419plot areas and 426, 427

colorsalternating row 163–165axis labels and 448axis lines and 444axis titles and 440background images and 491candlesticks 471cascading styles and 154chart areas and 416, 423, 425, 431chart backgrounds and 417–418chart legends and 433chart markers and 442chart outlines and 419chart shadows and 427chart titles and 431chart wall or floor and 420conditional formatting and 158, 162curve-fitting lines and 453, 454customizing 418data point labels and 473data series and 367, 450, 452dial regions and 466font properties and 147


I n d e x 621

colors (continued)formatting properties and 145grid lines and 445group headers and 201, 211marker labels and 443meter charts and 463styles and 46tick marks and 443, 445, 463

column aliases 96column binding 106–112, 129, 142, 241, 563column-binding expressions 106, 107, 109,

111column-binding information 108, 122, 241column-binding names 105, 106, 107, 109,

111column boundaries 169column headings

adding display names for 96, 97adding to designs 121, 134changing 45, 335formatting 45, 152localizing 542

Column Mapping dialog 95, 262Column Mapping page 95column mapping properties 95Column Mapping section (Edit Data

Set) 261Column Name property 99column names 73, 88, 96, 97, 351

See also column headingscolumn properties 169column widths 168, 169columnar layouts 118, 120, 171column-level attributes (XML) 93, 95column-level elements (XML) 95columns

See also fields; computed fieldsaccessing multiple data sets and 100, 102accessing multiple tables and 86, 87adding to designs 119, 171defined 562defining output 96defining relational structures for 92defining XML data mappings for 93, 95deleting 120displaying 88generating computed values and 98, 99mapping to 260

renaming 96, 97, 351resizing 168, 169retrieving 85, 91, 97selecting 40, 91setting up text file data sources and 73sorting values in 182spacing report elements with blank 344viewing values in 237

combination charts 402, 448, 449, 453combo boxes

adding values for 290–296creating dynamic lists for 291, 294creating static lists for 291formatting values for 288, 296, 297setting default values for 289, 294, 296setting maximum number of values

for 296sorting values for 294testing values in 309

comma (,) character 73, 246comma-separated values 73

See also CSV filesCommon Gateway Interface 563communications protocol 596company logos 129company names 486comparison operators 254, 268, 272comparison test conditions 259, 266comparisons

Boolean expressions and 254charts and numeric 378delimited text files and 74filter expressions and 259, 266, 272

computed columns. See computed fieldscomputed data. See computed valuescomputed fields

adding to data sets 98–100creating 128, 129defined 563displaying dynamic values from 134entering expressions for 99, 128group headings and 202naming 99overview 127previewing 100verifying expressions for 98

computed values 98, 107, 242, 267, 563See also calculations; computed fields


622 I n d e x

concatenation 48, 98, 128, 246, 247concatenation operator 98, 246conditional expressions 141, 266

See also Boolean expressionsconditional formatting 158, 163conditional logic filters 266conditions

adding multiple formatting rules and 162adding to queries 258alternating colors and 163displaying report elements and 255filtering with. See filter conditionsformatting with 158–163hiding report elements and 175, 177mapping data values and 173sorting data and 193testing 280

confidentiality statements 486configuration files 563configuring BIRT Report Designer 7connection information. See connection

propertiesConnection objects 564connection parameters 77, 78, 80connection properties

accessing databases and 67changing 65prompting for 78setting JDBC data source 68setting text file data source 75setting XML data source 76specifying at run time 77

connectionsassociating with parameters 78overview 63setting up run-time 77–79testing 69troubleshooting 79

constants 564constructor code 564container elements 118, 126, 127containers 117, 153, 340, 564containment 564containment hierarchy 564content. See structured contentContent type property 139conversions

case 151, 183

numbers to strings 244strings to numbers 252

converters 564copying

database drivers 71resource files 543

copyright information 153, 486, 502count function 221, 226, 227, 228countDistinct function 221, 228counting rows 221, 222, 228counting unique values 221Create Template Report Item command 536Create Template Report Item dialog 536creating

aggregate expressions 224–226cascading parameters 301–307charts 349, 423, 429, 443, 451

tutorial for 349–364column bindings 108, 109column headings 134computed fields 99, 128, 129custom formats 148, 149, 151data groups 57, 183, 184, 195, 197data set parameters 281–284data sets 77, 81, 82

tutorial for 37data sources 64, 67, 76, 77expressions 128filter conditions. See filter conditionsflat file data sources 75, 76formatting rules 159–161, 162, 163grids 117, 119, 171, 519group headers 211group headings 199–202, 213grouped reports 184hyperlinks 497–502JavaScript expressions 238, 240joins 86, 100, 101labels 134, 139libraries 517, 522–524, 528lists 117, 121, 124, 134, 290map rules 173master pages 478, 493, 494, 532master reports 323page layouts 57, 117, 477parameter groups 298, 299, 301pictures for conditional values 175projects 22, 32


I n d e x 623

creating (continued)queries. See queries; SQL statementsreport design files 29, 350report designs 22, 516report parameters 277, 278–280, 285report sections 118report templates 516, 517, 534report titles 50, 118, 134, 135reports 22, 34, 58, 234, 542resource files 542, 544, 550resource keys 542, 545run-time parameters 280, 281stored procedures 89styles 46, 153, 154, 155subreports 125, 316, 325, 329

examples for 312, 313summary reports 234–236table of contents 215, 503–505tables 171, 325, 329text messages 175, 177watermarks 491XPath expressions 92–94

credentials 77CRLF escape code 74cross tabs 564cross tabulation. See cross tabs; cross-tab

reportscross-tab reports 564CSS files 157, 559

See also cascading style sheetsCSS specifications 156CSV files 73, 74, 511curly braces ({}) characters 91Currency format type 148currency values 56, 135, 147current date 128, 253, 486Curve Fitting Line dialog 453, 454curve-fitting labels (charts) 454curve-fitting lines (charts) 452–454Custom Color button 418custom color picker (charts) 419custom data sources. See open data accesscustom format patterns 388, 389Custom Style property 47, 156Customers.rptdesign 35, 203Customers_grouped.rptdesign 204customizing

background colors 419

charts 415data 146, 175date formats 149, 389master pages 485–494number formats 148, 388page layouts 516report elements 145, 152, 520, 524report templates 534–536string formats 151styles 47, 156time formats 389

Ddata

See also data elements; valuesaccessing 22, 67, 73, 76adding textual information and 133aggregating 219, 220, 224, 385analyzing 275caching 97, 103combining dynamic and static 134, 135,

141, 142, 224creating lists and 123, 124creating tables and 120, 121customizing 146, 175defined 565defining relational structures for 85, 92detecting patterns in 452, 453displaying 105, 115, 136, 237, 485, 497exporting 511–513filtering. See filters; filteringformatting 23, 145, 146, 158, 387

tutorial for 44grouping. See grouping data; groupshighlighting 23, 215, 335limiting retrieval of 85, 257, 258mapping to alternate values 173–174organizing 56, 115planning for 53, 54plotting 381, 404, 405, 407previewing 97reordering 179, 180retrieving 63, 81, 89returning from expressions 137returning values at run time 120selecting 85sorting. See sorting dataviewing relationships between 349, 452


624 I n d e x

data binding. See column bindingdata elements

See also dataadding expressions to 137adding to designs 40, 134, 519aligning text in 165changing group order and 197, 199creating column bindings for 109creating hyperlinks with 501creating report titles and 135defined 117, 565displaying aggregate values and 224, 225,

234displaying alternate values for 173displaying date values and 149, 336displaying string values and 150formatting numeric values in 136, 147,

338formatting static text in 135increasing spacing between 340placing in lists 124placing in tables 121selecting 340viewing placement of 340

Data Exploreradding data sets to 38, 82adding JDBC drivers and 70adding parameters to 279changing connection properties and 65creating cascading parameters and 303,

305creating column headings for 96creating data sources and 36, 64creating run-time connections and 78defined 565grouping parameters and 299, 308opening 64overview 28placing data set fields from 125, 127removing data sets from 84reordering parameters in 308

Data Explorer command 64data filters

See also filteringadding to designs 265, 268, 270applying 257, 385creating 262defined 576

defining aggregate expressions for 265defining JavaScript expressions for 262defining XPath expressions for 260, 261,

262matching string patterns and 249setting at run time 277, 278, 285setting conditions for. See filter conditionsspecifying parameters as 277, 285, 286

data point labels 449, 472–473data points

See also chartsadding multiple sets of 390arranging 381, 406, 454changing labels for 472charting logarithmic values and 407charting text values and 407defined 566formatting labels for 449, 472, 473hiding 509highlighting 440, 443identifying 449setting interactive features for 509

Data Preview section (Select Data) 384, 387, 412

data rows 566See also rows

data seriesSee also chartsadding values to legends 437adjusting depth 455adjusting widths 422changing type 449coloring 450–452creating combination charts and 402, 448defined 603defining translucent 449displaying pie sectors and 354displaying type 369, 455entering expressions for 383, 386, 391formatting 448–471grouping data for 405hiding 449linking to 510plotting 375, 382setting interactive features for 506, 507setting up 383, 389sorting 403spacing 457


I n d e x 625

data series (continued)stacking 454stretching markers for 455

data series markers. See markers; tick marksdata series types 448, 449, 455data set cache 103Data Set Editor 98data set elements 518data set fields 127, 238

See also columns; fieldsData Set Name property 82, 90, 91, 94data set parameters

See also parametersassigning data types to 282binding to report parameters 281–284creating 281–284defined 566displaying 282, 385linking subreports and 315, 327, 331naming 282saving 284

Data Set Type property 82, 90data sets

accessing fields in 127adding computed fields to 98–100adding to designs 127adding to libraries 524associating images with 132associating with data sources 82, 90, 94,

102binding textual elements to 138, 142binding to lists 125, 142binding to reports 105binding to tables 122–123, 142changing data sources for 84changing number of rows in 97creating 77, 81, 82

tutorial for 37defined 566defining cascading parameters and 303defining queries for 38, 87, 281, 282deleting 84displaying binding information for 123displaying data in 121, 124, 127, 134displaying fields in 238, 242filtering 263, 265, 268grouping values in 190, 204importing values from 291, 292, 293

joining 100, 101limiting rows returned in 258, 259, 261linking subreports and 314, 315

tutorial for 318, 320, 322localizing text from 542naming 82, 90, 91, 94plotting multiple 398previewing 97, 103, 269removing data sources and 66returning from

JDBC data sources 87stored procedures 89text files 76, 91XML data sources 92, 94

saving 83selecting columns for 40selecting for charts 353, 373, 384setting cache size for 103setting properties for 82setting up output columns for 96sorting values in 181testing 23troubleshooting 80verifying 97

data source elements 518, 524See also data sources

Data Source Name property 68, 75, 76data source objects 64, 566

See also data sourcesData Source property 82, 90, 91, 94data sources

See also specific data source typeaccessing data in 22, 63, 67, 73, 76adding to designs 64associating with data sets 82, 90, 94, 102binding parameters to 78building multiple projects and 64changing connection properties for 65changing data sets for 84changing default names for 64, 65charts and 381, 385, 404, 406combining data from multiple 100connecting to. See connectionscreating 64, 67, 76, 77

tutorial for 36, 318defined 566filtering data in 258, 260, 265, 277limiting data returned from 257


626 I n d e x

data sources (continued)naming 65overview 64placing in libraries 64removing from designs 66retrieving data from 81, 82, 127, 179selecting 65sorting and 181specifying type 65troubleshooting 79

data streams 76data type indicators 74Data Type property 99data types

accessing text files and 74, 76assigning to parameters 279, 282building charts and 404, 407creating JavaScript expressions and 238defined 567selecting for computed fields 99setting column binding 109

database drivers 69, 70See also JDBC drivers

database management systems 567database schemas 87, 88, 602Database URL property 69, 72database URLs 67, 69, 72databases

See also Classic Models sample database; data sources

accessing data in 67, 77building stored procedures for 89connecting to 68creating queries for 87–89displaying tables in 87displaying views in 88filtering data in 257, 258, 278–284joining tables in 86, 100, 101retrieving data from 85selecting null or blank values from 297sorting and 181, 183

date axis type 407DATE data type 74date elements 487

See also datesdate expressions 252–254, 387, 389date fields 280date format options 389

date formatschanging 253, 336, 487charting expressions and 387, 389customizing 149, 150, 389setting 149

Date function 253date functions 241, 252DATE type indicator 74date values

See also date elementsadding or subtracting from 254adding to group headings 199, 202adding to headers and footers 57, 487calculating days between 253creating locale-specific reports and 56,

149defined 567defining as text 133, 134defining report parameters for 280displaying current 128, 253, 486formatting 149–150, 389grouping by interval 191, 192grouping in charts 404, 405parsing 253plotting 405, 406reformatting 336, 487

Date# element 487date-and-time data type 567DateTime property 253DateTimeSpan functions 241, 252, 253DBMS (defined) 567debugging 23, 308, 567decimal places 148, 388DecimalFormat class 148declarations 567default alignment 165default column binding 106default data type 109default formats 153default master page 23, 485, 494default themes 523Default value property 288default values

assigning to parameters 288, 289creating user-selection lists and 290designing master pages and 23specifying 277, 294

Define Custom Colors button 419


I n d e x 627

definitions 553Delete command 66, 84, 120deleting

cached information 14chart legends 359column bindings 111columns or rows from grids 120data set fields 123data sets 84data sources 66formatting rules 163headers 489, 490image files 130JDBC drivers 72resource keys 546, 548, 550styles 158

delimited text files 73delimiters 73, 246demand paging 276demo database 557

See also Classic Models sample databasedemo database package 10department seals 490deploying reports 59, 131depreciation 242derived classes. See descendant classesdescendant classes 568Descending option 183, 187, 195descending sort order 183, 187, 195design environments 23

See also BIRT; Eclipsedesign files

creating 29, 350defined 597editing 520opening 29overview 516saving 204

design perspective 10design views 26designer applications 3designer packages 4, 17designers 9designing master pages 23, 493designing reports 21–23, 58, 477, 515

See also designsdesigning templates 517

designsSee also page layoutsaccessing 29accessing templates for 538adding columns to 171adding data sources to 64adding libraries to 515, 518, 520adding report elements to 516applying styles and 154, 531creating 22, 516creating charts and 374, 474creating locale-specific reports and 56,

541, 542creating multipage reports and 477defined 568displaying 29, 340drawing mock-ups of 58embedding images in 130, 131formatting data and 145, 152, 158grouping data in 185, 195, 197hiding elements in 175, 176importing styles for 156laying out reports and 115linking images to 130on-demand reporting and 276overview 21prerequisites for 53, 54previewing 118removing column bindings from 111removing data sources from 66returning values at run time for 120, 275,

277, 295saving 29selecting data for 85selecting fonts and 146setting filters in 265, 268, 270shared report environments and 107, 515sorting data in 181structure of 516time-sensitive data and 276updating 520viewing environments and 55viewing libraries in 518

desktop applications. See Java appletsDetail list area 124detail reports 314, 315, 316

See also subreports


628 I n d e x

detail rowsadding charts to 373adding data set fields to 127adding images to 129, 132adding text elements to 142adding to tables 123aggregating data and 223alternating colors for 163creating summary reports and 234defined 40displaying group headings in 200–202hiding 187, 234placing report elements in 121selecting cells in 49sorting data in 193

developers xxi, 23, 29, 53, 515developing

custom templates 534reports 9, 515

development languages 582See also scripting languages

DHTML (defined) 569dial labels 464dial radius 461dial regions 460, 465–466dial scale 462Dial Scale dialog 462dial settings (charts) 461, 465dial shapes 461dial size 461–462Dial Ticks dialog 463dials, arranging multiple 464directories

BIRT components and 5data set cache and 103flat file data sources and 75image files and 492JDBC drivers and 70projects and 28RCP designer updates and 18report libraries and 525

Display Name property 97display names

defined 568JDBC drivers and 72output columns and 96report parameters and 299

Display type pick list 291, 295

Display type property 288, 289displaying

aggregate values 219alternate values 173available drivers 69charts 350column-binding information 108, 122current date 128, 253, 486current projects 28data 105, 115, 136, 237, 485, 497data groups 197, 199data set fields 238data set parameters 282, 385database schemas 87database views 88date and time values 149detail rows 187errors 79group headings 200, 213HTML reports 478images 117, 129, 175JavaScript functions 241master pages 27, 485numbers 147output 27, 168, 493output columns 97page layouts 115parameter groups 300, 308PDF documents 478percentages 234report designs 29, 340report elements 28, 48report parameters 287, 308report properties 145report templates 35, 517reports 55, 340, 477report-specific libraries 28resource keys 545, 548, 550sample parameter formats 297summary values 219table of contents 215text 117, 133, 134text messages 175value expressions 137

DISTINCT keyword 291distributing reports 59, 131division 243division by zero 243


I n d e x 629

document files 598document model (BIRT) 29

See also ROMdocument object model. See DOMdocument type definitions 568documentation xxi, xxii, 24, 25documents 21, 478, 501

See also PDF documents; reportsDOM (defined) 568domain names 569DOUBLE data type 75double quotation mark (") character

concatenation and 48filter conditions and 268format patterns and 143SQL statements and 88text file data sources and 74

DOUBLE type indicator 75downloadable archives 5downloading

Eclipse Modeling Framework 7Eclipse SDK software 6Graphics Editor Framework 7iText PDF library 10, 12, 13JDK software 5, 6program archives 10, 11, 13

drafts 490dragging report elements 125drill-through links 499Drill-through option 500driver class 67, 69Driver Class property 69driver classes 71Driver Display Name property 72driver list 69drivers

accessing data and 67, 76accessing text files and 73adding database 70defined 569deleting 72installing 69, 70naming 72restoring 72running stored procedures and 89setting properties for 72testing connections for 69viewing available 69

drivers directory 70Drivers page 71Drop property 200, 201, 214DTD (defined) 568dual y-axis charts 410duplicate values 184dynamic data 106, 120, 134

See also datadynamic filters 277, 285dynamic hypertext markup language. See

DHTMLDynamic image option 132dynamic lists 291, 294, 295dynamic queries 102dynamic text elements

adding 134, 138, 139, 519adding to tables 122binding to data sets 138creating column bindings for 109, 138defined 117, 569preserving HTML formats and 136, 138,

143setting properties for 139

dynamic variables 569

EEclipse, starting 24Eclipse documentation. See Eclipse online

documentationEclipse environments 570Eclipse Modeling Framework 7, 570Eclipse online documentation 25Eclipse perspective 570Eclipse platform 6, 571

See also Eclipse Rich Client PlatformEclipse Plug-in Development

Environment 571Eclipse projects 571

See also projectsEclipse Rich Client Platform 571

See also rich client platformsEclipse SDK software 6Eclipse views 571Eclipse workbench 24, 572Eclipse workspace 572Eclipse, starting 80eclipse.exe 24


630 I n d e x

Edit Chart wizard 353, 356, 358See also chart builder

Edit command 65Edit Data Set dialog

adding computed fields and 99changing data sources and 84creating queries and 87, 103defining data set parameters and 282defining run-time parameters and 281filtering data and 261, 268setting cache preferences and 103viewing output columns in 96, 97

Edit Data Source dialog 66, 70, 73, 78Edit Font dialog 431Edit Format dialog 361Edit Format icon 387, 389Edit Group context menu 186Edit Group dialog 194, 197, 271Edit JDBC Driver dialog 72Edit Parameter dialog

creating dynamic list values in 295creating static list values in 292enabling null values and 298formatting values and 296selecting display types from 291setting default values in 289

Edit Style command 158Edit Text Item dialog 51, 140editing source code 29editors 29, 138, 140, 542EJBs 573elements

See also report elements; ROM elements; XML elements

defined 572formatting data and 147, 149, 150, 158shared reports and 516, 517, 518, 524styles and container 153, 154

ellipsis (…) buttonchart titles and 430defined 572expression builder and 99externalized text and 547hyperlink options and 498legend text and 438resource keys and 545run-time connections and 78sorting data and 182, 194

text file connections and 76XML files and 77

Embedded image option 131embedded images 129embedding images 130, 131EMF (defined) 570EMF software 7empty expressions 395empty lines (delimited text files) 74empty report designs 35empty rows and columns

deleting 120inserting 168, 340

empty strings 244, 297, 298empty values 288, 297, 298Enable editing button 530Enable Live Preview option 414Enable master page content setting 493encapsulation 572encoding 610Enter Parameters dialog 276, 290, 298, 300Enter URI field 131enterprise 573Enterprise JavaBeans. See EJBsenterprise reporting 57, 573enterprise systems 573environment settings 29environments 23, 594error log view 79error messages 28, 79error reports 79errors 29, 79event handlers 573event listeners 574event types 508, 509events 508, 509, 573

See also actionsexample database 32, 36

See also Classic Models sample databaseexceptions 574executing stored procedures 91experts. See wizardsExplode Slice When property 469Export Data dialog 512Export data icon 512exporting data 511–513expression builder

accessing 99, 240


I n d e x 631

expression builder (continued)aggregating data and 226creating column bindings and 111creating expressions with 128creating filter conditions and 269defined 574defining chart series and 386displaying value expressions in 137generating computed values and 98, 99manipulating date and time values

and 252manipulating numeric data and 242manipulating string data and 245overview 239–241setting up run-time connections and 79

expression builder buttons 240expressions

adding formatting rules and 160adding images and 132aggregating data and 224, 226, 228, 230,

553alternating colors and 164changing 137changing column bindings and 111combining dynamic and static values

in 141, 142combining values from multiple fields

and 246comparing values from 259computing percentages with 233computing values and 98, 99, 127, 128,

129creating 128, 238–239creating charts and 349, 353, 366, 385creating column bindings and 106, 107,

109, 111creating hyperlinks and 500defined 574defining data series and 383, 386, 391defining multiple y-axes values and 410,

411defining textual information and 133displaying images and 175displaying values from 134, 137dividing by zero and 243entering automatically 239, 240entering multiple lines in 239exploding pie sectors and 469

filtering with 251, 261, 262, 268examples for 227

formatting return values from 143, 387–389

generating table of contents and 187, 504grouping data and 202, 216, 405hiding report elements and 175, 177manipulating date and time values

with 252–254manipulating numeric values and 242–

244, 590manipulating string data and 245–252,

606mapping alternate values and 173matching text patterns and 597operator precedence and 242overview 237preserving HTML formats and 143returning Boolean values from 254–255,

555returning unexpected results from 238returning unique values from 228sorting data and 183, 195verifying 98, 238

extensible markup language. See XMLextension points 575extensions 575external files 59external libraries 526external resources 59Externalize Text dialog 547, 548Externalize Text option 547, 548

FFeature License dialog 18Feature Updates dialog 17features 8field names 41, 106field types 238field value expressions 141field variables 575

See also member variables; variablesfields

See also columns; computed fieldsadding data set 147adding pictures to 175adding to designs 125, 127adding to expressions 237, 238, 242


632 I n d e x

fields (continued)adding to tables 121, 122, 123binding parameters to 316, 327, 331building user-selection lists and 291, 293changing data set bindings and 123combining values from 246computing values from 128, 242concatenating values in 48, 98, 128, 246creating group headings and 202defined 575deleting 123displaying available 242displaying data in 175, 237displaying dynamic values from 134displaying text values in 142displaying type 238filtering values in 265, 280getting highest value in 221getting lowest value in 221grouping on 184, 186, 192, 199providing default values and 289removing duplicate values from 184removing null values from 247replacing values in 173returning values for 221setting up text file data sources and 74sorting on 180, 182, 183, 193testing for null values in 260, 266

File Download dialog 512file name extensions 74file names 74, 486, 522file systems 131file types 576files

See also specific typedownloading program archive 10, 11, 13extracting program archive 5, 10managing 28

fill colors 442filter characters (SQL) 88filter conditions

adding to queries 258, 259, 268calculating aggregate values and 227counting unique values and 229creating 265, 267, 269, 270, 271, 280defining multiple 269, 272excluding null values and 228matching text patterns and 251

retrieving specific rows and 258–259, 261testing 280types described 265updating at run time 286users specifying 277, 278, 285

filter expressionsaggregate values and 227calculated values and 267creating 269, 272pattern-matching and 251user-specified values and 286

filter options 88filter properties 263filter tool 265, 272filtering

aggregate values 227–229, 265data 257, 262, 265, 275, 277data groups 187data sets 263, 265, 268database tables and views 88groups 263, 265, 270JDBC data sources 259report elements 263, 265, 270XML data sources 260–262

filtering options 262, 263filters

adding to designs 265, 268, 270applying 257, 385creating 262defined 576defining aggregate expressions for 265defining JavaScript expressions for 262defining XPath expressions for 260, 261,

262matching string patterns and 249setting at run time 277, 278, 285setting conditions for. See filter conditionsspecifying parameters as 277, 285, 286

Filters and Sorting section (Edit Group) 194, 271

Filters button 385Filters option (Edit Data Set) 269Filters page (Edit Group) 271Filters page (Property Editor) 270, 286Filters section (Edit Data Set) 269financial calculations 242financial functions 241


I n d e x 633

findingmultiple strings 245specific characters 249, 251string patterns 249, 251

first function 221Fixed format setting 148flat file data sets 91flat file data sources 75, 91, 262flat file repositories 64flat files 76, 85, 576

See also flat file data sources; text filesFlip Axis option 411floor (charts) 420Focus event type 509folders 59font attributes 147, 431Font Editor (charts) 362, 437font editor (charts) 430font properties 147font size 141fonts

axis labels and 448axis titles and 440chart legends and 437, 438, 439chart titles and 431curve-fitting line labels and 454data point labels and 473default formats and 153defined 576dial labels and 464HTML reports and 141installing 146marker labels and 443styles and 153, 158

Footer list area 124footer rows 121, 123, 223, 225footers

adding charts to 373adding report elements to 486changing 487creating master pages and 486creating page 118creating section 121, 124defined 576displaying text in 487displaying totals in 223, 225planning for 57resizing 488

setting size 488form e-capable browser 577form letters 123, 125, 134, 142format attribute 143Format Builder 296Format Chart page

adding axis titles and 439adding chart legend titles and 438adding curve-fitting lines and 453, 454adding dial regions and 465, 466adding dials and 462, 463, 464adding grid lines and 445adding legend items and 451changing chart titles and 358, 430, 432changing data point labels and 472, 473changing series type and 449creating pie charts and 467, 468, 470creating stock charts and 471defining axes values and 406, 407exploding pie sectors and 469formatting axis labels and 442, 448formatting axis markers and 441, 442, 444formatting chart areas and 417formatting chart legends and 433, 434,

437formatting chart series and 458, 459, 460formatting needles and 463formatting plot areas and 426, 427grouping series data and 405hiding chart series and 449outlining chart areas and 419overview 367rotating charts and 456scaling axes values and 410setting axes intersection and 408setting chart area insets and 422setting wall or floor color and 420spacing chart legends and 436stacking chart series and 455

Format DateTime property 149Format Legend Text dialog 434, 438Format Number property 136, 147, 148format patterns

date-and-time data 149, 389JavaScript expressions and 143numbers 148, 388text 151

Format property 288, 296


634 I n d e x

Format Specifier dialog 388, 389format specifiers (charts) 387Format String property 150, 152format styles. See stylesformats

adding HTML tags and 51applying 146, 153, 160changing date 336changing number 338changing text 140charting expressions and 387–389creating locale-specific reports and 56,

149customizing date 149, 389customizing number 148, 388customizing string 151defined 576defining conditions for 158–163defining run-time parameters and 279,

288, 296defining styles and 152, 158displaying 297generating charts and 365, 379generating reports and 30hiding report elements and 177overriding 162preserving HTML 136, 138, 143reporting considerations for 57resetting date 253updating 146VALUE-OF tag and 148, 152

formattingaxes values 407, 425, 439axis labels 442, 448axis markers 441–442axis titles 461chart areas 416, 422chart legends 437, 438chart titles 430charts 367, 416, 456, 474column headings 45curve-fitting lines 453data 23, 145, 146, 158, 387

tutorial for 44data point labels 449, 472, 473data series 448–471date-and-time values 149–150, 389dial labels 464

group headings 208grouped reports 213–217numbers 136, 147–148, 387report elements 45, 145, 152, 158report parameter values 296–297sector labels 362strings 135, 150–152text 51, 135, 141, 143

formatting attributes 362, 474formatting options 145formatting properties 45, 145, 146, 162formatting rules 159–163formatting symbols 148, 151formatting tasks 23Formula Editor. See expression builderformulas 106, 237

See also expressionsforward slash (/) character 249Fraction Digits pick list 388fractions, formatting 388framework 577FROM clause 85FROM keyword 85Full Eclipse Install (BIRT Report

Designer) 5, 11–12function names 238functions

See also methodsaccessing 138, 226aggregating data and 220, 225calculating values with 128case sensitivity for 238converting case and 183counting rows with 228creating group headings and 202creating XPath expressions and 93defined 577displaying 241entering in expressions 237, 238, 242filtering with 267returning data values from 106

fundamental data types. See data typesfuture values 452

Gg flag (expressions) 252GEF software 7general libraries 522, 523


I n d e x 635

General Number format setting 148General Properties dialog (charts) 455generating

HTML reports 30PDF documents 30reports 275table of contents 187

getDay function 253getHours function 253getMinutes function 253getMonth function 253getSeconds function 253getting started 21, 24, 25, 58

See also tutorialsgetYear function 253global styles 531global variables 577

See also variablesGlossary 553glyph 577

See also character sets; fontsgradient colors (charts) 418, 423Gradient Editor 418gradient patterns (charts) 418grand totals. See totalsgrandchild classes. See descendant classesgrandparent classes. See ancestor classesgraphical applications 379graphical user interface

See also user interface elementsBIRT RCP Report Designer 26BIRT Report Designer 25

graphics 379See also images

Graphics Editor Framework 7graphs. See chartsgrid cells 172

See also cellsGrid Column Count pick list 464, 470grid elements

See also gridsadding table elements to 333adding to designs 118, 333, 519as containers 118creating subreports and 312, 314defined 117, 578displaying page headers and footers

and 487

displaying placement of 340placing in libraries 523

grid layouts 119grid lines (charts) 443, 445grid marks (charts) 409grid style 153Grid tab 119, 340, 344Gridlines button 444Gridlines dialog 406, 444, 445grids

See also grid elementsadding columns or rows to 119adding data set fields to 127adjusting spacing for 168aligning content in 165–166aligning report elements in 119changing 119creating 117, 119, 171, 519defined 578displaying 168merging cells in 172organizing elements in 118–120removing columns or rows from 120resizing columns and rows in 169spacing elements in 120, 340, 344spacing report content and 488

group editor. See Edit Group dialoggroup footers 187, 225, 373group header cells 201group header rows 211, 223group headers

adding aggregate values to 223, 224, 225, 230

adding charts to 373adding summary values to 187creating 211defined 579

group headings 199–202, 208, 213group index 231group keys

charting data and 390, 393, 398, 403creating multiple pies and 397defined 579defining multiple needles and 393defining multiple y-axes values and 410,

411generating table of contents and 503, 504

group names 199, 231, 233


636 I n d e x

Group On pick list 186group properties 185grouped reports

See also groupsadding summary values to 187aggregating data and 220creating 184defined 578filtering data in 187generating table of contents for 503hiding detail rows for 187sorting data in 187

grouping dataadvantages of 184, 188, 210by intervals 187–192, 207by time periods 191charts and 404–405from BIRT designer 185overview 183pagination and 484tutorial for 202–215

grouping intervalscharts 404, 405data groups 186date and time values 191, 192numbers 190strings 189

grouping key expressions. See group keysgrouping options 405Grouping section (Format Chart) 405groups

adding to designs 185, 197, 207charting data and 373creating 57, 184, 195, 197defined 578defining multiple 187, 195–197displaying headings for 200, 201, 202filtering data in 263, 265, 270formatting values in 213–217hiding detail rows for 234highlighting data in 215including aggregate values in 220, 222,

225including range of values in 190, 209inserting page breaks for 479, 484moving 199naming 186organizing parameters in 298, 299, 301

previewing 215, 272reordering 197–199retrieving aggregate values from 229selecting 199sorting data in 192–195specifying starting values for 190, 191

Groups page 193, 197, 198, 271Groups tab 197guide cells 119, 120, 169

Hhard-coded text. See static texthardware interfaces 582Header list area 124header rows

adding background colors to 46adding images to 129adding to tables 123placing aggregate values in 223, 224placing group headings in 211placing report elements in 121

headersadding charts to 373adding group 211changing 487creating page 118creating section 121, 124defined 579designing master pages and 486displaying text in 487displaying totals in 224, 225, 230planning for 57removing 489, 490repeating report 479resizing 488setting size 488setting style properties and 154

headings. See column headings; group headings

height hint (charts) 428, 429Height Hint property 429Height property 169help 591Help text property 288hexadecimal numbers 579Hide Detail property 187Hide Element option 176


I n d e x 637

hidingaxis labels 447axis lines 444chart areas 423, 430chart legends 435chart series 449data point labels 473data points 509detail rows 187, 234dial labels 464leader lines 469marker labels 442report elements 175–177tick marks 445, 463

hierarchy 579high values, plotting 379, 400Highlight option 509highlighting

axes values 440chart areas 419, 423charts 509data 23, 215, 335data points 440, 443

Highlights page 159, 160, 163horizontal alignment 165, 437, 492horizontal spacing (charts) 427, 428horizontal spacing (reports) 166, 170, 344HTML (defined) 579HTML elements 572HTML formats 30, 31, 55, 136, 138, 143HTML reports

See also web pagesadding lists to 134adding textual elements for 136, 138, 140,

143controlling pagination in 478–485creating master pages for 493customizing master pages and 485designing for 477displaying 478generating 30previewing 31, 42, 166resizing headers and footers for 488spacing defaults for 166

HTML tables 118, 167HTML tags 51, 136, 139, 140, 141, 577HTML text elements 117, 224HTML value (content type) 139

HTML/Dynamic option 140, 143HTTP (defined) 580hyperlink expressions 500Hyperlink Options dialog 498, 499, 500Hyperlink property 500, 502hyperlinks 497–502, 579hypertext markup language pages. See web

pageshypertext markup language. See HTMLhypertext transfer protocol. See HTTP

Ii flag (expressions) 252icons 129, 537identifiers 238, 580If expressions 160if statements 255if...else statements 142Image Builder 132image elements

See also imagesadding 117, 129, 131creating column bindings for 109, 122,

132defined 580

Image file in BIRT resource folder option 130

image filesdeleting 130entering URIs for 131entering URLs for 131generating charts and 379managing 59moving 130opening 502

image formats 129, 379images

See also image elementsadding as watermarks 490–492adding background 418, 490, 492adding to master pages 487adding to reports 129, 131adding to tables 122as static elements 118associating with data sets 132associating with templates 533, 536, 537changing 129charting data and 379


638 I n d e x

images (continued)defined 580displaying 117, 129, 175embedding 130, 131linking to 129, 130, 501, 502previewing 130retrieving remote 131sharing 519

Import CSS Style command 156Import CSS Style dialog 157Import Values button 291, 292Import Values dialog 292importing styles 153, 156–157importing values 291, 292, 293indexOf function 248infinity symbol 244information 53, 115, 133

See also datainformation systems 21inheritance 580inheriting styles 154inline report elements 48, 166inner groups 195, 196, 197INNER JOIN clause 86inner joins 100, 581

See also joinsinput

adding messages for 175creating parameters for 278, 281prompting for 275, 277, 288, 298

input parameters 88, 283input sources. See data sourcesinput streams 76InputStream objects 76Insert Column to the Left command 120Insert Column to the Right command 120Insert Grid dialog 333Insert Group command 197Insert menu 125Insert Row Above command 119Insert Row Below command 119Insert Table dialog 40inset settings

axis labels 448axis titles 440chart areas 416, 421, 422, 424chart legends 436, 439chart titles 432

curve-fitting labels 454data point labels 473dial labels 464marker labels 443plot areas 427

inset values 421installation

BIRT components 5BIRT RCP Report Designer 12–14BIRT Report Designer 9–11database drivers 69, 70Eclipse 24fonts 146JDK software 5, 6testing 11, 14troubleshooting 14–15

installation demo 5installation packages 9instance variables 581

See also class variables; variablesinstances. See objectsinstantiation 581INT type indicator 75INTEGER data type 75integers 147

See also numbersinteractive chart features 379, 497, 505–511interactive content 134interactive images 379interactive report viewer 31

See also report viewerinteractive reports 497, 501interactive viewing features 55, 497Interactivity dialog 508Interactivity Editor 508interfaces 89, 582

See also application programming interfaces; user interface elements

international users 56internationalization 582

See also localesintersection options (charts) 408Interval pick list 186, 189, 191, 192Interval value 191introductory information 124invoice IDs 252Invoke Font Editor icon 430Invoke Script option 509


I n d e x 639

IP addresses 582Is Category Axis option 406Is True operator 272isBottomN function 221isBottomNPercent function 221isTopN function 221isTopNPercent function 221italic text style 147

JJ2EE environments 9, 13, 582J2SE environments 5, 6, 583.jar files 70, 71, 72, 583Java. See Java programming languageJava 2 Enterprise Edition. See J2EE

environmentsJava 2 Runtime Standard Edition. See J2SE

environmentsJava applets 554Java archives. See .jar filesJava code 582Java Database Connectivity. See JDBCJava Development Kit. See JDK softwareJava interfaces 582Java Naming and Directory Interface 583Java programming language 582Java programs 583Java Virtual Machines. See JVMsJavaBeans 584JavaScript

case sensitivity for 238defined 584familiarity with 238multiline expressions and 239null values and 247pattern matching and 249string conversions and 244

JavaScript expressionscombining dynamic and static values

in 141, 142creating 209, 238, 240defining textual information and 133displaying values from 134, 137editing 137filtering with 262, 268formatting return values from 143generating table of contents and 504grouping data and 209, 216

matching text patterns and 267overview 237preserving HTML formats and 143

JavaScript functionsaccessing 138aggregating data and 220calculating values with 128concatenating values and 98converting case and 183displaying values with 202filtering with 267getting specific characters with 202parsing string data and 248viewing 241

JavaScript operators 138, 242JavaServer Pages. See JSPsJDBC (defined) 583JDBC data sets 81, 85, 258JDBC data sources

accessing data in 63, 67building queries for 87–89building stored procedures for 89changing connection properties for 65connecting to 68creating 67defining run-time parameters for 281displaying tables or views in 88filtering data in 258, 259, 277naming 68retrieving data from 37, 81, 85setting connection properties for 68troubleshooting 79

JDBC directory 71JDBC driver manager 69, 70, 71, 72JDBC Driver Manager. See Manage JDBC

Drivers dialogJDBC drivers

accessing data and 67adding 70deleting 72installing 69, 70naming 72restoring 72running stored procedures and 89setting properties for 72testing connections for 69

JDBC interfaces 89JDBC/ODBC bridge 69


640 I n d e x

JDBC-ODBC bridge driver 69JDK software 5, 6, 583JNDI (defined) 583JNDI URL property 69JNDI URLs 67, 69join conditions 585JOIN keyword 86joins 86, 100, 101, 584joint data sets 100, 101, 581, 585JPEG files 379JSPs xvii, 584jTDS project 89justification 147JVMs 15, 584

KKey Down event type 509Key Press event type 509Key Up event type 509key=value format 542keywords 138, 238, 585

Llabel elements

See also labelsadding static text to 135, 136adding to designs 134, 139, 519adding to header rows 41adding to master pages 487assigning resource keys to 545changing text formats in 140creating hyperlinks with 501creating messages with 175creating report titles and 135defined 117, 585removing resource keys for 546setting properties for 140

label style 154labels

See also label elementsadding chart axis 445adding chart marker 441adding curve-fitting line 454adding pie sector 359, 361, 468as static text 117changing data point 472changing report 139

combining text and numeric values in 135creating 134, 139formatting axes 448formatting data point 449, 472, 473formatting dial 464formatting marker 442formatting pie sector 362formatting report 140hiding chart 442, 447, 464, 473inserting icons for 129inserting multiple values in 361localizing 542, 545, 546missing in charts 446outlining axis 448outlining curve-fitting line 454outlining data point 473outlining dial 464outlining marker 443rotating chart 446selecting values from 294skipping 447staggering chart 446

Labels button 360Labels dialog

data point labels and 472, 473dial labels and 464pie sectors and 360

large data sets 97large data sources 103large reports 276large XML documents 92last function 221lastIndexOf function 248laying out reports 23, 56, 115

See also layouts; page layoutsLayout button 359layout editor

changing report libraries and 527creating styles and 155defined 585displaying list structures in 124displaying row-and-column structures

in 118, 120grouping data with 185laying out reports and 115naming restrictions for 107overview 27reordering data groups with 197


I n d e x 641

layout editor (continued)restrictions for 126, 485selecting templates for 538sorting data with 181viewing column-binding names in 106viewing output and 168

layout elements 117Layout Legend dialog

adjusting legends and 436hiding legends and 359, 435outlining legends and 434setting background colors and 433

Layout page. See layout editorLayout tab 43layouts 23, 115, 117, 532, 585

See also columnar layouts; grid layouts; tabular layouts; page layouts

lazy load 585Leader Line section (Format Chart) 470Leader Line Size pick list 364, 470Leader Line Style pick list 364, 469, 470leader lines (charts) 363, 469–470LEFT JOIN clause 87left outer joins 100legend area (charts) 416

See also legendslegend orientation setting 436Legend section (Format Chart) 372legend text area (charts) 433legends

See also chartsadding items to 451adding shadows to 433, 434adding titles to 438adding to charts 372, 433

tutorial for 359anchoring 435changing information in 433changing spacing of 416, 421deleting 359displaying series in 437, 450formatting text in 437hiding 423, 435highlighting 423, 433laying out 422, 423, 435, 436outlining 433, 434repositioning 435, 436setting background colors for 433

setting interactive options for 506, 507setting padding around 421, 424, 436wrapping text in 437

length property 248level-break listings. See grouped reportsLF escape code 74libraries

accessing 526accessing elements in 527, 529adding data sources to 64adding report elements to 517–518, 529adding to designs 515, 518, 520adding to resource folder 525, 526changing report elements in 517, 519, 527,

530creating 517, 522–524, 528defined 586defining project 524–525naming 528opening 527publishing 59, 525sharing styles and 520–522, 523, 531structure of 516updating 528viewing 28

Library command 528Library Explorer 28, 526, 528library files 517, 586library name spaces 518, 522licenses 18line break characters 74line charts

See also chartschanging series type in 449coloring data series for 450curve fitting and 453defining axes values for 406defining axis titles for 439defining data series for 389–392formatting data series in 459–460overview 377stacking series in 455

line colorsaxis lines 444candlesticks 471chart markers 442curve-fitting lines 453grid lines 445


642 I n d e x

line colors (continued)outlines 419pie charts 470

line markers (charts) 440, 441, 443line styles

candlesticks 471chart areas 416chart markers 442curve-fitting lines 453grid lines 445needles 463outlines 419pie charts 470tick marks 443x- or y-axis 443

line widthscandlesticks 471chart markers 442curve-fitting lines 453grid lines 445needles 463outlines 419pie charts 470

linear axis type 407, 409Linear setting 407lines 215linked images 129linked reports 314linked subreports 313–316linking fields 314, 315linking to

charts 510–511images 129, 130, 501, 502report elements 497reports 311, 315, 499–500web pages 501, 502

links. See hyperlinkslist boxes

adding values for 290–296creating dynamic lists for 291, 294creating static lists for 291enabling blank or null values for 298formatting values for 288, 296, 297providing default values and 289setting default values for 289, 296setting maximum number of values

for 296sorting values for 294

testing values in 309list elements

See also listsadding 124, 323, 519as containers 123creating subreports and 312, 314, 323defined 117, 586placing in libraries 523

list layouts 124, 125List Limit property 296List of value options 292, 295list style 154list-detail style 154listeners. See event listenerslist-footer style 154list-header style 154listing reports 32, 219, 586lists

See also list elementsadding CLOB fields to 138adding data set fields to 127adding textual elements to 138, 142binding to data sets 125, 142changing data set bindings and 123creating 117, 121, 124, 134, 290defining cascading parameters for 301–

307filtering data in 263, 270, 286grouping data in 185, 197organizing elements in 123–125placing report elements in 124selecting values from 277sorting data in 181, 324updating 291

literal characters 148literal spaces 246literal text

See also static textadding to dynamic data 134combining with numbers 244creating column bindings for 109creating localized reports and 541displaying 117returning from expressions 237searching on 250

literal values in expressions 237, 250Load event type 509local file systems 131


I n d e x 643

local styles 531local variables 587

See also global variables; variableslocales

creating resource files for 542, 550creating resource keys for 543, 545defined 587designing for 56, 541, 542formatting dates and 149, 150, 336formatting numbers and 338previewing reports for 550, 552resetting date formats for 253, 487

localization 541, 542, 587See also locales

Localization Properties option 545localizing reports 56, 541, 542locating

multiple strings 245specific characters 249, 251string patterns 249, 251

Location property 502logarithmic axis type 407, 409Logarithmic setting 407logos 129Lookup Key pick list 547low values, plotting 379, 400lowercase characters 151, 183Lowercase format setting 151Lowess algorithm 453

Mmajor grid lines 443, 445major grid marks 409, 410major tick marks 443, 444Manage Drivers button 71Manage JDBC Drivers dialog 69, 71, 73manifest files 587Map List 174Map List options 173Map page 173map rules 173, 174mapping

data values 173to alternate values 173–174XML data 93, 94, 260

Margin Top property 170margins

cascading styles and 154

PDF reports and 494spacing options and 170web browsers and 168, 340

Margins property 170marker interactivity options 507Marker Label Properties section (Axis

Markers) 442marker labels 441, 442

See also data point labelsMarker Line Attributes section (Axis

Markers) 441marker line styles 442marker lines 440, 441, 442, 443marker range 440marker range formatting options 442marker types 440markers (charts)

See also specific typeadding 440, 441, 471changing location of 424formatting 441–442outlining 442stretching 455

Markers button 441Markers dialog 441, 442markup languages 569, 575, 579

See also elements; tagsMaster command 485Master Page page 27, 485Master Page tab 485master pages

adding 478, 493, 532changing 486creating multiple 494–496customizing 485–494defined 587designing 23, 493displaying 27, 485placing images on 487, 490, 491restrictions for 486, 487setting properties for 494sizing headers and footers on 488

master reports 314, 315, 316See also subreports

master/detail relationships 314, 482Match operator 251matching

character patterns 260, 267


644 I n d e x

matching (continued)sequence of characters 88specific characters 249

math expressions 243math functions 241, 242matrix reports. See cross-tab reportsmax function 221median function 221median values 221member variables 588

See also field variables; variablesmembers 588membership test conditions 260memo fields 252memory 92memos 117, 134Merge command 172merging table or grid cells 172message files 59messages 175, 177metadata 589meter charts

See also chartsadding dial regions to 465–466adding labels to 464changing dial scale in 462changing needle appearance for 463coloring series for 451defining data series for 392–395displaying multiple meters in 393, 463displaying multiple needles in 393formatting data series in 460–461overview 377setting dial size for 462

methods 589See also functions

Microsoft Windows systems. See Windows platforms

milestone builds 7milestone release 17min function 221Minimum Slice pick list 468Minor grid count option 410minor grid lines 443, 445minor grid marks 409, 410minor tick marks 443, 444mock-ups 58modal windows 589

mode 589mode function 221modeless windows 589modulus (%) operator 164, 165monthly reports 191Mouse Click event type 508Mouse Double-Click event type 508Mouse Down event type 508Mouse Move event type 508Mouse Out event type 508Mouse Over event type 508Mouse Up event type 508movie clips 502moving image files 130movingAve function 221multicolumn page layouts 171–172multiline expressions 137, 239multiline text 134multipage reports 477multiple columns, selecting 91multiple report elements 46, 48Multiple Y Axis pick list 410multiplication 243Multiplier property 388multithreaded applications 589

Nname fields 48, 246, 248name spaces 518, 522named styles 153names

cascading parameters and 303, 305changing default 64, 65character limits for 107column binding and 105, 106, 107, 109,

111concatenating 48, 128, 246creating data sets and 82creating data sources and 65grouping on 189predefined styles and 156

namingcascading parameters 303, 304, 305, 306computed fields 99data set parameters 282data sets 82, 90, 91, 94groups 186JDBC data sources 68


I n d e x 645

naming (continued)JDBC drivers 72libraries 528parameter groups 299report parameters 78, 279resource files 542, 544text file data sources 75XML data sources 76

Native JavaScript Functions category 241native2ascii command 543Navigator 28, 203, 589Navigator command 203needle colors 451needle settings 463needles 392, 460, 463

See also meter chartsnesting

report sections 116, 117reports 311, 314

New Cascading Parameter command 303, 305

New Cascading Parameter dialog 303, 305New Chart wizard 351, 385

See also chart builderNew Data Set command 38, 82New Data Set wizard

creating data sets and 82, 91, 94creating stored procedures and 90joining data sets and 101sample database and 38

New Data Source command 37, 65New Data Source wizard

adding database URLs to 72creating flat file data sources and 75creating JDBC data sources and 68creating XML data sources and 76demo database and 37selecting data sources and 65

New Flat File Data Source Profile wizard 75New Group dialog 185New Highlight dialog 160New Image Item dialog 130, 131New JDBC Data Source Profile wizard 68New Joint Data Set command 101new lines 48New Map Rule dialog 173New Parameter command 78, 279New Parameter dialog 78

New Parameter Group command 299New Parameter Group dialog 299New Project command 33New Project wizard 33New Report command 34New Report Project wizard 33New Report wizard 34, 35, 318New Style command 155, 529New Style dialog 46, 155, 337, 339New Template wizard 534New Theme command 529New XML File Data Source Profile

wizard 77newsgroups 5nightly builds 8node 590non-visual report elements 516Not Between operator 269notes 153notices 153null argument 230null value test conditions 260, 266null values

aggregation and 228concatenation and 246creating user-selection lists and 290defined 590delimited text files and 74removing 247specifying at run time 288, 297, 298string data and 246, 297testing for 260, 266

number format options 387, 388number format types 147number formats

changing 338creating charts and 361, 387, 407customizing 148, 388setting data types for 147specifying 147, 148

number function 242numbered lists 134numbers

averaging 220, 221, 228charting comparisons for 378combining with text 135computing values of 228, 242converting strings to 252


646 I n d e x

numbers (continued)converting to strings 244creating locale-specific reports and 56defining as text 133displaying as percentages 234displaying dynamic data as 134dividing by zero 243formatting 136, 147–148, 387grouping by interval 190grouping in charts 404, 405plotting 406reformatting 338returning from expressions 242returning sum of 222

NUMERIC data type 74numeric data types 238, 590numeric expressions 387, 590numeric fields 242N-up reports. See multicolumn page layouts

Oobject-oriented programming 590objects 590octal numbers 591ODA (defined) 591ODA drivers 591ODA framework 63ODBC (defined) 592ODBC data sources 69on-demand reporting 276online documentation 24, 25online help 591online reports 55, 57Opacity scroll tool 418open data access 63, 591

See also ODAopen database connectivity. See ODBCOpen File command 29Open Image File dialog 131Open Report command 203open source projects. See projectsopen source software development. See

Eclipseopening

BIRT RCP Report Designer 25BIRT Report Designer 25chart builder 358Data Explorer 64

expression builder 99, 240image files 502libraries 527Navigator 203project files 203Property Editor 43report design files 29report designs 29reports 27resource files 550sample database 37

opening values, plotting 379, 400operator precedence 242operators 138, 237, 265, 592

See also JavaScript operatorsOperators category 242OR operator 272Or operator 254ORDER BY clause 85, 181

See also SQL statementsorder of precedence 242order-entry forms 127orientation (charts) 436orientation (reports) 494, 495Orientation pick list 436Origin pick list 408orthogonal axis values 560orthogonal series 467, 472outer joins 100, 592

See also joinsOutline button 419Outline command 340Outline dialog 419outline line styles 419Outline page. See Outline viewOutline view (BIRT) 28, 340, 516Outline view (Eclipse) 592outlines, customizing 419outlining

axis labels 448axis markers 442axis titles 440chart legends 434charts 419curve-fitting labels 454data point labels 473dial labels 464dial regions 466


I n d e x 647

outlining (continued)legend titles 439legends 433marker labels 443pie sectors 449, 468plot areas 426

outputcharting data and 379designing for 23displaying 27, 168, 493removing headers from 489–490sizing headers and footers for 488spacing defaults for 167

output columns 96, 97Output Columns section (Edit Data Set) 96,

97Output Columns view 238Output Format pick list 380output formats

changing chart 380generating charts and 365, 379generating reports and 30

output parameters 88overall value 230overlapping areas in charts 375overlapping axes labels 446

Ppackage (defined) 593packages 3, 17padding

axis labels 448axis titles 440chart areas 421–422, 424chart titles 432container elements and 154curve-fitting labels 454data groups and 214, 215data point labels 473data rows and 50dial labels 464legends 436, 439marker labels 443page headers and 488plot areas 427report elements and 168, 170web browsers and 168, 340

padding properties 154, 170

Padding property 170, 214, 347PaddingBottom property 170Page Break After property 479Page Break Before property 479Page Break options 187page break properties 479page breaks

adding 478, 484designing reports and 477restrictions for 478

page headers and footersadding multiple elements to 487adding report elements to 486changing 487creating 57, 118defined 576, 579displaying text in 487excluding from first page 489–490resizing 488

page layout models 115–118page layouts

See also designs; master pagesadding container elements to 118, 127adding data set fields to 127adding images to 129, 130, 131adding multiple elements to 117, 126adding report elements to 117, 125–132adjusting spacing for 166, 168, 170applying from templates 533building multicolumn 171–172creating 57, 117, 477customizing 516defined 477, 585defining computed fields in 98defining list structures for 124, 125defining row and column structures

for 118, 120defining tabular structures for 120deleting data sets and 84designing multipage reports and 477displaying 115displaying master pages for 27, 485displaying text and 133, 135distributing reports and 55grouping data and 184, 185, 188, 195overview 23, 115placing aggregate data and 222, 224placing side-by-side-elements in 126


648 I n d e x

page layouts (continued)prerequisites for 56, 115

page numbers 57, 486page orientation 494page settings 494page size 494Page# element 487pagination 478–485palette 125palette (charts) 451, 452palette (report editor) 28palette list 452Palette page. See Palette viewPalette view 28, 487, 593paragraph styles 134parallel subreports 316parameter groups

adding parameters to 300, 304, 306creating 298, 299, 301displaying 300, 308naming 299reordering in Data Explorer 308

parameter lists 290, 303parameter markers (queries) 280, 281parameter sets 298parameters

See also data set parameters; report parameters

adding messages for 175adding to expressions 241adding to queries 280, 281assigning data types to 279, 282assigning values to 289binding to connections 78building charts and 385debugging 308defined 593defining as data filters 277, 285, 286display properties for 287grouping 298, 299, 301providing input with 277, 298returning values from 280, 282setting up run-time connections and 77,

78testing 284, 308troubleshooting connection 80

Parameters button 385parent class. See superclasses

parseFloat function 252parseInt function 252Password property 69passwords

defined 594JDBC data sources and 67, 69relational databases and 67run-time connections and 77, 78static text and 77

pathsimage files and 492resource folders and 59XPath expressions and 93, 95

pattern-matching characters 250pattern-matching conditions 249, 260, 267patterns 594

See also object-oriented programmingPDE (defined) 571PDF documents

controlling pagination in 478–485creating master pages for 485, 493, 494designing for 478generating 30previewing 31, 42, 166, 481resizing headers and footers for 488setting page breaks for 479, 481spacing defaults for 166viewing 478

PDF formats 30, 31, 55PDF reports. See PDF documentspercent (%) character 88, 234Percent format setting 148, 234percent stacked charts 375percentages 222, 231–234, 378percentile function 221percentRank function 222percentSum function 222period (.) character 250personalized reporting 55perspectives 25, 570phone numbers 150, 252photographs 379pictures 118, 129, 175

See also imagespie charts

See also chartsadding leader lines to 363changing leader lines for 469–470


I n d e x 649

pie charts (continued)coloring series for 451creating 349, 466defining axes values for 406defining data series for 395–398defining multiple pies for 397, 470displaying sectors for 354entering expressions for 353exploding sectors in 449, 469formatting data series in 467labeling sectors in 359, 361, 468outlining sectors in 449, 468overview 378resizing 467setting sector size for 355, 468

Pie Ratio property 467pie shapes, stretching 467Plain text option 140plain text values 139, 140Plain value (content type) 139planning process (described) 22, 53platform 594plot area (charts)

adding shadows to 427adjusting 423, 425, 427changing layout of 372changing spacing of 416, 421, 427highlighting 423laying out 422outlining 426setting background colors for 425–426setting padding around 424, 427setting size 428–429

Plot section (Format Chart) 371Plot section options 426plotting data 381, 404, 405Plug-in Development Environment 571plug-in fragments 594plug-ins 14, 594PNG files 379pointer shapes (needles) 463polymorphism 594portal 595portlets 595position-based parameters 281precedence 242predefined layouts. See master pagesPredefined Style pick list 156

predefined styles 153, 156, 158, 531predefined templates 515predefined text elements 486, 487predefined values 564predicates (XPath expressions) 93Preferences command 97, 413, 551Preferences dialog 98, 413, 551Prefix property 189, 388, 473presentations 23Preview page 27, 31, 42preview preferences 550, 551Preview Results section (Edit Data Set) 39,

97, 98Preview with format section (Format

Builder) 297previewer 27, 481, 595previewing

charts 356, 357, 412computed fields 100data 97data sets 97, 103, 269formatted values 297grouped reports 215groups 272HTML documents 31, 42images 130interactive features 510PDF documents 31, 42, 481report designs 118report parameters 284reports 23, 31, 166, 550sample chart data 384SQL statements 39XML data sets 95

printed reports 55, 57printing multipage reports 477privileges 77Problems page. See Problems viewProblems view 28, 80procedures 595process 595program archives 5, 10, 11, 13program requirements

BIRT RCP Report Designer 5BIRT Report Designer 6–7

program updates 17programmers xxi, 23, 29, 53, 515


650 I n d e x

programming interfaces 582See also application programming

interfaces; interfacesprogramming languages 582

See also scripting languagesproject libraries 522, 524–525project types 33projects

adding files to 28adding resources to 542, 543creating 22, 32opening 203reusing data sources in 64viewing error messages for 28viewing report 28

Prompt text property 288prompting for input 275, 277, 288, 298prompts 277, 279, 288.properties files 542properties

alternating colors and 163data set parameters and 282data sets and 82defined 596displaying 145dynamic text elements and 139filtering data and 263format patterns and 143formatting data and 145, 146grouped reports and 185JDBC connections and 65JDBC drivers and 72label elements and 140master pages and 494report elements and 45report parameters and 279, 287report templates and 534, 535restoring 530run-time connections and 77shared libraries and 517, 524, 530sorting and 182spacing elements and 170styles and 46, 153, 154, 155, 156text alignment and 165

Properties command 145properties list 595Properties page. See Properties viewProperties view 145, 595

Property Binding options 78, 103Property Editor

accessing 43adding table of contents and 505alternating colors and 163assigning resource files and 544assigning resource keys and 545, 549creating hyperlinks and 500, 502creating master pages and 488, 490, 494defined 596defining themes and 520filtering data with 270, 271, 286format property options in 46formatting charts and 474formatting data and 145, 146, 152, 159grouping data and 197, 198, 201hiding report elements and 176localizing text and 545, 546, 550mapping to alternate values and 173overview 28resetting date formats with 253selecting multiple report elements in 46sorting data and 182viewing binding information and 108,

122Property Editor command 43protocol 596prototypes 69publish 596Publish Library dialog 525Publish Library to Resource Folder

command 525Publish to Template Folder command 537Publish to Template Folder dialog 538publishing libraries 59, 525publishing report templates 533, 537purpose statements 54

Qquarterly reports 188, 191quartile function 222queries

See also SQL statementsaccessing multiple tables and 86building linked subreports and 315building lists and 291, 295changing 281, 530charting data and 385, 403, 405


I n d e x 651

queries (continued)creating 85, 87, 102defined 597filtering data with 258, 262, 268, 277, 278

examples for 259limiting data returned by 85matching text patterns and 267previewing result sets for 97retrieving data with 37, 81, 82, 85sorting data with 181validating 39, 97

Query section (Edit Data Set) 87Query wizard 82, 90question mark (?) character 250, 280Quick Add section (Select Key) 545quotation mark characters. See double

quotation mark character; single quotation mark character

Rradio buttons

adding values for 290–296formatting values for 288, 296, 297setting default values for 294, 296setting maximum number of values

for 296sorting values for 294testing values in 309

randomly generated data 413, 414range 597range fill colors 442range markers (charts) 440range of values

defined 597highlighting in charts 440searching 259, 266selecting grouping intervals for 186, 190

Range property 189, 191, 192range test conditions 259, 266rank function 222ratio setting (charts) 467RCP (defined) 571

See also rich client platformsRDBMS data sources 64record-level elements (XML) 95records 74, 257, 309

See also rowsReference Found dialog 66

referencing column bindings 111RegExp objects 249, 251

See also regular expressionsRegions button 465Regions dialog 465regression testing 558regular expressions 249, 250, 251, 597

See also expressionsrelational databases 67

See also databasesrelational models 85relational structures 85, 92relative paths 93release builds 7, 10, 12, 13removing. See deletingRename command 65renaming

column bindings 111columns 96, 97, 351data sources 64, 65resource keys 550

rendering environments 55rendering extensions 597Repeat Header option 121, 479repeated headings 200replace function 245, 247replacing

multiple strings 245specific characters 249, 251

report descriptions 124Report Design command 25report design environments 23

See also BIRT; Eclipsereport design files

creating 29, 350defined 597editing 520opening 29overview 516saving 204

Report Design perspective 11, 25report design perspective 10report design views 26report designer packages 4, 17report designers 9report designs

See also page layoutsaccessing 29


652 I n d e x

report designs (continued)accessing templates for 538adding columns to 171adding data sources to 64adding libraries to 515, 518, 520adding report elements to 516applying styles and 154, 531creating 22, 516creating charts and 374, 474creating locale-specific reports and 56,

541, 542creating multipage reports and 477defined 568displaying 29, 340drawing mock-ups of 58embedding images in 130, 131formatting data and 145, 152, 158grouping data in 185, 195, 197hiding elements in 175, 176importing styles for 156laying out reports and 115linking images to 130on-demand reporting and 276overview 21prerequisites for 53, 54previewing 118removing column bindings from 111removing data sources from 66returning values at run time for 120, 275,

277, 295saving 29selecting data for 85selecting fonts and 146setting filters in 265, 268, 270shared report environments and 107, 515sorting data in 181structure of 516time-sensitive data and 276updating 520viewing environments and 55viewing libraries in 518

report document files 598report document model (BIRT) 29

See also ROMreport documents. See documents; reportsreport editor 27, 29, 598report elements

See also specific type

accessing 28, 527, 529adding containers for 118adding multiple 117, 126adding to designs 40, 125–132, 516adding to libraries 517, 522, 529adjusting spacing between 344aligning 119, 165, 166applying styles to 153, 154, 155, 158arranging in grids 118–120arranging in lists 123–125arranging in tables 120–123changing 527, 538changing formatting rules for 161changing with conditions 159, 162creating column bindings for 109, 111creating formatting rules for 159, 162creating hyperlinks with 501, 502creating textual information and 133customizing 145, 152, 520, 524defined 598defining as inline elements 48deleting styles for 158designing master pages and 486, 487developing reports and 516displaying 28, 48filtering data and 263, 265, 270formatting 45, 145, 152, 158generating output-specific content

and 493generating table of contents and 504hiding 175–177inserting page breaks and 478linking to 497overview 117restrictions for placing 126retrieving data for 106selecting multiple 46setting properties for 45, 146spacing options for 166, 168, 170specifying resource keys for 542, 545structuring subreports and 312viewing properties for 145

report engine 13, 557report engine package 10report executable files 598

See also report object executable filesreport file types 576


I n d e x 653

report files 28, 32See also specific type

report footer sections 118, 121, 124report header sections 121, 124report headers 479report item extension sample plug-in 558report item extensions 599report items

See also report elementsadding to libraries 524, 529adding to templates 536defined 598standardizing 527

Report Items slot 527, 529report library files 517, 586report object model. See ROMreport parameters

See also cascading parametersadding to expressions 241assigning data types to 279assigning resource keys to 549associating connection parameters

with 77, 78binding to data set parameters 281–284binding to data sources 78changing 289creating 277, 278–280, 285data set parameters compared to 278defined 600defining cascading 301–307defining hyperlink expressions and 500displaying 287, 308filtering data with 277, 285formatting 296–297grouping 298–300localizing 549naming 78, 279overview 275–277reordering in Data Explorer 308returning dynamic values from 295returning static values from 291running dynamic queries and 102selecting 287setting default values for 277, 288, 289–

290setting display names for 299testing 308–309viewing properties for 289

viewing sample formats for 297Report Parameters category 241Report Parameters fields (Hyperlink

Options) 500Report Parameters list 308report projects. See projectsreport sections

adding charts to 373adding multiple master pages to 495adding report elements to 117, 118adding to designs 118arranging static elements in 118conditionally displaying 176controlling pagination for 478creating subreports and 125defined 603displaying data in 118, 121, 124laying out 115, 116, 117nesting 116, 117

report specifications. See report designsreport style 154report template files 517, 600report templates

accessing 517, 538adding report items to 536associating images with 533, 536, 537creating 517, 534customizing 534–536defined 608designing 517displaying 35, 517laying out reports and 57overview 532publishing 533, 537selecting 535setting properties for 534, 535structure of 516

Report templates section (New Report) 538report title sections 118, 119report viewer 31, 481, 511report viewer servlet 600reporting applications. See applicationsreporting platform. See BIRTreports

adding multiple master pages to 494, 495assigning resource files to 543–544binding data sets to 105controlling pagination for 478


654 I n d e x

reports (continued)creating 22, 34, 58, 234, 542defined 597deploying 59, 131designing. See designing reportsdeveloping 9, 515displaying 55, 340, 477formatting data and 23generating 30, 275grouping data and 57, 185, 195importing styles for 156laying out 23, 56, 115linking charts to 510–511linking to 311, 315, 499–500localizing 56, 541, 542nesting 311, 314opening 27organizing content of 180, 183overview 21planning for 22, 53, 54, 55previewing 23, 31, 166, 550reducing size of 276restricting data returned for 257returning no data 175reusing 57specifying data for 22, 85standardizing designs for 515testing 23

repository 525requests 601reserved words. See keywordsresizing

charts 357columns and rows 168–169page headers and footers 488

Resource File pick list 544resource files 541, 542, 543, 550, 601resource folder 517, 525, 526resource folders 59resource keys

assigning to charts 546–548assigning to report parameters 549assigning to text elements 545–546changing 550creating 542, 545defined 601localizing 541removing 546, 548, 550

renaming 550specifying 542

resources 59response 601response messages 601restarting Eclipse 80restoring JDBC drivers 72restoring property settings 530result sets

See also data setschanging number of rows in 97defined 601limiting data in 85previewing data in 97retrieving multiple 89returning from multiple tables 86returning from stored procedures 89returning from XML data sources 92sorting data in 85

rich client platforms 22, 24, 571RIGHT JOIN clause 87right outer joins 100roles 77ROM (defined) 599ROM definition file 599ROM elements 599ROM schemas 600rom.def 599rotating chart titles 431rotating charts 456Rotation section (Edit Font) 431row and column structures 118, 120row boundaries 169row heights 168, 169row numbers 222row properties 169rows

See also recordsadding to grids 119adding to tables 40, 121, 123adjusting spacing for 49aligning text in 165alternating colors for 163–165changing number returned 97counting 221, 222, 228creating group headings and 200, 201defined 601deleting 120


I n d e x 655

rows (continued)displaying aggregate values and 223, 224,

227, 229filtering 263, 269, 272generating computed values and 98grouping on 484hiding detail 234inserting charts in 373iterating through 138placing data in 121resizing 168, 169restricting retrieval of 258, 265retrieving from databases 86returning values in 221selecting cells in 49setting number per page 484spacing data elements with 341

.rptdesign files. See report design files

.rptdocument files. See report document files

.rptlibrary files. See report library files

.rpttemplate files. See report template filesrules

changing formatting 161creating formatting 159–161, 162, 163default precedence for 162deleting 163mapping to alternate values and 173reordering 163testing formatting 161, 162

run 602running average 221running stored procedures 91running totals 164, 223, 225runningCount function 165, 222, 484runningSum function 222run-time connections 77–79run-time filters 277, 285run-time parameters 280, 281run-time queries 102, 280

Ssample data (charts) 384, 413, 414sample database 32, 36

See also Classic Models sample databasesample report templates 58Samples package 10saving

data set parameters 284

data sets 83report designs 29, 204styles 156

Scalable Vector Graphics. See SVG formatsScale button 410Scale dialog 410scaling options (charts) 409scatter charts

See also chartscurve fitting and 453defining axes values for 406defining data series for 398–399formatting data series in 459–460labeling axis values in 439overview 378trendlines in 448

schemas 76, 87, 88, 602Scientific format setting 148scope 602script editor 27, 602Script page 27scripting engine 611scripting languages 603scripts 267, 509SDK package 603SDK software 6, 10SDO Runtime component 7searching for

multiple strings 245program updates 17specific characters 249, 251string patterns 249, 251

section footer rows 118, 121, 124section header rows 121, 124sections

adding charts to 373adding multiple master pages to 495adding report elements to 117, 118adding to designs 118arranging static elements in 118conditionally displaying 176controlling pagination for 478creating subreports and 125defined 603displaying data in 118, 121, 124laying out 115, 116, 117nesting 116, 117

sector colors 451


656 I n d e x

sector labels 359, 360, 468sector names 361sector size 355, 395, 468sectors 354, 395, 467

See also pie chartssecurity roles 77select 603Select a Data Source type page 65Select charset option 76Select Chart Type page

changing output formats and 380creating second y-axis and 410overview 365selecting chart type and 351

Select Chart Type page (Edit Chart) 411SELECT clause 85Select Columns page (New Data Set) 91Select Data Binding dialog 105, 109, 110Select Data page (New Chart)

defining data series and 386overview 366previewing data and 412selecting data sets and 353, 384

Select Data Set options 384Select file property 91Select folder option 76Select Folder page 75Select Key dialog 545SELECT keyword 85SELECT statements 85

See also SQL statementsSelect Value Column pick list 296selecting multiple report elements 46selecting report templates 535Selection values section (Edit

Parameter) 291Selection values text area 293semicolon (;) character 239Separator property 473separators (chart labels) 361, 473separators (text files) 73series

See also chartsadding values to legends 437adjusting depth 455adjusting widths 422changing type 449coloring 450–452

creating combination charts and 402, 448defined 603defining translucent 449displaying pie sectors and 354displaying type 369, 455entering expressions for 383, 386, 391formatting 448–471grouping data for 405hiding 449linking to 510plotting 375, 382setting interactive features for 506, 507setting up 383, 389sorting 403spacing 457stacking 454stretching markers for 455

Series Depth property 455series markers. See markers; tick marksSeries Palette button 367Series Palette dialog 367, 452Series section (Format Chart) 369, 455series types 448, 449Service Data Objects component 7servlets 604Set As Default button 294shadow colors 427Shadow pick list 427shadows

axis labels 448axis titles 440chart areas 423chart legends 433, 434chart titles 431curve-fitting labels 454dial labels 464marker labels 443plot areas 427

shared report development framework 515shared report environments 58, 515Show Curve Fitting Line option 453Show header on first property 490Show ToolTip option 509Show Value option 437side-by-side subreports 316SimpleDateFormat class 149single quotation mark (’) character 74, 268single-equality conditions (XPath) 93


I n d e x 657

single-position predicates (XPath) 93singleton pattern 594Slice Label property 468Slice Outline property 468Slice Size Definition property 355slice size series 395, 397slices. See pie charts; sectorsslots 527, 604Software Development Kit 6, 10, 603

See also JDK software; SDK packagesoftware interfaces 582software requirements

BIRT RCP Report Designer 5BIRT Report Designer 6–7

sort 604Sort alphabetically when prompting

option 294Sort Direction property (Edit Group) 195Sort Direction property (New Group) 187Sort Direction property (Property

Editor) 183sort fields 180, 182, 183, 193sort key expressions 43, 183, 195Sort Key field (Edit Group) 194Sort Key field (Property Editor) 182sort keys 182, 194, 605sort order

designing reports and 57grouping data and 187, 192, 195setting 183sorting data and 180

sort-and-group-by fields. See group keyssorting data

charts and 403expressions and 237from BIRT designer 181grouped reports and 187, 192–195overview 180queries and 85, 181string values and 183tutorial for 43user interface elements and 294

Sorting page (Edit Group) 194Sorting page (Property Editor) 182sorting properties 182Sorting tab 43, 182sorting values in lists 324

source codeediting 29, 558expressions as 239loading 585referencing columns and 96testing and debugging 23, 558

source data. See data sourcesspace characters 48, 74, 88, 393spacing

See also paddingchart areas and 416, 421, 427chart series and 457empty columns and rows and 120headers and footers and 488report elements and 136, 166–168, 170tutorial for adjusting 340, 344

spacing between rows 49spacing properties 170SQL (defined) 85, 605SQL data sets 82SQL language 605SQL reserved words 88SQL statements

See also queriesadding parameters to 280, 281adding sort conditions to 181changing 281, 530defined 605defining at run time 278, 284joining tables with 86–87previewing 39prompting users for 102selecting tables for 87setting filter conditions in 258, 259, 268

SQL Stored Procedure Query option 90stable builds 8stacked charts 375, 454Stacked option 455stacking chart series 454standard deviation 222Standard option (Format Specifier) 388, 389Standard Viewer 605starting

BIRT RCP Report Designer 15, 25BIRT Report Designer 11, 15, 24Eclipse 24

starting valuesgrouping data and 190, 191


658 I n d e x

starting values (continued)plotting 379, 400

state. See instance variablesstatements 239, 605static elements 118static images 129static lists 291, 293static tables 117static text

adding to dynamic text elements 136adding to reports 541combining with dynamic data 134, 135,

141, 142, 224combining with numbers 244controlling spacing for 136creating column bindings for 109creating group headings and 202creating report titles and 135defined 133displaying 117, 134formatting 135localizing 545, 546setting run-time connections and 77

static variables 606See also dynamic variables; variables

stdDev function 222stock charts

See also chartschanging series type in 449coloring data series for 450curve fitting and 453defining axes values for 406defining axis titles for 439defining data series for 400–402formatting data series in 471overview 379

stocks, tracking value of 379, 400stored procedures 88, 89straddle. See mergingstraight cursor 125strike through text style 147strikethrough text options 431String data type 606string expressions 606string fields 245, 260, 267string format types 151string functions 241, 245, 248

string substitution 245STRING type indicator 75strings

concatenating 48, 128, 246, 247containing null values 297containing zero (0) values 244converting case for 151converting numbers to 244converting to numbers 252creating user-selection lists for 290defining numbers as 238defining textual information and 133, 134displaying portions of 247, 248finding specific characters in 248formatting 135, 150–152formatting numbers and 147grouping by interval 189inputting date values and 280matching patterns in 249–252, 260, 267replacing instances of 245replacing values in 245returning from expressions 245–252returning length of 248selecting at run time 298sorting 183translating 56

structured content 115, 606Structured Query Language. See SQLstructures libraries 523style elements 519style properties

cascading styles and 154displaying 155setting 153, 155, 158unsupported 156

style sheets 559See also cascading style sheets

stylesadding to libraries 520, 521, 529, 531applying from libraries 531applying predefined 153changing 158, 519creating 46, 153, 154, 155customizing 47, 156defined 606defining chart 474deleting 158


I n d e x 659

styles (continued)formatting with 152importing 153, 156–157inheriting 154localized reports and 337, 339selecting 158setting for multiple report elements 45sharing reports and 516, 517, 520, 523

subclasses 607See also descendant classes

subDate function 254subreports

aligning data in 314building data sets for 318, 320, 322building queries for 332creating 125, 316, 325, 329

examples for 312, 313defined 607defining links for 315, 327, 331displaying in web browsers 340formatting 335highlighting data in 335laying out 312, 314, 333overview 311

substr function 248substrings 245, 247, 248subtotals 224, 225subtraction 243Suffix property 388, 473sum function 222, 230summary data. See summary valuessummary reports 234–236summary values

See also aggregate valuesadding to grouped reports 187adding to lists 124adding to tables 121designing reports and 57displaying 219grouping data and 210plotting 385returning from groups 229

superclasses 607See also ancestor classes

SVG (defined) 379SVG formats 379SVG output 379syntax (programming languages) 607

Ttable cells 172

See also cellstable elements

See also tablesadding 40, 120, 519as containers 120defined 117, 607placing image elements in 131placing in grid elements 333placing in libraries 523viewing placement of 340

table headers 154, 211Table Mapping page 94table names 88table of contents

automatically generating 184, 215creating 216, 503–505displaying 215retrieving data for 187

table of contents button 215table style 154Table tab 43, 47, 123table-detail style 154table-footer style 154table-header style 154table-level attributes (XML) 93table-level elements (XML) 94tables

See also databases; table elementsadding borders to 346, 347adding charts to 373adding CLOB fields to 138adding data set fields to 121, 122, 123,

127, 205adding rows to 121, 123adding to queries 87adding to reports 40, 117, 120adjusting spacing for 49, 168, 170aggregating values in 222–223, 225aligning content in 165–166applying styles to 154binding to data sets 122–123, 142changing 123creating 171, 325, 329creating column headings for 96, 335creating subreports and 312, 314


660 I n d e x

tables (continued)defined 607defining column bindings for 109defining relational structures for 92defining XML data mappings for 93displaying 168filtering data in 88, 263, 270, 286grouping data in 185, 186, 197, 202, 211increasing spacing between 344inserting header rows in 211inserting report elements in 121, 122inserting textual elements in 138, 142joining 86, 100, 101mapping to XML 94merging cells in 172organizing elements in 120–123placing side-by-side 333resizing columns and rows in 169retrieving data from 85selecting 43, 47sorting data in 181, 326, 330specifying width 167viewing binding information for 122, 123viewing columns in 88

tabs 607See also page

tabular layouts 118, 120tags 608

See also elementstelephone numbers 150, 252template files 517, 600template folder 517, 537template report elements 517template report items 538templates

accessing 517, 538adding report items to 536associating images with 533, 536, 537creating 516, 517, 534customizing 534–536defined 608designing 517displaying 35, 517laying out reports and 57overview 532publishing 533, 537selecting 535setting properties for 534, 535

structure of 516temporary directory 103Test Connection button 69test packages 558testing

BIRT installations 11, 14character patterns 260, 267connections 69data sets 23filter conditions 280for null values 260, 266formatting rules 161, 162locale-specific reports 550map rules 174parameters 284, 308range of values 259, 266reports 23sets of values 260subreports 311viewing environments 55

textSee also static text; text elementsaligning 147, 165, 431applying styles to 153as introductory material 124as static elements 118automatically completing 290changing 139, 245, 487combining from multiple fields 246, 247combining with dynamic data 135creating data sources and 77displaying 117, 133, 134entering 487formatting 51, 135, 141, 143grouping in charts 404, 405localizing 56, 542, 545, 546plotting 404, 406, 407returning from expressions 239, 245wrapping 437

text attributes 134, 147, 431text axis type 407text boxes 288, 289, 290

enabling blank or null values for 298text color options 431text editors 29, 138, 140, 542text elements

See also textadding dynamic values to 135


I n d e x 661

text elements (continued)adding HTML tags to 141adding JavaScript expressions to 137, 141,

142adding to designs 134, 140, 519adding to grid elements 118adding to list elements 124, 125adding to master pages 486, 487adding to page headers and footers 487adding to table elements 121aggregating data and 224assigning resource keys to 545binding to data sets 142creating column bindings for 109creating group headings and 202creating messages with 175, 177creating report titles and 51, 135defined 117, 609formatting data in 148, 150, 152formatting dynamic values in 143formatting static text in 135formatting strings in 150preserving HTML formats and 136, 143removing resource keys for 546selecting predefined 486, 487

text fields 245text file data sources 73–76, 91

See also text filestext files

accessing data in 63, 73, 75, 91connecting to 75defining parameters for 285displaying data in 91exporting data to 511–513filtering data in 262localizing reports and 542retrieving data from 85, 91selecting character sets for 76selecting data in 91setting location of 76setting up 73–74sorting data in 181specifying data types for 74, 76

Text Format button 434Text Format dialog 439, 448text formats 51, 140Text key property 545text messages 175, 177

text patterns 249, 251, 260, 267, 597text strings. See stringstext style (predefined) 154text styles 134, 147text-alignment property 165textual elements 133, 135

See also specific typetextual information 133, 135

See also textthemes 517, 521, 523, 531, 609

See also stylesThemes property 531Then expressions 1613-D charts

coloring areas in 420curve fitting and 453formatting 456rotating axes in 456selecting as type 374setting inset values for 422setting series depth in 455spacing series in 457transposing axes values and 411

thumbnail images 502tick 609tick interval 609tick marks 443, 444, 463

See also markers (charts)tick settings 444time axis type 407time continuums 379TIME data type 75time data type 567time expressions 387, 389time format options 389time formats

charting expressions and 387, 389customizing 389setting 149

time functions 252time period values (grouping intervals) 192TIME type indicator 75time values

displaying date values and 253getting parts of 253grouping by interval 191, 192grouping in charts 405plotting 374, 406


662 I n d e x

TIMESTAMP data type 75TIMESTAMP type indicator 75title area (charts)

adding shadows to 431aligning text in 431anchoring text to 432changing spacing of 416, 421formatting text in 430hiding 423, 430highlighting 423laying out 422, 423, 429setting background colors for 431setting font attributes for 431setting interactive features for 506setting padding around 421, 424, 432

title bar (Property Editor) 50Title Format button 430Title Format dialog 430, 432title text area (charts) 431titles

adding to charts 429, 430, 461adding to legends 438adding to tables 121adjusting spacing for 170changing chart 358, 430creating report 118, 134, 135formatting chart 430, 438formatting text in 135hiding 430localizing 542outlining legend 439rotating 431specifying inset settings for 432

TOC Item Expression property 187Toggle Data Point Visibility option 509Toggle Visibility option 509toLowerCase function 183toolbars 609ToolTips 241, 288top n logic filters 267top n summary reports 235top-level groups 195, 196, 197toString function 244Total class 220totals

See also summary valuesaggregating data and 223, 229as percentage of whole 231

calculating 108, 128, 224, 225charting data and 349, 378color-coding 162, 164comparing 255generating computed values and 98generating running 225placing in detail rows 223placing in footer rows 121, 223, 225placing in header rows 223, 224retrieving 222returning from groups 229, 231

toUpperCase function 183translators. See converterstranslucent data series 449transparent backgrounds (charts) 417, 418,

433transparent colors (charts) 420tree views 340trendlines (charts) 448triggers. See actions; eventstroubleshooting connections 79troubleshooting installation problems 14–15tutorials

building listing reports 32–52building side-by-side subreports 316–348creating charts 349–364filtering run-time queries 278–287grouping report data 202–215

TXT files 74See also text files

Type pick list 407Type pick list (Interactivity) 508types. See data typestypographic conventions

(documentation) xxvi

UUCS2 code point values 183undefined values 244underlays. See watermarksunderline text style 147underscore (_) character 88ungrouped reports 180Unicode 610Unicode encoding 610Uniform Resource Locators. See URLsunique values 221, 228, 289, 291Unit Spacing property 457


I n d e x 663

unit spacing values 457Units pick list 422universal hyperlinks. See hyperlinksUniversal Resource Identifiers. See URIsUNIX platforms 15unpacking BIRT archives 5, 10unusable data sets 67updates 17updating

data formats 146designer packages 17list of values 291report designers 18report designs 520report libraries 528

upgrades 17uppercase characters 151, 183Uppercase format option 151URI option 130URIs 131, 502, 610URL Redirect option 509URL redirect option 510URL Template property 72URLs

database connections and 67defined 610Eclipse Modeling Framework and 7Eclipse SDK software 6Graphics Editor Framework and 7image files and 131, 491installation demo and 5iText PDF library and 11, 12, 13JDBC connections and 69, 72JDK software and 5, 6ODA framework and 63program archives and 10, 12, 13redirecting from 509XML data sources and 77XML schemas and 77XML specification and 76

Use data set option 353Use fixed base value option 191Use identifier quoting option 89user IDs 252user interface elements 290, 296user name parameters 78User Name property 69, 78user names 67, 69, 77

user-defined formulas 106user-named styles 156users

changing at run time 77creating lists of values for 290–296, 297creating reports and 54, 56prompting 275, 277, 288, 298specifying filters 277, 278, 285

Vvalue axis 406, 409value expressions 137, 269value series

See also data seriesbuilding combination charts and 402changing 449coloring 367, 450creating multiple 391, 395, 398, 401, 403defined 382displaying options for 369formatting 448linking to 510setting chart type for 389, 393, 395, 400setting interactive features for 506, 507

Value Series section (Format Chart) 369value series titles 461VALUE-OF tag

combining dynamic and static values and 141, 142

formatting and 143, 148, 152values

See also dataassigning to parameters 288, 289averaging 220, 221, 228calculating 128changing formats and 158combining from multiple fields 246combining with literal text 244comparing 259, 266computing number of unique 228concatenating 48, 98, 128, 246counting unique 221creating labels for 294creating pictures for 175data types as 238defined 610defining axis type and 407, 409


664 I n d e x

values (continued)displaying 117, 290, 296, 301eliminating duplicate 184getting highest 221getting lowest 221getting median 221grouping range of 190grouping report data and 187, 197importing 291, 292, 293mapping to alternate 173–174plotting as data series 378, 385, 387, 404plotting linear 377, 407previewing formatted 297prompting for 275, 277, 288, 298reformatting 296removing null 247retrieving at run time 120, 275, 277, 295returning from expressions 98, 237, 239,

254returning from parameters 282returning zero 243selecting 290, 291, 295, 301showing relationships to whole 378specifying base 190, 191testing for null 260, 266testing range of 259, 266testing sets of 260

VARCHAR data type 75variable formats 140variable names 238variables

defined 610expressions and 237, 238, 239parameters as 278pattern matching and 250

variance 222variance function 222VBScript 611vector graphics file formats 379vertical alignment

background images 492chart legends 437report content 165

vertical spacing (charts) 427, 428vertical spacing (reports) 166, 170, 340vertical-alignment property 165, 166View Report as HTML command 31, 481View Report as PDF command 31

View Report in Web Viewer command 31, 215, 481

viewer. See report viewerviewing

aggregate values 219alternate values 173available drivers 69charts 350column-binding information 108, 122current date 128, 253, 486current projects 28data 105, 115, 136, 237, 485, 497data groups 197, 199data set fields 238data set parameters 282, 385database schemas 87database views 88date and time values 149detail rows 187errors 79group headings 200, 213HTML reports 478images 117, 129, 175JavaScript functions 241master pages 27, 485numbers 147output 27, 168, 493output columns 97page layouts 115parameter groups 300, 308PDF documents 478percentages 234report designs 29, 340report elements 28, 48report parameters 287, 308report properties 145report templates 35, 517reports 55, 340, 477report-specific libraries 28resource keys 545, 548, 550sample parameter formats 297summary values 219table of contents 215text 117, 133, 134text messages 175value expressions 137

viewsBIRT Report Designer 26


I n d e x 665

views (continued)defined 611displaying database 88Eclipse platform and 25, 571filtering database 88

Visibility property 175, 176visibility settings

axis labels 447axis titles 439chart areas 423chart outlines 419chart series 449, 450chart titles 430curve-fitting lines 454grid lines 445leader lines 470legends 435, 438marker labels 443plot areas 426report elements 176, 493tick marks 445

visibility toggles 509Visual Basic Script Edition. See VBScriptvisual report elements 516, 527

Wwall (charts) 420.war files 611watermarks 490–492web applications xviii, 275web archive files 611web browsers 379, 509, 577web pages

adding images to 117defined 611displaying tables in 167, 168importing styles from 153, 156linking to 501, 502padding and margins in 340

web servers 611web standards 612Web Viewer 31

See also report viewerweekly reports 191weighted average 222weightedAve function 222well-formed XML 612

WHERE clause 85, 258, 260See also SQL statements

white space characters 48, 74, 88, 393white space in reports. See spacingwidth hint (charts) 428, 429Width Hint property 429Width property 169wildcard characters 250windows 589

See also application windowWindows platforms 15wizards 63Word styles 152workbench projects

See also Eclipse workbench; projectsworkspace. See Eclipse workspaceworkspace directory 18Workspace Launcher (Eclipse) 24World Wide Web Consortium (W3C) 612wrapping chart legend text 437Wrapping Width option 437

XX Axis section (Format Chart) 461x-axis

See also axes valuesadding markers to 440building 405, 406changing line styles for 443, 444defining data series for 389overlapping labels and 446position of 415scaling 409setting options for 371transposing 411

x-axis labels 415, 446, 448x-axis rotation settings 456x-axis titles 439XML (defined) 575XML attributes 261XML code 29, 30XML data 63, 76XML data mappings 93, 94, 260XML data sets 92, 94, 95, 260, 261XML data sources

accessing data in 76, 94associating with data sets 94


666 I n d e x

XML data sources (continued)connecting to 76creating 76defining parameters for 285filtering data in 260–262naming 76previewing data sets for 95retrieving data from 85, 92, 258

XML DataSet page 94XML documents 76, 92, 260, 612XML editor 27, 29XML elements 92, 260, 261, 572XML files

deleting column mappings for 95filtering 285mapping to data in 93, 94, 260, 261selecting 77, 94validating 76

XML PATH language 612XML schema files 77XML schemas 76, 602XML Source page 27XML Source tab 30XML specification 76XML structures 261XPath expressions

accessing XML data sources and 92, 260creating 92–94defined 612

filtering with 260, 261, 262mapping to XML data and 95

XPath functions 93XPath property 95

Yy series items 454, 472y-axis

See also axes valuesadding a second 410–411arranging tick marks on 443building 405, 406changing line styles for 443, 444defining data series for 389highlighting points on 440overlapping labels and 446scaling 409, 410setting options for 371transposing 411

y-axis labels 446, 448y-axis rotation settings 456y-axis titles 439

Zz-axis rotation settings 456zero values 243zip codes 252ZIP files. See archive files


Index Symbols Numerics A - Pearsoncmg.com

Documents

Transcript of Index Symbols Numerics A - Pearsoncmg.com