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

All Superinterfaces:
IClone, ISort
All Known Implementing Classes:
TopNSort

public interface ITopNSort
extends ISort

This interface defines a Top N sort order. If a group contains a summary, it is possible for the group to be Top N sorted. This sorts the groups according to the group summary that was inserted. Data is grouped according to the group name for the first N groups. The groups that are not included in the Top N are either discarded or grouped under a specified name.


Method Summary
 TopNConditionFormulas getConditionFormulas()
           Returns the conditional formulas that override the sort values for the default Top N sort order.
 boolean getDiscardOthers()
           Returns what should be done with records that do not fall into the Top N group.
 int getNIndividualGroups()
           Returns the number of groups that should be in the Top N.
 java.lang.String getNotInTopBottomName()
           Returns the name used to group records that are not a part of the Top N group.
 double getPercentageValue()
           Returns the percentage of top or bottom values.
 boolean getWithTies()
           Returns whether ties are included when sorting top or bottom groups.
 void setConditionFormulas(TopNConditionFormulas formulas)
           Sets the condition formulas that override the sort values for the default Top N sort order.
 void setDiscardOthers(boolean discardOthers)
           Sets what should be done with records that do not fall into the Top N group.
 void setNIndividualGroups(int nIndividualGroups)
           Sets the number of groups that should be in the Top N.
 void setNotInTopBottomName(java.lang.String notInTopBottomName)
           Sets the name used to group records that are not a part of the Top N group.
 void setPercentageValue(double percentageValue)
           
 void setWithTies(boolean withTies)
           Sets whether ties are included when sorting top or bottom groups.
 
Methods inherited from interface com.crystaldecisions.sdk.occa.report.data.ISort
getDirection, getSortField, setDirection, setSortField
 

Method Detail

getDiscardOthers

boolean getDiscardOthers()

Returns what should be done with records that do not fall into the Top N group. If this value is true, records that are not a part of the Top N are discarded. If this is false, the records that are not in the Top N are grouped under the name specified in setNotInTopBottomName method.

Returns:
true if records that are not part of the Top N are discarded, and false otherwise.

getNIndividualGroups

int getNIndividualGroups()

Returns the number of groups that should be in the Top N.

Returns:
An int that specifies the number of groups that should be in the Top N.

getPercentageValue

double getPercentageValue()

Returns the percentage of top or bottom values.

Returns:
An double that specifies the percentage of top or bottom values.

getNotInTopBottomName

java.lang.String getNotInTopBottomName()

Returns the name used to group records that are not a part of the Top N group. This property is used only when the getDiscardOthers() method returns false.

Returns:
A String containing the name used to group records that are not a part of the Top N group.

setDiscardOthers

void setDiscardOthers(boolean discardOthers)

Sets what should be done with records that do not fall into the Top N group. If this value is true, records that are not a part of the Top N are discarded. If this is false, the records that are not in the Top N are grouped under the name specified in setNotInTopBottomName method.

Parameters:
discardOthers - true if records that are not part of the Top N are discarded, and false otherwise.

setNIndividualGroups

void setNIndividualGroups(int nIndividualGroups)

Sets the number of groups that should be in the Top N.

Parameters:
nIndividualGroups - An int that specifies the number of groups that should be in the Top N.

setPercentageValue

void setPercentageValue(double percentageValue)

setNotInTopBottomName

void setNotInTopBottomName(java.lang.String notInTopBottomName)

Sets the name used to group records that are not a part of the Top N group. This property is used only when the getDiscardOthers() method returns false.

Parameters:
notInTopBottomName - A String containing the name used to group records that are not a part of the Top N group.

getConditionFormulas

TopNConditionFormulas getConditionFormulas()

Returns the conditional formulas that override the sort values for the default Top N sort order.

Returns:
A TopNConditionFormulas object containing the condition formulas that override the sort values for the default Top N sort order.

setConditionFormulas

void setConditionFormulas(TopNConditionFormulas formulas)

Sets the condition formulas that override the sort values for the default Top N sort order.

Parameters:
formulas - A TopNConditionFormulas object containing the condition formulas that override the sort values for the default Top N sort order.

getWithTies

boolean getWithTies()

Returns whether ties are included when sorting top or bottom groups. If this value is true, groups whose summarized values are equal will be accommodated.

Returns:
true if ties are included when sorting top or bottom groups, and false otherwise.

setWithTies

void setWithTies(boolean withTies)

Sets whether ties are included when sorting top or bottom groups. If this value is true, groups whose summarized values are equal will be accommodated.

Parameters:
withTies - true if ties are included when sorting top or bottom groups, and false otherwise.