com.crystaldecisions.sdk.occa.report.application
Class ReportClientDocument

java.lang.Object
  extended by com.crystaldecisions.sdk.occa.report.application.ClientDocument
      extended by com.crystaldecisions.sdk.occa.report.application.ReportClientDocument
All Implemented Interfaces:
IReportClientDocument, java.io.Externalizable, java.io.Serializable

public class ReportClientDocument
extends ClientDocument
implements IReportClientDocument, java.io.Externalizable

This object enables you to perform a variety of operations on a report, in addition to saving, copying, and closing. Use this object to modify or create a new a report. Applications that use the RAS server in Crystal Enterprise 10 (BusinessObjects Enterprise as of version 11), create ReportClientDocument instances using the IReportAppFactory interface provided by the BusinessObjects Enterprise Java SDK.

See Also:
Serialized Form

Field Summary
static java.lang.String inprocConnectionString
          The inproc EROM connection string
 
Fields inherited from class com.crystaldecisions.sdk.occa.report.application.ClientDocument
URIPROTOCAL_CECUID, URIPROTOCAL_CEIS, URIPROTOCAL_RAS, URIPROTOCAL_RASSDK
 
Constructor Summary
ReportClientDocument()
           
ReportClientDocument(IEnterprisePlugin plugin)
           
 
Method Summary
 void cancelProcessing()
          For internal use only.
 void checkDatabaseAndUpdate()
          For internal use only.
 FormulaErrors checkFormula(IFormula formula)
          For internal use only.
 FormulaErrors checkFormula(IFormula formula, java.lang.String contextObjectName)
          For internal use only.
 FormulaErrors checkFormula(IFormula formula, java.lang.String contextObjectName, java.lang.String containerCrosstabName)
          For internal use only.
 void close()
           Closes the ReportClientDocument and releases all resources.
static ReportClientDocument createDefault()
           
 java.lang.Object createMember(java.lang.String eleName, org.xml.sax.Attributes attrs, XMLSerializationContext ctxt, java.util.Map objState, boolean[] bLoaded)
          For internal use only.
static ReportClientDocument createReport()
           
 void disableBuiltinControllers()
          For internal use only.
 java.lang.String displayName()
           Returns the title of the document.
 void enableBuiltinControllers()
          For internal use only.
 void endElement(java.lang.String eleName, java.util.Map objState)
          For internal use only.
 IByteArray fetchPreviewThumbnail()
           
 void flushRequests()
           For internal use only.
 PropertyBag getAvailableExportFormats(java.lang.String languageCode, boolean includePropertyInformation)
          For internal use only.
 CustomFunctionController getCustomFunctionController()
           Returns the CustomFunctionController object which allows you to get and modify a custom function.
 IDatabase getDatabase()
          Deprecated. As of Version 10
 DatabaseController getDatabaseController()
           Returns the DatabaseController object that is used to add, remove, and modify the tables that are used as the report's data source.
 DataDefController getDataDefController()
           Returns the DataDefController object used to modify the report's data definition.
 IDataDefinition getDataDefinition()
          Deprecated. As of Version 10
 PropertyBag getDesignerProperties(java.lang.String subreportName)
          For internal use only.
 FormulaLanguageService getFormulaLanguageService()
          For internal use only.
 java.lang.Object getInternal(java.lang.Class internal)
          For internal use only.
 java.lang.Object getInternal(java.lang.String name, java.lang.Class internal)
          For internal use only.
 ReportClientDocument getMainReport()
          For internal use only.
 PrintOutputController getPrintOutputController()
           Returns the PrintOutputController object used to export this document to a different format.
 java.lang.String getRecordSelectionFormula()
          Retrieves the record selection formula for this report
 ReportDefController getReportDefController()
           Returns the ReportDefController object used to modify the report definition's areas, sections, and report objects.
 ReportDocument getReportDocument()
           Returns the IReportDocument object used to retrieve areas, sections, and report objects in the report.
 IReportOptions getReportOptions()
           Returns IReportOptions object, which specifies the subreport's behavior and capabilities such a how it should handle server data, dates, queries, printing, viewing, and other such options.
 IReportSource getReportSource()
          Returns the ReportSource object used by the Web Report Viewer to display the contents of the report.
 IReportStatistics getReportStatistics()
          Retrieves Report Statistics
 IRepositoryLogonInfo getRepositoryLogonInfo()
          Deprecated. As of Version 10.
 RepositoryService getRepositoryService()
          For internal use only.
 com.crystaldecisions.sdk.occa.report.application.RowsetController getRowsetController()
           Returns the RowsetController object used to browse field and table values in the database that the report is using and to fetch group tree and rowset data.
 java.lang.Object getSavedExportOptions(ReportExportFormat exportFormat)
           Gets the saved export options of the report for the specified export format.
 PropertyBag getSavedExportOptionsEx(java.lang.String canonicalExportFormatId)
           
 SearchController getSearchController()
           Returns the SearchController object, which is used for searching.
 PropertyBag getStatusVariables()
          For internal use only.
 SubreportController getSubreportController()
           Returns the SubreportController object used to determine the names of the subreports in the report and to modify the subreports' databases.
 java.util.List<UnsupportedFeatureType> getUnsupportedFeatures()
          For internal use only.
 boolean isCachable(int nOptions)
           Returns true if this document is cachable, and false otherwise.
 boolean isOpen()
           Returns true if this document is open, and false otherwise.
 boolean isReadOnly()
           Returns true if this document is read-only, false otherwise.
 void logOffRepository()
          For internal use only.
 void logOnRepository(java.lang.String repositorySessionString)
          For internal use only.
 void modifyDesignerProperties(PropertyBag newProperties, java.lang.String subreportName)
          For internal use only.
 void modifyReportOptions(IReportOptions reportOptions)
           Modifies the report’s behavior and capabilities such as how it should handle server data, dates, queries, printing, viewing, and other such options.
 void modifySummaryInfo(ISummaryInfo summaryInfo)
           Modifies the report's summary information such as the author's name, comments, keywords, subject, title, and whether or not a preview image is saved.
static ReportClientDocument openReport(java.io.File theFile)
           
 java.lang.String path()
           Returns the full path of the document.
 void playBackRequests(java.lang.String filePath, java.lang.String logPath)
           For internal use only.
 void readElement(java.lang.String eleName, java.lang.String sVal, org.xml.sax.Attributes attrs, java.util.Map objState)
          For internal use only.
 void readExternal(java.io.ObjectInput in)
           Reads the stream written by the writeExternal method to reconstruct the ReportClientDocument object.
 void refreshReportDocument()
           For internal use only.
 void refreshRepositoryObjects()
           For internal use only.
 void save()
           Saves changes to the current document.
 void save(XMLWriter writer, java.lang.String sTag, XMLSerializationContext ctxt)
          For internal use only.
 void save(XMLWriter writer, XMLSerializationContext ctxt)
          For internal use only.
 void saveAs(java.lang.String displayName, java.lang.Object parentFolderPath, int options)
           Saves the changes to a new report.
 void saveContents(XMLWriter writer, XMLSerializationContext ctxt)
          For internal use only.
 void setLocale(java.util.Locale locale)
           Sets the locale that is used to localize various aspects of the document.
 void setRecordSelectionFormula(java.lang.String formulaText)
          Modifies the record selection formula for this report
 void setReportOptions(IReportOptions reportOptions)
          Deprecated. As of Version 10, should use modifyReportOptions instead.
 void setSavedExportOptions(ReportExportFormat exportFormat, java.lang.Object exportOptions)
           Saves the export options for the report for the specified export format.
 void setSavedExportOptionsEx(java.lang.String exportFormatID, PropertyBag exportOptions)
           
 void setSummaryInfo(ISummaryInfo summaryInfo)
          Deprecated. As of Version 10, should use modifySummaryInfo instead.
 void startElement(java.lang.String eleName, java.util.Map objState, org.xml.sax.Attributes attrs)
          For internal use only.
 PropertyBag UID()
           Returns the properties that uniquely identify this ClientDocument object.
 void verifyDatabase()
           Checks to ensure that the report is using the most current data scheme from its database.
 void writeExternal(java.io.ObjectOutput out)
           Writes the ReportClientDocument's contents to a stream to be read back by the readExternal method.
 
Methods inherited from class com.crystaldecisions.sdk.occa.report.application.ClientDocument
addAdvancedClientDocumentEventListener, addClientDocumentEventListener, getIsModified, getLocale, getReportAppServer, getReportAppSession, getUndoManager, initialize, newDocument, open, removeAdvancedClientDocumentEventListener, removeClientDocumentEventListener, setIsModifiedUntilSaved, setReportAppServer, setReportAppSession, setTimeZone
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface com.crystaldecisions.sdk.occa.report.application.IReportClientDocument
getLocale, getUndoManager
 

Field Detail

inprocConnectionString

public static final java.lang.String inprocConnectionString
The inproc EROM connection string

See Also:
Constant Field Values
Constructor Detail

ReportClientDocument

public ReportClientDocument()

ReportClientDocument

public ReportClientDocument(IEnterprisePlugin plugin)
Method Detail

createDefault

public static ReportClientDocument createDefault()
Returns:
a default ReportClientDocument using the inproc connection

createReport

public static ReportClientDocument createReport()
                                         throws ReportSDKException
Returns:
A new blank ReportClientDocument
Throws:
ReportSDKException - If there is a problem creating the report

openReport

public static ReportClientDocument openReport(java.io.File theFile)
                                       throws ReportSDKException
Parameters:
theFile - the file representing the report to open
Returns:
the opened ReportClientDocument
Throws:
ReportSDKException - if there was an error opening the report

displayName

public java.lang.String displayName()
                             throws ReportSDKException
Description copied from class: ClientDocument

Returns the title of the document.

Specified by:
displayName in class ClientDocument
Returns:
A String containing the document's title.
Throws:
ReportSDKException

close

public void close()
           throws ReportSDKException

Closes the ReportClientDocument and releases all resources.

NOTE: This method must be called by the user to release resources used by this object and to notify the RAS server to close the report behind the ReportClientDocument instance. If this method is not called, the report on the RAS server will no longer be accessible, but will remain in memory until it times out.

Overrides:
close in class ClientDocument
Throws:
ReportSDKException

flushRequests

public void flushRequests()
                   throws ReportSDKException

For internal use only.

Throws:
ReportSDKException

getCustomFunctionController

public CustomFunctionController getCustomFunctionController()
                                                     throws ReportSDKException

Returns the CustomFunctionController object which allows you to get and modify a custom function. You can create custom functions through Crystal Reports and use the CustomFunctionController object to access and modify them.

Specified by:
getCustomFunctionController in interface IReportClientDocument
Returns:
The CustomFunctionController object used to modify a custom function.
Throws:
ReportSDKException

getDatabase

public IDatabase getDatabase()
                      throws ReportSDKException
Deprecated. As of Version 10

Returns the IDatabase object which allows you to retrieve the report's database name, tables, and table links. It also allows you to retrieve a particular field based on a field ID and table.

Note: To modify the IDatabase objects, use the getDatabaseController() method.

Returns:
The IDatabase object for this report.
Throws:
ReportSDKException

getDatabaseController

public DatabaseController getDatabaseController()
                                         throws ReportSDKException

Returns the DatabaseController object that is used to add, remove, and modify the tables that are used as the report's data source.

Specified by:
getDatabaseController in interface IReportClientDocument
Returns:
The DatabaseController object used to add, remove, and modify the tables that are used as the report's data source.
Throws:
ReportSDKException

getDataDefController

public DataDefController getDataDefController()
                                       throws ReportSDKException

Returns the DataDefController object used to modify the report's data definition.

A data definition defines what data is used in the report and how it is treated. Use the DataDefController object to modify the report's databases, formula fields, groups, parameter fields, record filters, and sorting definition.

Specified by:
getDataDefController in interface IReportClientDocument
Returns:
The DataDefController object used to modify the report's data definition.
Throws:
ReportSDKException

getDataDefinition

public IDataDefinition getDataDefinition()
                                  throws ReportSDKException
Deprecated. As of Version 10

Returns the IDataDefinition object used to access a report's formula fields, group filters, group name fields, groups, parameter fields, record filters, result fields, sorting definitions, and summary fields.

Note: This object should be accessed using the DataDefController.getDataDefinition() method.

Returns:
The IDataDefinition object.
Throws:
ReportSDKException

getFormulaLanguageService

public FormulaLanguageService getFormulaLanguageService()
Description copied from interface: IReportClientDocument
For internal use only.

Specified by:
getFormulaLanguageService in interface IReportClientDocument

getRepositoryService

public RepositoryService getRepositoryService()
For internal use only.

Specified by:
getRepositoryService in interface IReportClientDocument

getPrintOutputController

public PrintOutputController getPrintOutputController()
                                               throws ReportSDKException

Returns the PrintOutputController object used to export this document to a different format.

Returns:
The PrintOutputController object used to export this document to a different format.
Throws:
ReportSDKException

getReportDefController

public ReportDefController getReportDefController()
                                           throws ReportSDKException

Returns the ReportDefController object used to modify the report definition's areas, sections, and report objects.

Specified by:
getReportDefController in interface IReportClientDocument
Returns:
The ReportDefController object.
Throws:
ReportSDKException

getReportDocument

public ReportDocument getReportDocument()
                                 throws ReportSDKException

Returns the IReportDocument object used to retrieve areas, sections, and report objects in the report. This property provides access to areas in the report; each area may contain multiple sections, and each section may contain multiple report objects. A new report, by default, contains five area objects: the Report Header area, the Page Header area, the Details area, the Report Footer area, and the Page Footer area.

Returns:
The IReportDocument object used to retrieve areas, sections, and report objects in the report.
Throws:
ReportSDKException

getReportSource

public IReportSource getReportSource()

Returns the ReportSource object used by the Web Report Viewer to display the contents of the report.

Returns:
The IReportSource object used by the viewer to display the report.

getRepositoryLogonInfo

public IRepositoryLogonInfo getRepositoryLogonInfo()
Deprecated. As of Version 10.

Returns the IRepositoryLogonInfo object used to get and set the database logon information for the report.

Returns:
An IRepositoryLogonInfo object used to get and set the database logon information for the report.

getRowsetController

public com.crystaldecisions.sdk.occa.report.application.RowsetController getRowsetController()
                                                                                      throws ReportSDKException

Returns the RowsetController object used to browse field and table values in the database that the report is using and to fetch group tree and rowset data.

Specified by:
getRowsetController in interface IReportClientDocument
Returns:
The RowsetController object.
Throws:
ReportSDKException

getSearchController

public SearchController getSearchController()
                                     throws ReportSDKException

Returns the SearchController object, which is used for searching. This controller is similar to the RowsetController object in that you can retrieve rowset information in the report. In addition, you can specify a search filter for the records you are looking for.

Specified by:
getSearchController in interface IReportClientDocument
Returns:
The SearchController object used to perform searches.
Throws:
ReportSDKException

getSubreportController

public SubreportController getSubreportController()
                                           throws ReportSDKException

Returns the SubreportController object used to determine the names of the subreports in the report and to modify the subreports' databases.

Returns:
The SubreportController object used.
Throws:
ReportSDKException

isCachable

public boolean isCachable(int nOptions)

Returns true if this document is cachable, and false otherwise.

Parameters:
nOptions - An OpenReportOptions constant that specifies the options used to open this report.
Returns:
true if this document is cachable, and false otherwise.

isOpen

public boolean isOpen()
               throws ReportSDKException

Returns true if this document is open, and false otherwise.

Returns:
true if this document is open, and false otherwise.
Throws:
ReportSDKException

isReadOnly

public boolean isReadOnly()
                   throws ReportSDKException
Description copied from class: ClientDocument

Returns true if this document is read-only, false otherwise.

Specified by:
isReadOnly in class ClientDocument
Returns:
true if this document is read-only, false otherwise.
Throws:
ReportSDKException

path

public java.lang.String path()
                      throws ReportSDKException
Description copied from class: ClientDocument

Returns the full path of the document.

Specified by:
path in class ClientDocument
Returns:
A String that specifies the full path of the document.
Throws:
ReportSDKException

playBackRequests

public void playBackRequests(java.lang.String filePath,
                             java.lang.String logPath)

For internal use only.


readExternal

public void readExternal(java.io.ObjectInput in)
                  throws java.io.IOException,
                         java.lang.ClassNotFoundException

Reads the stream written by the writeExternal method to reconstruct the ReportClientDocument object. You must first create an instance of the ReportClientDocument using the public no-arg constructor and then call this method on this instance to restore its contents.

Specified by:
readExternal in interface java.io.Externalizable
Parameters:
in - the input object to be read
Throws:
java.io.IOException
java.lang.ClassNotFoundException

refreshRepositoryObjects

public void refreshRepositoryObjects()
                              throws ReportSDKException

For internal use only.

Throws:
ReportSDKException

refreshReportDocument

public void refreshReportDocument()
                           throws ReportSDKException

For internal use only.

Throws:
ReportSDKException

save

public void save()
          throws java.io.IOException,
                 ReportSDKException

Saves changes to the current document.

If the file cannot be modified, or is marked read-only, the method will fail. Use the isReadOnly() method to check if the file is read-only or not. Note that this method can save a file to Crystal Enterprise 9 or 10 and to BusinessObjects Enterprise (as of version 11), but cannot save a file to Crystal Enterprise 8 or 8.5.

If the report contains processing extensions and if it is saved to BusinessObjects Enterprise, the processing extensions are saved with the report. For information on applying processing extensions to a report, see the BusinessObjects Enterprise Administrator's Guide.

Specified by:
save in class ClientDocument
Throws:
java.io.IOException
ReportSDKException

saveAs

public void saveAs(java.lang.String displayName,
                   java.lang.Object parentFolderPath,
                   int options)
            throws ReportSDKException,
                   java.io.IOException

Saves the changes to a new report.

If the report is saved successfully, the ReportClientDocument will point to the newly saved report. The saveAs method fails when:

You can use the isReadOnly() method to check if the report is read-only or not.

on the version of RAS this can be:

If you are running RAS in an unmanaged environment, see the Setting up your RAS environment section in the Setting up the Development Environment chapter of the Reference Guide for details on report location.

If the report contains processing extensions and if it is saved to BusinessObjects Enterprise, the processing extensions are saved with the report. If it is saved to a folder on the RAS server or on RAS SDK machine the processing extensions are not preserved. However, the report's selection formulas are modified to apply the data filtering rules enforced by the processing extensions. For information on applying processing extensions to a report, see the BusinessObjects Enterprise Administrator's Guide.

Specified by:
saveAs in class ClientDocument
Parameters:
displayName - The name of the file. This parameter is required for this version.
parentFolderPath - This parameter specifies a folder where the report is saved. Depending
options - Specifies how the file should be saved. If this value is not included, this method will attempt to save the file in the current version without overwriting existing files. For valid options, see ReportSaveAsOptions.
Throws:
ReportSDKException
java.io.IOException

setLocale

public void setLocale(java.util.Locale locale)
               throws ReportSDKException
Description copied from class: ClientDocument

Sets the locale that is used to localize various aspects of the document.

Note: This method is only used in standalone RAS for Crystal Reports 9.0 or higher, and RAS add-in component for Crystal Enterprise 8.x. When you use RAS in Crystal Enterprise 9.0 or higher (BusinessObjects Enterprise as of version 11), the locale is set when you create a a ReportClientDocument using the IReportAppFactory openDocument method. The locale cannot be set after the ReportClientDocument has been created.

Overrides:
setLocale in class ClientDocument
Parameters:
locale - The Locale object used to localize the document.
Throws:
ReportSDKException

getReportOptions

public IReportOptions getReportOptions()
Description copied from interface: IReportClientDocument

Returns IReportOptions object, which specifies the subreport's behavior and capabilities such a how it should handle server data, dates, queries, printing, viewing, and other such options.

Specified by:
getReportOptions in interface IReportClientDocument
Returns:
A IReportOptions object.

modifyReportOptions

public void modifyReportOptions(IReportOptions reportOptions)
                         throws ReportSDKException

Modifies the report’s behavior and capabilities such as how it should handle server data, dates, queries, printing, viewing, and other such options.

Example:

This sample shows how to set the report options. IReportOptions interface enables you to get and set a number of technical options that apply only to an active report.

 IReportDocument reportDocument = clientDoc.getReportDocument();
 ReportOptions reportOptions = new ReportOptions(reportDocument.getReportOptions());
 reportOptions.setEnableVerifyOnEveryPrint(true);
 clientDoc.modifyReportOptions(reportOptions);
 

Specified by:
modifyReportOptions in interface IReportClientDocument
Parameters:
reportOptions - the IReportOptions object to be modified
Throws:
ReportSDKException

setReportOptions

public void setReportOptions(IReportOptions reportOptions)
                      throws ReportSDKException
Deprecated. As of Version 10, should use modifyReportOptions instead.

Specifies the report options value.

Throws:
ReportSDKException

modifySummaryInfo

public void modifySummaryInfo(ISummaryInfo summaryInfo)
                       throws ReportSDKException

Modifies the report's summary information such as the author's name, comments, keywords, subject, title, and whether or not a preview image is saved.

Parameters:
summaryInfo - the ISummaryInfo object to be modified
Throws:
ReportSDKException

fetchPreviewThumbnail

public IByteArray fetchPreviewThumbnail()
                                 throws ReportSDKException
Throws:
ReportSDKException

getDesignerProperties

public PropertyBag getDesignerProperties(java.lang.String subreportName)
                                  throws ReportSDKException
For internal use only.

Throws:
ReportSDKException

modifyDesignerProperties

public void modifyDesignerProperties(PropertyBag newProperties,
                                     java.lang.String subreportName)
                              throws ReportSDKException
For internal use only.

Throws:
ReportSDKException

setSummaryInfo

public void setSummaryInfo(ISummaryInfo summaryInfo)
                    throws ReportSDKException
Deprecated. As of Version 10, should use modifySummaryInfo instead.

Specifies the summary info value.

Throws:
ReportSDKException

getReportStatistics

public IReportStatistics getReportStatistics()
                                      throws ReportSDKException
Description copied from interface: IReportClientDocument
Retrieves Report Statistics

Specified by:
getReportStatistics in interface IReportClientDocument
Throws:
ReportSDKException

UID

public PropertyBag UID()
                throws ReportSDKException
Description copied from class: ClientDocument

Returns the properties that uniquely identify this ClientDocument object.

Specified by:
UID in class ClientDocument
Returns:
A PropertyBag containing the properties that uniquely identify this ClientDocument object.
Throws:
ReportSDKException

verifyDatabase

public void verifyDatabase()
                    throws ReportSDKException

Checks to ensure that the report is using the most current data scheme from its database. If the scheme of the database on the server have been changed, the report is automatically updated. If a new field has been added to the database on the server, the new field is added to the report but will not be displayed in the report's contents. If a field has been deleted from the database, the field will also be deleted from the report. If the method fails, it throws a ReportSDKException containing the error code.

Specified by:
verifyDatabase in interface IReportClientDocument
Throws:
ReportSDKException - This is thrown if the report fails to be updated from the database. The exception will contain the error code given.

checkDatabaseAndUpdate

public void checkDatabaseAndUpdate()
                            throws ReportSDKException
For internal use only.

Specified by:
checkDatabaseAndUpdate in interface IReportClientDocument
Throws:
ReportSDKException

writeExternal

public void writeExternal(java.io.ObjectOutput out)
                   throws java.io.IOException

Writes the ReportClientDocument's contents to a stream to be read back by the readExternal method.

Specified by:
writeExternal in interface java.io.Externalizable
Parameters:
out - the input object to be written out to the stream
Throws:
java.io.IOException

checkFormula

public FormulaErrors checkFormula(IFormula formula)
                           throws ReportSDKException
Description copied from interface: IReportClientDocument
For internal use only.

Specified by:
checkFormula in interface IReportClientDocument
Throws:
ReportSDKException

checkFormula

public FormulaErrors checkFormula(IFormula formula,
                                  java.lang.String contextObjectName)
                           throws ReportSDKException
Description copied from interface: IReportClientDocument
For internal use only.

Specified by:
checkFormula in interface IReportClientDocument
Throws:
ReportSDKException

checkFormula

public FormulaErrors checkFormula(IFormula formula,
                                  java.lang.String contextObjectName,
                                  java.lang.String containerCrosstabName)
                           throws ReportSDKException
Description copied from interface: IReportClientDocument
For internal use only.

Specified by:
checkFormula in interface IReportClientDocument
Throws:
ReportSDKException

getUnsupportedFeatures

public java.util.List<UnsupportedFeatureType> getUnsupportedFeatures()
                                                              throws ReportSDKException
For internal use only.

Throws:
ReportSDKException

createMember

public java.lang.Object createMember(java.lang.String eleName,
                                     org.xml.sax.Attributes attrs,
                                     XMLSerializationContext ctxt,
                                     java.util.Map objState,
                                     boolean[] bLoaded)
For internal use only.


endElement

public void endElement(java.lang.String eleName,
                       java.util.Map objState)
For internal use only.


readElement

public void readElement(java.lang.String eleName,
                        java.lang.String sVal,
                        org.xml.sax.Attributes attrs,
                        java.util.Map objState)
For internal use only.


save

public void save(XMLWriter writer,
                 XMLSerializationContext ctxt)
          throws java.io.IOException
For internal use only.

Throws:
java.io.IOException

save

public void save(XMLWriter writer,
                 java.lang.String sTag,
                 XMLSerializationContext ctxt)
          throws java.io.IOException
For internal use only.

Throws:
java.io.IOException

saveContents

public void saveContents(XMLWriter writer,
                         XMLSerializationContext ctxt)
                  throws java.io.IOException
For internal use only.

Throws:
java.io.IOException

startElement

public void startElement(java.lang.String eleName,
                         java.util.Map objState,
                         org.xml.sax.Attributes attrs)
For internal use only.


setSavedExportOptions

public void setSavedExportOptions(ReportExportFormat exportFormat,
                                  java.lang.Object exportOptions)
                           throws ReportSDKException

Saves the export options for the report for the specified export format. The supported formats for saved export options are PDF, Microsoft Excel (97-2003) Data-Only, Microsoft Excel (97-2003) (page-based), Separated Values (CSV), Microsoft Word - Editable (RTF), and Text.

Parameters:
exportFormat - the ReportExportFormat object that specifies the export format of a report
exportOptions - the export options of the report for the specified export format
Throws:
ReportSDKException

setSavedExportOptionsEx

public void setSavedExportOptionsEx(java.lang.String exportFormatID,
                                    PropertyBag exportOptions)
                             throws ReportSDKException
Throws:
ReportSDKException

getSavedExportOptionsEx

public PropertyBag getSavedExportOptionsEx(java.lang.String canonicalExportFormatId)
                                    throws ReportSDKException
Parameters:
canonicalExportFormatId -
Returns:
the property bag containing all the export format options for the given export format. If no option is available for the given format, a null value is returned.
Throws:
ReportSDKException

getSavedExportOptions

public java.lang.Object getSavedExportOptions(ReportExportFormat exportFormat)
                                       throws ReportSDKException

Gets the saved export options of the report for the specified export format. The supported formats for saved export options are PDF, Microsoft Excel (97-2003) Data-Only, Microsoft Excel (97-2003) (page-based), Separated Values (CSV), Microsoft Word - Editable (RTF), and Text.

Parameters:
exportFormat - the ReportExportFormat object that specifies the export format of a report
Returns:
The object that specifies the export options.
Throws:
ReportSDKException

getRecordSelectionFormula

public java.lang.String getRecordSelectionFormula()
                                           throws ReportSDKException
Description copied from interface: IReportClientDocument
Retrieves the record selection formula for this report

Specified by:
getRecordSelectionFormula in interface IReportClientDocument
Returns:
The record selection formula as a String
Throws:
ReportSDKException

setRecordSelectionFormula

public void setRecordSelectionFormula(java.lang.String formulaText)
                               throws ReportSDKException
Description copied from interface: IReportClientDocument
Modifies the record selection formula for this report

Specified by:
setRecordSelectionFormula in interface IReportClientDocument
Parameters:
formulaText - The record selection formula for this report.
Throws:
ReportSDKException

cancelProcessing

public void cancelProcessing()
                      throws ReportSDKException
For internal use only.

Throws:
ReportSDKException

getStatusVariables

public PropertyBag getStatusVariables()
                               throws ReportSDKException
For internal use only.

Throws:
ReportSDKException

enableBuiltinControllers

public void enableBuiltinControllers()
For internal use only.


disableBuiltinControllers

public void disableBuiltinControllers()
For internal use only.


getMainReport

public ReportClientDocument getMainReport()
Description copied from interface: IReportClientDocument
For internal use only.

Specified by:
getMainReport in interface IReportClientDocument

getInternal

public java.lang.Object getInternal(java.lang.Class internal)
For internal use only.

Parameters:
internal - the internal class
Returns:
an internal object

getInternal

public java.lang.Object getInternal(java.lang.String name,
                                    java.lang.Class internal)
For internal use only.

Parameters:
name - the document name
internal - the internal class
Returns:
an internal object

logOnRepository

public void logOnRepository(java.lang.String repositorySessionString)
                     throws ReportSDKException
For internal use only.

Throws:
ReportSDKException

logOffRepository

public void logOffRepository()
                      throws ReportSDKException
For internal use only.

Throws:
ReportSDKException

getAvailableExportFormats

public PropertyBag getAvailableExportFormats(java.lang.String languageCode,
                                             boolean includePropertyInformation)
                                      throws ReportSDKException
For internal use only.

Throws:
ReportSDKException