com.crystaldecisions.sdk.occa.report.data
Interface IDataDefinition

All Superinterfaces:
IClone
All Known Implementing Classes:
DataDefinition

public interface IDataDefinition
extends IClone

This interface provides access the document's 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.

The following table shows the differences in behavior associated with the different report filters:

Record Filter Saved Data Filter Group Filter
Can refer to the summary? No. Yes. Yes.
When is the formula evaluated? While reading records./td> If a summary is used, at print time; otherwise, while reading records. At print time.
When is the report refreshed? If the evaluation result is false, when records are dropped. If records are being read, when evaluated. If the evaluation result is false, when records are dropped. N/A
Affects summary calculation? Yes, records that are filtered out are not counted. If the filter is evaluated while reading records, then no; otherwise, yes. No, records are counted even when they are filtered out.


Method Summary
 Alerts getAlerts()
          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()
          Deprecated. please use getRecordSorts() for record sorts, and IGroup.getSort() for group sorts.
 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.
 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)
          Deprecated. please use setRecordSorts(com.crystaldecisions.sdk.occa.report.data.Sorts) for record sorts, and IGroup.setSort(com.crystaldecisions.sdk.occa.report.data.ISort) for group sorts.
 

Method Detail

getFormulaFields

Fields<IFormulaField> getFormulaFields()

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 getResultFields() method.

Returns:
The Fields object.

getGroupFilter

IFilter getGroupFilter()

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

Returns:
The group filter as an IFilter object.

getGroups

Groups getGroups()

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

Returns:
The Groups object.

getParameterFields

Fields<IParameterField> getParameterFields()

Returns an object that contains the parameters in the report.

Returns:
The Fields object.

getSavedDataFilter

IFilter getSavedDataFilter()

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.

Returns:
The saved data filter as an IFilter object.
See Also:
getSavedDataFilterController

getRecordFilter

IFilter getRecordFilter()

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

Returns:
The filter as an IFilter object.

getResultFields

Fields<IField> getResultFields()

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

Returns:
The Fields object.

getSorts

Sorts getSorts()
Deprecated. please use getRecordSorts() for record sorts, and IGroup.getSort() for group sorts.

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

Returns:
The Sorts object.

getRecordSorts

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

Returns:
The Sorts object.
See Also:
RecordSortController

getSummaryFields

SummaryFields<ISummaryField> getSummaryFields()

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

Returns:
The Fields object.

setFormulaFields

void setFormulaFields(Fields<IFormulaField> formulaFields)

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 getResultFields() method.

Parameters:
formulaFields - Returns the Fields object.

setGroupFilter

void setGroupFilter(IFilter groupFilter)

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

Parameters:
groupFilter - The group filter as an IFilter object.

setGroups

void setGroups(Groups groups)

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

Parameters:
groups - The Groups object.

setParameterFields

void setParameterFields(Fields<IParameterField> parameterFields)

Sets an object that contains the parameters in the report.

Parameters:
parameterFields - The Fields object.

setSavedDataFilter

void setSavedDataFilter(IFilter savedDataFilter)

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.

Parameters:
savedDataFilter - The saved data filter as an IFilter object.

setRecordFilter

void setRecordFilter(IFilter recordFilter)

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

Parameters:
recordFilter - The filter as an IFilter object.

setResultFields

void setResultFields(Fields<IField> resultFields)

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

Parameters:
resultFields - The Fields object.

setSorts

void setSorts(Sorts sorts)
Deprecated. please use setRecordSorts(com.crystaldecisions.sdk.occa.report.data.Sorts) for record sorts, and IGroup.setSort(com.crystaldecisions.sdk.occa.report.data.ISort) for group sorts.

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

Parameters:
sorts - The Sorts object.

setRecordSorts

void setRecordSorts(Sorts sorts)
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).

Parameters:
sorts - The Sorts object.
See Also:
RecordSortController

getRunningTotalFields

Fields<IRunningTotalField> getRunningTotalFields()

For internal use only.


setRunningTotalFields

void setRunningTotalFields(Fields<IRunningTotalField> runningTotalFields)

For internal use only.


getCustomFunctions

CustomFunctions getCustomFunctions()

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.

Returns:
A CustomFunctions object containing a collection of custom functions.

getAlerts

Alerts getAlerts()
For internal use only.


getViewTimeFilter

IFilter getViewTimeFilter()

Returns the report filter that can be applied when viewing.

Returns:
The view time filter as an IFilter object.