McGraw hill crystal reports 2008 the complete reference jun 2008 ISBN 0071590986 pdf

Crystal Reports® 2008:
The Complete Reference


This page intentionally left blank


Crystal Reports® 2008:
The Complete Reference

George Peck

New York Chicago San Francisco
Lisbon London Madrid Mexico City
Milan New Delhi San Juan
Seoul Singapore Sydney Toronto


Copyright © 2008 by The McGraw-Hill Companies. All rights reserved. Manufactured in the United States of America. Except as
permitted under the United States Copyright Act of 1976, no part of this publication may be reproduced or distributed in any form or by
any means, or stored in a database or retrieval system, without the prior written permission of the publisher.
0-07-159099-4
The material in this eBook also appears in the print version of this title: 0-07-159098-6.
All trademarks are trademarks of their respective owners. Rather than put a trademark symbol after every occurrence of a trademarked
name, we use names in an editorial fashion only, and to the benefit of the trademark owner, with no intention of infringement of the
trademark. Where such designations appear in this book, they have been printed with initial caps.
McGraw-Hill eBooks are available at special quantity discounts to use as premiums and sales promotions, or for use in corporate
training programs. For more information, please contact George Hoare, Special Sales, at or (212) 9044069.
TERMS OF USE
This is a copyrighted work and The McGraw-Hill Companies, Inc. (“McGraw-Hill”) and its licensors reserve all rights in and to the work.

Use of this work is subject to these terms. Except as permitted under the Copyright Act of 1976 and the right to store and retrieve one
copy of the work, you may not decompile, disassemble, reverse engineer, reproduce, modify, create derivative works based upon,
transmit, distribute, disseminate, sell, publish or sublicense the work or any part of it without McGraw-Hill’s prior consent. You may use
the work for your own noncommercial and personal use; any other use of the work is strictly prohibited. Your right to use the work may
be terminated if you fail to comply with these terms.
THE WORK IS PROVIDED “AS IS.” McGRAW-HILL AND ITS LICENSORS MAKE NO GUARANTEES OR WARRANTIES AS TO
THE ACCURACY, ADEQUACY OR COMPLETENESS OF OR RESULTS TO BE OBTAINED FROM USING THE WORK,
INCLUDING ANY INFORMATION THAT CAN BE ACCESSED THROUGH THE WORK VIA HYPERLINK OR OTHERWISE,
AND EXPRESSLY DISCLAIM ANY WARRANTY, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. McGraw-Hill and its licensors do not warrant or guarantee that the functions contained in the work will meet your requirements or that its operation will be uninterrupted or error
free. Neither McGraw-Hill nor its licensors shall be liable to you or anyone else for any inaccuracy, error or omission, regardless of cause,
in the work or for any damages resulting therefrom. McGraw-Hill has no responsibility for the content of any information accessed
through the work. Under no circumstances shall McGraw-Hill and/or its licensors be liable for any indirect, incidental, special, punitive,
consequential or similar damages that result from the use of or inability to use the work, even if any of them has been advised of the
possibility of such damages. This limitation of liability shall apply to any claim or cause whatsoever whether such claim or cause arises
in contract, tort or otherwise.
DOI: 10.1036/0071590986


Professional

Want to learn more?
We hope you enjoy this
McGraw-Hill eBook! If
you’d like more information about this book,
its author, or related books and websites,
please click here.


About the Author

George Peck has been involved in various IT pursuits for close to 30
years. He founded his own consulting and training firm, The Ablaze
Group, in 1994 (www.AblazeGroup.com). He has trained, consulted,
and developed custom software for large and small organizations
throughout the United States, Canada, the United Kingdom, and Puerto
Rico.
George works as both a trainer and consultant exclusively with
Crystal Reports and the BusinessObjects Enterprise family. This is his
seventh title in the Crystal Reports: The Complete Reference series, bestsellers published by McGraw-Hill/Osborne. He is also the author of
Crystal Reports Professional Results, also published by McGraw-Hill/
Osborne.
In addition to his software career, George is a broadcaster and voice
actor. His voice may be heard on national radio, TV, and web
commercials, promotions, and documentaries.

About the Technical Editor
Ian Treleaven is a software engineer working on the Crystal Reports
product development team. He has helped create Crystal Reports
features as a Senior Developer, Development Lead, and most recently as
a Program Manager. Prior to working on Crystal Reports at Seagate
Software/Crystal Decisions/Business Objects/SAP, Ian worked for a
number of years in the industry at various companies including
Microsoft and IBM.

Copyright © 2008 by The McGraw-Hill Companies. Click here for terms of use.


This page intentionally left blank

In memory of my Father
My true writing inspiration


This page intentionally left blank


Contents at a Glance

Part I Designing Reports
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

Getting a Feel for Crystal Reports 2008 . . . . . . . . . . . . . . . . . . . . . . . . . .
Sorting and Grouping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Analyzing with Advanced Selection Criteria . . . . . . . . . . . . . . . . . . . . .
Using Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Creating Custom Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Making Your Reports Visually Appealing . . . . . . . . . . . . . . . . . . . . . . .
Using Sections and Areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Analyzing with Cross Tabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Creating Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Creating Geographic Maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Integration with Crystal Xcelsius and Flash . . . . . . . . . . . . . . . . . . . . . .
Using Subreports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Interactive Reporting with Parameter Fields . . . . . . . . . . . . . . . . . . . . .
Exporting Reports to Different Formats . . . . . . . . . . . . . . . . . . . . . . . . .
Reporting from SQL Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Reporting from Proprietary Data Types . . . . . . . . . . . . . . . . . . . . . . . . . .
Reporting from OLAP Cubes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Accommodating Database Changes and Field Mapping . . . . . . . . . . .
Creating Crystal Reports Applications with Visual Studio .NET . . .

3
37
71
85
155
171
215
245
291
325

341
359
379
419
437
491
519
543
565

Part II Crystal Reports Enterprise Reporting
20
21
22
Appendix

Crystal Reports Web Alternatives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using InfoView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Administering Enterprise Reporting Sytems . . . . . . . . . . . . . . . . . . . . .
Formula Language Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

607
637
697
787

Index

941

........................................................

ix


This page intentionally left blank


For more information about this title, click here

Contents
Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxxiii
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxxv

Part I Designing Reports
1

Getting a Feel for Crystal Reports 2008 . . . . . . . . . . . . . . . . . . . . . . . . . .
Introducing Crystal Reports 2008 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Crystal Reports Screen Elements . . . . . . . . . . . . . . . . . . . . . . . . . . .
Starting Out: Opening or Creating a Report . . . . . . . . . . . . . . . . .
Using the Report Wizards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using the Blank Report Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Database Expert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Design Tab and Field Explorer . . . . . . . . . . . . . . . . . . . . . . . . .
Report Sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Previewing the Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Moving and Sizing Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Formatting Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Customizing Crystal Reports Behavior . . . . . . . . . . . . . . . . . . . . .

The Report Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Workbench . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Creating Projects and Adding Existing Reports . . . . . . . . . . . . . .
Adding Report Packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Dependency Checker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Checking Dependencies in the Current Report . . . . . . . . . . . . . . .
Checking Dependencies for Workbench Projects . . . . . . . . . . . . .

3
3
4
8
9
13
13
15
17
18
19
21
23
28
29
30
31
32
32
34

2

Sorting and Grouping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Sorting Your Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
New Interactive Sorting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Grouping Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Manipulating Existing Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Group Expert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Adding Summaries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

37
37
38
40
45
46
46

xi


xii

Crystal Reports 2008: The Complete Reference

Multiple Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Specified Order Grouping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Drilling Down on Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Grouping on Date Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Customizing Group Name Fields . . . . . . . . . . . . . . . . . . . . . . . . . .
Grouping on Formula Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Top N Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Hierarchical Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

52
54
56
59
60
61
62
66

3

Analyzing with Advanced Selection Criteria . . . . . . . . . . . . . . . . . . . . .
Three Different Ways to Select Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Select Expert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Refreshing the Report Versus Using Saved Data . . . . . . . . . . . . .
Selection with Date Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Manipulating the Selection Formula Directly . . . . . . . . . . . . . . . . . . . . . .
Performance Considerations with Record Selection . . . . . . . . . . . . . . . .

71
71
73
78
79
81
83

4

Using Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Formula Workshop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Formula Expert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Formula Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Data Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Creating a New Formula . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Editing, Renaming, or Deleting an Existing Formula . . . . . . . . . .
Copying Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Number Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Order of Precedence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
String Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The ToText Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Picking Apart Strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Date/Time Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Number of Days Between Dates . . . . . . . . . . . . . . . . . . . . . . . . . . .
Number of Hours and Minutes Between Times . . . . . . . . . . . . . .
Month, Day, Year, Hour, Minute, and Seconds Functions . . . . . .
DateValue Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
If-Then-Else Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Data Types in If-Then-Else Formulas . . . . . . . . . . . . . . . . . . . . . . .
Multiple Actions with One If-Then-Else Statement . . . . . . . . . . .
Helpful Built-in Functions for If-Then-Else Formulas . . . . . . . . .
Other Crystal Reports Logic Constructs . . . . . . . . . . . . . . . . . . . . . . . . . .
Select Case Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

85
85
89

91
101
103
107
108
109
111
112
116
118
120
120
121
122
122
123
124
126
129
130
130


Contents

For Loop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
While Do Loop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Boolean Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Variables in Formulas and Evaluation Times . . . . . . . . . . . . . . . . . . . . . .
Declaring a Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Variable Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Assigning a Value to a Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Displaying a Variable’s Contents . . . . . . . . . . . . . . . . . . . . . . . . . . .
Evaluation Times and Report Passes . . . . . . . . . . . . . . . . . . . . . . .
When Not to Use Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
User Function Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Running Total Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

131
133
134
136
136
138
138
140
141
146
148
149

5

Creating Custom Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Custom Functions Defined . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Creating Your Own Custom Functions . . . . . . . . . . . . . . . . . . . . . . . . . . .
Extracting Custom Functions from Existing Formulas . . . . . . . .
Creating Custom Functions from Scratch . . . . . . . . . . . . . . . . . . .
Modifying Existing Custom Functions . . . . . . . . . . . . . . . . . . . . . .
Sharing Custom Functions with Other Users . . . . . . . . . . . . . . . . . . . . . .

Using Custom Functions in Your Formulas . . . . . . . . . . . . . . . . . . . . . . .

155
155
157
157
162
166
168
168

6

Making Your Reports Visually Appealing . . . . . . . . . . . . . . . . . . . . . . .
Setting Page Size, Orientation, and Margins . . . . . . . . . . . . . . . . . . . . . . .
General Formatting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Formatting Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Format Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Highlighting Expert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Conditional Formatting Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Absolute Versus Conditional Formatting . . . . . . . . . . . . . . . . . . . .
Creative Use of the Suppress Property . . . . . . . . . . . . . . . . . . . . . .
Special Fonts, Graphics, Line Drawing, and Barcodes . . . . . . . . . . . . . .
Using Special Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using Bitmap Graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Line and Box Drawing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Printing Barcodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Text and Paragraph Formatting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Format Editor Paragraph Formatting Tab . . . . . . . . . . . . . . . . . . .
The Format Painter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Report Alerts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

171
171
174
174
174
177
179
179
183
184
184
186
190
190
192
193
195
196

xiii


xiv

Crystal Reports 2008: The Complete Reference

Basing Report Formulas or Conditional Formatting on Report
Alerts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Crystal Reports Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Template Expert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Creating Your Own Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Adding Custom Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Field Heading Text Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Combining Database Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Combining Special Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Formatting Individual Parts of Text Objects . . . . . . . . . . . . . . . . .
Importing Text from a File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

200
200
202
203
206
207
208
210
212
213

7

Using Sections and Areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Formatting Sections with the Section Expert . . . . . . . . . . . . . . . . . . . . . .
The Section Expert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Creating Summary and Drill-Down Reports . . . . . . . . . . . . . . . . . . . . . .
Drill-Down Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Multiple-Column Reports for Labels and Listings . . . . . . . . . . . . . . . . . .
Using Multiple Sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Conditionally Suppressing Sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Printing a Bonus Message for Certain Records . . . . . . . . . . . . . . .
Printing a Different Page Header on Page 2 and Later . . . . . . . .
Printing Odd and Even Page Headers or Footers . . . . . . . . . . . . .
Underlaying Sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

215
215
217
227
229
233
235
239
239
239
240
241

8

Analyzing with Cross-Tabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Creating a Cross-Tab Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Editing an Existing Cross-Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Creative Use of Grouping and Formulas . . . . . . . . . . . . . . . . . . . .
Multiple Rows, Columns, and Summarized Fields . . . . . . . . . . . . . . . . .
Reordering Fields in the Rows, Columns, or Summarized
Field Boxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
New Derived Rows, Columns, and Cells . . . . . . . . . . . . . . . . . . . . . . . . .
Creating Calculated Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Using Embedded Summaries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Customizing Cross-Tab Appearance . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Style Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Customize Style Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Labels or Legends with Cross-Tabs . . . . . . . . . . . . . . . . . . . . . . . . .
Conditionally Formatting Cross-Tabs . . . . . . . . . . . . . . . . . . . . . . .
Cross-Tab Virtual Page Formatting Options . . . . . . . . . . . . . . . . .

245
245
250
252
255
259
259
260
274
277
279
280
284
285
288


Contents

9

Creating Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Types and Layouts of Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chart Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Chart Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Creating Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Type Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Data Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Axes Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Options Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Color Highlight Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Text Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Placing and Sizing Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Modifying Existing Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Zooming In and Out on Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Drilling Down on Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Finer Points of Chart Formatting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Customizing Charts with Chart Options . . . . . . . . . . . . . . . . . . . .

291
291
292
293
294
295
295
306
308
310
310
311
314

315
315
316
316

10

Creating Geographic Maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Different Map Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Adding a Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Data Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Type Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Text Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Drilling Down on Maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Changing the Map View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Map Navigator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Resolving Data Mismatches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Map Layers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

325
325
327
327
333
333
333
334
334
335
337

11

Integration with Crystal Xcelsius and Flash . . . . . . . . . . . . . . . . . . . . . .
Adding a Flash .SWF File to a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Flash Formatting Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Integrating Crystal Reports 2008 with Xcelsius . . . . . . . . . . . . . . . . . . . .
Using Flash Variables with Crystal Xcelsius 4.5 . . . . . . . . . . . . . .
Integration with Xcelsius 2008 . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

341
341
342
344
344
351

12

Using Subreports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Unlinked Subreports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Drilling Down on Subreports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

359
360
364

xv

xvi

Crystal Reports 2008: The Complete Reference

Linked Subreports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Linking Based on Formula Fields . . . . . . . . . . . . . . . . . . . . . . . . . .
Linking to Existing Parameter Fields in Subreports . . . . . . . . . . .
Subreport Formatting with the Format Editor . . . . . . . . . . . . . . . . . . . . .
On-Demand Versus In-Place Subreports . . . . . . . . . . . . . . . . . . . . . . . . . .
Passing Data Between Main Reports and Subreports . . . . . . . . . . . . . . .
Handling Empty Subreports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Performance Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

366
369
370
371
372
374
376
378

13

Interactive Reporting with Parameter Fields . . . . . . . . . . . . . . . . . . . . .
Creating a Parameter Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Responding to Parameter Field Prompts . . . . . . . . . . . . . . . . . . . .
Data Type Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using Parameter Fields in Record, Group, or Saved Data Selection . . .
The New Parameter Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Displaying Parameter Field Values on the Report . . . . . . . . . . . . . . . . . .
Creating Pick Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Static Pick Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Dynamic and Cascading Pick Lists . . . . . . . . . . . . . . . . . . . . . . . . .
Special Parameter Field Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Optional Parameter Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Multiple Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Range Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Controlling Parameter Field Data Entry . . . . . . . . . . . . . . . . . . . . .
Conditional Formatting with Parameter Fields . . . . . . . . . . . . . . . . . . . .
Highlighting Data Based on Parameter Fields . . . . . . . . . . . . . . .
Conditional Suppression Based on Parameter Fields . . . . . . . . . .
Using Parameter Fields with Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using a Parameter Field for Partial Text Matches . . . . . . . . . . . . .
Using a Parameter Field to Change Sorting or Grouping . . . . . .
Using a Parameter Field to Control Top N Reporting . . . . . . . . .

379
380
382
383
385
389
391
392
393
395
402
402
404

405
409
411
411
412
413
413
415
416

14

Exporting Reports to Different Formats . . . . . . . . . . . . . . . . . . . . . . . . .
Exporting Reports to Office Applications . . . . . . . . . . . . . . . . . . . . . . . . .
Exporting to Different File Formats . . . . . . . . . . . . . . . . . . . . . . . . .
Exporting and Launching an Application . . . . . . . . . . . . . . . . . . .
Exporting to an ODBC Data Source . . . . . . . . . . . . . . . . . . . . . . . .
Sending Reports via E-Mail and Messaging Systems . . . . . . . . . . . . . . .
New Crystal Reports 2008 XML Exporting . . . . . . . . . . . . . . . . . . . . . . . .
Initial Export via Crystal Reports XML Schema . . . . . . . . . . . . . .
Using an XSLT Transform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

419
420
420
428
428
428
430
431

433


Contents

15

Reporting from SQL Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Logging On to SQL Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Direct Database Drivers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ODBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OLE DB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Choosing the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Changing SQL Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Changing to a Different Database . . . . . . . . . . . . . . . . . . . . . . . . . .
Adding Additional Tables to the Report . . . . . . . . . . . . . . . . . . . .
Removing Unused Tables from the Report . . . . . . . . . . . . . . . . . .
Linking Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Database Expert Links Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using Multiple Database Types in the Same Report . . . . . . . . . .
Join Types, Link Types, and Join Enforcement . . . . . . . . . . . . . . .
Viewing the SQL Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Crystal Reports SQL Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Creating the SQL Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using a SQL Command in a Report . . . . . . . . . . . . . . . . . . . . . . . .
Using SQL Stored Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Choosing Stored Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Working with Stored Procedure Parameters . . . . . . . . . . . . . . . . .
Using SQL Expression Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Creating SQL Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Grouping on the Database Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Enabling Server-Based Grouping . . . . . . . . . . . . . . . . . . . . . . . . . .
What’s Required to Use Server-Based Grouping . . . . . . . . . . . . .
Effects of Drill-Down . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Accommodating Database Changes and Field Mapping . . . . . . . . . . . .
Recognizing Database Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Mapping Old Fields to New Names . . . . . . . . . . . . . . . . . . . . . . . .
Performance Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Let the Server Do the Work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Use Indexed Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

437
438
438
439
439
440
445
447
448
449
449
451
454
456
462
464
464
467
468

468
469
471
471
475
477
478
478
480
481
487
489
489
490

16

Reporting from Proprietary Data Types . . . . . . . . . . . . . . . . . . . . . . . . . .
Reporting from Microsoft Outlook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Reporting from the File System Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Reporting from the Windows Event Log . . . . . . . . . . . . . . . . . . . . . . . . . .
Reporting from Web Server Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

491
494
495
498
500

xvii

xviii

Crystal Reports 2008: The Complete Reference

Crystal Reporting with XML Data Sources . . . . . . . . . . . . . . . . . . . . . . . .
Using Local XML Data Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using Web-Based XML Data Sources . . . . . . . . . . . . . . . . . . . . . . .
BusinessObjects Enterprise Universes . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Reporting with Salesforce.com Web Data . . . . . . . . . . . . . . . . . . . . . . . . .

503
503
507
512
515

17

Reporting from OLAP Cubes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
What Is OLAP? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Crystal Reports OLAP Capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Supported OLAP Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
OLAP Report Creation Methods . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using the OLAP Report Creation Wizard . . . . . . . . . . . . . . . . . . . . . . . . .
Adding an OLAP Grid to an Existing Report . . . . . . . . . . . . . . . . . . . . . .
Adding an OLAP Grid Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Changing the OLAP Database Location . . . . . . . . . . . . . . . . . . . . . . . . . .
Controlling OLAP Grid Appearance . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Virtual Page Formatting Options . . . . . . . . . . . . . . . . . . . . . . . . . . .
Interacting with the OLAP Grid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The OLAP Worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

519
519
521
521
522
522
531
531
534
534
535
536
540

18

Sharing Report Items with the Repository . . . . . . . . . . . . . . . . . . . . . . .
The Repository Defined . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Repository Explorer Enterprise Items Folder . . . . . . . . . . . . .
The Repository Explorer Categories Folders . . . . . . . . . . . . . . . . .
The Repository Explorer Repository Items Folder . . . . . . . . . . . .
Adding To/Updating the Repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Creating Folders and Categories . . . . . . . . . . . . . . . . . . . . . . . . . . .
Adding and Deleting Repository Item Objects . . . . . . . . . . . . . . .
Adding Repository Items to Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Text Objects or Bitmap Graphics . . . . . . . . . . . . . . . . . . . . . . . . . . .

Custom Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SQL Commands and Business Views . . . . . . . . . . . . . . . . . . . . . . .
Changing Repository Items on Your Report . . . . . . . . . . . . . . . . . . . . . . .
Updating Repository Versions of Objects . . . . . . . . . . . . . . . . . . . .
Controlling Repository Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Controlling Rights at the Central Management Server Level . . .
Controlling Rights at the Folder and Object Level . . . . . . . . . . . .

543
543
545
545
546
548
548
550
554
554
555
556
557
558
559
561
563

19

Creating Crystal Reports Applications with Visual Studio .NET . . .
Crystal/VS.NET Bundle Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

565
566


Contents

Crystal Reports Windows and Web Forms Viewer Control Objects . . .
Your First Application: Viewing a Report . . . . . . . . . . . . . . . . . . .
Crystal Report Object Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Integrated Report Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Choosing a Data Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Selecting Records and Adding Field Objects . . . . . . . . . . . . . . . . .
Formatting Objects and Sections . . . . . . . . . . . . . . . . . . . . . . . . . . .
Sorting and Grouping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
VS.NET Report Customization Object Models . . . . . . . . . . . . . . . . . . . . .
Run-Time Customization with the CrystalReportViewer Object
Report Viewer Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Run-Time Customization with the Crystal Reports Engine
(ReportDocument) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Distributing Crystal Reports Visual Studio .NET Applications . . . . . . .
General Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

568
568
572
576
578
580
582

583
587
588
591
592
601
602

Part II Crystal Reports Enterprise Reporting
20

Crystal Reports Web Alternatives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Exporting to Static HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Hyperlink Capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Cascading Style Sheet Support . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Navigating and Viewing Report Parts . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using Navigation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Displaying Report Parts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Introduction to BusinessObjects Enterprise XI 3.0 . . . . . . . . . . . . . . . . . .
BusinessObjects Enterprise Defined . . . . . . . . . . . . . . . . . . . . . . . .
BusinessObjects Enterprise XI 3.0 New Features . . . . . . . . . . . . .
BusinessObjects Enterprise XI 3.0 Architecture . . . . . . . . . . . . . . .

607
608
613
617
618
618
621

625
625
629
629

21

Using InfoView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Connecting to InfoView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
BOE Security Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
InfoView Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
My Favorites and My Inbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Document List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Objects and Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Viewing Reports: On Demand or Instance . . . . . . . . . . . . . . . . . . .
Viewing Third-Party Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

637
637
640
640
641
641
644
646
649

xix

xx

Crystal Reports 2008: The Complete Reference

22

Setting InfoView Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
General Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Change Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Crystal Reports Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Searching InfoView Objects and Instances . . . . . . . . . . . . . . . . . . . . . . . .
Object-Level Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Content Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Viewing, Printing, and Exporting Reports . . . . . . . . . . . . . . . . . . . . . . . .
Supplying Database Credentials and Parameters . . . . . . . . . . . . .
Using the Report Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Scheduling Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Scheduling Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Scheduling Reports Containing Alerts . . . . . . . . . . . . . . . . . . . . . .
Rescheduling Existing Instances . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using Discussions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Modifying or Deleting Existing Messages . . . . . . . . . . . . . . . . . . .
Organizing InfoView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Working with Folders and Categories . . . . . . . . . . . . . . . . . . . . . .
Organizing Objects and Instances . . . . . . . . . . . . . . . . . . . . . . . . . .
The My InfoView Custom Layout . . . . . . . . . . . . . . . . . . . . . . . . . .

650
651
652

652
654
654
656
657
657
660
665
666
674
676
678
680
680
681
685
691

Administering Enterprise Reporting Systems . . . . . . . . . . . . . . . . . . . .
Introducing the Central Management Console . . . . . . . . . . . . . . . . . . . . .
Managing Users and Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Adding, Modifying, and Deleting User Accounts . . . . . . . . . . . .
Password Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Adding Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Placing Users in Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Integrating BusinessObjects Enterprise with Existing Security
Environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Windows NT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Windows Active Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LDAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Managing Folders, Crystal Reports, and Third-Party Objects . . . . . . . .
Managing Public Folders and Subfolders . . . . . . . . . . . . . . . . . . .
Managing Personal Subfolders . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Adding Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Adding Program Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Adding Third-Party Objects and Hyperlinks . . . . . . . . . . . . . . . .
Working with Categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Manipulating Categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

697
698
700
700
703
704
710
712
713
715
717
718
718
721
722
732
735
737
738

Contents

Assigning Categories to Reports and Other Objects . . . . . . . . . .
Controlling Access Using Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Setting Folder and Object Rights . . . . . . . . . . . . . . . . . . . . . . . . . . .
Setting Access Rights for CMC Functions . . . . . . . . . . . . . . . . . . .
Defining Custom Access Levels . . . . . . . . . . . . . . . . . . . . . . . . . . . .
BusinessObjects Enterprise Architecture . . . . . . . . . . . . . . . . . . . . . . . . . .
Central Management Server (CMS) . . . . . . . . . . . . . . . . . . . . . . . .
File Repository Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Crystal Reports Processing Server . . . . . . . . . . . . . . . . . . . . . . . . . .
Crystal Reports Job Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Program Job Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Destination Job Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Crystal Reports Cache Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Event Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
List of Values Job Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Defining Output Destinations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Creating Calendars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configuring Success/Failure/Alert Notification . . . . . . . . . . . . . . . . . . .
Success/Failure Notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Alert Notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Other General Administrative Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Adding Additional Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Setting Instance Limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Specifying Default InfoView Settings . . . . . . . . . . . . . . . . . . . . . . .
Using Instance Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Managing Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Viewing Server Properties and Metrics . . . . . . . . . . . . . . . . . . . . .

The Server Intelligence Agent and the CCM . . . . . . . . . . . . . . . . .

739
741
743
747
747
749
751
751
752
753
753
753
754
754
755
755
759
761
764
764
766
768
768
769
771
772
774
774

778

Appendix Formula Language Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Functions: Additional Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ByteToText . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DateTimeTo2000 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DateTimeToDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DateTimeToSeconds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DateTimeToTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DateTo2000 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DTSTo2000 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DTSToDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DTSToDateTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

787
787
788
788
788
788
789
789
789
789
790

xxi


xxii

Crystal Reports 2008: The Complete Reference

DTSToSeconds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DTSToTimeField . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DTSToTimeString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
EventNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ExchGetId . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ExchGetOrganization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ExchGetPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ExchGetSite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ExtractString . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FRAccRecTurnover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FRCashFlowVsTotalDebt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FRCurrentRatio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FRDebtEquityRatio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FRDividendYield . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FREarningsPerCommonShare . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FREquityVsTotalAssets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FRGrossProfitMargin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FRInterestCoverage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FRInventoryTurnover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FRNetProfitMargin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FROperatingProfitMargin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FRPriceEarningsRatio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FRQuickRatio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FRReturnOnCommonEquity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FRReturnOnEquity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FRReturnOnInvestedCapital . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
FRReturnOnNetFixedAssets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

FRReturnOnTotalAssets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
LooksLike . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Now . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Picture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Soundex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Functions: Alerts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
AlertMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
AlertNames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
IsAlertEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
IsAlertTriggered . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Functions: Arrays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Average . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

790
790
790
790
791
791
791
792
792
792
792
793
793
793
794
794

794
794
795
795
795
796
796
796
796
797
797
797
798
798
798
798
799
799
799
799
800
800
800
800


Contents

DistinctCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
MakeArray . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Maximum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Minimum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PopulationStdDev . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PopulationVariance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
StdDev . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Sum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
UBound . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Variance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Functions: Conditional Formatting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Color . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CurrentFieldValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DefaultAttribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Functions: Date and Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CurrentDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CurrentDateTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CurrentTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DateAdd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DateDiff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DatePart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DateSerial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DateTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DateTimeValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DateValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Day . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DayOfWeek . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Hour . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
IsDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
IsDateTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
IsTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Minute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Month . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
MonthName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Second . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ShiftDateTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Timer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
TimeSerial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

801
801
802
802
802
802
803
803
803
803
804
804
804
804
805
805
805
805
805
806
806

807
807
808
808
809
810
810
811
811
811
812
812
812
813
813
813
815
815
815

xxiii