com.crystaldecisions.sdk.occa.report.data
Class DataDefinition

java.lang.Object
  extended by com.crystaldecisions.sdk.occa.report.data.DataDefinition
All Implemented Interfaces:
IDataDefinition, IClone

public class DataDefinition
extends java.lang.Object
implements IDataDefinition, IClone

This object contains the DataDefinition. The DataDefinition contains all the fields and groups in the report. This is used to define the structure of the data that is being retrieved from the database. In order to modify any part of the report's data definition, you must access the DataDefinition object through the DataDefController object. If you want to access the DataDefinition only to read it, you can also use the ReportClientDocument object. When possible, use the IDataDefinition interface to manipulate this object.


Constructor Summary
DataDefinition()
           
DataDefinition(IDataDefinition src)
           
 
Method Summary
 void adjustGroupIndex()
          For internal use only.
 java.lang.Object clone(boolean deepClone)
           
 void copyTo(java.lang.Object destObject, boolean deepCopy)
           
 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.
 void doControllerModification(java.lang.Object newObject)
          For internal use only.
 void endElement(java.lang.String eleName, java.util.Map objState)
          For internal use only.
 void enumerateMembers(IMemberVisitor visitor)
          For internal use only.
 Alerts getAlerts()
          For internal use only.
 ControllableMixin getControllableMixin()
          For internal use only.
 CustomFunctions getCustomFunctions()
           Returns a collection of the custom functions contained in a report.
 Fields<IFormulaField> getFormulaFields()
           Returns an object that contains a list of all the formula fields in the report.
 IFilter getGroupFilter()
           Returns the filter that indicates how groups are filtered in the report.
 Groups getGroups()
           Returns an object that indicates how data is grouped in the report.
 Fields<IParameterField> getParameterFields()
           Returns an object that contains the parameters in the report.
 IFilter getRecordFilter()
           Returns the filter that determines which records should be retrieved from the database when data is retrieved.
 Sorts getRecordSorts()
          Returns an object that indicates how records are sorted once they are retrieved from the database.
 Fields<IField> getResultFields()
           Returns an object that contains the result fields in the report.
 Fields<IRunningTotalField> getRunningTotalFields()
           For internal use only.
 IFilter getSavedDataFilter()
           Returns the filter that allows users to view a subset of the data saved in a report.
 Sorts getSorts()
           Returns an object that indicates how records are sorted once they are retrieved from the database.
 SummaryFields<ISummaryField> getSummaryFields()
           Returns an object that contains a list of the summaries in the report.
 IFilter getViewTimeFilter()
           Returns the report filter that can be applied when viewing.
 boolean hasContent(java.lang.Object srcDataDefinition)
           
 boolean isDirectlyControllable()
          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 rebuildSortCollection()
          For internal use only.
 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 saveContents(XMLWriter writer, XMLSerializationContext ctxt)
          For internal use only.
 void setAlerts(Alerts alerts)
          For internal use only.
 void setFormulaFields(Fields<IFormulaField> formulaFields)
           Sets an object that contains a list of all the formula fields in the report.
 void setGroupFilter(IFilter groupFilter)
           Sets the filter that indicates how groups are filtered in the report.
 void setGroups(Groups groups)
           Sets an object that indicates how data is grouped in the report.
 void setParameterFields(Fields<IParameterField> parameterFields)
           Sets an object that contains the parameters in the report.
 void setRecordFilter(IFilter recordFilter)
           Sets the filter that determines which records should be retrieved from the database when data is retrieved.
 void setRecordSorts(Sorts sorts)
          Sets an object that indicates how records are sorted once they are retrieved from the database.
 void setResultFields(Fields<IField> resultFields)
           Sets an object that contains the result fields in the report.
 void setRunningTotalFields(Fields<IRunningTotalField> runningTotalFields)
           For internal use only.
 void setSavedDataFilter(IFilter savedDataFilter)
           Sets a filter that allows users to view a subset of the data saved in a report.
 void setSorts(Sorts sorts)
           Sets an object that indicates how records are sorted once they are retrieved from the database.
 void startElement(java.lang.String eleName, java.util.Map objState, org.xml.sax.Attributes attrs)
          For internal use only.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

DataDefinition

public DataDefinition(IDataDefinition src)

DataDefinition

public DataDefinition()
Method Detail

clone

public java.lang.Object clone(boolean deepClone)

copyTo

public void copyTo(java.lang.Object destObject,
                   boolean deepCopy)

adjustGroupIndex

public void adjustGroupIndex()
For internal use only.


rebuildSortCollection

public void rebuildSortCollection()
For internal use only.


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.


getFormulaFields

public Fields<IFormulaField> getFormulaFields()
Description copied from interface: IDataDefinition

Returns an object that contains a list of all the formula fields in the report. The formula fields that are included in this list are not necessarily placed on the report. That is, you may not see their values when the report is refreshed. To see whether a formula field has been placed on the report, use the IDataDefinition.getResultFields() method.

Specified by:
getFormulaFields in interface IDataDefinition
Returns:
The Fields object.

getGroupFilter

public IFilter getGroupFilter()
Description copied from interface: IDataDefinition

Returns the filter that indicates how groups are filtered in the report.

Specified by:
getGroupFilter in interface IDataDefinition
Returns:
The group filter as an IFilter object.

getGroups

public Groups getGroups()
Description copied from interface: IDataDefinition

Returns an object that indicates how data is grouped in the report. This object contains all the groups in a report.

Specified by:
getGroups in interface IDataDefinition
Returns:
The Groups object.

getParameterFields

public Fields<IParameterField> getParameterFields()
Description copied from interface: IDataDefinition

Returns an object that contains the parameters in the report.

Specified by:
getParameterFields in interface IDataDefinition
Returns:
The Fields object.

getSavedDataFilter

public IFilter getSavedDataFilter()
Description copied from interface: IDataDefinition

Returns the filter that allows users to view a subset of the data saved in a report. Changing the SavedDataFilter will not discard the data saved in a report or result in a database hit.

Specified by:
getSavedDataFilter in interface IDataDefinition
Returns:
The saved data filter as an IFilter object.
See Also:
getSavedDataFilterController

getRunningTotalFields

public Fields<IRunningTotalField> getRunningTotalFields()
Description copied from interface: IDataDefinition

For internal use only.

Specified by:
getRunningTotalFields in interface IDataDefinition

getCustomFunctions

public CustomFunctions getCustomFunctions()
Description copied from interface: IDataDefinition

Returns a collection of the custom functions contained in a report. Custom functions must be added to the report using Crystal Reports. For information on how to do this, see the Crystal Reports online help.

Specified by:
getCustomFunctions in interface IDataDefinition
Returns:
A CustomFunctions object containing a collection of custom functions.

getRecordFilter

public IFilter getRecordFilter()
Description copied from interface: IDataDefinition

Returns the filter that determines which records should be retrieved from the database when data is retrieved.

Specified by:
getRecordFilter in interface IDataDefinition
Returns:
The filter as an IFilter object.

getAlerts

public Alerts getAlerts()
Description copied from interface: IDataDefinition
For internal use only.

Specified by:
getAlerts in interface IDataDefinition

getResultFields

public Fields<IField> getResultFields()
Description copied from interface: IDataDefinition

Returns an object that contains the result fields in the report.

Specified by:
getResultFields in interface IDataDefinition
Returns:
The Fields object.

getSorts

public Sorts getSorts()
Description copied from interface: IDataDefinition

Returns an object that indicates how records are sorted once they are retrieved from the database.

Specified by:
getSorts in interface IDataDefinition
Returns:
The Sorts object.

getRecordSorts

public Sorts getRecordSorts()
Description copied from interface: IDataDefinition
Returns an object that indicates how records are sorted once they are retrieved from the database. For group sorts, see IGroup.getSort().

Specified by:
getRecordSorts in interface IDataDefinition
Returns:
The Sorts object.
See Also:
RecordSortController

getSummaryFields

public SummaryFields<ISummaryField> getSummaryFields()
Description copied from interface: IDataDefinition

Returns an object that contains a list of the summaries in the report.

Specified by:
getSummaryFields in interface IDataDefinition
Returns:
The Fields object.

hasContent

public boolean hasContent(java.lang.Object srcDataDefinition)

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

setFormulaFields

public void setFormulaFields(Fields<IFormulaField> formulaFields)
Description copied from interface: IDataDefinition

Sets an object that contains a list of all the formula fields in the report. The formula fields that are included in this list are not necessarily placed on the report. That is, you may not see their values when the report is refreshed. To see whether a formula field has been placed on the report, use the IDataDefinition.getResultFields() method.

Specified by:
setFormulaFields in interface IDataDefinition
Parameters:
formulaFields - Returns the Fields object.

setGroupFilter

public void setGroupFilter(IFilter groupFilter)
Description copied from interface: IDataDefinition

Sets the filter that indicates how groups are filtered in the report.

Specified by:
setGroupFilter in interface IDataDefinition
Parameters:
groupFilter - The group filter as an IFilter object.

setSavedDataFilter

public void setSavedDataFilter(IFilter savedDataFilter)
Description copied from interface: IDataDefinition

Sets a filter that allows users to view a subset of the data saved in a report. Changing the SavedDataFilter will not discard the data saved in a report or result in a database hit.

Specified by:
setSavedDataFilter in interface IDataDefinition
Parameters:
savedDataFilter - The saved data filter as an IFilter object.

setGroups

public void setGroups(Groups groups)
Description copied from interface: IDataDefinition

Sets an object that indicates how data is grouped in the report. This object contains all the groups in a report.

Specified by:
setGroups in interface IDataDefinition
Parameters:
groups - The Groups object.

setParameterFields

public void setParameterFields(Fields<IParameterField> parameterFields)
Description copied from interface: IDataDefinition

Sets an object that contains the parameters in the report.

Specified by:
setParameterFields in interface IDataDefinition
Parameters:
parameterFields - The Fields object.

setRunningTotalFields

public void setRunningTotalFields(Fields<IRunningTotalField> runningTotalFields)
Description copied from interface: IDataDefinition

For internal use only.

Specified by:
setRunningTotalFields in interface IDataDefinition

setAlerts

public void setAlerts(Alerts alerts)
For internal use only.


setRecordFilter

public void setRecordFilter(IFilter recordFilter)
Description copied from interface: IDataDefinition

Sets the filter that determines which records should be retrieved from the database when data is retrieved.

Specified by:
setRecordFilter in interface IDataDefinition
Parameters:
recordFilter - The filter as an IFilter object.

setResultFields

public void setResultFields(Fields<IField> resultFields)
Description copied from interface: IDataDefinition

Sets an object that contains the result fields in the report.

Specified by:
setResultFields in interface IDataDefinition
Parameters:
resultFields - The Fields object.

setSorts

public void setSorts(Sorts sorts)
Description copied from interface: IDataDefinition

Sets an object that indicates how records are sorted once they are retrieved from the database.

Specified by:
setSorts in interface IDataDefinition
Parameters:
sorts - The Sorts object.

setRecordSorts

public void setRecordSorts(Sorts sorts)
Description copied from interface: IDataDefinition
Sets an object that indicates how records are sorted once they are retrieved from the database. To set group sorts, see IGroup.setSort(com.crystaldecisions.sdk.occa.report.data.ISort).

Specified by:
setRecordSorts in interface IDataDefinition
Parameters:
sorts - The Sorts object.
See Also:
RecordSortController

startElement

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


getControllableMixin

public ControllableMixin getControllableMixin()
For internal use only.


doControllerModification

public void doControllerModification(java.lang.Object newObject)
                              throws ReportSDKException
For internal use only.

Throws:
ReportSDKException

isDirectlyControllable

public boolean isDirectlyControllable()
For internal use only.


enumerateMembers

public void enumerateMembers(IMemberVisitor visitor)
For internal use only.


getViewTimeFilter

public IFilter getViewTimeFilter()
Description copied from interface: IDataDefinition

Returns the report filter that can be applied when viewing.

Specified by:
getViewTimeFilter in interface IDataDefinition
Returns:
The view time filter as an IFilter object.