Professional Documents
Culture Documents
Release 5
Information in this document is subject to change without notice. Examples
provided are fictitious. No part of this document may be reproduced or
transmitted in any form, or by any means, electronic or mechanical, for any
purpose, in whole or in part, without the express written permission of
Actuate Corporation.
© 1995 - 2001 by Actuate Corporation. All rights reserved. Printed in the
United States of America.
Contains information proprietary to:
Actuate Corporation
701 Gateway Boulevard
South San Francisco, CA 94080
http://www.actuate.com
The software described in this manual is provided by Actuate Corporation
under an Actuate License agreement. The software may be used only in
accordance with the terms of the agreement.
Actuate Corporation trademarks and registered trademarks:
Actuate, e.Analysis, e.Report, e.Reporting, Live Report Document,
Live Report Extension, ReportBlast, ReportCast, Report Encyclopedia,
SmartSearch, Transporter, Virtual Report Distribution, and XML Reports.
Third party trademarks:
ActiveX, Microsoft, MSN, The Microsoft Network, Windows, Windows NT,
Windows 95/98 and/or other Microsoft products are either trademarks or registered
trademarks of Microsoft. CT-Library is a trademark of Sybase, Inc. Databeacon is a
trademark of InterNetivity Inc. Digital Creations and DCLC, are trademarks of
Digital Creations, LC. Graphics Server is a trademark of Bits Per Second, Ltd. and
Pinnacle Publishing, Inc. HDK is a registered trademark of Virtual Media Technology
Pty Ltd. INFORMIX-ESQL/C is a trademark of Informix Software, Inc. InstallShield
is a registered trademark of InstallShield Corporation. Java, ONC, Solaris, SPARC,
Sun, and Sun Microsystems are trademarks of Sun Microsystems. LEADTOOLS is a
registered trademark of LEAD Technologies, Inc. Netscape, Netscape
Communications, Netscape Communicator, Netscape Enterprise Server, Netscape
FastTrack Server, and Netscape Navigator are either trademarks or registered
trademarks of Netscape Communications Corporation. NobleNet and WinRPC are
trademarks of NobleNet, Inc. Oracle Call Interface is a trademark of Oracle
Corporation. Progress is a registered trademark of Progress Software Corporation.
Sheridan Calendar Widgets is a trademark of Sheridan Software Systems, Inc.
SmartHeap is a trademark of MicroQuill Software Publishing, Inc. Tools.h++ is a
trademark of Rogue Wave Software, Inc. UNIX is a registered trademark of X/Open
Company, Ltd. XPrinter is a trademark of Bristol Technology, Inc. XPAT, created by
James Clark, is licensed under the Mozilla license agreement. WinWidgets is a
trademark of Simple Software, Inc.
All other brand or product names are trademarks or registered trademarks of
their respective companies or organizations.
Document No. 010409-2-940304 April 25, 2001
10 9 8 7 6 5 4 3 2 1
Contents
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiii
About Actuate e.Reporting Suite 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
About e.Reports Designer API Java Edition . . . . . . . . . . . . . . . . . . . . . . . . . . . xviii
About Actuate e.Report Designer product . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviii
Online documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xx
Using online manuals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xx
Online help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xx
Using the Actuate online help system. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xx
Typographical conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxii
Syntax conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiii
Chapter 1
Class hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Hierarchy for all packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Differences between the AWT and SWING API . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Chapter 2
Serialized objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Class com.actuate.ereport. designer.ACJDesigner . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Class com.actuate.ereport. datasrcmgrs.appdatasrc. AppDataHandler . . . . . . . . . . . . . . 11
Class com.actuate.ereport. datasrcmgrs.asciidatasrc. ASCIIDataHandler . . . . . . . . . . . . .12
Class com.actuate.ereport. datasrcmgrs.ejbdatasrc. EJBDataHandler . . . . . . . . . . . . . . .13
Chapter 3
Class summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Package
com.actuate.ereport.
designer.ACJDesigner. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
ACJDesigner constructor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76
ACJDesigner.actionPerformed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76
ACJDesigner.addDataSource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77
ACJDesigner.addExternalFont . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77
ACJDesigner.addMruFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77
ACJDesigner.debugMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78
ACJDesigner.debugMessageLN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78
ACJDesigner.getActiveDataSource. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78
ACJDesigner.getClient. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78
i
ACJDesigner.getDataSources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
ACJDesigner.getDebugMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
ACJDesigner.getEngine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
ACJDesigner.getMruList. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
ACJDesigner.getRegdAppDataHandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
ACJDesigner.getRegdASCIIDataHandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
ACJDesigner.getRegdEJBHandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
ACJDesigner.getRegdJDBCHandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
ACJDesigner.getRegdMetaDataHandler. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
ACJDesigner.getRegdXMLDataHandler. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
ACJDesigner.getRelations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
ACJDesigner.itemStateChanged . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
ACJDesigner.loadTemplate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
ACJDesigner.loadTemplate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
ACJDesigner.main . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
ACJDesigner.paintComponent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
ACJDesigner.registerDataSources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
ACJDesigner.saveTemplate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
ACJDesigner.setActiveDataSource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
ACJDesigner.setAutoQuery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
ACJDesigner.setDebugMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
ACJDesigner.setDefaultAttachLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
ACJDesigner.setDefaultExitMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
ACJDesigner.setDefaultGridSnap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
ACJDesigner.setDefaultHorzGap. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
ACJDesigner.setDefaultImageRelativePath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
ACJDesigner.setDefaultLookAndFeel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
ACJDesigner.setDefaultLowercaseQuotes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
ACJDesigner.setDefaultNewTemplate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
ACJDesigner.setDefaultPrependSchema. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
ACJDesigner.setDefaultPrintMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
ACJDesigner.setdefaultshowgrid. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
ACJDesigner.setDefaultTemplateEncoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
ACJDesigner.setDocsPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
ACJDesigner.setHasBeenGenerated . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
ACJDesigner.setMruList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
ACJDesigner.setTemplateFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
ACJDesigner.showMenu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
ACJDesigner.stateChanged . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
ACJDesigner.syncTmplMgr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
ACJDesigner.updateDesigner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
ACJDesigner.updateOutputProperties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
ACJDesigner.updateRelations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
ACJDesigner.windowActivated . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
ii
ACJDesigner.windowClosed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .89
ACJDesigner.windowClosing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .89
ACJDesigner.windowDeactivated . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .90
ACJDesigner.windowDeiconified . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .90
ACJDesigner.windowIconified . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .90
ACJDesigner.windowOpened . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .90
Package
com.actuate.ereport.engine.ACJEngine . . . . . . . . . . . . . . . . . . . . 91
ACJDesigner constructor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96
ACJEngine.autoConnectDatasource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .97
ACJEngine.debugMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .97
ACJEngine.debugMessageLN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .97
ACJEngine.disconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .98
ACJEngine.doesX11GfxExist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .98
ACJEngine.finalizeEngine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .98
ACJEngine.generateReport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .98
ACJEngine.getColValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .99
ACJEngine.getCommunicationStub . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .99
ACJEngine.getData source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
ACJEngine.getDebugMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
ACJEngine.getEvaluater . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
ACJEngine.getOutputDevice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
ACJEngine.getTargetOutputDevice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
ACJEngine.getTemplateManager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
ACJEngine.getTemplateReader. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
ACJEngine.getTemplateWriter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
ACJEngine.getTmplMgr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
ACJEngine.newSystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
ACJEngine.newTemplate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
ACJEngine.overrideResolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
ACJEngine.print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
ACJEngine.printingDone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
ACJEngine.readTemplate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
ACJEngine.readTemplate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
ACJEngine.readTemplate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
ACJEngine.resetStub. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
ACJEngine.setCacheOption. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
ACJEngine.setCommunicationStub . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
ACJEngine.setDataSource. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
ACJEngine.setDebugMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
ACJEngine.setOutputDevice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
ACJEngine.setResizeFixRatio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
ACJEngine.getResizeFixRatio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
iii
ACJEngine.setTargetOutputDevice. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
ACJEngine.setTemplateReader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
ACJEngine.setTemplateWriter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
ACJEngine.setX11GfxAvailibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
ACJEngine.updateResolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
ACJEngine.writeTemplate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
ACJEngine.writeTemplate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
ACJEngine.writeTemplate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Package
com.actuate.ereport.output.ACJOutputProcessor . . . . . . . . . . . 111
ACJOutputProcessor constructor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
ACJOutputProcessor.closeZipEntry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
ACJOutputProcessor.closeZipStream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
ACJOutputProcessor.debugOutputProps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
ACJOutputProcessor.generateCSV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
ACJOutputProcessor.generateCSV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
ACJOutputProcessor.generateCSV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
ACJOutputProcessor.generateDHTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
ACJOutputProcessor.generateDHTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
ACJOutputProcessor.generateEMAIL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
ACJOutputProcessor.generateHTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
ACJOutputProcessor.generateHTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
ACJOutputProcessor.generateHTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
ACJOutputProcessor.generateHTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
ACJOutputProcessor.generateJOI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
ACJOutputProcessor.generateJOI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
ACJOutputProcessor.generatePDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
ACJOutputProcessor.generatePDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
ACJOutputProcessor.generatePDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
ACJOutputProcessor.generatePDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
ACJOutputProcessor.generatePDF_Ex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
ACJOutputProcessor.generatePDF_Ex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
ACJOutputProcessor.generatePRINTOUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
ACJOutputProcessor.generatePRINTOUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
ACJOutputProcessor.generatePRINTOUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
ACJOutputProcessor.getCSVProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
ACJOutputProcessor.getDHTMLDevice. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
ACJOutputProcessor.getDHTMLProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
ACJOutputProcessor.getDocumentationPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
ACJOutputProcessor.getEMAILProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
ACJOutputProcessor.getHTMLProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
ACJOutputProcessor.getJOIProperty. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
ACJOutputProcessor.getOutputFiles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
iv
ACJOutputProcessor.getPDFProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
ACJOutputProcessor.getPreviewDevice. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
ACJOutputProcessor.getPRINTERProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
ACJOutputProcessor.getPrinterResolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
ACJOutputProcessor.getVirtualOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
ACJOutputProcessor.hasMultipleOutputFiles . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
ACJOutputProcessor.instantiateZipStream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
ACJOutputProcessor.promptParams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
ACJOutputProcessor.promptParams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
ACJOutputProcessor.prv_getActivePage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
ACJOutputProcessor.prv_getPageCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
ACJOutputProcessor.prv_getZoom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
ACJOutputProcessor.prv_removeToolbarItem . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
ACJOutputProcessor.prv_setActivePage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
ACJOutputProcessor.prv_setBackgroundTOC . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
ACJOutputProcessor.prv_setZoom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
ACJOutputProcessor.prv_showToolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
ACJOutputProcessor.prv_updateToolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
ACJOutputProcessor.prv_setNextPage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
ACJOutputProcessor.prv_setPrevPage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
ACJOutputProcessor.prv_showTOC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
ACJOutputProcessor.putNewZipEntry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
ACJOutputProcessor.refreshReport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
ACJOutputProcessor.setBufferSize. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
ACJOutputProcessor.setCSVProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
ACJOutputProcessor.setDHTMLProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
ACJOutputProcessor.setDocumentationPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
ACJOutputProcessor.setEMAILProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
ACJOutputProcessor.setHTMLProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
ACJOutputProcessor.setJOIFileSource. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
ACJOutputProcessor.setJOIProperty. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
ACJOutputProcessor.setJOISource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
ACJOutputProcessor.setJOIURLSource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
ACJOutputProcessor.setOutputProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
ACJOutputProcessor.setPDFProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
ACJOutputProcessor.setPRINTERProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
ACJOutputProcessor.setPrinterResolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
ACJOutputProcessor.setReportData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
ACJOutputProcessor.setReportData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
ACJOutputProcessor.writefile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
ACJOutputProcessor.writeZip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
ACJOutputProcessor.writeZip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
v
Package
com.actuate.ereport.datasrcmgrs.appdatasrc.
AppDataHandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
AppDataHandler constructor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
AppDataHandler.allowMultipleTableRegistering . . . . . . . . . . . . . . . . . . . . . . . . . 149
AppDataHandler.connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
AppDataHandler.disconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
AppDataHandler.fetchData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
AppDataHandler.getCatalogName. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
AppDataHandler.getColumnNames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
AppDataHandler.getDataType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
AppDataHandler.getDebugMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
AppDataHandler.getEndRecordNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
AppDataHandler.getIdentifierQuote. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
AppDataHandler.getName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
AppDataHandler.getPropertySheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
AppDataHandler.getQuery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
AppDataHandler.getQueryColumns. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
AppDataHandler.getQueryResult . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
AppDataHandler.getQueryTables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
AppDataHandler.getRelations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
AppDataHandler.getStartRecordNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
AppDataHandler.getTable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
AppDataHandler.getTableNames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
AppDataHandler.getTableType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
AppDataHandler.isConnected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
AppDataHandler.isNullable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
AppDataHandler.passTableData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
AppDataHandler.registerDataSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
AppDataHandler.registerObjectAsTable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
AppDataHandler.registerQuery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
AppDataHandler.RegisterTable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
AppDataHandler.RegisterTable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
AppDataHandler.registerUserDefTable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
AppDataHandler.requiresConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
AppDataHandler.setDebugMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
AppDataHandler.setExtraOperators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
AppDataHandler.setQueryDisplay. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
AppDataHandler.setRelations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
AppDataHandler.setResultSetRange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
AppDataHandler.setTableDefinition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
AppDataHandler.sortVector. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
vi
Interface
com.actuate.ereport.datasrcmgrs.appdatasrc . . . . . . . . . . . . . . 161
Interface IObjectTable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
getColumns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
getValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
hasColumn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
iterator. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Interface Iterator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
hasNext . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
resetCursor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
Package
com.actuate.ereport.datasrcmgrs.asciidatasrc.
ASCIIDataHandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
ASCIIDataHandler constructor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
ASCIIDataHandler.checkIfExists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
ASCIIDataHandler.connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
ASCIIDataHandler.connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
ASCIIDataHandler.getColumnCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
ASCIIDataHandler.getCurrentPropertiesAsString . . . . . . . . . . . . . . . . . . . . . . . . . 171
ASCIIDataHandler.getPropertiesFileName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
ASCIIDataHandler.getSourceFileName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
ASCIIDataHandler.registerObjectsWithEngine. . . . . . . . . . . . . . . . . . . . . . . . . . . 171
ASCIIDataHandler.setPropertiesFileName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Package
com.actuate.ereport.datasrcmgrs.ejbdatasrc.
EJBDataHandler. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
EJBDataHandler constructor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
EJBDataHandler.addTableData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
EJBDataHandler.addTableDefinition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
EJBDataHandler.clearSchemaAndData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
EJBDataHandler.connectToRemoteApp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
EJBDataHandler.getContextFactory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
EJBDataHandler.getName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
EJBDataHandler.getProperties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
EJBDataHandler.getPropertySheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
EJBDataHandler.getRemoteAppName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
EJBDataHandler.isConnected. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
EJBDataHandler.processMsg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
vii
EJBDataHandler.processRemoteMsg. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
EJBDataHandler.requiresConnection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
EJBDataHandler.setContextFactory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
EJBDataHandler.setProperties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
EJBDataHandler.setTableDefinition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
Package
com.actuate.ereport.datasrcmgrs.jdbcdatasrc.
JDBCHandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
JDBCHandler constructor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
JDBCHandler.allStoredObjectsCallable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
JDBCHandler.Connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
JDBCHandler.connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
JDBCHandler.Connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
JDBCHandler.connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
JDBCHandler.Connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
JDBCHandler.connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
JDBCHandler.debugMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
JDBCHandler.debugMessageLN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
JDBCHandler.debugMessageLN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
JDBCHandler.Disconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
JDBCHandler.disconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
JDBCHandler.extractRelations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
JDBCHandler.fetchData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
JDBCHandler.getCatalogName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
JDBCHandler.getColumnNames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
JDBCHandler.getConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
JDBCHandler.getCurrentTableSelection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
JDBCHandler.getDataType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
JDBCHandler.getDebugMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
JDBCHandler.getDefaultValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
JDBCHandler.getDriverName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
JDBCHandler.getEndRecordNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
JDBCHandler.getGrantee . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
JDBCHandler.getGrantor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
JDBCHandler.getIdentifierQuote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
JDBCHandler.getName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
JDBCHandler.getPassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
JDBCHandler.getPrivileges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
JDBCHandler.getPropertySheet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
JDBCHandler.getQuery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
JDBCHandler.getQueryColumns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
JDBCHandler.getQueryResult . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
JDBCHandler.getQueryTables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
viii
JDBCHandler.getRelations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
JDBCHandler.getRemarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
JDBCHandler.getSelectiveTableFilter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
JDBCHandler.getSelectedTables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
JDBCHandler.getSOImplementation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
JDBCHandler.getStartRecordNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
JDBCHandler.getStoredObjects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
JDBCHandler.getTable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
JDBCHandler.getTableCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
JDBCHandler.getTableNames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
JDBCHandler.getTables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
JDBCHandler.getUrl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
JDBCHandler.getUsername . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
JDBCHandler.isConnected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
JDBCHandler.isGrantable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
JDBCHandler.isNullable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
JDBCHandler.makeSelective . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
JDBCHandler.registerQuery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
JDBCHandler.requiresConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
JDBCHandler.retrieveTables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
JDBCHandler.setDebugMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
JDBCHandler.setDriver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
JDBCHandler.setLowercaseQuotes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
JDBCHandler.setPassword . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
JDBCHandler.setPrependSchema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
JDBCHandler.setProperties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
JDBCHandler.setResultSetRange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
JDBCHandler.setSelectiveProperties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
JDBCHandler.setUrl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
JDBCHandler.setUsername . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
JDBCHandler.supportsStoredObjects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
JDBCHandler.useTables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
Package
com.actuate.ereport.datasrcmgrs.metadatasrc.
MetaDataHandler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
MetaDataHandler constructor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
MetaDataHandler.addTable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
MetaDataHandler.clearMetaData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
MetaDataHandler.connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
MetaDataHandler.disconnect. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
MetaDataHandler.exportAsMetadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
MetaDataHandler.fetchData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
MetaDataHandler.getCatalogName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
ix
MetaDataHandler.getColumnNames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
MetaDataHandler.getDatasourceName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
MetaDataHandler.getDataType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
MetaDataHandler.getDefaultValue. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
MetaDataHandler.getGrantee. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
MetaDataHandler.getGrantor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
MetaDataHandler.getIdentifierQuote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
MetaDataHandler.getName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
MetaDataHandler.getPrivileges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
MetaDataHandler.getPropertySheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
MetaDataHandler.getQuery. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
MetaDataHandler.getQueryColumns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
MetaDataHandler.getQueryResult . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
MetaDataHandler.getQueryTables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
MetaDataHandler.getRelations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
MetaDataHandler.getRemarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
MetaDataHandler.getTable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
MetaDataHandler.getTableNames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
MetaDataHandler.getTableType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
MetaDataHandler.isConnected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
MetaDataHandler.isGrantable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
MetaDataHandler.isNullable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
MetaDataHandler.manuallyConstructed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
MetaDataHandler.readObject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
MetaDataHandler.registerQuery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
MetaDataHandler.requiresConnection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
MetaDataHandler.setCatalogName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
MetaDataHandler.setDatasourceName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
MetaDataHandler.setIdentifierQuote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
MetaDataHandler.setRelations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
MetaDataHandler.setResultSetRange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
MetaDataHandler.writeObject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
Package
com.actuate.ereport.output.OD_DHTML . . . . . . . . . . . . . . . . . . . 221
OD_DHTML constructor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
OD_DHTML.generate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
OD_DHTML.generateMainFrameSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
OD_DHTML.generateReportPage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
OD_DHTML.generateTOCPage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
OD_DHTML.getImage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
OD_DHTML.getImage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
OD_DHTML.setGenerateOnDemand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
x
Package
com.actuate.ereport.output.OD_HTML . . . . . . . . . . . . . . . . . . . . 229
OD_HTML constructor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
OD_HTML.generate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
OD_HTML.generateMainFrameSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
OD_HTML.generateReportPage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
OD_HTML.generateTOCPage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
OD_HTML.getImage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
OD_HTML.getImage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
OD_HTML.setGenerateOnDemand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
Package
com.actuate.ereport.engine.TemplateManager . . . . . . . . . . . . . 237
TemplateManager.changeID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
TemplateManager.collapseTemplate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
TemplateManager.connectToDatasource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
TemplateManager.createControl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
TemplateManager.createControl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
TemplateManager.createRuntimeParams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
TemplateManager.destroyTemplate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
TemplateManager.getAlignment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
TemplateManager.getBounds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
TemplateManager.getDataField . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
TemplateManager.getFillColor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
TemplateManager.getFont . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
TemplateManager.getFontColor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
TemplateManager.getFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
TemplateManager.getFormula . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
TemplateManager.getImageURL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
TemplateManager.getImportedSQLQuery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
TemplateManager.getLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
TemplateManager.getORDERBYClause . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
TemplateManager.getPageHeight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
TemplateManager.getPageMargins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
TemplateManager.getPageWidth. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
TemplateManager.getParameterIds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
TemplateManager.getParamProperty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
TemplateManager.getQueryContents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
TemplateManager.getReportAuthor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
TemplateManager.getReportComments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
TemplateManager.getReportTitle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
TemplateManager.getResizeToFitContents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
TemplateManager.getSectionId. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
xi
TemplateManager.getTemplateWidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
TemplateManager.getTextWrap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
TemplateManager.getVisible . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
TemplateManager.getWHEREClause . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
TemplateManager.hasEmbeddedDatasource . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
TemplateManager.hasParameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
TemplateManager.isChart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
TemplateManager.isDataField . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
TemplateManager.isFormula . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
TemplateManager.isImageURL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
TemplateManager.isLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
TemplateManager.isLine. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
TemplateManager.setAlignment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
TemplateManager.setBounds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
TemplateManager.setDataField . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
TemplateManager.setFillColor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
TemplateManager.setFont . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
TemplateManager.setFontColor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
TemplateManager.setFormat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
TemplateManager.setFormula . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
TemplateManager.setImageURL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
TemplateManager.setImportedSQLQuery. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
TemplateManager.setLabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
TemplateManager.setORDERBYClause . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
TemplateManager.setPageHeight. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
TemplateManager.setPageMargins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
TemplateManager.setPageWidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
TemplateManager.setParamProperty. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
TemplateManager.setParamValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
TemplateManager.setReportAuthor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
TemplateManager.setReportComments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
TemplateManager.setReportTitle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
TemplateManager.setResizeToFitContents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
TemplateManager.setTextWrap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
TemplateManager.setUnitType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
TemplateManager.setVisible. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
TemplateManager.setWallpaper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
TemplateManager.setWallpaper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
TemplateManager.setWHEREClause. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
TemplateManager.setZoneHeight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
xii
Introduction
Introduction xiii
Challenge Actuate solution
Reusing existing integrated content Open server provides access to
content from other applications
Maintaining data integrity on hard PDF provides high-resolution
copy printed copy
Transferring information into other XML output provides access to data
applications across applications
Introduction xv
Product name Use
Actuate e.Reporting Server A server application that generates Live
Java™ Edition Report Documents developed using the
Actuate e.Report Designer Java Edition,
manages them in the Report
Encyclopedia®, and makes them available
to users.
This product includes Actuate
Administrator Desktop, an application for
system and network administrators to
manage and control one or more Actuate
report servers.
This product also includes Actuate
ReportCast™ that transforms the Report
Encyclopedia into a dynamic, secure web
site. ReportCast provides the foundation for
Channels and seamless integration with
other web sites.
Actuate e.Reporting Server A server application designed to work
Progress Edition exclusively with Progress databases that
generates Live Report Documents, manages
them in the Report Encyclopedia®, and
makes them available to users.
This product includes Actuate
Administrator Desktop, an application for
system and network administrators to
manage and control one or more Actuate
report servers.
This product also includes Actuate
ReportCast™ that transforms the Report
Encyclopedia into a dynamic, secure web
site. ReportCast provides the foundation for
Channels and seamless integration with
other web sites.
Actuate Advanced An application that adds two capabilities to
e.Reporting Server the basic e.Reporting Server, open server
and page security.
■ Open server supports the use of third-
party report generators with the Actuate
e.Reporting Server.
■ Page security supports personalized
viewing of parts of reports for various
users
Actuate Viewer and Actuate Live Report Extension (LRX) are included with all
products except Actuate e.Report Designer Java Edition.
Introduction xvii
About e.Reports Designer API Java Edition
The Actuate e.Reports Designer API Java Edition reference provides information
for using the methods found in the Actuate e.Reports Designer API.
The e.Reports Designer API Java Edition includes the following chapters:
Introduction. This chapter provides an overview of this guide, the Actuate
e.Report Designer Java Edition documentation, and the typographical
conventions used.
Chapter 1. Class hierarchy. This chapter provides a tutorial for designing sample
reports.
Chapter 2. Serialized objects. This chapter explains the basic report design
process. It introduces templates, the report explorer, zones, report layout, and
launching reports.
Chapter 3. Class summary. This chapter discusses formatting options, control
properties, and web links.
Packages com.actuate.ereport. designer.ACJDesigner through com.actuate.ereport.
engine.TemplateManager. These chapters describe the classes and methods in
the API.
e.Report
Designer API
Java Edition
Introduction xix
For information about See the following
Terminology map
Glossary
Actuate
Glossary
Online documentation
The information in the printed manuals is also available as online books in
Adobe Acrobat PDF format and in the online help system for the Actuate
products. For products without a Windows interface, such as the various
versions of Actuate e.Reporting Server, Actuate e.Report Designer Java
Edition, Actuate ReportCast, and Actuate e.Analysis, we provide HTML help
files. The HTML files install automatically with the product. These files can be
viewed with standard browsers.
Online help
Actuate products provide both context-sensitive online help about the product
and report-specific online help about the report you are viewing. Actuate
e.Reporting Suite makes it possible for developers to create customized report-
specific online help.
The tabs at the top of the left window access different views. Use these tabs to
switch views among the Table of Contents, Index, and Search. The Table of
Contents provides an overview of the help file contents. For example, in the
preceding window, you see the introduction to the documentation for the
e.Reporting Server product. The Search tab accesses any word in the help files.
The following two illustrations show an example of the Index and the result of
an Index search.The following illustration shows the result of the search as it
appears in the window on the right.
Use the Index tab to view the topics
Select a topic to search the Index
Select a topic from the search results
To view the topic double-click the topic in the list. The topic displays in the
window on the right.
Introduction xxi
Use the Search tab to find all instances of a keyword in the help files. The
following illustration shows the results of a search for the keyword, templates.
The topics containing the keyword appear under Search. Double-click a topic
in the Search list to display the topic in the right window.
Typographical conventions
The following table describes the typographical conventions used in this
guide.
Syntax conventions
The following table describes the symbols used to present the syntax.
Introduction xxiii
xxiv e.Repor t Designer API Java Edition
Chapter
Class hierarchy
Chapter 1
1
This chapter contains the following topics:
■ Hierarchy for all packages
■ Differences between the AWT and SWING API
AppDataHandler
In the SWING API, passTableData and registerDataSet take the second
argument as a Collection.
In the AWT API, passTableData and registerDataSet take the second argument
as a Vector.
In Java 2, a Vector extends Collection.
JDBCDataHandler
The AWT and SWING API are the same.
MetaDataHandler
The AWT and SWING API are the same.
EJBDataHandler
The class is present only in the SWING API.
ACJDesigner
In the SWING API, one of the constructors takes the first argument as a
javax.swing.JFrame.
In the AWT API, one of the constructors takes the first argument as a
java.awt.Frame.
In the SWING API, there is an additional method getRegdEJBDataHandler().
In the SWING API, there is an additional method setDefaultLookAndFeel.
ACJEngine
The AWT and SWING API are the same.
TemplateManager
In the SWING API, there is only one method called setPageMargins().
In the AWT API, there are two methods called setPageMargins(). The second
method in AWT takes 4 double arguments, the left, right, top and bottom
margins of the page.
Serialized objects
Chapter 2
2
This chapter lists the available serialized objects.
Serialized fields
activeIDS
com.actuate.ereport.engine.IDataSource activeIDS
tp
javax.swing.JTabbedPane tp
erwD
com.actuate.ereport.designer.GuiTemplate erwD
erw
ACJEngine erw
vDSM
java.util.Vector vDSM
showMem
boolean showMem
rels
com.actuate.ereport.designer.relationships.Relations rels
prv
com.actuate.ereport.output.OD_Preview prv
bAutoWhere
boolean bAutoWhere
bAutoOrder
boolean bAutoOrder
bPrependSchema
boolean bPrependSchema
bLowercaseQuotes
boolean bLowercaseQuotes
Serialized fields
vR
java.util.Vector vR
bDisplay
boolean bDisplay
startRecNo
int startRecNo
endRecNo
int endRecNo
bAllowMultipleTablesForSameClass
boolean bAllowMultipleTablesForSameClass
Used for ASCIIDataSource where only one class (GenericTable) is used to
register multiple tables.
Serialized fields
tableRecords
java.util.Vector tableRecords
fileName
java.lang.String fileName
propertiesFileName
java.lang.String propertiesFileName
tableName
java.lang.String tableName
pp
com.actuate.ereport.datasrcmgrs.asciidatasrc.PropertyFileParser pp
vPropertiesOfAllTables
java.util.Vector vPropertiesOfAllTables
fp
com.actuate.ereport.datasrcmgrs.asciidatasrc.FileParser fp
Serialized fields
htColAccessors
java.util.Hashtable htColAccessors
htIC
java.util.Hashtable htIC
sRemoteAppJNDIName
java.lang.String sRemoteAppJNDIName
sContextFactory
java.lang.String sContextFactory
iRemoteApp
com.actuate.ereport.datasrcmgrs.ejbdatasrc.EJBAppRI iRemoteApp
Class summary
Chapter 3
3
The following summary is a list of available classes, methods, fields, and
variables with their descriptions.
com.actuate.ereport.
Package
designer.ACJDesigner
Pa c k a g e c o m . a c t u a t e . e r e p o r t . d e s i g n e r. A C J D e s i g n e r 69
Class ACJDesigner
java.lang.Object
|
+--java.awt.Component
|
+--java.awt.Container
|
+--javax.swing.JComponent
|
+--javax.swing.JPanel
|
+--com.actuate.ereport.designer.ACJDesigner
_____________________________________________________________________
See also
Serialized objects
Constructor summary
ACJDesigner()
An empty constructor; created for backward compatibility.
public ACJDesigner(javax.swing.JFrame fResizable, ACJEngine erw, boolean
isDesign, boolean isPreview)(javax.swing.JFrame fResizable, ACJEngine
e.Report Designer API Java Edition, boolean isDesign, boolean isPreview)
The default constructor.
Method summary
Method Description
ACJDesigner Notification received when a menu item is
.actionPerformed selected.
Pa c k a g e c o m . a c t u a t e . e r e p o r t . d e s i g n e r. A C J D e s i g n e r 71
Method Description
ACJDesigner Returns an instance of
.getActiveDataSource() ACJOutputProcessor used by
ACJDesigner; used internally.
ACJDesigner Returns a vector containing all registered
.getDataSources() data sources.
ACJDesigner Returns the current debug mode.
ACJDesigner.getDebugMode()
ACJDesigner Returns the reference of ACJEngine
.getEngine() maintained by the GUI.
ACJDesigner Returns an array of file names stored in the
.getMruList() MRU list.
ACJDesigner..getRegdAppDat Returns the instance of the registered
aHandler() AppDataHandler data source.
ACJDesigner Returns the instance of the registered
.getRegdASCIIDataHandler() ASCIIDataHandler data source.
ACJDesigner Returns the instance of the registered
.getRegdEJBHandler() EJBHandler data source.
ACJDesigner Returns the instance of the registered
.getRegdJDBCHandler() JDBCHandler data source.
ACJDesigner Returns the instance of the registered
.getRegdMetaDataHandler() MetadataHandler data source.
ACJDesigner Returns the instance of the registered
.getRegdXMLDataHandler() XMLDataHandler data source.
ACJDesigner Returns a vector of Relations strings. Used
.getRelations() internally.
ACJDesigner Notification received when the active tab is
.itemStateChanged changed via the menu option.
ACJDesigner Requests the Designer to load a template
.loadTemplate into the user interface.
ACJDesigner Requests the Designer to load a template
.loadTemplate into the user interface using the specified
encoding 'templateEncoding'.
ACJDesigner
.main
Pa c k a g e c o m . a c t u a t e . e r e p o r t . d e s i g n e r. A C J D e s i g n e r 73
Method Description
ACJDesigner Specifies that if a table or column has
.setDefaultLowercaseQuotes lowercase characters embedded in it, then
the Quote Identifier is prepended and
appended to it by default.
ACJDesigner Deprecated. Specifies that if a new
.setDefaultNewTemplate template is Blank (default = True) or
should be read from a file 'startup.erw'
then e.Report Designer API Java Edition
creates a default startup skeleton template.
ACJDesigner Specifies whether the Schema/Owner
.setDefaultPrependSchema name should be prepended to the table
name by default in the FROM clause, as
expected by ORACLE8.
ACJDesigner Specifies whether the user wishes to
.setDefaultPrintMode generate Preview/Printer output in
landscape format (True) or portrait format
(False).
ACJDesigner Sets the default value to show the grid
.showMenu while designing templates.
ACJDesigner Sets the default template
.setDefaultTemplateEncoding 'templateEncoding'. Currently supported
templateEncodings are
ACJConstants.ASCII, ACJConstants.UTF8.
ACJDesigner Specifies the name of the user guide file.
.setDocsPath
ACJDesigner
.setHasBeenGenerated
ACJDesigner Specifies an array of filenames to be stored
.setMruList in the MRU list.
ACJDesigner When a template is loaded externally,
.setTemplateFile specifies the filename to be used by the
GUI when the Save Template option is
selected from the menu.
ACJDesigner Constructs the menu structure used in the
.showMenu() menu bar.
ACJDesigner Notification received just before the
.stateChanged Designer's tab is changed; used internally.
ACJDesigner Used internally.
.syncTmplMgr()
Field detail
showMem
public boolean showMem
doPreviewReset
public boolean doPreviewReset
hasBeenGenerated
public boolean hasBeenGenerated
Indicates that the On switching to preview the report has to be refreshed.
Pa c k a g e c o m . a c t u a t e . e r e p o r t . d e s i g n e r. A C J D e s i g n e r 75
ACJDesigner constructor
ACJDesigner
public ACJDesigner()
An empty constructor; created for backward compatibility.
public ACJDesigner(javax.swing.JFrame fResizable,
ACJEngine erw,
boolean isDesign,
boolean isPreview)
The default constructor. Constructs the designer shell using a variety of
options which can be embedded within an existing application.
In the AWT API, the constructor takes the first argument as a java.awt.Frame.
fCloseNotification
Handle of the parent frame (can be null).
erw
A reference to an instance of the engine instantiated by an external wrapper.
isDesign
Specifies whether the Designer tab should be displayed.
isPreview
Specifies whether the Preview tab should be displayed.
ACJDesigner.actionPerformed
public void actionPerformed(java.awt.event.ActionEvent ae)
Notification received when a menu item is selected.
Specified by
actionPerformed in interface java.awt.event.ActionListener
Updates the preview device with default output properties. This function is
called internally by GuiTemplate.
ids
An implementation of the IDataSource interface.
See also
JDBCHandler, AppDataHandler, MetaDataHandler
ACJDesigner.addExternalFont
public void addExternalFont(java.lang.String s)
Installs any additional fonts if required in the Font dialog box.
s
The name of the external font to be added.
Returns
A reference to the client output device maintained internally.
ACJDesigner.addMruFile
public void addMruFile(int fileNo,
java.lang.String mruFileName)
Updates the list of MRU files in the menu structure with a filename to be
inserted at a specified index. This function is called internally by GuiTemplate.
fileNo
Index in the internal array of MRU filenames.
mruFileName
The filename to be inserted at the specified index.
Pa c k a g e c o m . a c t u a t e . e r e p o r t . d e s i g n e r. A C J D e s i g n e r 77
ACJDesigner.debugMessage
public static void debugMessage(java.lang.String sMsg)
Used internally.
ACJDesigner.debugMessageLN
public static void debugMessageLN(java.lang.String sMsg)
Used internally.
public static void debugMessageLN()
Used internally.
ACJDesigner.getActiveDataSource
public com.actuate.ereport.engine.IDataSource getActiveDataSource()
Returns the active selected data source for data extraction.
Returns
A reference to the active implementation of IDataSource used by the designer.
ACJDesigner.getClient
public ACJOutputProcessor getClient()
Returns an instance of ACJOutputProcessor used by ACJDesigner; used
internally.
ACJDesigner.getDataSources
public java.util.Vector getDataSources()
Returns a vector containing all registered data sources.
ACJDesigner.getEngine
public ACJEngine getEngine()
Returns the reference of ACJEngine maintained by the GUI.
Returns
A reference to the engine maintained internally by the designer.
ACJDesigner.getMruList
public java.lang.String[] getMruList()
Returns an array of filenames stored in the MRU list. This function is called
internally by GuiTemplate.
Returns
The array of filenames stored in the MRU list.
ACJDesigner.getRegdAppDataHandler
public AppDataHandler getRegdAppDataHandler()
Returns an instance of the registered AppDataHandler data source.
Method is only in the SWING API. It is not in the AWT API.
Returns
A reference to the internally maintained instance of AppDataHandler.
Pa c k a g e c o m . a c t u a t e . e r e p o r t . d e s i g n e r. A C J D e s i g n e r 79
ACJDesigner.getRegdASCIIDataHandler
public ASCIIDataHandler getRegdASCIIDataHandler()
Returns an instance of the registered ASCIIDataHandler data source.
Returns
A reference to the internally maintained instance of ASCIIDataHandler.
ACJDesigner.getRegdEJBHandler
public com.actuate.ereport.engine.IDataSource getRegdEJBHandler()
Returns an instance of the registered EJBHandler data source.
Returns
A reference to the internally maintained instance of EJBHandler.
ACJDesigner.getRegdJDBCHandler
public JDBCHandler getRegdJDBCHandler()
Returns an instance of the registered JDBCHandler data source.
Returns
A reference to the internally maintained instance of JDBCHandler.
ACJDesigner.getRegdMetaDataHandler
public MetaDataHandler getRegdMetaDataHandler()
Returns an instance of the registered MetadataHandler data source.
ACJDesigner.getRegdXMLDataHandler
public com.actuate.ereport.engine.IDataSource getRegdXMLDataHandler()
Returns an instance of the registered XMLDataHandler data source.
Returns
A reference to the internally maintained instance of JDBCHandler.
ACJDesigner.getRelations
public java.util.Vector getRelations()
Returns a vector of Relations strings used internally.
Returns
A vector of relations stored as strings.
ACJDesigner.itemStateChanged
public void itemStateChanged(java.awt.event.ItemEvent ie)
Notification received when the active tab is changed via the menu option.
Specified by
itemStateChanged in interface java.awt.event.ItemListener.
ACJDesigner.loadTemplate
public void loadTemplate(java.lang.String urlORfile)
Requests the Designer to load a template into the user interface.
Pa c k a g e c o m . a c t u a t e . e r e p o r t . d e s i g n e r. A C J D e s i g n e r 81
urlORfile
The URL or file location where the template can be found.
ACJDesigner.loadTemplate
public void loadTemplate(java.lang.String urlORfile,
int templateEncoding)
Requests the Designer to load a template into the user interface using the
specified encoding 'templateEncoding'.
urlORfile
The URL or file location where the template can be found.
templateEncoding
A constant; either ACJConstants.ASCII or ACJConstants.UTF8.
ACJDesigner.main
public static void main(java.lang.String[] s)
ACJDesigner.paintComponent
public void paintComponent(java.awt.Graphics g)
ACJDesigner.registerDataSources
public void registerDataSources(java.util.Vector vDSM)
Registers a vector of data sources for selection via the GUI.
ACJDesigner.saveTemplate
public void saveTemplate(java.lang.String urlORfile)
Requests the Designer to save the template to a file.
urlORfile
The URL or file location where the template is to be stored.
templateEncoding
A constant; either ACJConstants.ASCII or ACJConstants.UTF8.
ACJDesigner.setActiveDataSource
public void setActiveDataSource(com.actuate.ereport.engine.IDataSource ds)
Selects one of the registered data sources for data extraction.
ids
An implementation of the IDataSource interface.
See also
JDBCHandler, AppDataHandler, MetaDataHandler
ACJDesigner.setAutoQuery
public void setAutoQuery(boolean bAutoWhere,
boolean bAutoOrder)
Specifies whether it is required to automatically update the WHERE and/or
ORDERBY clauses based on template contents.
bAutoWhere
Indicates that the WHERE clause should be automatically updated internally
for joins based on table relations.
bAutoOrder
Indicates that the ORDERBY clause should be automatically updated based on
the grouping criteria.
Pa c k a g e c o m . a c t u a t e . e r e p o r t . d e s i g n e r. A C J D e s i g n e r 83
ACJDesigner.setDebugMode
public static void setDebugMode(boolean b)
Specifies whether progress or error messages are to be displayed in the console
window.
ACJDesigner.setDefaultAttachLabel
public void setDefaultAttachLabel(boolean isLabelAttached)
Specifies whether a label should be automatically added to the visible group
header above the zone in which a data field is dropped.
ACJDesigner.setDefaultExitMode
public void setDefaultExitMode(int exitMode)
Sets the default File - Exit action.
exitMode
Any combination of ACJConstants.DISPOSE_WINDOW,
ACJConstants.EXIT_JVM, and ACJConstants.NONE.
ACJDesigner.setDefaultGridSnap
public void setDefaultGridSnap(boolean isSnapped)
Sets the default value for Snap to Grid when designing templates.
isSnapped
Indicates whether the controls in the Designer are restricted along grid
boundaries.
showGrid
Indicates whether the grid should be displayed.
iSpaceInPixels
Specifies the default pixel width between controls which are arranged
horizontally.
bPrependSchema
A boolean value indicating whether the table name should be prefixed with
the schema.
ACJDesigner.setDefaultImageRelativePath
public void setDefaultImageRelativePath(boolean bImageUsesRelativePath)
Specifies whether the location is automatically updated as a relative path
when the image path is changed for an image control.
bImageUsesRelativePath
Indicates whether the path for the image should assume a path that is relative
to the application codebase.
ACJDesigner.setDefaultLookAndFeel
public void setDefaultLookAndFeel(java.lang.String sLookNFeel)
This method is used only in the SWING API. It is not in the AWT API.
ACJDesigner.setDefaultLowercaseQuotes
public void setDefaultLowercaseQuotes(boolean bLowercaseQuotes)
Specifies that if a table or column has lowercase characters embedded in it,
then the Quote Identifier is prepended and appended to it by default.
Pa c k a g e c o m . a c t u a t e . e r e p o r t . d e s i g n e r. A C J D e s i g n e r 85
bPrependSchema
A boolean value indicating whether the all-lowercase tablename should be
surrounded by quotes.
ACJDesigner.setDefaultNewTemplate
public void setDefaultNewTemplate(boolean isBlankTemplate)
Deprecated. Specifies whether a new template is blank (default = True) or
should be read from a file 'startup.erw'. Otherwise, Actuate e.Report Designer
creates a default startup skeleton template.
ACJDesigner.setDefaultPrependSchema
public void setDefaultPrependSchema(boolean bPrependSchema)
Specifies whether the schema or owner name should be prepended to the table
name by default in the FROM clause, as expected by ORACLE8.
ACJDesigner.setDefaultPrintMode
public void setDefaultPrintMode(boolean bLandscape)
Specifies whether to generate preview or printer output in landscape format
(True) or portrait format (False).
ACJDesigner.setdefaultshowgrid
public void setDefaultShowGrid(boolean showGrid)
Sets the default value to show the grid when designing templates.
ACJDesigner.setDefaultTemplateEncoding
public void setDefaultTemplateEncoding(int templateEncoding)
ACJDesigner.setDocsPath
public void setDocsPath(java.lang.String sDoc)
Specifies the name of the user guide file.
sDoc
The filename of the user guide.
ACJDesigner.setHasBeenGenerated
public void setHasBeenGenerated(boolean hasBeenGenerated)
ACJDesigner.setMruList
public void setMruList(java.lang.String[] ml)
Specifies an array of filenames to be stored in the MRU list. This function is
called internally by GuiTemplate.
mruList
An array of filenames containing templates.
ACJDesigner.setTemplateFile
public void setTemplateFile(java.lang.String urlORfile)
When a template is loaded externally, specifies the filename to be used by the
GUI when the Save Template option is selected from the menu.
urlORfile
The URL or file location where the template can be found.
Pa c k a g e c o m . a c t u a t e . e r e p o r t . d e s i g n e r. A C J D e s i g n e r 87
ACJDesigner.showMenu
public void showMenu()
Constructs the menu structure used in the menu bar. Used internally by
ACJDesigner.
ACJDesigner.stateChanged
public void stateChanged(javax.swing.event.ChangeEvent e)
Notification received just before the Designer's tab is changed; used internally.
Specified by
stateChanged in interface javax.swing.event.ChangeListener
ACJDesigner.syncTmplMgr
public void syncTmplMgr()
Used internally.
ACJDesigner.updateDesigner
public void updateDesigner()
Forces the Designer to reflect changes made to the template via the API.
ACJDesigner.updateOutputProperties
public void updateOutputProperties()
ACJDesigner.windowActivated
public void windowActivated(java.awt.event.WindowEvent ev)
Specified by
windowActivated in interface java.awt.event.WindowListener
ACJDesigner.windowClosed
public void windowClosed(java.awt.event.WindowEvent ev)
Specified by
windowClosed in interface java.awt.event.WindowListener
ACJDesigner.windowClosing
public void windowClosing(java.awt.event.WindowEvent ev)
Notification received when an attempt is made to close the parent frame. This
notification is used to prompt the user to save the existing template before
quitting.
Specified by
windowClosing in interface java.awt.event.WindowListener
Pa c k a g e c o m . a c t u a t e . e r e p o r t . d e s i g n e r. A C J D e s i g n e r 89
ACJDesigner.windowDeactivated
public void windowDeactivated(java.awt.event.WindowEvent ev)
Specified by
windowDeactivated in interface java.awt.event.WindowListener
Specified by
windowOpened in interface java.awt.event.WindowListener
ACJDesigner.windowDeiconified
public void windowDeiconified(java.awt.event.WindowEvent ev)
Specified by
windowDeiconified in interface java.awt.event.WindowListener
ACJDesigner.windowIconified
public void windowIconified(java.awt.event.WindowEvent ev)
Specified by
windowIconified in interface java.awt.event.WindowListener
ACJDesigner.windowOpened
public void windowOpened(java.awt.event.WindowEvent ev)
com.actuate.ereport.
Package
engine.ACJEngine
Pa ck a g e c o m .a c t u a t e. e r e p o r t. e n g i n e. AC J E n i g n e 91
Class ACJEngine
java.lang.Object
|
+--com.actuate.ereport.engine.ACJEngine
_____________________________________________________________________
public class ACJEngine
extends java.lang.Object
This class forms the heart of the reporting engine. Users must instantiate this
class as the first step in using ACJEngine for data reporting. This class contains
references of key objects such as the active data source, from which data is
extracted for generating reports, the Template Manager, which handles the
template skeleton structure, the Expression Evaluator, which is capable of
processing formulae embedded inside the report, and a communication stub,
which provides an interface for buffered raw report data to be fetched by the
output devices.
Field summary
Type Field
boolean DEBUG
A boolean variable used for internal
debugging.
Constructor summary
ACJEngine()
The default constructor creates an instance of the report engine and initializes
it by calling newSystem() internally.
Pa ck a g e c o m .a c t u a t e. e r e p o r t. e n g i n e. AC J E n i g n e 93
Method Description
ACJEngine Returns the proportional increment required
.getResizeFixRatio() to fix the resize-to-fit feature for other
output devices.
ACJEngine
.getOutputDevice()
ACJEngine TemplateManager is the main class that lets
.getTemplateManager() the user manipulate most aspects of the
template.
ACJEngine Returns an instance of the default
.getTemplateReader() implementation of ITmplReader that is
capable of reading an ASCII/Unicode
template structure from a specified input file
or stream.
ACJEngine Returns an instance of the default
.getTemplateWriter() implementation of ITmplWriter that is
capable of writing an ASCII/Unicode
template structure to a specified output file
or stream.
ACJEngine This function returns a reference to the
.getTmplMgr() internal TmplMgr instance variable
maintained by ACJEngine.
ACJEngine This function is called when data in the
.newSystem() engine needs to be cleared.
ACJEngine This function is called when data in the
.newTemplate() engine needs to be cleared.
ACJEngine This function is used to update the value of
.overrideResolution(int res) the resolution parameter stored in a
template with the resolution value specified
by the user.
ACJEngine This method is called internally to generate
.print() the entire report.
ACJEngine Notification received when the report
.printingDone() generation process is complete.
ACJEngine Reads the template from the specified
.readTemplate InputStream. Used in cases where loading a
template from a local file is not a viable
option.
Pa ck a g e c o m .a c t u a t e. e r e p o r t. e n g i n e. AC J E n i g n e 95
Method Description
ACJEngine Specifies a custom implementation of the
.setTemplateWriter ITmplWriter interface used to write the
contents of a report template to a file or
output stream.
ACJEngine Specifies whether the X11 Graphics
.setX11GfxAvailibility subsystem is available so font creation and
other tasks can be safely carried out.
ACJEngine This function is used to update the value of
.updateResolution() the resolution parameter stored in a
template with the value of the current screen
resolution.
ACJEngine This method attempts to write the contents
.writeTemplate of the entire template structure maintained
by the Template Manager to a specified file
using the default ANSI encoding type.
ACJEngine This method attempts to write the contents
.writeTemplate of the entire template structure maintained
by the Template Manager to a specified file
using the specified encoding type.
ACJEngine This method attempts to write the contents
.writeTemplate of the entire template structure maintained
by the Template Manager to a specified file
using the specified encoding type.
Field detail
DEBUG
public boolean DEBUG
A boolean variable used for internal debugging.
ACJDesigner constructor
ACJEngine
public ACJEngine()
See also
ACJEngine.newSystem()
ACJEngine.autoConnectDatasource
public void autoConnectDatasource(boolean bAutoConnect)
If this flag is set to True, a template with an embedded data source attempts to
connect to that data source and update the active data source reference in the
engine.
ACJEngine.debugMessage
public static void debugMessage(java.lang.String sMsg)
This function is used internally for debugging. It is a flagged version of
System.out.print(...). It allows a debug flag to be used to turn on or off all
console messages.
sMsg
A message to be displayed on the console window.
ACJEngine.debugMessageLN
public static void debugMessageLN(java.lang.String sMsg)
This function is used internally for debugging. It is a flagged version of
System.out.println(...). It allows a debug flag to be used to turn on or off all
console messages.
sMsg
A message to be displayed on the console window
public static void debugMessageLN()
Pa ck a g e c o m .a c t u a t e. e r e p o r t. e n g i n e. AC J E n i g n e 97
This function is used internally for debugging. It is a flagged version of
System.out.println(...). It allows a debug flag to be used to turn on or off all
console messages.
ACJEngine.disconnect
public void disconnect()
throws java.lang.Exception
This method was called internally by the engine in previous releases of
ACJEngine. It should not be explicitly called from an external class although
the method is defined as public. This method is not used in ACJEngine 3.xx. It
has been provided only for backward compatibility.
ACJEngine.doesX11GfxExist
public static boolean doesX11GfxExist()
Returns the availability of the X11 Gfx subsystem while performing internal
validations.
ACJEngine.finalizeEngine
public void finalizeEngine()
throws java.lang.Throwable
ACJEngine.generateReport
public com.actuate.ereport.common.IViewerInterface generateReport()
throws java.lang.Exception
Generates a report and returns the IViewerInterface instance required by
ACJOutputProcessor. Alternatively, you can call getDATReader(boolean b) or
getCommunicationStub(). These calls do not generate the report immediately,
however. They generate the report only when you request the data from the
report. These calls are useful when working with reports that use parameters.
The following initialization is required before generating a report:
Returns
An implementation of IViewerInterface communication interface
Throws
An exception occurs if the report generation process is abnormally terminated.
Abnormal termination usually occurs because of a fatal error.
ACJEngine.getColValue
public java.lang.Object getColValue(java.lang.Object TableId,
java.lang.Object ColumnName)
throws java.lang.Exception
This function is not used. It is provided for backward compatibility only.
When generating the report, data is returned for a specified column in the
Current Tuple in the result set structure represented by ITable.
ACJEngine.getCommunicationStub
public com.actuate.ereport.common.IViewerInterface
getCommunicationStub()
throws java.lang.Exception
Returns an implementation of the IViewerInterface. For normal report
generation, the default implementation is
com.actuate.ereport.engine.stub.DefaultReadWriteStub. For a thin viewer,
which generates a finished report from a raw report, the default
implementation is com.actuate.ereport.engine.stub.DefaultReadOnlyStub.
Returns
An implementation of the IViewerInterface communication stub.
Pa ck a g e c o m .a c t u a t e. e r e p o r t. e n g i n e. AC J E n i g n e 99
ACJEngine.getData source
public com.actuate.ereport.engine.IDatasource getDataSource()
Returns an instance of the active data source implementation that is currently
registered with ACJEngine. A report template that is used in generating
reports must use fields from this data source only.
Returns
A generic instance of the active data source.
ACJEngine.getDebugMode
public static boolean getDebugMode()
Returns the current debugMode status.
ACJEngine.getEvaluater
public com.actuate.ereport.engine.expreval.ExprEvaluator getEvaluater()
Returns the internal reference of ExprEvaluator that is required to register
user-defined functions. The ExprEvaluator package is responsible for
processing complex expressions embedded inside a template.
Returns
An instance of the expression evaluator maintained by ACJEngine.
ACJEngine.getOutputDevice
public com.actuate.ereport.engine.IPrinter getOutputDevice()
This function should not be used. It is provided only for backward
compatibility. This function returns an instance of the actual IPrinter report
generation interface implementation. Typically, this function is used when the
default output generation mechanism is overridden.
ACJEngine.getTargetOutputDevice
public int getTargetOutputDevice()
ACJEngine.getTemplateManager
public TemplateManager getTemplateManager()
TemplateManager is the main class that lets the user manipulate most aspects
of the template. You must get an instance of the Template Manager using this
method before you can access the template via the public API. Note that this
instance is destroyed whenever a call to the newSystem() or newTemplate()
methods is made. When the instance is destroyed, you must re-query the
engine for the instance of the newly created Template Manager.
Returns
An instance of the Template Manager internally maintained by the engine.
ACJEngine.getTemplateReader
public com.actuate.ereport.engine.ITmplReader getTemplateReader()
This API should not be used. It is provided for backward compatibility only.
Returns an instance of the default implementation of ITmplReader that is
capable of reading an ASCII/Unicode template structure from a specified
input file or stream.
Returns
An instance of the default ITmplReader implementation.
Returns
An instance of the default ITmplWriter implementation.
ACJEngine.getTmplMgr
public com.actuate.ereport.engine.TmplMgr getTmplMgr()
This function returns a reference to the internal Template Manager instance
variable maintained by ACJEngine. It is called internally and must not be
called from an external source. Its return type has been declared public
because it is required from classes in other packages.
Returns
A reference to the internal Template Manager instance variable used for
manipulating the template structure.
ACJEngine.newSystem
public void newSystem()
This function is called when all variables in the engine need to be reset.
Internally, this function removes the active data source, clears dynamic tables,
resets the Expression Evaluator, destroys the contents of the entire template
structure (including report header/footer, page header/footer, and the default
section), and resets the instance of the Template Manager maintained by the
engine.
ACJEngine.newTemplate
public void newTemplate()
This function is called when all variables in the engine need to be reset.
Internally, this function clears dynamic tables, resets the Expression Evaluator,
destroys the contents of the entire template structure (including report
header/footer, page header/footer, and the default section) and resets the
instance of the Template Manager maintained by the engine.
See also
ACJEngine.newSystem()
ACJEngine.overrideResolution
public void overrideResolution(int res)
This function is used to update the value of the resolution parameter stored in
a template with the resolution value specified by the user. The call to this
method should be made after the call to the readTemplate method.
ACJEngine.print
public void print()
throws java.lang.Exception
This method is internally called to generate the entire report. It is called
internally by the generateReport() API after query parameter values are
substituted. This method internally calls the print() function in the Template
Manager, which autogenerates a query, fetches a record set from the active
Data source, formats the data, and notifies the IPrinter implementation for
different printing messages.
ACJEngine.printingDone
public void printingDone()
Notification received when the report generation process is complete. This
function is specifically implemented to clear all stateless variables. It explicitly
frees memory locked by unused objects.
ACJEngine.readTemplate
public void readTemplate(java.lang.String template)
throws java.lang.Exception
Reads a template from specified filename.
template
A valid path indicating a template file containing a template written in an
ANSI format.
ACJEngine.readTemplate
public void readTemplate(java.lang.String template, int fileMode)
throws java.lang.Exception
Reads a template from specified filename using the specified encoding.
Updates the contents of the Template Manager. Any data source embedded in
the template is loaded and set as the active data source.
template
Path of the template file to be read.
fileMode
Encoding type. Permissible values are ACJConstants.ASCII, and
ACJConstants.UTF8.
template
Input stream from which a template is to be read. This function instantiates
Template Manager and reads the template.
template
A valid input stream from which a template formatted using ANSI encoding
can be loaded.
public void readTemplate(java.io.InputStream template, int streamMode)
throws java.lang.Exception
Reads a template from the specified input stream. Used in cases where loading
a template from a local file is not a viable option. Any data source embedded
inside a template is automatically loaded and set as the active data source.
template
Input stream from which template is to be read.
streamMode
Encoding type. Valid types are ACJConstants.ASCII and ACJConstants.UTF8.
This function instantiates Template Manager and reads the template.
ACJEngine.resetStub
public void resetStub()
ACJEngine.setCacheOption
public void setCacheOption(boolean filecache,
java.lang.String tempfile)
Specifies whether the temporary file is generated by ACJEngine during report
generation. Indicates whether the temporary file should be stored in memory
filecache
Stores temporary files to disk if True is passed. Keeps data in memory if False
is passed.
tempfile
Path of a temporary file. Valid only if the first parameter is True.
ACJEngine.setCommunicationStub
public void setCommunicationStub(com.actuate.ereport.engine.stub.BaseStub
stub)
This function was called internally in previous versions of ACJEngine. It is no
longer used and must not be used from outside ACJEngine. It has only been
provided for backward compatibility. Sets the internal reference of the
IViewerInterface implementation.
ACJEngine.setDataSource
public void setDataSource(com.actuate.ereport.engine.IDataSource ds)
throws java.lang.Exception
Users must specify the implementation of the data source to be used for data
retrieval when generating reports. Default implementations of the data source
interface (IDataSource) provided are JDBCHandler, AppDataHandler, and
MetaDataHandler.
ACJEngine.setDebugMode
public static void setDebugMode(boolean b)
Specifies whether progress or error messages are to be displayed in the console
window.
b
Turns on or off the engine-related debugging messages that appear in the
console window.
ACJEngine.setResizeFixRatio
public void setResizeFixRatio(float fResizeFixRatio)
Sets the proportional increment required to fix the resize-to-fit feature for other
output devices.
ACJEngine.getResizeFixRatio
public float getResizeFixRatio()
Returns the proportional increment required to fix the resize-to-fit feature for
other output devices.
ACJEngine.setTargetOutputDevice
public void setTargetOutputDevice(int iTargetOutputDevice)
ACJEngine.setTemplateReader
public void setTemplateReader(com.actuate.ereport.engine.ITmplReader it)
This API is not used. It is provided for backward compatibility only. Specifies a
custom implementation of the ITmplReader interface used to read the contents
of a report template from a file or input stream.
ACJEngine.setX11GfxAvailibility
public static void setX11GfxAvailibility(boolean b)
Specifies whether the X11 Graphics subsystem is available so font creation and
other tasks can be safely carried out.
ACJEngine.updateResolution
public void updateResolution()
This function is used to update the value of the resolution parameter stored in
a template with the value of the current screen resolution. The call to this
method should be made after the call to the readTemplate method.
ACJEngine.writeTemplate
public void writeTemplate(java.lang.String template, int fileMode)
throws java.lang.Exception
This method attempts to write the contents of the entire template structure
maintained by the Template Manager to a specified file using the specified
encoding type.
template
Output file name to which template is to be saved.
fileMode
Encoding type. Permissible values are ACJConstants.ASCII and
ACJConstants.UTF8.
os
Output stream to which the template is to be saved.
ACJEngine.writeTemplate
public void writeTemplate(java.io.OutputStream os, int streamMode)
throws java.lang.Exception
This method attempts to write the contents of the entire template structure
maintained by the Template Manager to a specified file using the specified
encoding type.
os
Output stream to which template is to be saved.
streamMode
Encoding type. Permissible values are ACJConstants.ASCII and
ACJConstants.UTF8.
com.actuate.ereport.
Package
output.
ACJOutputProcessor
Constructor summary
ACJOutputProcessor()
A default constructor.
Method summary
Method Description
ACJOutputProcessor
.closeZipEntry
ACJOutputProcessor
.closeZipStream
ACJOutputProcessor Undocumented feature.
.debugOutputProps()
ACJOutputProcessor Generates a CSV report using the properties
.generateCSV() individually set by the setCSVProperty()
method.
ACJOutputProcessor Deprecated. Use setCSVProperty() /
.generateCSV generateCSV() instead.
ACJOutputProcessor Deprecated. Use setCSVProperty() /
.generateCSV generateCSV() instead.
ACJOutputProcessor Generates a DHTML report using the
.generateDHTML() properties individually set by the
setDHTMLProperty() method.
ACJOutputProcessor constructor
ACJOutputProcessor
public ACJOutputProcessor()
A default constructor.
ACJOutputProcessor.closeZipStream
public static void closeZipStream(java.util.zip.ZipOutputStream zos)
throws java.lang.Exception
ACJOutputProcessor.debugOutputProps
public void debugOutputProps()
Undocumented feature
Throws
java.lang.RuntimeException. A runtime exception occurs if there is an error
when generating the HTML report.
ACJOutputProcessor.generateCSV
public void generateCSV()
throws java.lang.Exception
Generates a CSV report using the properties individually set by the
'setCSVProperty()' method.
Throws
java.lang.RuntimeException. A runtime exception occurs if there is an error
when generating the CSV report.
sFilename
Filename to which the output should be saved.
cProgressParent
An AWT component visible on screen. If Null is passed, ACJOutputProcessor
internally creates a dummy component.
cSeparator
Specifies the separator string. If Null is passed a comma ( , ) is used.
ACJOutputProcessor.generateCSV
public void generateCSV(java.lang.Object sFilename,
java.awt.Component cProgressParent,
java.lang.String cSeparator,
java.lang.String cTextQual)
Deprecated. Use setCSVProperty() / generateCSV() instead. Exports the
current report to a CSV file specified by the given name.
sFilename
Filename to which the output should be saved.
cProgressParent
An AWT component visible on screen. If Null is passed, ACJOutputProcessor
internally creates a dummy component.
cSeparator
Specifies the separator string. If Null is passed a comma ( , ) is used.
cTextQual
Specifies the text qualifier string. If Null is passed, no qualifier is set.
ACJOutputProcessor.generateDHTML
public void generateDHTML()
throws java.lang.Exception
Generates a DHTML report using the properties individually set by the
setDHTMLProperty() method.
Throws
java.lang.RuntimeException. A runtime exception occurs if there is an error
when generating the DHTML report.
ACJOutputProcessor.generateEMAIL
public void generateEMAIL()
throws java.lang.Exception
Transmits the listed set of e-mails to the recipients via an SMTP server with
other properties as set by setEMAILProperty().
Throws
java.lang.RuntimeException. A runtime exception occurs if there is an error
when generating or sending the report.
ACJOutputProcessor.generateHTML
public void generateHTML(java.lang.Object outputDesc,
java.awt.Component cOffscreenImages,
boolean preserveFonts,
boolean preserveColors)
Deprecated. Use setHTMLProperty() / generateHTML() instead. Exports the
current report to an HTML file with the given filename. Exports optional
additional files appended by an ID, depending on the report type and content.
sFilename
Filename where output should be saved.
cOffscreenImages
Any on screen AWT component. Needed by ACJEngine if charts, graphs or
images are present in the template. If Null is passed, ACJOutputProcessor
creates them internally only if charts, graphs or images are present in the
template.
preserveFonts
Preserves the report's original fonts if True is passed. Otherwise, creates all text
using the default font. Useful when trying to reduce the size of the output.
preserveColors
Preserves the report's original colors if True is passed. Otherwise, uses black
and white colors for the entire report. Useful when trying to reduce the size of
the output.
ACJOutputProcessor.generateHTML
public void generateHTML(java.lang.Object outputDesc,
java.awt.Component cOffscreenImages,
sFilename
Filename where output should be saved.
cOffscreenImages
Any on screen AWT component. Needed by ACJEngine if charts, graphs or
images are present in the template. If Null is passed, ACJOutputProcessor
creates them internally only if charts, graphs or images are present in the
template.
preserveFonts
Preserves the report's original fonts if True is passed. Otherwise, creates all text
using the default font. Useful when trying to reduce the size of the output.
preserveColors
Preserves the report's original colors if True is passed. Otherwise, uses black
and white colors for the entire report. Useful when trying to reduce the size of
the output.
useHorSpacing
Tries to preserve horizontal spacing between controls if True is passed.
Otherwise, ignores horizontal spacing between controls.
isTOC
Generates a Table of Contents if True is passed. Does not generate a Table of
Contents if False is passed.
ACJOutputProcessor.generateHTML
public void generateHTML(java.lang.Object outputDesc,
java.awt.Component cOffscreenImages,
boolean preserveFonts,
boolean preserveColors,
boolean useHorSpacing,
boolean isTOC,
boolean gzip)
ACJOutputProcessor.generateJOI
public void generateJOI(java.lang.String sFilename)
Exports the current report to a JOI file specified by the argument. JOI is a raw
ACJEngine data file that lets users create report executables.
ACJOutputProcessor.generateJOI
public void generateJOI()
throws java.lang.Exception
Generates a JOI report using the properties individually set by the
setJOIProperty() method.
Throws
java.lang.RuntimeException. A runtime exception occurs if there is an error
when generating the JOI report.
ACJOutputProcessor.generatePDF
public void generatePDF()
throws java.lang.Exception
Generates a PDF report using the properties individually set by the
setPDFProperty() method.
Throws
java.lang.RuntimeException. A runtime exception occurs if there is an error
when generating the PDF report.
outputDesc
Filename string to which output should be saved, or an instance of an output
stream.
cOffscreenImages
Any visible AWT component. Needed by ACJEngine if charts, graphs or
images are present in the template. If Null is passed, ACJEngine generates an
instance internally only if charts, graphs or images are present in the template.
ACJOutputProcessor.generatePDF
public void generatePDF(java.lang.Object outputDesc,
java.awt.Component cOffscreenImages,
boolean isTOC)
Deprecated. Use setPDFProperty() / generatePDF() instead. Exports the
current report to a PDF file specified by filename.
outputDesc
Filename string to which output should be saved, or an instance of an output
stream.
cOffscreenImages
Any visible AWT component. Needed by ACJEngine if charts, graphs or
images are present in the template. If Null is passed, ACJEngine generates an
instance internally only if charts, graphs or images are present in the template.
isTOC
Specifies whether a Table of Contents is to be generated.
outputDesc
Filename string to which output should be saved, or an instance of an output
stream.
cOffscreenImages
Any visible AWT component. Needed by ACJEngine if charts, graphs or
images are present in the template. If Null is passed, ACJEngine internally
generates an instance only if charts, graphs or images are present in the
template.
isTOC
Specifies whether a Table of Contents is to be generated.
ACJOutputProcessor.generatePDF_Ex
public void generatePDF_Ex(java.lang.Object outputDesc,
java.awt.Component cOffscreenImages,
int maxIds,
int maxPages,
int maxContents)
Deprecated. Use setPDFProperty() / generatePDF() instead. Extended API for
generating PDF reports. Required for very large reports.
maxIds
Every object rendered on a PDF page is represented as an ID. The default value
is 65,536 bytes.
maxPages
Every page in a PDF file is represented by an ID. Specifies the maximum
number of pages required for preallocation.
ACJOutputProcessor.generatePDF_Ex
public void generatePDF_Ex(java.lang.Object outputDesc,
java.awt.Component cOffscreenImages,
int maxIds,
int maxPages,
int maxContents,
boolean isTOC)
Deprecated. Use setPDFProperty() / generatePDF() instead. Extended API for
generating PDF reports. Required for very large reports.
maxIds
Every object rendered on a PDF page is represented as an ID. The default value
is 65,536 bytes.
maxPages
Every page in a PDF file is represented by an ID. Specifies the maximum
number of pages required for preallocation, rounded up.
maxContents
For an indexed report with a Table of Contents, each item in the Table of
Contents is stored as a content. Specifies the maximum number of contents
required for preallocation, rounded up.
isTOC
Generates a Table of Contents if True is passed; none if False is passed.
ACJOutputProcessor.generatePRINTOUT
public java.awt.print.PrinterJob generatePRINTOUT()
throws java.lang.Exception
Prints a hard copy of the report using properties individually set by
setPRINTERProperty().
In the SWING API, the generatePRINTOUT() methods return
java.awt.print.PrinterJob.
Throws
java.lang.RuntimeException. A runtime exception occurs if there is an error
when printing the report.
ACJOutputProcessor.generatePRINTOUT
public java.awt.print.PrinterJob generatePRINTOUT(boolean isGui,
java.awt.print.PrinterJob pj,
boolean preservePrintjob,
boolean silentPrint)
Deprecated. Use setPRINTERProperty() / generatePRINTOUT() instead.
In the SWING API, the generatePRINTOUT() methods return
java.awt.print.PrinterJob.
In the AWT API, the generatePRINTOUT() methods return a
java.awt.PrintJob.
ACJOutputProcessor.generatePRINTOUT
public java.awt.print.PrinterJob generatePRINTOUT(boolean isGui,
java.awt.print.PrinterJob pj,
boolean preservePrintjob,
boolean silentPrint,
java.awt.Component bVisibleComponent)
Deprecated. Use setPrinterProperty() / generatePRINTOUT() instead. Prints a
hard copy of the report to the printer specified in the printer specifications/
setup dialog box.
In the SWING API, the generatePRINTOUT() methods return
java.awt.print.PrinterJob.
In the AWT API, the generatePRINTOUT() methods return a
java.awt.PrintJob.
isGui
Specifies whether the preview device is showing; if the device is showing, it
has a parent frame.
preservePrintjob
Indicates whether the PrinterJob should be destroyed or retained for another
process.
silentPrint
If True is passed, printing occurs without displaying a print dialog box.
Otherwise, the dialog box displays before printing.
bVisibleComponent
The component used to get the print job.
ACJOutputProcessor.getCSVProperty
public java.lang.Object getCSVProperty(java.lang.String sProperty)
Attempts to retrieve an individual property used by the CSV output device
when generating a CSV report.
sProperty
The property to be retrieved. Properties are: FileName (String), OutputStream
(OutputStream), CharacterSeparator (String), and QuoteCharacter (String).
ACJOutputProcessor.getDHTMLDevice
public com.actuate.ereport.output.OD_DHTML getDHTMLDevice()
Used internally.
ACJOutputProcessor.getDHTMLProperty
public java.lang.Object getDHTMLProperty(java.lang.String sProperty)
Attempts to retrieve an individual property to be used by the DHTML output
report.
ACJOutputProcessor.getDocumentationPath
public java.lang.String getDocumentationPath()
Gets the path to the main documentation file.
ACJOutputProcessor.getEMAILProperty
public java.lang.Object getEMAILProperty(java.lang.String sProperty)
Attempts to retrieve an individual property used by the printer output device
when printing a report.
sProperty
The property to be retrieved. Properties are: SMTPServer (String),
SenderEmail (String), Recipients (Vectpr), Subject (String), Notes (String),
ReportTypes(Integer - ACJConstants.PDF+HTML+DHTML, etc.), and
FilesToAttach (Vector).
ACJOutputProcessor.getHTMLProperty
public java.lang.Object getHTMLProperty(java.lang.String sProperty)
Attempts to retrieve an individual property to be used by the HTML output
report.
sProperty
The property to be retrieved. Properties are: FileName (String), OutputStream
(OutputStream), BufferSize (Integer), VisibleComponent (Component),
TableOfContents (Boolean), ZipCompressed (Boolean), PreserveColors
(Boolean), PreserveFonts (Boolean), PreservePageBreaks (Boolean), and
HorizontalSpacing (Boolean).
sProperty
The FileName (String) property to be retrieved.
ACJOutputProcessor.getOutputFiles
public java.lang.String[] getOutputFiles()
Returns a list of files generated for a structured output; for example, HTML
with Table of Contents or images.
ACJOutputProcessor.getPDFProperty
public java.lang.Object getPDFProperty(java.lang.String sProperty)
Attempts to retrieve an individual property used by the PDF output device
when generating a PDF report.
sProperty
The property to be retrieved. Properties are: FileName (String), OutputStream
(OutputStream), BufferSize (Integer), VisibleComponent (Component),
TableOfContents (Boolean), ZipCompressed (Boolean), MaxPages (Integer),
MaxItems (Integer), and MaxContents (Integer).
ACJOutputProcessor.getPreviewDevice
public javax.swing.JPanel getPreviewDevice()
Returns an instance of the preview device. A handle of OD_Preview is needed
before the preview device can be embedded inside a container, such as a frame
or panel. The handle is also needed before the preview device can be
controlled through the API in this class. All publicly available APIs to control
the preview device are available through ACJOutputProcessor. Publicly
available APIs are only accessible after making a call to getPreviewDevice().
ACJOutputProcessor.getPRINTERProperty
public java.lang.Object getPRINTERProperty(java.lang.String sProperty)
Attempts to retrieve an individual property used by the printer output device
when printing a report.
sProperty
The property to be retrieved. Properties are: PrinterJob (PrintJob),
VisibleComponent (Component), IsGUIVisible (Boolean), PreservePrinterJob
(Boolean), and SilentPrint (Boolean).
ACJOutputProcessor.getPrinterResolution
public double getPrinterResolution()
Returns the current resolution for the printer device only when printer
resolution is set through setPrinterResolution. Otherwise, zero is returned.
ACJOutputProcessor.getVirtualOutput
public com.actuate.ereport.output.VirtualOutput getVirtualOutput()
Returns an instance of the VirtualOutput object. Used internally.
ACJOutputProcessor.hasMultipleOutputFiles
public boolean hasMultipleOutputFiles()
Returns True if more than a single output file is generated.
ACJOutputProcessor.promptParams
public boolean promptParams()
Indicates whether the parameter entry dialog displays when the report output
is required.
ACJOutputProcessor.promptParams
public void promptParams(boolean bPromptParams)
Specifies whether the parameter entry dialog displays when the report output
is required.
ACJOutputProcessor.prv_getActivePage
public int prv_getActivePage()
Returns the active page in the preview window.
ACJOutputProcessor.prv_getPageCount
public int prv_getPageCount()
Returns the count of available pages in the preview. If the report is indexed,
returns the total number of pages buffered for the currently selected node in
the Table Of Contents.
ACJOutputProcessor.prv_removeToolbarItem
public void prv_removeToolbarItem(java.lang.String sName)
throws java.lang.Exception
Removes a single item from the toolbar in the preview window.
sName
A name representing the toolbar item. Permissible values are Export, Zoom,
Printer, Navigation, Refresh, TOC, and Margins.
Throws
java.lang.RuntimeException. An error occurs if an attempt is made to remove
an icon other than those in the list of removeable items above.
ACJOutputProcessor.prv_setActivePage
public boolean prv_setActivePage(int p)
Sets the active page in the preview window.
ACJOutputProcessor.prv_setBackgroundTOC
public void prv_setBackgroundTOC(java.awt.Color bgClr)
Sets the background color of the Table of Contents in the preview window.
ACJOutputProcessor.prv_showToolbar
public void prv_showToolbar()
Shows the toolbar in the preview window.
ACJOutputProcessor.prv_updateToolbar
public void prv_updateToolbar()
ACJOutputProcessor.prv_setNextPage
public void prv_setNextPage()
Sets the active page to the next page. The next page may be a subpage split on
the current page.
ACJOutputProcessor.prv_setPrevPage
public void prv_setPrevPage()
Sets the active page to the previous page. The previous page may be a subpage
split on the current page.
ACJOutputProcessor.prv_showTOC
public void prv_showTOC()
ACJOutputProcessor.putNewZipEntry
public static void putNewZipEntry(java.lang.String filenm,
java.util.zip.ZipOutputStream zos)
throws java.lang.Exception
ACJOutputProcessor.refreshReport
public void refreshReport(boolean regenerate)
throws java.lang.Exception
Re-retrieves the current page. If True is passed, the report is regenerated, then
the page is retrieved.
regenerate
If True is passed, the report is regenerated. Otherwise, existing report data is
used.
ACJOutputProcessor.setBufferSize
public void setBufferSize(int bufferSize)
Sets the buffer size in bytes for delayed filewrites. The default is 65,536 bytes.
Setting a higher buffer reduces the time it takes to write a file but increases
memory usage.
ACJOutputProcessor.setCSVProperty
public void setCSVProperty(java.lang.String sProperty,
java.lang.Object oValue)
throws java.lang.Exception
Attempts to set an individual property used by the CSV output device when
generating a CSV report. If a property is omitted, a default value is used.
oValue
The corresponding value for the property to be set. Ensure that the correct data
type is used when setting the value.
Throws
java.lang.RuntimeException. An exception is generated if an invalid property,
an invalid data type value, or a Null property is set.
ACJOutputProcessor.setDHTMLProperty
public void setDHTMLProperty(java.lang.String sProperty,
java.lang.Object oValue)
throws java.lang.Exception
Attempts to set an individual property used by the DHTML output device
when generating an DHTML report. If a property is omitted, a default value is
used.
sProperty
The property to be set. Properties are: FileName (String), OutputStream
(OutputStream), BufferSize (Integer), VisibleComponent (Component),
TableOfContents (Boolean), ZipCompressed (Boolean), PreserveColors
(Boolean), PreserveFonts (Boolean), PreservePageBreaks (Boolean), and
HorizontalSpacing (Boolean).
oValue
The corresponding value for the property to be set. Ensure that the correct data
type is used when setting the value.
Throws
java.lang.RuntimeException. An exception is generated if an invalid property,
an invalid data type value, or a Null property is set.
ACJOutputProcessor.setEMAILProperty
public void setEMAILProperty(java.lang.String sProperty,
java.lang.Object oValue)
throws java.lang.Exception
Attempts to set an individual property used by the emailing system while
deploying reports. If a specific property is omitted, a default value is used.
sProperty
The property to be set. Properties are: SMTPServer (String), SenderEmail
(String), Recipients (Vector), Subject (String), Notes (String),
ReportTypes(Integer - ACJConstants.PDF+HTML+DHTML etc.) and
FilesToAttach (Vector).
oValue
The corresponding value for the property to be set. Ensure that the correct data
type is used when setting the value.
Throws
java.lang.RuntimeException. An exception is generated if an invalid property,
an invalid value data type value or a Null property is set.
ACJOutputProcessor.setHTMLProperty
public void setHTMLProperty(java.lang.String sProperty,
java.lang.Object oValue)
throws java.lang.Exception
Attempts to set an individual property used by the HTML output device while
generating an HTML report. If a specific property is omitted, a default value is
used.
oValue
The corresponding value for the property to be set. Ensure that the correct data
type is used when setting the value.
Throws
java.lang.RuntimeException. An exception is generated if an invalid property,
an invalid value data type or a Null property is set.
ACJOutputProcessor.setJOIFileSource
public void setJOIFileSource(java.io.File JOIFile)
throws java.lang.Exception
Sets the source of report data to the specified filename. Used for report
executables. Note that loading a JOI file from a file on the local system is
handled differently than loading a JOI file from a URL. Be sure to use the
appropriate API.
JOIFile
Filename on the file system where the JOI file is located.
ACJOutputProcessor.setJOIProperty
public void setJOIProperty(java.lang.String sProperty,
java.lang.Object oValue)
throws java.lang.Exception
Attempts to set an individual property used by the JOI Handler when
generating a JOI report. If a specific property is omitted, a default value is
used.
sProperty
The property FileName (String) to be set.
Throws
java.lang.RuntimeException. An exception is generated if an invalid property,
an invalid data type value or a Null property is set.
ACJOutputProcessor.setJOISource
public void setJOISource(java.lang.String sJOIorURL)
throws java.lang.Exception
A macro that accepts a string representation of a JOI filename or the location of
a JOI filename via a URL (http:, ftp:, or file:). Internally calls setJOIURLSource
or setJOIFileSource.
sDATorURL
Either a JOI local filename or a JOI file at a URL.
ACJOutputProcessor.setJOIURLSource
public void setJOIURLSource(java.net.URL JOIURL)
throws java.lang.Exception
Sets the source of report data to the specified URL. Used for report
executables. Note that loading a JOI file from a file on the local system is
handled differently than loading a JOI file from a URL. Be sure to use the
appropriate API.
JOIURL
URL location of the JOI file.
ACJOutputProcessor.setOutputProperty
public void setOutputProperty(java.lang.String sOutputDevice,
java.lang.String sProperty,
java.lang.Object oValue)
ACJOutputProcessor.setPDFProperty
public void setPDFProperty(java.lang.String sProperty,
java.lang.Object oValue)
throws java.lang.Exception
Attempts to set an individual property used by the PDF output device when
generating a PDF report. If a specific property is omitted, a default value used.
sProperty
The property to be set. Properties are: FileName (String), OutputStream
(OutputStream), BufferSize (Integer), VisibleComponent (Component),
TableOfContents (Boolean), ZipCompressed (Boolean), MaxPages (Integer),
MaxItems (Integer), and MaxContents (Integer).
oValue
The corresponding value for the property to be set. Ensure that the correct data
type is used when setting the value.
Throws
java.lang.RuntimeException. An exception is generated if an invalid property,
an invalid data type value or a Null property is set.
ACJOutputProcessor.setPRINTERProperty
public void setPRINTERProperty(java.lang.String sProperty,
java.lang.Object oValue)
throws java.lang.Exception
Attempts to set an individual property used by the printer output device when
printing a report. If a specific property is omitted, a default value is used.
sProperty
The property to be set. Properties are: PrinterJob (PrinterJob),
VisibleComponent (Component), IsGUIVisible (Boolean), PreservePrinterJob
(Boolean), and SilentPrint (Boolean).
SilentPrint is not available in AWT since the IsGUIVisible option must always
be True for the generatePrintout() method to work.
Throws
java.lang.RuntimeException. An exception is generated if an invalid property,
an invalid data type value, or a Null property is set.
ACJOutputProcessor.setPrinterResolution
public void setPrinterResolution(boolean showDialog,
double resolution)
Sets and resets the printer resolution. This method is used to force printer
resolution to a predefined value.
showDialog
Set this parameter to True to enable setting correct resolution, when the JVM
resolution returned through PrintJob is not correct. When ShowDialog is True,
a printer resolution dialog displays before printing.
resolution
The required value for the printer resolution. This parameter is ignored if
showDialog is True.
ACJOutputProcessor.setReportData
public boolean setReportData
(com.actuate.ereport.common.IViewerInterface ivi)
throws java.lang.Exception
Sets the raw report data generated using ACJEngine.generateReport() as the
actual data that ACJOutputProcessor uses to generate output.
ivi
Raw ACJEngine report data generated by ACJEngine.generateReport().
c
If the report is contains parameters, pass Visible to display the Enter Parameter
Values dialog box. Pass Null to bypass displaying the dialog box.
Returns
True if report data was successfully set to the ACJEngine client module. False
otherwise.
ACJOutputProcessor.writefile
public static void writefile(java.util.zip.ZipOutputStream zos,
java.util.Vector filenms)
throws java.lang.Exception
ACJOutputProcessor.writeZip
public static void writeZip(java.lang.String fnm,
java.util.zip.ZipOutputStream zos)
throws java.lang.Exception
com.actuate.ereport.
Package
datasrcmgrs.appdatasrc.
AppDataHandler
Package co m.a ctu ate.erep or t.d atasrcmgrs.app data src.Ap pDa taHa nd ler 145
Class AppDataHandler
java.lang.Object
|
+--com.actuate.ereport.engine.MetadataAdapter
|
+--com.actuate.ereport.datasrcmgrs.appdatasrc.AppDataHandler
_____________________________________________________________________
See also
Serialized objects
Constructor summary
AppDataHandler()
The default constructor.
Package co m.a ctu ate.erep or t.d atasrcmgrs.app data src.Ap pDa taHa nd ler 147
Method Description
AppDataHandler
.getQueryResult
AppDataHandler
.getQueryTables
AppDataHandler Returns all relations as a vector of strings.
.getRelations()
AppDataHandler
.getStartRecordNumber()
AppDataHandler Executes the query and returns the result
.getTable set.
AppDataHandler Returns a list of all table names registered
.getTableNames() with the data source.
AppDataHandler Not used. Returns Java Class.
.getTableType
AppDataHandler Not used. An application data source does
.isConnected() not require a connection the way a JDBC
data source does.
AppDataHandler Returns Yes if Null is a valid default value
.isNullable for the specified table or column; No
otherwise.
AppDataHandler Used internally.
.passTableData
AppDataHandler Passes the data objects from your
.registerDataSet application to ACJEngine.
AppDataHandler Defines your application object and its
.registerObjectAsTable structure to ACJEngine in the form of a
table.
AppDataHandler Predefined query implementation.
.registerQuery
AppDataHandler Deprecated. Use registerUserDefTable()
.RegisterTable instead.
AppDataHandler Deprecated. Use registerObjectAsTable()
.RegisterTable instead.
AppDataHandler Defines your application object and its
.registerUserDefTable structure to ACJEngine in the form of a
table.
AppDataHandler constructor
AppDataHandler
public AppDataHandler()
A default constructor.
AppDataHandler.allowMultipleTableRegistering
public void allowMultipleTableRegistering(boolean
bAllowMultipleTablesForSameClass)
Allows multiple tables to be registered using the same class.
bAllowMultipleTablesForSameClass - if true
Allows multiple tables to be registered.
Package co m.a ctu ate.erep or t.d atasrcmgrs.app data src.Ap pDa taHa nd ler 149
AppDataHandler.connect
public void connect()
throws java.lang.Exception
Not used. An application data source does not require a connection the way a
JDBC data source does.
Specified by
connect in interface com.actuate.ereport.engine.IDataSource
AppDataHandler.disconnect
public void disconnect()
throws java.lang.Exception
Not used. An application data source does not require a connection the way a
JDBC data source does.
Specified by
disconnect in interface com.actuate.ereport.engine.IDataSource
AppDataHandler.fetchData
public java.lang.Object fetchData(java.lang.String sTable,
java.lang.String sColumn,
int iStart,
int iCount)
throws java.lang.Exception
Not used. Returns Null.
Specified by
fetchData in interface com.actuate.ereport.engine.IDataSource
Overrides
getCatalogName in class com.actuate.ereport.engine.MetadataAdapter
AppDataHandler.getColumnNames
public java.util.Vector getColumnNames(java.lang.String sTableName)
throws java.lang.Exception
Returns a vector of column names that have been registered for the specified
table name.
Specified by
getColumnNames in interface com.actuate.ereport.engine.IDataSource
Overrides
getColumnNames in class com.actuate.ereport.engine.MetadataAdapter
AppDataHandler.getDataType
public int getDataType(java.lang.String sTable,
java.lang.String sColumn)
throws java.lang.Exception
Returns the SQL equivalent of a primitive data type. String = VARCHAR, int =
INTEGER, long = BIGINT, double = DOUBLE, boolean = BIT, Date = DATE,
BIGDECIMAL = DECIMAL, float = REAL, short = SMALLINT, Time = TIME,
TimeStamp = TIMESTAMP, byte = TINYINT, Image = LONGVARBINARY,
Character = CHAR.
Package co m.a ctu ate.erep or t.d atasrcmgrs.app data src.Ap pDa taHa nd ler 151
Overrides
getDataType in class com.actuate.ereport.engine.MetadataAdapter
AppDataHandler.getDebugMode
public static boolean getDebugMode()
Returns the current debugMode status.
AppDataHandler.getEndRecordNumber
public int getEndRecordNumber()
AppDataHandler.getIdentifierQuote
public java.lang.String getIdentifierQuote()
Returns a " ' " as the delimiter string for special data types such as dates, as
well as when table names have spaces in them.
Overrides
getIdentifierQuote in class com.actuate.ereport.engine.MetadataAdapter
AppDataHandler.getName
public java.lang.String getName()
Identifies the name of the data source. Returns Application DataSource.
Specified by
getName in interface com.actuate.ereport.engine.IDataSource
Specified by
getPropertySheet in interface com.actuate.ereport.engine.IDataSource
AppDataHandler.getQuery
public java.lang.String getQuery(java.lang.Object queryId)
Specified by
getQuery in interface com.actuate.ereport.engine.IDataSource
AppDataHandler.getQueryColumns
public java.util.Vector getQueryColumns(java.lang.Object queryId,
java.lang.String tableName)
throws java.lang.Exception
Specified by
getQueryColumns in interface com.actuate.ereport.engine.IDataSource
AppDataHandler.getQueryResult
public com.actuate.ereport.engine.ITable getQueryResult(java.lang.Object
queryId,java.lang.String query)
throws java.lang.Exception
Package co m.a ctu ate.erep or t.d atasrcmgrs.app data src.Ap pDa taHa nd ler 153
Specified by
getQueryResult in interface com.actuate.ereport.engine.IDataSource
AppDataHandler.getQueryTables
public java.util.Vector getQueryTables(java.lang.Object queryId)
throws java.lang.Exception
Specified by
getQueryTables in interface com.actuate.ereport.engine.IDataSource
AppDataHandler.getRelations
public java.util.Vector getRelations()
throws java.lang.Exception
Returns all relations as a vector of strings. The format for each relation is:
TABLE1.COL1-TABLE2.COL2, RELATIONTYPE.
Overrides
getRelations in class com.actuate.ereport.engine.MetadataAdapter
AppDataHandler.getStartRecordNumber
public int getStartRecordNumber()
AppDataHandler.getTable
public com.actuate.ereport.engine.ITable getTable(java.util.Hashtable
htQuery,
java.lang.String sReaders)
throws java.lang.Exception
Executes the query and returns the result set.
AppDataHandler.getTableNames
public java.util.Vector getTableNames()
throws java.lang.Exception
Returns a list of all table names registered with the data source.
Specified by
getTableNames in interface com.actuate.ereport.engine.IDataSource
Overrides
getTableNames in class com.actuate.ereport.engine.MetadataAdapter
AppDataHandler.getTableType
public java.lang.String getTableType(java.lang.String sTable)
throws java.lang.Exception
Not used. Returns Java Class.
Overrides
getTableType in class com.actuate.ereport.engine.MetadataAdapter
AppDataHandler.isConnected
public boolean isConnected()
throws java.lang.Exception
Not used. An application data source does not require a connection the way a
JDBC data source does. Returns True.
Package co m.a ctu ate.erep or t.d atasrcmgrs.app data src.Ap pDa taHa nd ler 155
Specified by
isConnected in interface com.actuate.ereport.engine.IDataSource
AppDataHandler.isNullable
public java.lang.String isNullable(java.lang.String sTable,
java.lang.String sColumn)
throws java.lang.Exception
Returns Yes if Null is a valid default value for the specified table or column;
No otherwise.
Overrides
isNullable in class com.actuate.ereport.engine.MetadataAdapter
AppDataHandler.passTableData
public void passTableData(java.lang.String sTableName,
java.util.Collection cAllRecords)
Used internally.
In the AWT API, passTableData takes the second argument as a vector.
AppDataHandler.registerDataSet
public void registerDataSet(java.lang.String sTableName,
java.util.Collection cAllRecords)
Passes the data objects from your application to ACJEngine. The default
implementation of IObjectTable is that of a vector.
tableName
The name you have given for the object when calling registerObjectAsTable.
data
A java.util.Collection of objects containing the objects you want ACJEngine to
query and from which it is to extract the result set.
In the AWT API, registerDataSet takes the second argument as a vector.
Parameters
oInstanceOfClass
An instance of a class you are trying to define as a table. This class must be
defined as public or this method fails.
sTableName
The name you designate for this class. Normally used to provide a more user
friendly name than the actual class name.
vColsDefn
A vector of class variables or methods to be defined as columns of this table.
AppDataHandler.registerQuery
public void registerQuery(java.lang.Object queryId,
java.lang.String query)
throws java.lang.Exception
Predefined query implementation.
Specified by
registerQuery in interface com.actuate.ereport.engine.IDataSource
AppDataHandler.RegisterTable
public void
RegisterTable(com.actuate.ereport.datasrcmgrs.appdatasrc.IObjectTable
iot,
java.lang.String sTableName)
Deprecated. Use registerUserDefTable() instead.
Package co m.a ctu ate.erep or t.d atasrcmgrs.app data src.Ap pDa taHa nd ler 157
AppDataHandler.RegisterTable
public void RegisterTable(java.util.Vector vAllRecords,
java.lang.String sTableName,
java.util.Vector vColsDefn,
java.lang.String primaryKey)
Deprecated. Use registerObjectAsTable() instead.
AppDataHandler.registerUserDefTable
public void
registerUserDefTable(com.actuate.ereport.datasrcmgrs.appdatasrc.IObject
Table iot,
java.lang.String sTableName)
Defines your application object and its structure to ACJEngine in the form
of a table.
iot
An implementation of the IObjectTable class to be defined as a table.
sTableName
The name of the table represented by this IObjectTable implementation.
AppDataHandler.requiresConnection
public boolean requiresConnection()
An application data source does not require a connection the way a JDBC data
source does. Returns False.
Specified by
requiresConnection in interface com.actuate.ereport.engine.IDataSource
AppDataHandler.setExtraOperators
public void setExtraOperators(java.util.Vector vOperators)
throws java.lang.Exception
Attempts to register additional operators that can be used in processing the
WHERE clause.
AppDataHandler.setQueryDisplay
public void setQueryDisplay(boolean bDisplay)
Enables or disables the query display.
AppDataHandler.setRelations
public void setRelations(java.util.Vector vR)
Sets all relations as a vector of strings. The format for each relation is:
TABLE1.COL1-TABLE2.COL2, RELATIONTYPE.
AppDataHandler.setResultSetRange
public void setResultSetRange(int startRecordNo,
int endRecordNo)
Specified by
setResultSetRange in interface com.actuate.ereport.engine.IDataSource
Package co m.a ctu ate.erep or t.d atasrcmgrs.app data src.Ap pDa taHa nd ler 159
AppDataHandler.setTableDefinition
public void setTableDefinition(java.lang.String sTableName,
java.lang.Class cTableClass,
java.util.Vector vColsDefn)
throws java.lang.Exception
Used internally.
AppDataHandler.sortVector
public static void sortVector(java.util.Vector v)
com.actuate.ereport.
Interface
datasrcmgrs.appdatasrc
Public interfaces:
■ IObjectTable
■ Iterator
Method Summary
Method Description
getColumns() This method returns the list of the fields or
methods representing the columns in the
table.
getValue(java.lang.Object o, An implementation of this method returns
java.lang.String colName) the value represented by the specified
column <colName> in the corresponding
object <o>, which is an instance of this table.
hasColumn(java.lang.String This method returns True if the column
col) indicated by <col> exists; False otherwise.
iterator() Returns the iterator that represents this table
object.
getColumns
public java.util.Vector getColumns()
This method returns the list of the fields or methods representing the columns
in the table.
getValue
public java.lang.Object getValue(java.lang.Object o, java.lang.String colName)
throws java.lang.Exception
An implementation of this method returns the value represented by the
specified column in the corresponding object, which is an instance of this
table.
o
An instance of this table class. The data must be retrieved from this instance.
hasColumn
public boolean hasColumn(java.lang.String col)
This method must return True if the column indicated by <col> exists; False
otherwise.
Parameter
col
The name of the column to be verified.
Returns
boolean True if the column exists; False otherwise.
iterator
public Iterator iterator()
Return the Iterator that represents this table object.
Returns
Iterator. An instance of com.actuate.ereport.datasrcmgrs.appdatasrc.Iterator.
Method Summary
Method Description
hasNext() This method returns a boolean indicating
whether further traversal in this table is possible.
next() An implementation of this method should return
the current record and advance the cursor to the
next record in the data set.
remove() This method is never called
resetCursor() This method is called to cause the table class to
reset the cursor to the starting position of the data
set. the data can then be refetched.
hasNext
public boolean hasNext()
This method returns a boolean indicating whether further traversal in this
table is possible.
Returns
boolean True if there are more records; False otherwise.
next
public java.lang.Object next()
throws java.util.NoSuchElementException
An implementation of this method returns the current record and advances
the cursor to the next record in the data set.
Throws
java.util.NoSuchElementException when the end of the data set is
encountered.
remove
public void remove()
throws java.lang.Exception
This method is never called. It is presented for compatibility with the class
java.util.Iterator.
resetCursor
public void resetCursor()
This method is called to cause the table class to reset the cursor to the starting
position of the data set. The data can then be refetched.
com.actuate.ereport.
Package
datasrcmgrs.asciidatasrc.
ASCIIDataHandler
Packag e co m.a ctu ate.erep or t.d atasrcmgrs.ascii data src.ASCIIDa taHa nd ler 167
Class ASCIIDataHandler
java.lang.Object
|
+--com.actuate.ereport.engine.MetadataAdapter
|
+--com.actuate.ereport. datasrcmgrs.appdatasrc. AppDataHandler
|
+--com.actuate.ereport.datasrcmgrs.asciidatasrc.ASCIIDataHandler
_____________________________________________________________________
See also
Serialized objects
Constructor summary
ASCIIDataHandler()
Method summary
Method Description
ASCIIDataHandler
.checkIfExists
ASCIIDataHandler Constructor used to initialize the
.connect ASCII data source.
ASCIIDataHandler This constructor is used
.connect internally.
ASCIIDataHandler constructor
ASCIIDataHandler
public ASCIIDataHandler()
ASCIIDataHandler.checkIfExists
public static boolean checkIfExists(java.lang.String sName)
ASCIIDataHandler.connect
public void connect(ACJEngine erw,
java.lang.String fileName,
java.lang.String propertyFileName)
throws java.lang.Exception
Constructor used to initialize the ASCII data source.
erw
Packag e co m.a ctu ate.erep or t.d atasrcmgrs.ascii data src.ASCIIDa taHa nd ler 169
An instance of the ACJEngine engine.
sfileName
The file containing the ASCII text data.
propertyFileName
The file containing information required to parse the text file. This file is
generated by the ASCII data wizard.
ASCIIDataHandler.connect
public void connect(ACJEngine erw,
java.lang.String fileName,
java.util.Vector vPropertiesOfAllTables)
throws java.lang.Exception
This constructor is used internally.
erw
An instance of the ACJEngine engine.
fileName
The file containing the ASCII text data.
vPropertiesOfAllTables
Vector describing the data in the ASCII data file.
ASCIIDataHandler.getColumnCount
public int getColumnCount(java.util.Vector vDataTypes,
java.lang.String dataType)
Function to count the number of columns having the same data type.
vDataTypes
Vector of column data types for a particular table.
dataType
The datatype for which the count is needed.
ASCIIDataHandler.getCurrentPropertiesAsString
public java.lang.String getCurrentPropertiesAsString()
ASCIIDataHandler.getPropertiesFileName
public java.lang.String getPropertiesFileName()
ASCIIDataHandler.getSourceFileName
public java.lang.String getSourceFileName()
ASCIIDataHandler.registerObjectsWithEngine
public void registerObjectsWithEngine()
Function that registers all the tables with ACJEngine.
ASCIIDataHandler.setPropertiesFileName
public void setPropertiesFileName(java.lang.String sPropertiesFile)
Packag e co m.a ctu ate.erep or t.d atasrcmgrs.ascii data src.ASCIIDa taHa nd ler 171
172 e.Repor t Designer API Java Edition
Package
com.actuate.ereport.
Package
datasrcmgrs.ejbdatasrc.
EJBDataHandler
Pa cka ge com.actua te.erepo r t.da tasrcmgrs.e jbda tasrc.EJBDa taHa nd ler 173
Class EJBDataHandler
The class is only in the SWING API. It is not in the AWT API.
java.lang.Object
|
+--com.actuate.ereport.engine.MetadataAdapter
|
+--+--com.actuate.ereport.datasrcmgrs.appdatasrc.AppDataHandler
|
+--com.actuate.ereport.datasrcmgrs.ejbdatasrc.EJBDataHandler
_____________________________________________________________________
See also
Serialized objects
Constructor summary
EJBDataHandler()
EJBDataHandler(java.lang.String sRemoteAppJNDIName)
Method summary
Method Description
.addTableDefinition Adds a single remote table entry data set
.addTableData that contains all records for a single table.
EJBDataHandler Adds a single local or remote table entry
.addTableDefinition definition that describes the entire table, its
columns, accessors, and so on.
EJBDataHandler
.clearSchemaAndData()
EJBDataHandler constructor
EJBDataHandler
public EJBDataHandler()
Pa cka ge com.actua te.erepo r t.da tasrcmgrs.e jbda tasrc.EJBDa taHa nd ler 175
EJBDataHandler
public EJBDataHandler(java.lang.String sRemoteAppJNDIName)
EJBDataHandler.addTableData
public void addTableData(java.lang.String sT,
java.util.Vector vAllRecords)
throws java.lang.Exception
Adds a single remote table entry data set that contains all records for a single
table.
EJBDataHandler.addTableDefinition
public void addTableDefinition(java.lang.String sT,
java.lang.Class cT,
java.lang.String[] saCA)
throws java.lang.Exception
Adds a single local or remote table entry definition that describes the entire
table, its columns, accessors, and so on.
EJBDataHandler.clearSchemaAndData
public void clearSchemaAndData()
EJBDataHandler.connectToRemoteApp
public void connectToRemoteApp(java.lang.String sRemoteAppJNDIName)
throws java.lang.Exception
Initializes the system by connecting to the remote EJB application.
EJBDataHandler.getName
public java.lang.String getName()
Identifies the name of this data source. Returns Application DataSource.
Overrides
AppDataHandler.getName
EJBDataHandler.getProperties
public java.util.Hashtable getProperties()
EJBDataHandler.getPropertySheet
public com.actuate.ereport.engine.IPropertySheet getPropertySheet()
Returns the default implementation of the EJBDataSource property sheet.
Overrides
AppDataHandler.getPropertySheet
EJBDataHandler.getRemoteAppName
public java.lang.String getRemoteAppName()
Pa cka ge com.actua te.erepo r t.da tasrcmgrs.e jbda tasrc.EJBDa taHa nd ler 177
EJBDataHandler.isConnected
public boolean isConnected()
throws java.lang.Exception
Notifies the system if the EJB data source connection is active.
Overrides
AppDataHandler.isConnected
EJBDataHandler.processMsg
public java.lang.Object processMsg(int msgID,
java.lang.Object oParams)
throws java.rmi.RemoteException
EJBDataHandler.processRemoteMsg
public java.lang.Object processRemoteMsg(int msgID,
java.lang.Object oParams)
throws java.lang.Exception
EJBDataHandler.requiresConnection
public boolean requiresConnection()
An application data source does not require a connection the way a JDBC data
source does. Returns False.
Overrides
AppDataHandler.requiresConnection
EJBDataHandler.setProperties
public void setProperties(java.util.Hashtable htIC)
EJBDataHandler.setTableDefinition
public void setTableDefinition(java.lang.String sTableName,
java.lang.Class cTableClass,
java.util.Vector vColsDefn)
throws java.lang.Exception
Overrides
AppDataHandler.setTableDefinition
Pa cka ge com.actua te.erepo r t.da tasrcmgrs.e jbda tasrc.EJBDa taHa nd ler 179
180 e.Repor t Designer API Java Edition
Package
com.actuate.ereport.
Package
datasrcmgrs.jdbcdatasrc.
JDBCHandler
Pa ck a g e c o m . a c t u a t e. e r e p o r t. d a t a s r c m g r s .j d b c d a t a s r c . J D B C H a n d l e r 181
Class JDBCHandler
java.lang.Object
|
+--com.actuate.ereport.engine.MetadataAdapter
|
+--com.actuate.ereport.datasrcmgrs.jdbcdatasrc.JDBCHandler
_____________________________________________________________________
Field summary
Type Method
static int ALIAS
java.sql.Connection dbconnection
java.sql.Driver driver
java.lang.String DriverName
java.lang.String password
static int SYNONYM
static int SYSTEM
static int TABLE
Original Class Implementation
java.lang.String url
java.lang.String username
static int VIEW
Method summary
Method Description
JDBCHandler
.allStoredObjectsCallable()
JDBCHandler Connects to the JDBC data source using the
.connect() driver, URL, username and password.
JDBCHandler Deprecated as of ACJEngine 3.0.
.Connect()
JDBCHandler Passes an existing connection and specifies
.connect whether all tables are to be extracted.
JDBCHandler Deprecated as of ACJEngine 3.0.
.Connect
JDBCHandler Connects to the JDBC data source.
.connect
JDBCHandler Deprecated as of ACJEngine 3.0.
.Connect
JDBCHandler Used internally for debugging.
.debugMessage
JDBCHandler Used internally for debugging.
.debugMessageLN()
JDBCHandler Used internally for debugging.
.debugMessageLN
JDBCHandler Disconnects from the data source.
.disconnect()
JDBCHandler Deprecated as of ACJEngine 3.0.
.Disconnect()
JDBCHandler
.extractRelations
Pa ck a g e c o m . a c t u a t e. e r e p o r t. d a t a s r c m g r s .j d b c d a t a s r c . J D B C H a n d l e r 183
Method Description
JDBCHandler Returns a result set containing all data for a
.fetchData specified table and column for iCount objects.
iStart is currently not used and will be
supported in a future version.
JDBCHandler Returns the default catalog associated with
.getCatalogName() the JDBC connection
JDBCHandler Returns a vector with all the column names of
.getColumnNames the table name that is passed to the method.
JDBCHandler
.getConnection()
JDBCHandler
.getCurrentTableSelection()
JDBCHandler Returns the java.sql.Types equivalent data
.getDataType type for the specified column.
JDBCHandler Returns the current debugMode status.
.getDebugMode()
JDBCHandler Returns the default value for the specified
.getDefaultValue fully qualified column.
JDBCHandler Returns the name of the active JDBC driver.
.getDriverName()
JDBCHandler
.getEndRecordNumber()
JDBCHandler Returns the grantee of privileges for the
.getGrantee specified fully qualified column.
JDBCHandler Returns the grantor of privileges for the
.getGrantor specified fully qualified column.
JDBCHandler Returns the identifier quote string for the
.getIdentifierQuote() specified database.
JDBCHandler Returns the name of the data source.
.getName()
JDBCHandler Returns the password for the active JDBC
.getPassword() data source connection.
JDBCHandler Returns a comma-separated list of privileges
.getPrivileges associated with a column.
JDBCHandler Returns an instance of the property sheet.
.getPropertySheet() Used internally.
Pa ck a g e c o m . a c t u a t e. e r e p o r t. d a t a s r c m g r s .j d b c d a t a s r c . J D B C H a n d l e r 185
Method Description
JDBCHandler Indicates if this column can be granted
.isGrantable privileges.
JDBCHandler Indicates that this column can have a Null
.isNullable value.
JDBCHandler
.makeSelective()
JDBCHandler
.registerQuery
JDBCHandler Indicates that the JDBC data source requires
.requiresConnection() an active connection to work with.
JDBCHandler Fetches all the requested tables from the
.retrieveTables() active JDBC connection.
JDBCHandler Specifies whether progress or error messages
.setDebugMode are to be displayed in the console window.
JDBCHandler Sets the JDBC driver to the string being
.setDriver passed.
JDBCHandler Specifies that if the table or column has
.setLowercaseQuotes lowercase characters embedded in it, then the
quote identifier is prepended and appended
to it.
JDBCHandler Sets the password to the string being passed.
.setPassword
JDBCHandler Specifies whether the schema name should be
.setPrependSchema prepended to the table name in the FROM
clause, as expected by ORACLE.
JDBCHandler
.setProperties
JDBCHandler
.setResultSetRange
JDBCHandler
.setSelectiveProperties
JDBCHandler Sets the JDBC URL to the string being passed.
.setUrl
JDBCHandler Sets the username to the string being passed.
.setUsername
Field detail
TABLE
public static final int TABLE
========== ORIGINAL CLASS IMPLEMENTATION =========
VIEW
public static final int VIEW
SYSTEM
public static final int SYSTEM
ALIAS
public static final int ALIAS
SYNONYM
public static final int SYNONYM
driver
public java.sql.Driver driver
DriverName
public java.lang.String DriverName
Pa ck a g e c o m . a c t u a t e. e r e p o r t. d a t a s r c m g r s .j d b c d a t a s r c . J D B C H a n d l e r 187
url
public java.lang.String url
username
public java.lang.String username
password
public java.lang.String password
dbconnection
public java.sql.Connection dbconnection
JDBCHandler constructor
JDBCHandler
public JDBCHandler()
An empty constructor.
JDBCHandler.allStoredObjectsCallable
public boolean allStoredObjectsCallable()
throws java.lang.Exception
JDBCHandler.Connect
public void Connect()
throws java.lang.Exception
Deprecated as of ACJEngine 3.0.
Specified by
connect in interface com.actuate.ereport.engine.IDataSource
JDBCHandler.Connect
public boolean Connect(java.sql.Connection c,
boolean extractTables)
Deprecated as of ACJEngine 3.0.
JDBCHandler.connect
public boolean connect(java.sql.Connection c,
boolean extractTables)
Passes an existing connection and specifies whether all tables are to be
extracted.
JDBCHandler.Connect
public void Connect(java.lang.String DriverName,
java.lang.String Url,
java.lang.String UserName,
java.lang.String Password,
boolean extractTables)
throws java.lang.Exception
Deprecated as of ACJEngine 3.0.
Pa ck a g e c o m . a c t u a t e. e r e p o r t. d a t a s r c m g r s .j d b c d a t a s r c . J D B C H a n d l e r 189
JDBCHandler.connect
public void connect(java.lang.String DriverName,
java.lang.String Url,
java.lang.String UserName,
java.lang.String Password,
boolean extractTables)
throws java.lang.Exception
Connects to the JDBC data source. First, gets the instance of the driver using
RegisterDriver(DriverName.trim()). Once the driver is successfully registered
and instantiated, connects to the database using
DriverManager.getConnection(JDBC_URL, username and password).
JDBCHandler.debugMessage
public static void debugMessage(java.lang.Object sMsg)
Used internally for debugging.
JDBCHandler.debugMessageLN
public static void debugMessageLN(java.lang.Object sMsg)
Used internally for debugging.
JDBCHandler.debugMessageLN
public static void debugMessageLN()
JDBCHandler.Disconnect
public void Disconnect()
throws java.lang.Exception
Deprecated as of ACJEngine 3.0.
Specified by
disconnect in interface com.actuate.ereport.engine.IDataSource
JDBCHandler.extractRelations
public java.util.Vector extractRelations(java.awt.Component cProgress,
java.sql.DatabaseMetaData dmd,
java.util.Vector vTables)
throws java.lang.Exception
JDBCHandler.fetchData
public java.lang.Object fetchData(java.lang.String sTable,
java.lang.String sColumn,
int iStart,
int iCount)
throws java.lang.Exception
Returns a result set containing all data for a specified table and column for
iCount objects. iStart is currently not used but will be supported in a future
version.
Specified by
fetchData in interface com.actuate.ereport.engine.IDataSource
JDBCHandler.getCatalogName
public java.lang.String getCatalogName()
throws java.lang.Exception
Returns the default catalog associated with the JDBC connection.
Pa ck a g e c o m . a c t u a t e. e r e p o r t. d a t a s r c m g r s .j d b c d a t a s r c . J D B C H a n d l e r 191
Overrides
getCatalogName in class com.actuate.ereport.engine.MetadataAdapter
JDBCHandler.getColumnNames
public java.util.Vector getColumnNames(java.lang.String TableName)
throws java.lang.Exception
Returns a vector with all the column names of the table name that is passed to
the method.
Specified by
getColumnNames in interface com.actuate.ereport.engine.IDataSource
Overrides
getColumnNames in class com.actuate.ereport.engine.MetadataAdapter
JDBCHandler.getConnection
public java.sql.Connection getConnection()
JDBCHandler.getCurrentTableSelection
public int getCurrentTableSelection()
JDBCHandler.getDataType
public int getDataType(java.lang.String sTable,
java.lang.String sColumn)
throws java.lang.Exception
Returns the java.sql.Type’s equivalent data type for the specified column.
JDBCHandler.getDebugMode
public static boolean getDebugMode()
Returns the current debugMode status.
JDBCHandler.getDefaultValue
public java.lang.Object getDefaultValue(java.lang.String sTable,
java.lang.String sColumn)
throws java.lang.Exception
Returns the default value for the specified fully qualified column
Overrides
getDefaultValue in class com.actuate.ereport.engine.MetadataAdapter
JDBCHandler.getDriverName
public java.lang.String getDriverName()
Returns the name of the active JDBC driver.
JDBCHandler.getEndRecordNumber
public int getEndRecordNumber()
Pa ck a g e c o m . a c t u a t e. e r e p o r t. d a t a s r c m g r s .j d b c d a t a s r c . J D B C H a n d l e r 193
JDBCHandler.getGrantee
public java.lang.String getGrantee(java.lang.String sTable,
java.lang.String sColumn)
throws java.lang.Exception
Returns the grantee of privileges for the specified fully qualified column.
Overrides
getGrantee in class com.actuate.ereport.engine.MetadataAdapter
JDBCHandler.getGrantor
public java.lang.String getGrantor(java.lang.String sTable,
java.lang.String sColumn)
throws java.lang.Exception
Returns the grantor of privileges for the specified fully qualified column.
Overrides
getGrantor in class com.actuate.ereport.engine.MetadataAdapter
JDBCHandler.getIdentifierQuote
public java.lang.String getIdentifierQuote()
Returns the identifier quote string for the specified database.
Overrides
getIdentifierQuote in class com.actuate.ereport.engine.MetadataAdapter
JDBCHandler.getName
public java.lang.String getName()
Returns the name of the data source.
JDBCHandler.getPassword
public java.lang.String getPassword()
Returns the password for the active JDBC data source connection.
JDBCHandler.getPrivileges
public java.lang.String getPrivileges(java.lang.String sTable,
java.lang.String sColumn)
throws java.lang.Exception
Returns a comma separated list of privileges associated with a column.
Overrides
getPrivileges in class com.actuate.ereport.engine.MetadataAdapter
JDBCHandler.getPropertySheet
public com.actuate.ereport.engine.IPropertySheet getPropertySheet()
Returns an instance of the property sheet. Used internally.
Specified by
getPropertySheet in interface com.actuate.ereport.engine.IDataSource
JDBCHandler.getQuery
public java.lang.String getQuery(java.lang.Object queryId)
Pa ck a g e c o m . a c t u a t e. e r e p o r t. d a t a s r c m g r s .j d b c d a t a s r c . J D B C H a n d l e r 195
Specified by
getQuery in interface com.actuate.ereport.engine.IDataSource
JDBCHandler.getQueryColumns
public java.util.Vector getQueryColumns(java.lang.Object queryId,
java.lang.String tableName)
throws java.lang.Exception
Specified by
getQueryColumns in interface com.actuate.ereport.engine.IDataSource
JDBCHandler.getQueryResult
public com.actuate.ereport.engine.ITable getQueryResult(java.lang.Object
queryId,
java.lang.String query)
throws java.lang.Exception
Specified by
getQueryResult in interface com.actuate.ereport.engine.IDataSource
JDBCHandler.getQueryTables
public java.util.Vector getQueryTables(java.lang.Object queryId)
throws java.lang.Exception
Specified by
getQueryTables in interface com.actuate.ereport.engine.IDataSource
Overrides
getRelations in class com.actuate.ereport.engine.MetadataAdapter
JDBCHandler.getRemarks
public java.lang.String getRemarks(java.lang.String sTable,
java.lang.String sColumn)
throws java.lang.Exception
Returns the remarks for the specified fully qualified column.
Overrides
getRemarks in class com.actuate.ereport.engine.MetadataAdapter
JDBCHandler.getSelectiveTableFilter
public int getSelectiveTableFilter()
Used internally.
JDBCHandler.getSelectedTables
public java.util.Vector getSelectedTables()
Pa ck a g e c o m . a c t u a t e. e r e p o r t. d a t a s r c m g r s .j d b c d a t a s r c . J D B C H a n d l e r 197
JDBCHandler.getSOImplementation
public com.actuate.ereport.datasrcmgrs.jdbcdatasrc.JDBCStoredObjectsImpl
getSOImplementation()
JDBCHandler.getStartRecordNumber
public int getStartRecordNumber()
JDBCHandler.getStoredObjects
public com.actuate.ereport.engine.IStoredObjects getStoredObjects()
throws java.lang.Exception
Returns a structure containing stored objects.
Overrides
getStoredObjects in class com.actuate.ereport.engine.MetadataAdapter
JDBCHandler.getTable
public com.actuate.ereport.engine.ITable getTable(java.util.Hashtable ht,
java.lang.String readers)
throws java.lang.Exception
Used internally.
Specified by
getTable in interface com.actuate.ereport.engine.IDataSource
JDBCHandler.getTableCount
public int getTableCount()
Specified by
getTableNames in interface com.actuate.ereport.engine.IDataSource
Overrides
getTableNames in class com.actuate.ereport.engine.MetadataAdapter
JDBCHandler.getTables
public java.util.Vector getTables()
throws java.lang.Exception
A macro for fetching all tables from the active JDBC source.
JDBCHandler.getUrl
public java.lang.String getUrl()
Returns the URL for the JDBC data source.
JDBCHandler.getUsername
public java.lang.String getUsername()
Returns the use name for the active JDBC data source connection
Pa ck a g e c o m . a c t u a t e. e r e p o r t. d a t a s r c m g r s .j d b c d a t a s r c . J D B C H a n d l e r 199
JDBCHandler.isConnected
public boolean isConnected()
throws java.lang.Exception
Returns True if connected to a JDBC data source; False otherwise.
Specified by
isConnected in interface com.actuate.ereport.engine.IDataSource
JDBCHandler.isGrantable
public boolean isGrantable(java.lang.String sTable,
java.lang.String sColumn)
throws java.lang.Exception
Indicates whether this column can be granted privileges.
Overrides
isGrantable in class com.actuate.ereport.engine.MetadataAdapter
JDBCHandler.isNullable
public java.lang.String isNullable(java.lang.String sTable,
java.lang.String sColumn)
throws java.lang.Exception
Indicates that this column can have a Null value.
Overrides
isNullable in class com.actuate.ereport.engine.MetadataAdapter
JDBCHandler.makeSelective
public void makeSelective()
Specified by
registerQuery in interface com.actuate.ereport.engine.IDataSource
JDBCHandler.requiresConnection
public boolean requiresConnection()
Indicates that the JDBC data source requires an active connection.
Specified by
requiresConnection in interface com.actuate.ereport.engine.IDataSource
JDBCHandler.retrieveTables
public java.util.Vector retrieveTables()
Fetches all the requested tables from the active JDBC connection.
JDBCHandler.setDebugMode
public static void setDebugMode(boolean b)
Specifies whether progress or error messages are to be displayed in the console
window.
Pa ck a g e c o m . a c t u a t e. e r e p o r t. d a t a s r c m g r s .j d b c d a t a s r c . J D B C H a n d l e r 201
JDBCHandler.setDriver
public void setDriver(java.lang.String d)
Sets the JDBC driver to the string being passed.
JDBCHandler.setLowercaseQuotes
public void setLowercaseQuotes(boolean bLowercaseQuotes)
Specifies that if the table or column has lowercase characters embedded in it,
then the quote identifier is prepended and appended to it.
JDBCHandler.setPassword
public void setPassword(java.lang.String p)
Sets the password to the string being passed.
JDBCHandler.setPrependSchema
public void setPrependSchema(boolean bPrependSchema)
Specifies whether the schema name should be prepended to the table name in
the FROM clause, as expected by ORACLE.
JDBCHandler.setProperties
public void setProperties(java.lang.String sDriver,
java.lang.String sUrl,
java.lang.String sUser,
java.lang.String sPassword)
Specified by
setResultSetRange in interface com.actuate.ereport.engine.IDataSource
JDBCHandler.setSelectiveProperties
public void setSelectiveProperties(int iFilter,
java.util.Vector vTables)
JDBCHandler.setUrl
public void setUrl(java.lang.String u)
Sets the JDBC URL to the string being passed
JDBCHandler.setUsername
public void setUsername(java.lang.String u)
Sets the username to the string being passed.
JDBCHandler.supportsStoredObjects
public boolean supportsStoredObjects()
throws java.lang.Exception
Pa ck a g e c o m . a c t u a t e. e r e p o r t. d a t a s r c m g r s .j d b c d a t a s r c . J D B C H a n d l e r 203
JDBCHandler.useTables
public void useTables(java.util.Vector v)
Specifies a domain of tables to work with. This method can be used in
conjunction with the connect(...) API when you know which tables you want
to work with in the Template Designer.
Used internally for debugging.
com.actuate.ereport.
Chapter 0
datasrcmgrs.metadatasrc.
MetaDataHandler
Pa ck a g e c o m . a c t u a t e. e r e p o r t . d a t a s r c m gr s. m e ta d a ta s r c .M e t a D a t a H a n d l e r 205
Class MetaDataHandler
java.lang.Object
|
+--com.actuate.ereport.engine.MetadataAdapter
|
+--com.actuate.ereport.datasrcmgrs.metadatasrc.MetaDataHandler
_____________________________________________________________________
Constructor summary
MetaDataHandler()
The default constructor.
Method summary
Method Description
MetaDataHandler Sequentially adds one table with all
.addTable associated columns to the metadata layer.
Returns True if successful, False if a hashtable
key collision occurs.
MetaDataHandler Removes all tables along with all associated
.clearMetaData() columns from the metadata layer.
MetaDataHandler This method is required to connect to a data
.connect() source. It is not implemented for
MetaDataHandler, however, since
MetaDataHandler does not require an active
data source connection.
Pa ck a g e c o m . a c t u a t e. e r e p o r t . d a t a s r c m gr s. m e ta d a ta s r c .M e t a D a t a H a n d l e r 207
Method Description
MetaDataHandler
.getQueryTables
MetaDataHandler Returns a vector of all relations in a string
.getRelations() format.
MetaDataHandler Determines whether a column can be granted
.getRemarks privileges.
MetaDataHandler Interface implementation used internally by
.getTable the engine.
MetaDataHandler Returns the names of all tables in the data
.getTableNames() source structure.
MetaDataHandler
.getTableType
MetaDataHandler Specifies whether the metadata information
.isConnected() has been set up by loading from an EMD file.
MetaDataHandler Determines whether a column can be granted
.isGrantable privileges.
MetaDataHandler Specifies whether the given column can have
.isNullable a Null value.
MetaDataHandler Specifies that the metadata has been
.manuallyConstructed() constructed manually.
MetaDataHandler Reads and parses the metadata from an ASCII
.readObject input stream into the metadata data structure.
MetaDataHandler
.registerQuery
MetaDataHandler Always returns False, indicating that
.requiresConnection() MetaDataHandler does not require a
connection.
MetaDataHandler Sets the name of the catalog for the data
.setCatalogName source structure to the specified name.
MetaDataHandler Sets the name of the data source.
.setDatasourceName
MetaDataHandler
.setIdentifierQuote
MetaDataHandler Sets all relations as a vector of strings.
.setRelations
MetaDataHandler constructor
MetaDataHandler
public MetaDataHandler()
The default constructor.
MetaDataHandler.addTable
public boolean addTable(com.actuate.ereport.engine.TableDescriptor td,
java.util.Vector vColumns)
Sequentially adds one table with all associated columns to the metadata layer.
Returns True if successful, False if a hashtable key collision occurs.
MetaDataHandler.clearMetaData
public void clearMetaData()
Removes all tables along with all associated columns from the metadata layer.
MetaDataHandler.connect
public void connect()
throws java.lang.Exception
Pa ck a g e c o m . a c t u a t e. e r e p o r t . d a t a s r c m gr s. m e ta d a ta s r c .M e t a D a t a H a n d l e r 209
This method is required to connect to a data source. It is not implemented for
MetaDataHandler, however, since the MetaDataHandler doesn't require an
active data source connection.
Specified by
connect in interface com.actuate.ereport.engine.IDataSource
MetaDataHandler.disconnect
public void disconnect()
throws java.lang.Exception
This method is required to disconnect from a data source. It is not
implemented for MetaDataHandler, however, since the MetaDataHandler
does not require an active data source connection.
Specified by
disconnect in interface com.actuate.ereport.engine.IDataSource
MetaDataHandler.exportAsMetadata
public static void exportAsMetadata(java.awt.Component cProgress,
com.actuate.ereport.engine.IDataSource ids,
java.io.OutputStream os,
java.util.Vector vR)
throws java.lang.Exception
MetaDataHandler.fetchData
public java.lang.Object fetchData(java.lang.String sTable,
java.lang.String sColumn,
int iStart,
int iCount)
throws java.lang.Exception
This function is reserved for future versions of ACJEngine.
MetaDataHandler.getCatalogName
public java.lang.String getCatalogName()
throws java.lang.Exception
Returns the name of the catalog for the data source structure.
Overrides
getCatalogName in class com.actuate.ereport.engine.MetadataAdapter
MetaDataHandler.getColumnNames
public java.util.Vector getColumnNames(java.lang.String sTable)
throws java.lang.Exception
Returns the names of all columns for a specified table.
Specified by
getColumnNames in interface com.actuate.ereport.engine.IDataSource
Overrides
getColumnNames in class com.actuate.ereport.engine.MetadataAdapter
MetaDataHandler.getDatasourceName
public java.lang.String getDatasourceName()
Returns the name of the data source.
Pa ck a g e c o m . a c t u a t e. e r e p o r t . d a t a s r c m gr s. m e ta d a ta s r c .M e t a D a t a H a n d l e r 211
MetaDataHandler.getDataType
public int getDataType(java.lang.String sTable,
java.lang.String sColumn)
throws java.lang.Exception
Returns the data type for a fully qualified column.
Overrides
getDataType in class com.actuate.ereport.engine.MetadataAdapter
MetaDataHandler.getDefaultValue
public java.lang.Object getDefaultValue(java.lang.String sTable,
java.lang.String sColumn)
throws java.lang.Exception
Returns the default value for a given column.
Overrides
getDefaultValue in class com.actuate.ereport.engine.MetadataAdapter
MetaDataHandler.getGrantee
public java.lang.String getGrantee(java.lang.String sTable,
java.lang.String sColumn)
throws java.lang.Exception
Returns the grantee of privileges for the specified column.
Overrides
getGrantee in class com.actuate.ereport.engine.MetadataAdapter
Overrides
getGrantor in class com.actuate.ereport.engine.MetadataAdapter
MetaDataHandler.getIdentifierQuote
public java.lang.String getIdentifierQuote()
Overrides
getIdentifierQuote in class com.actuate.ereport.engine.MetadataAdapter
MetaDataHandler.getName
public java.lang.String getName()
Returns the data source name as MetaDataSource.
Specified by
getName in interface com.actuate.ereport.engine.IDataSource
MetaDataHandler.getPrivileges
public java.lang.String getPrivileges(java.lang.String sTable,
java.lang.String sColumn)
throws java.lang.Exception
Returns a comma-separated list of privileges for a column.
Pa ck a g e c o m . a c t u a t e. e r e p o r t . d a t a s r c m gr s. m e ta d a ta s r c .M e t a D a t a H a n d l e r 213
Overrides
getPrivileges in class com.actuate.ereport.engine.MetadataAdapter
MetaDataHandler.getPropertySheet
public com.actuate.ereport.engine.IPropertySheet getPropertySheet()
Returns the default implementation of the metadata property sheet. This
method is used internally.
Specified by
getPropertySheet in interface com.actuate.ereport.engine.IDataSource
MetaDataHandler.getQuery
public java.lang.String getQuery(java.lang.Object queryId)
Specified by
getQuery in interface com.actuate.ereport.engine.IDataSource
MetaDataHandler.getQueryColumns
public java.util.Vector getQueryColumns(java.lang.Object queryId,
java.lang.String tableName)
throws java.lang.Exception
Specified by
getQueryColumns in interface com.actuate.ereport.engine.IDataSource
Specified by
getQueryResult in interface com.actuate.ereport.engine.IDataSource
MetaDataHandler.getQueryTables
public java.util.Vector getQueryTables(java.lang.Object queryId)
throws java.lang.Exception
Specified by
getQueryTables in interface com.actuate.ereport.engine.IDataSource
MetaDataHandler.getRelations
public java.util.Vector getRelations()
throws java.lang.Exception
Returns a vector of all relations in a string format. The format for each relation
is: TABLE1.COL1-TABLE2.COL2, RELATIONTYPE.
Overrides
getRelations in class com.actuate.ereport.engine.MetadataAdapter
MetaDataHandler.getRemarks
public java.lang.String getRemarks(java.lang.String sTable,
java.lang.String sColumn)
throws java.lang.Exception
Determines whether a column can be granted privileges.
Pa ck a g e c o m . a c t u a t e. e r e p o r t . d a t a s r c m gr s. m e ta d a ta s r c .M e t a D a t a H a n d l e r 215
Overrides
getRemarks in class com.actuate.ereport.engine.MetadataAdapter
MetaDataHandler.getTable
public com.actuate.ereport.engine.ITable getTable(java.util.Hashtable
querycontents,
java.lang.String readers)
throws java.lang.Exception
Interface implementation used internally by the engine.
Specified by
getTable in interface com.actuate.ereport.engine.IDataSource
MetaDataHandler.getTableNames
public java.util.Vector getTableNames()
throws java.lang.Exception
Returns the names of all tables in the data source structure.
Specified by
getTableNames in interface com.actuate.ereport.engine.IDataSource
Overrides
getTableNames in class com.actuate.ereport.engine.MetadataAdapter
MetaDataHandler.getTableType
public java.lang.String getTableType(java.lang.String sTable)
throws java.lang.Exception
Overrides
getTableType in class com.actuate.ereport.engine.MetadataAdapter
Specified by
isConnected in interface com.actuate.ereport.engine.IDataSource
MetaDataHandler.isGrantable
public boolean isGrantable(java.lang.String sTable,
java.lang.String sColumn)
throws java.lang.Exception
Determines whether a column can be granted privileges.
Overrides
isGrantable in class com.actuate.ereport.engine.MetadataAdapter
MetaDataHandler.isNullable
public java.lang.String isNullable(java.lang.String sTable,
java.lang.String sColumn)
throws java.lang.Exception
Specifies whether the given column can have a Null value.
Overrides
isNullable in class com.actuate.ereport.engine.MetadataAdapter
Pa ck a g e c o m . a c t u a t e. e r e p o r t . d a t a s r c m gr s. m e ta d a ta s r c .M e t a D a t a H a n d l e r 217
MetaDataHandler.manuallyConstructed
public void manuallyConstructed()
Specifies that the metadata has been constructed manually. Usually, this flag is
internally set when data is loaded from a metadata file.
MetaDataHandler.readObject
public boolean readObject(java.io.InputStream is)
throws java.lang.Exception
Reads and parses the metadata from an ASCII input stream into the metadata
data structure.
MetaDataHandler.registerQuery
public void registerQuery(java.lang.Object queryId,
java.lang.String query)
throws java.lang.Exception
Specified by
registerQuery in interface com.actuate.ereport.engine.IDataSource
MetaDataHandler.requiresConnection
public boolean requiresConnection()
Always returns False, indicating that the MetaDataHandler does not require a
connection.
Specified by
requiresConnection in interface com.actuate.ereport.engine.IDataSource
MetaDataHandler.setDatasourceName
public void setDatasourceName(java.lang.String dsName)
MetaDataHandler.setIdentifierQuote
public void setIdentifierQuote(java.lang.String sQ)
MetaDataHandler.setRelations
public void setRelations(java.util.Vector vR)
Sets all relations as a vector of strings. The format for each relation is:
TABLE1.COL1-TABLE2.COL2, RELATIONTYPE.
MetaDataHandler.setResultSetRange
public void setResultSetRange(int startRecordNo,
int endRecordNo)
Specified by
setResultSetRange in interface com.actuate.ereport.engine.IDataSource
Pa ck a g e c o m . a c t u a t e. e r e p o r t . d a t a s r c m gr s. m e ta d a ta s r c .M e t a D a t a H a n d l e r 219
MetaDataHandler.writeObject
public void writeObject(com.actuate.ereport.output.ProgressBox pb,
java.io.OutputStream os)
throws java.lang.Exception
Writes the metadata from the metadata data structure to an ASCII output
stream of the appropriate format.
Sets the name of the data source.
com.actuate.ereport.
Chapter 0
output.OD_DHTML
Pa ck a g e c o m . a c t u a t e. e r e p o r t . d a t a s r c m gr s. m e ta d a ta s r c .M e t a D a t a H a n d l e r 221
Class OD_DHTML
java.lang.Object
|
+--com.actuate.ereport.output.OD_HTML
_____________________________________________________________________
Constructor summary
OD_DHTML()
This is an empty constructor that is used for instantiating OD_DHTML using
Class.newInstance()
Method summary
Method Description
OD_DHTML.generate This is an interface call substituted in place of
generateHTML function in OD_Preview so all the
parameters specific to generateHTML call are
embeded into parameters vector
OD_DHTML. Used to generate the main container page for
generateMainFrameSet reports containing TOC.
OD_DHTML. Once the generate method successfully creates
generateReportPage and instantiates the data stream, It calls this
method to handle the formatting and writing of
controls to the output stream
OD_DHTML. Writes the Table Of contents if specified to the Html
generateTOCPage file
OD_DHTML constructor
OD_DHTML
public OD_DHTML()
This is an empty constructor that is used for instantiatingOD_HTML
OD_DHTML using Class.newInstance()
OD_DHTML.generate
public java.lang.Object generate(com.actuate.ereport.output.VirtualOutput vo,
com.actuate.ereport.output.ProgressInterface pi,
java.util.Properties properties)
throws java.lang.Exception
This is an interface call substituted in place of generateHTML function in
OD_Preview so all the parameters specific to generateHTML call are embeded
into parameters vector.
Specified by
generate in interface com.actuate.ereport.output.IOutputFormat
outputDesc
The output destination for html file. The possible values are String,
OutputStream. In case of output stream non indexed report should be
generated.
Pa ck a g e c o m . a c t u a t e. e r e p o r t . d a t a s r c m gr s. m e ta d a ta s r c .M e t a D a t a H a n d l e r 223
vo
The virtual output storage from which data can be extracted.
toc
If true, indexed report will be generated else non indexed report will be
generated. This must be set to false if OutputStream is used as outputDesc.
forceGui
If true, whenever the system needs gui support it will try to locate that support
or create new component as needed.
component
For java 1.x.x versions to create an offscreen image a visible component is
required this component should work as a ImageObserver the value of
component must be passed as null in case you want to generate html output
without any window system however in this case no image will be added to
the html file.
parameters
This is a vector which contains following elements
1 Boolean toc
2 Boolean forceGui
3 Boolean preserveFonts
4 Boolean preserveColors
5 Boolean useHorSpacing
6 Boolean gzip whether or not to generate a zipped output
7 Integer bufferSize
8 String charSet
9 String htmlTitle
10 String htmlAuthor
11 Boolean cache
12 Boolean preservePageBreak whether to display the PAGE Hdr/Ftr in the output or
not // ROH : (02/29/2000) : Inserted this param
13 String sTargetBrowser the target browser for the output style
14 ZipOutputStream zos
15 Color TOCBackground Background Color for TOC
16 Vector vPages Page numbers for page on demand
17 String pageOnDemandURL The URL of the source which requested for the page
on demand
18 int firstPageOnDemand The page that the link "First" is supposed to point to
19 int prevPageOnDemand The page that the link "Prev" is supposed to point to
20 int nextPageOnDemand The page that the link "Next" is supposed to point to
21 int lastPageOnDemand The page that the link "Last" is supposed to point to
The
OutputStream to which the report is being written.
Throws
a RuntimeException if there is a problem writing the TOC to the
OutputStream.
OD_DHTML.generateReportPage
public void generateReportPage(java.lang.Object outputDesc)
throws java.lang.Exception
Once the generate method successfully creates and instantiates the data
stream, it calls this method to handle the formatting and writing of controls to
the output stream.
Throws
java.lang.Exception throws an Exception if it is unable to write to the output.
OD_DHTML.generateTOCPage
public void generateTOCPage(java.lang.Object outputDesc)
throws java.lang.Exception
Writes the Table Of contents if specified to the Html file
Pa ck a g e c o m . a c t u a t e. e r e p o r t . d a t a s r c m gr s. m e ta d a ta s r c .M e t a D a t a H a n d l e r 225
Throws
java.lang.Exception if the toc cannot be written
OD_DHTML.getImage
public void getImage(java.lang.Object outputDesc, long ptr)
throws java.lang.Exception
This method is used to fetch individual images from the report. The arguments
are the Outputstream and the index of the image. When used in Multiple File
Serving, the images are requested by the browser, and are accordingly fetched.
However this call must only be made after the report has completely been
generated otherwise you get a NullPointerException. Internally calls
getImage(Object, Object)
outputDesc
Output Descriptor. Should be the OutputStream to which the image is to be
written.
ptr
The index of the image in the report.
Throws
a RuntimeException if it cannot write the Image to the OutputStream
OD_DHTML.getImage
public void getImage(java.lang.Object outputDesc,java.lang.Object ptr)
throws java.lang.Exception
Similar to getImage(Object, long) except that the second argument is an Object
representing the index of the image.
OD_DHTML.setGenerateOnDemand
public void setGenerateOnDemand(boolean bServerBased,
java.lang.String sRequestorName)
Boolean
used to indicate if the report is being generated from a server based
application
String
specifying the requestor of the report
Pa ck a g e c o m . a c t u a t e. e r e p o r t . d a t a s r c m gr s. m e ta d a ta s r c .M e t a D a t a H a n d l e r 227
228 e.Repor t Designer API Java Edition
Package
com.actuate.ereport.
Chapter 0
output.OD_HTML
Pa ck a g e c o m . a c t u a t e. e r e p o r t . d a t a s r c m gr s. m e ta d a ta s r c .M e t a D a t a H a n d l e r 229
Class OD_HTML
java.lang.Object
|
+--com.actuate.ereport.output.OD_HTML
_____________________________________________________________________
Constructor summary
OD_HTML()
This is an empty constructor that is used for instantiating OD_HTML using
Class.newInstance()
Method summary
Method Description
OD_HTML.generate This is an interface call substituted in place of
generateHTML function in OD_Preview so all
the parameters specific to generateHTML call are
embeded into parameters vector
OD_HTML. Used to generate the main container page for
generateMainFrameSet reports containing TOC
OD_HTML. Once the generate method successfully creates
generateReportPage and instantiates the data stream, It calls this
method to handle the formatting and writing of
controls to the output stream
OD_HTML constructor
OD_HTML
public OD_HTML()
This is an empty constructor that is used for instantiating OD_HTML using
Class.newInstance()
OD_HTML.generate
public java.lang.Object generate(com.actuate.ereport.output.VirtualOutput vo,
com.actuate.ereport.output.ProgressInterface pi,
java.util.Properties properties)
throws java.lang.Exception
This is an interface call substituted in place of generateHTML function in
OD_Preview so all the parameters specific to generateHTML call are embeded
into parameters vector.
Specified by
generate in interface com.actuate.ereport.output.IOutputFormat
Pa ck a g e c o m . a c t u a t e. e r e p o r t . d a t a s r c m gr s. m e ta d a ta s r c .M e t a D a t a H a n d l e r 231
outputDesc
The output destination for html file. The possible values are String,
OutputStream. In case of output stream non indexed report should be
generated.
vo
The virtual output storage from which data can be extracted.
toc
If true, indexed report will be generated else non indexed report will be
generated. This must be set to false if OutputStream is used as outputDesc.
forceGui
If true, whenever the system needs gui support it will try to locate that support
or create new component as needed.
component
For java 1.x.x versions to create an offscreen image a visible component is
required this component should work as a ImageObserver the value of
component must be passed as null in case you want to generate html output
without any window system however in this case no image will be added to
the html file.
parameters
This is a vector which contains following elements
1 Boolean toc
2 Boolean forceGui
3 Boolean preserveFonts
4 Boolean preserveColors
5 Boolean useHorSpacing
6 Boolean gzip whether or not to generate a zipped output
7 Integer bufferSize
8 String charSet
9 String htmlTitle
10 String htmlAuthor
11 Boolean cache
12 Boolean preservePageBreak whether to display the PAGE Hdr/Ftr in the output or
not
13 ZipOutputStream zos
14 Color TOCBackground Background Color for TOC
15 Vector vPages Page numbers for page on demand
16 String pageOnDemandURL The URL of the source which requested for the page
on demand
17 int firstPageOnDemand The page that the link "First" is supposed to point to
18 int prevPageOnDemand The page that the link "Prev" is supposed to point to
OD_HTML.generateMainFrameSet
public void generateMainFrameSet(java.lang.Object outputDesc)
throws java.lang.Exception
Used to generate the main container page for reports containing TOC. The
main page holds the TOC page and the Report Page.
The
OutputStream to which the report is being written.
Throws
a RuntimeException if there is a problem writing the TOC to the
OutputStream.
OD_HTML.generateReportPage
public void generateReportPage(java.lang.Object outputDesc)
throws java.lang.Exception
Once the generate method successfully creates and instantiates the data
stream, It calls this method to handle the formatting and writing of controls to
the output stream
Throws
java.lang.Exception - Throws an Exception if it is unable to write to the output.
OD_HTML.generateTOCPage
public void generateTOCPage(java.lang.Object outputDesc)
throws java.lang.Exception
Pa ck a g e c o m . a c t u a t e. e r e p o r t . d a t a s r c m gr s. m e ta d a ta s r c .M e t a D a t a H a n d l e r 233
Writes the Table Of contents if specified to the Html file
Throws
java.lang.Exception - if the toc cannot be written
OD_HTML.getImage
public void getImage(java.lang.Object outputDesc, long ptr)
throws java.lang.Exception
This method is used to fetch individual images from the report. The arguments
are the Outputstream and the index of the image. When used in Multiple File
Serving, the images are requested by the browser, and are accordingly fetched.
However this call must only be made after the report has completely been
generated otherwise you get a NullPointerException. Internally calls
getImage(Object, Object)
outputDesc
Output Descriptor. Should be the OutputStream to which the image is to be
written.
ptr
The index of the image in the report.
Throws
a RuntimeException if it cannot write the Image to the OutputStream
OD_HTML.getImage
public void getImage(java.lang.Object outputDesc, java.lang.Object ptr)
throws java.lang.Exception
Similar to getImage(Object, long) except that the second argument is an Object
representing the index of the image.
Boolean
used to indicate if the report is being generated from a server based
application
String
specifying the requestor of the report
Pa ck a g e c o m . a c t u a t e. e r e p o r t . d a t a s r c m gr s. m e ta d a ta s r c .M e t a D a t a H a n d l e r 235
236 e.Repor t Designer API Java Edition
Package
com.actuate.ereport.
Chapter 0
engine.TemplateManager
P a c k a g e c o m . a c t u a t e . e r e p o r t . e n g i n e . Te m p l a t e M a n a g e r 237
Class TemplateManager
java.lang.Object
|
+--com.actuate.ereport.engine.TemplateManager
_____________________________________________________________________
public class TemplateManager
extends java.lang.Object
This is the main class to access the template in ACJEngine. Most aspects of the
template can be controlled using this class. An ACJEngine template has
several logical parts: Section, Zone, Group, Control, and so on. Central to
accessing these parts is a control ID. Each piece of the template has a control ID
that uniquely identifies it within the template. Duplicate control IDs are not
allowed. Most of the methods in this class work a generic object class. You can,
however, pass the control ID within double quotation marks as a string
constant to refer to a particular control.
Field summary
Type Field
com.actuate.ereport.engine tmplMgr
.TmplMgr Used internally
Method summary
Method Description
TemplateManager Changes the control ID specified by the old
.changeID control ID and replaces it with the new ID.
TemplateManager Returns a set of control IDs, section IDs, and
.collapseTemplate zone IDs contained inside the entire template
based on filter criteria specified by boolean
variables.
TemplateManager Attempts to connect to the data source
.connectToDatasource() embedded inside the template.
TemplateManager Creates a generic control and returns a
.createControl handle to it.
TemplateManager Creates a new control with the specified ID
.createControl and the specified parent.
P a c k a g e c o m . a c t u a t e . e r e p o r t . e n g i n e . Te m p l a t e M a n a g e r 239
Method Description
TemplateManager Returns the page width in inches.
.getPageWidth()
TemplateManager Returns a list of parameter IDs using which
.getParameterIds() properties can be set or retrieved.
TemplateManager Returns an individual property for the
.getParamProperty specified parameter ID.
P a c k a g e c o m . a c t u a t e . e r e p o r t . e n g i n e . Te m p l a t e M a n a g e r 241
Method Description
TemplateManager Sets the value of a label control.
.setLabel
TemplateManager Sets the value of the ORDER BY clause of the
.setORDERBYClause specified section's query with given value.
TemplateManager Sets the page height in inches.
.setPageHeight
TemplateManager Sets the left, right, top, and bottom margins of
.setPageMargins the page using a Bounds structure.
TemplateManager Sets the page width in inches.
.setPageWidth
TemplateManager Sets an individual property for the specified
.setParamProperty parameter ID.
TemplateManager Sets the value of the parameter specified.
.setParamValue Used to bypass the Enter Parameter Values
dialog box and specify parameter values
through the API instead.
TemplateManager Sets the report's Author property.
.setReportAuthor
TemplateManager Sets the report's Comments property.
.setReportComments
TemplateManager Sets the report's Title property.
.setReportTitle
TemplateManager Allows the control to resize vertically when
.setResizeToFitContents set to True.
TemplateManager Sets the Word Wrap property of the specified
.setTextWrap control if True is passed; unsets it if False is
passed.
TemplateManager Set the measurement units to be used.
.setUnitType
TemplateManager Sets the control's visibility as specified.
.setVisible
TemplateManager Used to set the wallpaper which is tiled.
.setWallpaper
TemplateManager Used to set the wallpaper at a specified
.setWallpaper location.
Field detail
tmplMgr
public com.actuate.ereport.engine.TmplMgr tmplMgr
Used internally.
TemplateManager.changeID
public java.lang.String changeID(java.lang.Object OldId,
java.lang.Object NewId)
Changes the old control ID to the new ID.
TemplateManager.collapseTemplate
public java.util.Vector collapseTemplate(boolean IncRpHdr,
boolean IncPgHdr,
boolean IncSections,
boolean IncGrpHdrs,
boolean IncDetail,
boolean IncFields,
boolean IncGrpFtrs,
boolean IncPgFtr,
boolean IncRpFtr)
Returns a set of control IDs, section IDs, and zone IDs contained inside the
entire template based on a filter criteria specified by boolean variables.
P a c k a g e c o m . a c t u a t e . e r e p o r t . e n g i n e . Te m p l a t e M a n a g e r 243
TemplateManager.connectToDatasource
public void connectToDatasource()
throws java.lang.Exception
Attempts to connect to the data source embedded inside the template.
TemplateManager.createControl
public java.lang.Object createControl(java.lang.Object id)
Creates a generic control and returns a handle to it. Users should first create a
generic control and then set its type: data field, label, and so on.
TemplateManager.createControl
public java.lang.Object createControl(java.lang.Object newID,
java.lang.Object parentID)
Creates a new control with specified ID and the specified parent.
TemplateManager.createRuntimeParams
public boolean createRuntimeParams()
TemplateManager.destroyTemplate
public void destroyTemplate()
Use this method to cleanly destroy any template that may be loaded into the
Template Manager.
TemplateManager.getBounds
public com.actuate.ereport.engine.lib.Bounds getBounds(java.lang.Object Id)
Returns the width and height of a control.
TemplateManager.getDataField
public java.lang.String getDataField(java.lang.Object a)
Returns a string in Table.Column format.
TemplateManager.getFillColor
public java.awt.Color getFillColor(java.lang.Object Id)
Returns the fill/background color of a control.
TemplateManager.getFont
public com.actuate.ereport.common.FontExt getFont(java.lang.Object Id)
P a c k a g e c o m . a c t u a t e . e r e p o r t . e n g i n e . Te m p l a t e M a n a g e r 245
Returns a FontExt object, which is an enhanced class to describe a font.
FontExt not only provides more information than the regular Font class, but is
also designed to provide a Java platform-independent way to deal with fonts.
TemplateManager.getFontColor
public java.awt.Color getFontColor(java.lang.Object Id)
Returns the color used to display the text of this control.
TemplateManager.getFormat
public java.lang.String getFormat(java.lang.Object Id)
Returns a string normally used by Java to define string formatting.
TemplateManager.getFormula
public java.lang.String getFormula(java.lang.Object a)
Returns the formula that has been assigned to the specified control.
TemplateManager.getImageURL
public java.lang.String getImageURL(java.lang.Object Id)
Returns the URL of the image referred to in this control.
TemplateManager.getImportedSQLQuery
public java.lang.String getImportedSQLQuery(java.lang.Object sectionId)
Returns the imported SQL query for the section if already set through
setImportedSQLQuery. Otherwise, returns Null.
TemplateManager.getORDERBYClause
public java.lang.String getORDERBYClause(java.lang.Object SectionId)
Returns the current value of the ORDER BY clause of the specified section's
query.
TemplateManager.getPageHeight
public double getPageHeight()
Returns the page height in inches.
TemplateManager.getPageMargins
public com.actuate.ereport.engine.lib.Bounds getPageMargins()
Returns the page margins as a Bounds structure.
See also
Bounds
TemplateManager.getPageWidth
public double getPageWidth()
Returns the page width in inches.
P a c k a g e c o m . a c t u a t e . e r e p o r t . e n g i n e . Te m p l a t e M a n a g e r 247
TemplateManager.getParameterIds
public java.lang.String[] getParameterIds()
Returns a list of parameter IDs using properties that can be set or retrieved.
TemplateManager.getParamProperty
public java.lang.Object getParamProperty(java.lang.String sParamID,
java.lang.String sProperty)
throws java.lang.RuntimeException
Returns an individual property for the specified parameter ID.
sParamID
The ID of the parameter for which a property should be retrieved.
sProperty
The name of the property. Acceptable values are Description, Type, Value, and
Format.
TemplateManager.getQueryContents
public java.util.Hashtable getQueryContents(java.lang.Object sectionId)
throws java.lang.Exception
Returns a hashtable with values of SELECT, FROM, WHERE and ORDER BY
parts of the sections's query. No corresponding set function is available
because SELECT and FROM clauses cannot be modified through the API. For
WHERE and ORDER BY clauses, use TemplateManager.setWHEREClause()
and TemplateManager.setORDERBYClause() respectively.
TemplateManager.getReportAuthor
public java.lang.String getReportAuthor()
Returns the report's Author property.
TemplateManager.getReportTitle
public java.lang.String getReportTitle()
Returns the report's Title property.
TemplateManager.getResizeToFitContents
public boolean getResizeToFitContents(java.lang.Object Id)
Returns True if the control is set for resizing to fit the contents; otherwise,
False. This method is valid only for controls inside the zones.
TemplateManager.getSectionId
public java.lang.String getSectionId(java.lang.Object FieldId)
Returns the section ID of the section that contains the specified field.
TemplateManager.getTemplateWidth
public double getTemplateWidth()
Returns the width of the template in inches.
TemplateManager.getTextWrap
public boolean getTextWrap(java.lang.Object Id)
P a c k a g e c o m . a c t u a t e . e r e p o r t . e n g i n e . Te m p l a t e M a n a g e r 249
Returns True if the wrap text property of specified control is set; False
otherwise.
TemplateManager.getVisible
public boolean getVisible(java.lang.Object Id)
Returns True if the control is set to visible; False otherwise.
TemplateManager.getWHEREClause
public java.lang.String getWHEREClause(java.lang.Object Id)
Returns the current value of the WHERE clause of the specified section's
query.
TemplateManager.hasEmbeddedDatasource
public boolean hasEmbeddedDatasource()
Indicates that the loaded template contains an embedded data source.
TemplateManager.hasParameters
public boolean hasParameters()
Indicates whether any parameters exist in this template that can be resolved.
TemplateManager.isChart
public boolean isChart(java.lang.Object Id)
Returns True if the control specified by the control ID is a chart object; False
otherwise.
TemplateManager.isFormula
public boolean isFormula(java.lang.Object Id)
Returns True if the control specified by the control ID is a formula; False
otherwise.
TemplateManager.isImageURL
public boolean isImageURL(java.lang.Object Id)
Returns True if the control specified by the control ID is an image URL; False
otherwise.
TemplateManager.isLabel
public boolean isLabel(java.lang.Object Id)
Returns True if the control specified by the control ID is a label; False
otherwise.
TemplateManager.isLine
public boolean isLine(java.lang.Object Id)
Returns True if the control specified by the control ID is a line; False otherwise.
P a c k a g e c o m . a c t u a t e . e r e p o r t . e n g i n e . Te m p l a t e M a n a g e r 251
TemplateManager.setAlignment
public void setAlignment(java.lang.Object Id,
int val)
Sets the text alignment property of the control. Possible return values are:
NONE = 0, LEFT = 1, RIGHT = 2, BOTTOM = 8, TOP = 16,
VERTICALCENTER = 32, HORIZONTALCENTER = 64, TOPLEFT
(TOP | LEFT), TOPRIGHT = ( RIGHT | TOP ), TOPCENTER =
( HORIZONTALCENTER | TOP ), BOTTOMLEFT = ( LEFT | BOTTOM ),
BOTTOMRIGHT = ( RIGHT | BOTTOM ), BOTTOMCENTER =
( HORIZONTALCENTER | BOTTOM ), and CENTER =
( VERTICALCENTER | HORIZONTALCENTER ).
TemplateManager.setBounds
public void setBounds(java.lang.Object d,
com.actuate.ereport.engine.lib.Bounds rect)
Sets the width and height of a control.
TemplateManager.setDataField
public void setDataField(java.lang.Object FieldId,
java.lang.Object SectionId,
java.lang.String Colname)
Sets the value of a field control.
TemplateManager.setFillColor
public void setFillColor(java.lang.Object Id,
java.awt.Color c)
Sets the fill/background color of a control.
TemplateManager.setFontColor
public void setFontColor(java.lang.Object Id,
java.awt.Color c)
TemplateManager.setFormat
public void setFormat(java.lang.Object Id,
java.lang.String format)
Sets a string which is normally used by Java to define string formatting.
TemplateManager.setFormula
public void setFormula(java.lang.Object Id,
java.lang.String formula,
java.lang.Object resetZone)
Sets the formula for a given control.
Id
The identifier of a control.
formula
A formula string.
Rest
Criteria; must be a valid zone contained within the control's section.
P a c k a g e c o m . a c t u a t e . e r e p o r t . e n g i n e . Te m p l a t e M a n a g e r 253
TemplateManager.setImageURL
public void setImageURL(java.lang.Object FieldId,
java.lang.String url)
Sets the URL of the image referred to in this control.
TemplateManager.setImportedSQLQuery
public void setImportedSQLQuery(java.lang.Object sectionId,
java.lang.String query)
Sets the predesigned SQL query to be used by the section. When setting the
query through this API, make sure that the fields used in the template will be
provided in the result set of this query.
TemplateManager.setLabel
public void setLabel(java.lang.Object FieldId,
java.lang.String label)
Sets the value of a label control.
TemplateManager.setORDERBYClause
public void setORDERBYClause(java.lang.Object SectionId,
java.lang.String colssort)
Sets the value of the ORDER BY clause of the specified section's query with
given value.
TemplateManager.setPageHeight
public void setPageHeight(double h)
Sets the page height in inches.
TemplateManager.setPageWidth
public void setPageWidth(double w)
Sets the page width in inches.
TemplateManager.setParamProperty
public void setParamProperty(java.lang.String sParamID,
java.lang.String sProperty,
java.lang.Object oValue)
throws java.lang.RuntimeException
Sets an individual property for the specified parameter ID.
sParamID
The ID of the parameter for which a property is to be set.
sProperty
The names of property acceptable values are: Description, Type, Value, and
Format.
oValue
The value of the property; corresponding acceptable class types are String,
String, and Object.
P a c k a g e c o m . a c t u a t e . e r e p o r t . e n g i n e . Te m p l a t e M a n a g e r 255
TemplateManager.setParamValue
public boolean setParamValue(java.lang.String sName,
java.lang.Object sDefValue)
Sets the value of the parameter specified. Used to bypass the Enter Parameter
Values dialog box and instead specify parameter values through the API.
TemplateManager.setReportAuthor
public void setReportAuthor(java.lang.String sAuthor)
Sets the report's Author property.
TemplateManager.setReportComments
public void setReportComments(java.lang.String sComments)
Sets the report's Comments property.
TemplateManager.setReportTitle
public void setReportTitle(java.lang.String sTitle)
Sets the report's Title property.
TemplateManager.setResizeToFitContents
public void setResizeToFitContents(java.lang.Object Id,
boolean val)
Allows the control to resize vertically when set to True. Default value is False.
This value can be set only for controls inside the zones.
TemplateManager.setUnitType
public void setUnitType(java.lang.String sUnits)
Sets the measurement units to be used.
TemplateManager.setVisible
public void setVisible(java.lang.Object Id,
boolean val)
Sets the control's visibility as specified.
TemplateManager.setWallpaper
public void setWallpaper(java.lang.String URL,
double leftOffset,
double topOffset)
Used to set the wallpaper at a specified location.
URL
The file URL for the watermark image.
Double leftOffset is the left offset, from the margin, for the watermark double.
TopOffset is the top offset, from the margin, for the watermark.
TemplateManager.setWallpaper
public void setWallpaper(java.lang.String URL)
Used to set the wallpaper which is tiled.
P a c k a g e c o m . a c t u a t e . e r e p o r t . e n g i n e . Te m p l a t e M a n a g e r 257
URL
The file URL for the wallpaper image.
TemplateManager.setWHEREClause
public void setWHEREClause(java.lang.Object Id,
java.lang.String filterexpr)
Sets the WHERE clause of the specified section's query. The new WHERE
clause overwrites the existing WHERE clause.
TemplateManager.setZoneHeight
public void setZoneHeight(java.lang.Object Id,
double h)
Sets the height of a zone in inches.
Index 259
closeZipEntry method 118 ASCIIDataHandler 169
closeZipStream method 118 EJBDataHandler 174, 175
collapseTemplate method 243 JDBCHandler 188
colors MetaDataHandler 206, 209
getting font 246 OD_DHTML 222, 223
getting for controls 245 OD_HTML 230, 231
setting background 133 containers
setting for controls 252 embedding preview devices 130
column names 146 contents page
getting 151, 192, 211 displaying 134
lowercase characters in 85, 202 setting backgrounds 133
columns context factories 179
counting 170 control IDs 238
getting assigned privileges 194, 195, 212, changing 243
213 controls
getting data types for 192 creating 244
getting default values 193, 212 getting formulas assigned to 246
getting from templates 245 getting height and width 245
getting privileges for 213 getting labels for 247
getting relationships to tables 154, 215 getting visible 250
setting privileges 200, 215, 217 resizing 249
setting relationships to tables 159, 219 setting default gap 85
testing for null values in 156, 200, 217 setting dimensions of 252
Comments property setting formulas for 253
getting 249 setting labels for 254
setting 256 setting visibility of 257
communication stubs testing for labels 251
getting 99 counting report pages 132
resetting 105 createControl method 244
Connect method 188, 189 createRuntimeParams method 244
connect method creating
AppDataHandler 150 controls 244
ASCIIDataHandler 169, 170 EJB tables 176
JDBCHandler 189, 190 CSV reports 118
MetaDataHandler 209 getting properties for 128
connecting to data sources 97, 244 setting properties for 135
setting JDBC 189, 190 current page
testing connections 178, 200 retrieving 135
connectToDatasource method 244
connectToRemoteApp method 176 D
console messages data 146
displaying 84, 97, 106, 159, 201 retrieving 106
constructors setting raw report 141
ACJDesigner 71, 76 data context 179
ACJEngine 92, 96
ACJOutputProcessor 117
AppDataHandler 149
Index 261
doPreviewReset field 75 expressions 100
duplicate identifiers 238 ExprEvaluator package 100
duplicate names 146 external fonts 77
extractRelations method 191
E
e.Analysis application xvii F
e.Report Designer xv F1 key xx
e.Report Designer Java Edition xv, xviii fetchData method
e.Report Designer overview xviii AppDataHandler 150
e.Report Designer Professional xiv JDBCHandler 191
e.Reporting Server xv MetaDataHandler 210
e.Reporting Server Java Edition xvi fields. See data fields; serialized fields
e.Reporting Server Progress Edition xvi file buffers 135
e.Reporting Suite xiii file caches 105
product summary xiv FileName property
EJB data sources setCSVProperty method 136
creating tables 176 setDHTMLProperty method 136
getting name 177 setHTMLProperty method 138
getting property sheets for 177 setJOIProperty method 138
getting registered 80 setPDFProperty method 140
setting context factory for 179 FilesToAttach property 137
testing connections 178 fill color
EJBDataHandler class 174 getting 245
AWT vs. Swing usage 4 setting 252
serialized objects listed 13 finalizeEngine method 98
email Font dialogs
getting properties for 129 adding external fonts 77
setting properties for 137 FontExt object 246
transmitting 120 fonts
embedding preview devices 130 creating 108
encoding getting 246
setting default template 86 getting colors for 246
encoding types setting text 253
reading templates 104, 105 formatting strings 253
writing templates 108, 109 formulas
End User Desktop xvii setting 253
engine 92 testing for 251
accessing templates 238 freeing memory 104
creating reporting 96 functions
getting GUI maintained 79 registering user-defined 100
resetting 102, 103
error messages G
displaying 84, 106, 201 generate method
examples xviii OD_DHTML 223
executing queries 154 OD_HTML 231
exportAsMetadata method 210 generateCSV method 118, 119
Index 263
getLabel method 247 getRegdASCIIDataHandler method 80
getMruList method 79 getRegdEJBHandler method 80
getName method getRegdJDBCHandler method 80
AppDataHandler 152 getRegdMetaDataHandler method 80
EJBDataHandler 177 getRegdXMLDataHandler method 81
JDBCHandler 194 getRelations method
MetaDataHandler 213 ACJDesigner 81
getORDERBYClause method 247 AppDataHandler 154
getOutputDevice method 100 JDBCHandler 197
getOutputFiles method 130 MetaDataHandler 215
getPageHeight method 247 getRemarks method
getPageMargins method 247 JDBCHandler 197
getPageWidth method 247 MetaDataHandler 215
getParameterIds method 248 getRemoteAppName method 177
getParamProperty method 248 getReportAuthor method 248
getPassword method 195 getReportComments method 249
getPDFProperty method 130 getReportTitle method 249
getPreviewDevice method 130 getResizeFixRatio method 107
getPRINTERProperty method 131 getResizeToFitContents method 249
getPrinterResolution method 131 getSectionId method 249
getPrivileges method 195 getSelectedTables method 197
MetaDataHandler 213 getSelectiveTableFilter method 197
getProperties method 177 getSOImplementation method 198
getPropertiesFileName method 171 getSourceFileName method 171
getPropertySheet method getStartRecordNumber method
AppDataHandler 153 AppDataHandler 154
EJBDataHandler 177 JDBCHandler 198
JDBCHandler 195 getStoredObjects method 198
MetaDataHandler 214 getTable method
getQuery method AppDataHandler 154
AppDataHandler 153 JDBCHandler 198
JDBCHandler 195 MetaDataHandler 216
MetaDataHandler 214 getTableCount method 198
getQueryColumns method getTableNames method
AppDataHandler 153 AppDataHandler 155
JDBCHandler 196 JDBCHandler 199
MetaDataHandler 214 MetaDataHandler 216
getQueryContents method 248 getTables method 199
getQueryResult method getTableType method
AppDataHandler 153 AppDataHandler 155
JDBCHandler 196 MetaDataHandler 216
MetaDataHandler 215 getTargetOutputDevice method 101
getQueryTables method getTemplateManager method 101
AppDataHandler 154 getTemplateReader method 101
JDBCHandler 196 getTemplateWidth method 249
MetaDataHandler 215 getTemplateWriter method 102
getRegdAppDataHandler method 79 getTextWrap method 249
Index 265
JDBC data sources 182 setting 255
extracting tables for 189 MaxContents property 140
fetching result sets from 191 MaxItems property 140
fetching tables from 201 MaxPages property 140
getting default values 193 measurement units 257
getting names 194 memory
getting property sheets for 195 caching options for 105
getting registered 80 freeing 104
getting tables from 199 menu bars 70
getting URLs for 199 selecting items 76
testing for null values 200 setting up 88
JDBC drivers messages
getting names 193 displaying for queries 159
setting 202 displaying in console 97
JDBCDataHandler class displaying progress or error 84, 106, 201
AWT vs. Swing usage 4 MetaDataHandler class 206
JDBCHandler class 182 AWT vs. Swing usage 4
JOI reports MetaDataSrc type 206
generating 123 meta-information
getting properties for 130 getting data sources 213
setting file names for 138 getting data types 212
setting properties for 138 getting property sheets for 214
setting source 139 getting registered data sources for 80
implementing data sources for 206
L loading data for 217, 218
labels reading and parsing data for 218
adding to data fields 84 testing connections for 218
creating for controls 254 writing to output stream 220
getting 247 methods 15
testing for 251 ACJDesigner 71
landscape mode 86 ACJEngine 93
line controls 251 ACJOutputProcessor 112
loading AppDataHandler 147
data sources 104, 105 ASCIIDataHandler 168
templates 81, 82, 104, 105 EJBDataHandler 174
loadTemplate method 81, 82 JDBCHandler 183
LRX (Live Report Extension) xvii MetaDataHandler 206
OD_DHTML 222
M OD_HTML 230
TemplateManager 238
main method 82 MRU files
makeSelective method 200 getting file names 79
manuallyConstructed method 218 storing 87
Manuals directory xx updating 77
mapping client keys to template keys 139 multi-table registrations 149
margins
getting 247
Index 267
PDF reports privileges
generating 123 getting 213
getting properties for 130 getting grantee for 194, 212
setting properties for 140 getting grantor for 194, 213
PLAIN parameter 253 getting specific 195
portrait mode 86 testing column availability for 200, 215,
PreserveColors property 217
setDHTMLProperty method 136 processMsg method 178
setHTMLProperty method 138 processRemoteMsg method 178
PreserveFonts property product summary xiv
setDHTMLProperty method 136 product update information xviii
setHTMLProperty method 138 programming interfaces xiv
PreservePageBreaks property progress messages
setDHTMLProperty method 136 displaying 84, 106, 201
setHTMLProperty method 138 promptParams method 132
PreservePrinterJob property 140 properties
preview devices 130 getting CSV 128
Preview tab 70 getting DHTML 128
enabling 76 getting email 129
preview windows getting HTML 129
counting available pages for 132 getting JOI 130
displaying TOCs in 134 getting parameter ID 248
displaying toolbars in 134 getting PDF 130
getting active page 132 getting printer 131
getting zoom values for 133 setting CSV 135
removing toolbars 133 setting DHTML 136
setting active page 133 setting email 137
setting next page for 134 setting HTML 137
setting previous page 134 setting JOI 138
setting zoom values for 134 setting parameter ID 255
primitive data types setting PDF 140
getting 151, 192 setting printer 140
print method 103 property sheets
print modes 86 getting 177, 195
printed documentation getting for meta-information 214
syntax conventions xxiii prv_getActivePage method 132
typographical conventions xxii prv_getPageCount method 132
PrinterJob property 140 prv_getZoom method 133
printers prv_removeToolbarItem method 133
getting current resolution for 131 prv_setActivePage method 133
getting properties for 131 prv_setBackgroundTOC method 133
setting properties for 140 prv_setNextPage method 134
setting resolution for 141 prv_setPrevPage method 134
printing reports 103, 126 prv_setZoom method 134
getting email properties for 129 prv_showTOC method 134
printingDone method 104 prv_showToolbar method 134
Index 269
resolution setDataField method 252
getting print 131 setDataSource method 106
setting printer 141 setDatasourceName method 219
updating screen 103, 108 setDebugMode method
result sets 159, 219 ACJDesigner 84
fetching from JDBC data sources 191 ACJEngine 106
generating 154 AppDataHandler 159
retrieveTables method 201 JDBCHandler 201
retrieving data 106 setDefaultAttachLabel method 84
running queries 154 setDefaultExitMode method 84
setDefaultGridSnap method 84
S setDefaultHorzGap method 85
sample application xvii setDefaultImageRelativePath method 85
sample reports xviii setDefaultLookAndFeel method 85
saveTemplate method 82 setDefaultLowercaseQuotes method 85
saving templates 82, 87 setDefaultNewTemplate method 86
schemas setDefaultPrependSchema method 86
prepending to tables 202 setDefaultPrintMode method 86
setting default behavior for 86 setDefaultShowGrid method 86
screen resolution 103, 108 setDefaultTemplateEncoding method 86
search extension API xiv setDHTMLProperty method 136
searches (help topics) xxi setDocsPath method 87
section IDs 249 setDocumentationPath method 137
selecting data sources 83 setDriver method 202
SenderEmail property 137 setEMAILProperty method 137
sending email 120 setExtraOperators method 159
serialized fields setFillColor method 252
ACJDesigner 8, 71, 75 setFont method 253
ACJEngine 92 setFontColor method 253
AppDataHandler 11 setFormat method 253
ASCIIDataHandler 12 setFormula method 253
EJBDataHandler 13 setGenerateOnDemand method
JDBCHandler 182, 187 OD_DHTML 226
TemplateManager 238, 243 OD_HTML 235
serialized objects 7 setHasBeenGenerated method 87
servers xv, xvi, xvii setHTMLProperty method 137
setActiveDataSource method 83 setIdentifierQuote method 219
setAlignment method 252 setImageURL method 254
setAutoQuery method 83 setImportedSQLQuery method 254
setBounds method 252 setJOIFileSource method 138
setBufferSize method 135 setJOIProperty method 138
setCacheOption method 105 setJOISource method 139
setCatalogName method 219 setJOIURLSource method 139
setCommunicationStub method 106 setLabel method 254
setContextFactory method 179 setLowercaseQuotes method 202
setCSVProperty method 135 setMruList method 87
setORDERBYClause method 254
Index 271
tables (continued) text wrapping 249, 257
removing from metadata layers 209 thin viewer 99
setting relationships to columns 159, 219 third-party analysis tools xiv
specirying domain of 204 Title property
testing for null values in 156, 200, 217 getting 249
testing for spaces in names 152 setting 256
tabs 70 TmplMgr variable 102
changed-state notification for 88 toolbars
changing 81 displaying 134
displaying 76 removing 133
Template Designer 70 updating 134
constructing 76 types
exiting 84 getting 151, 192
quitting 89 getting columns with same 170
selecting active tab 81 getting delimiter strings for 152
selecting menu items 76 getting for meta-information 212
updating 88 typestyles 253
Template Manager 238 typographical conventions xxii
getting instances of 101, 102 syntax xxiii
instantiating 105
resetting 102, 103 U
updating 104 updateDesigner method 88
Template Reader 101 updateOutputProperties method 88
Template Writer 102 updateRelations method 89
TemplateManager class 238 updateResolution method 108
AWT vs. Swing usage 4 updating queries 83
templates updating screen resolution 103, 108
accessing 238 URLs
connecting to data sources in 244 getting image 246
deleting 244 getting JDBC data source 199
generating output from 112 setting as JOI source 139
getting columns 245 setting for images 254
getting dimensions of 249 setting for JDBC connections 203
getting identifiers for 243 testing for image 251
loading 81, 82, 104, 105 user names
mapping to client keys 139 getting 199
overriding resolution parameter in 103 setting 203
processing complex expressions in 100 user-defined functions
saving 82, 87 registering 100
setting default encoding for 86 useTables method 204
storing structures 108, 109
testing for embedded data sources 250 V
testing for parameters 250
temporary files 105 variables 15
text alignment clearing stateless 104
getting 245 Viewer xvii
setting 252
Index 273
274 e.Repor t Designer API Java Edition