*** This class is subject to change ***

com.sas.iquery.metadata.business.step.olap
Class DataItemNavigationFilter

java.lang.Object
  |
  +--com.sas.iquery.metadata.impl.IQModelImplUtilities
        |
        +--com.sas.iquery.metadata.business.impl.AbstractBase
              |
              +--com.sas.iquery.metadata.business.impl.AbstractModelItem
                    |
                    +--com.sas.iquery.metadata.business.step.olap.BaseFilter
                          |
                          +--com.sas.iquery.metadata.business.step.olap.DataItemNavigationFilter

All Implemented Interfaces:

Base, BusinessModelResourceReferencer, ModelItem, PropertyChangeListenee, StepFilterInterface, StepInterface, UsabilityInterface

public class DataItemNavigationFilter

extends BaseFilter

A step that filters a data item based on a specific kind of navigation on a particular member. There are a few types of navigation filters, each of which returns a different set of members. In order to navigate through the data, a hierarchy filter must be defined, or a hierarchy will need to be specified as part of this filter.

See Also:

StepFilterInterface, BaseFilter

Field Summary

static int	ANCESTORS_NAVIGATION_FILTER_TYPE This navigation filter type returns the ancestors of the member
static int	CHILDREN_NAVIGATION_FILTER_TYPE This navigation filter type returns the children of the member
static int	DESCENDANTS_NAVIGATION_FILTER_TYPE This navigation filter type returns the descendants of the member
static String	EVENT_LEVEL_NAME_CHANGED Indication that level name has been changed.
static String	EVENT_NAVIGATION_FILTER_TYPE_CHANGED Indication that navigation filter type has been changed.
static String	EVENT_NAVIGATION_MEMBER_NAME_CHANGED Indication that navigation member name has been changed.
static int	LEAVES_NAVIGATION_FILTER_TYPE This navigation filter type returns the leaves of the member
static int	LEVEL_NAVIGATION_FILTER_TYPE This navigation filter type returns the members of a specified level on the branch that contains the member
static int	PARENT_LEVEL_NAVIGATION_FILTER_TYPE This navigation filter type returns the members of the parent level
static int	PARENT_NAVIGATION_FILTER_TYPE This navigation filter type returns the parent of the member
static int	ROOTS_NAVIGATION_FILTER_TYPE This navigation filter type returns the roots of the member
static int	SIBLINGS_NAVIGATION_FILTER_TYPE This navigation filter type returns the siblings of the member

Fields inherited from class com.sas.iquery.metadata.business.step.olap.BaseFilter

EVENT_ACTION_TYPE_CHANGED

Fields inherited from interface com.sas.iquery.metadata.business.step.StepFilterInterface

APPEND_ACTION_TYPE, DIFFERENCE_ACTION_TYPE, INITIAL_ACTION_TYPE, INSERT_ACTION_TYPE, INTERSECT_ACTION_TYPE, PREPEND_ACTION_TYPE, SPECIAL_ACTION_TYPE, UNION_ACTION_TYPE

Fields inherited from interface com.sas.iquery.metadata.business.Base

EVENT_OBJECT_DEFINITION_CHANGED

Fields inherited from interface com.sas.iquery.metadata.business.ModelItem

EVENT_OBJECT_PROPERTY_CHANGED

Constructor Summary

DataItemNavigationFilter()
Constructor for persistence use only -- do not use

DataItemNavigationFilter(int navigationFilterType, String navigationName)
This constructor defines a step to create a MDX string that will navigate a cube.

DataItemNavigationFilter(int navigationFilterType, String navigationName, String levelName)
This constructor defines a step to create a MDX string that will navigate a cube.

Method Summary

String	getLevelName() This method returns the name of the level to be used when navigating to a particular branch of a Level.
int	getNavigationFilterType() This method returns the type of navigation filter that is used.
String	getNavigationName() This method returns the name of the member or hierarchy unique level name to be used for filtering.
void	setLevelName(String levelName) This method defines the name of the level to be used when navigating to a particular branch of a Level.
void	setNavigationFilterType(int type) This method defines the type of navigation filter to be applied.
void	setNavigationMemberName(String navigationName) This method defines the name of the member to use for filtering.

Methods inherited from class com.sas.iquery.metadata.business.step.olap.BaseFilter

getActionType, setActionType

Methods inherited from class com.sas.iquery.metadata.business.impl.AbstractBase

accumulateDirectlyReferencedModelsInDownwardDefinition, getDirectlyReferencedBaseObjectsInDownwardDefinition, hasCycleInDownwardDefinition

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.sas.iquery.metadata.business.BusinessModelResourceReferencer

getResources

Methods inherited from interface java.beans.PropertyChangeListener

propertyChange

Methods inherited from interface com.sas.iquery.metadata.PropertyChangeListenee

addListener, getListeners, removeListener

Methods inherited from interface com.sas.iquery.metadata.business.UsabilityInterface

getReasonsUnusable, isUsableInQuery

Field Detail

EVENT_LEVEL_NAME_CHANGED

public static final String EVENT_LEVEL_NAME_CHANGED

Indication that level name has been changed.

EVENT_NAVIGATION_FILTER_TYPE_CHANGED

public static final String EVENT_NAVIGATION_FILTER_TYPE_CHANGED

Indication that navigation filter type has been changed.

EVENT_NAVIGATION_MEMBER_NAME_CHANGED

public static final String EVENT_NAVIGATION_MEMBER_NAME_CHANGED

Indication that navigation member name has been changed.

PARENT_NAVIGATION_FILTER_TYPE

public static final int PARENT_NAVIGATION_FILTER_TYPE

This navigation filter type returns the parent of the member

ANCESTORS_NAVIGATION_FILTER_TYPE

public static final int ANCESTORS_NAVIGATION_FILTER_TYPE

This navigation filter type returns the ancestors of the member

DESCENDANTS_NAVIGATION_FILTER_TYPE

public static final int DESCENDANTS_NAVIGATION_FILTER_TYPE

This navigation filter type returns the descendants of the member

SIBLINGS_NAVIGATION_FILTER_TYPE

public static final int SIBLINGS_NAVIGATION_FILTER_TYPE

This navigation filter type returns the siblings of the member

CHILDREN_NAVIGATION_FILTER_TYPE

public static final int CHILDREN_NAVIGATION_FILTER_TYPE

This navigation filter type returns the children of the member

ROOTS_NAVIGATION_FILTER_TYPE

public static final int ROOTS_NAVIGATION_FILTER_TYPE

This navigation filter type returns the roots of the member

LEAVES_NAVIGATION_FILTER_TYPE

public static final int LEAVES_NAVIGATION_FILTER_TYPE

This navigation filter type returns the leaves of the member

LEVEL_NAVIGATION_FILTER_TYPE

public static final int LEVEL_NAVIGATION_FILTER_TYPE

This navigation filter type returns the members of a specified level on the branch that contains the member

PARENT_LEVEL_NAVIGATION_FILTER_TYPE

public static final int PARENT_LEVEL_NAVIGATION_FILTER_TYPE

This navigation filter type returns the members of the parent level

Constructor Detail

DataItemNavigationFilter

public DataItemNavigationFilter()

Constructor for persistence use only -- do not use

DataItemNavigationFilter

public DataItemNavigationFilter(int navigationFilterType,
                                String navigationName)

This constructor defines a step to create a MDX string that will navigate a cube.

Parameters:

navigationFilterType - The actionType defining how navigation will be defined.

navigationName - Defines either a tuple element name or a hierarchy unique level name such as [TIME].[QUARTER]

DataItemNavigationFilter

public DataItemNavigationFilter(int navigationFilterType,
                                String navigationName,
                                String levelName)

This constructor defines a step to create a MDX string that will navigate a cube.

Parameters:

navigationFilterType - The actionType defining how navigation will be defined.

navigationName - Defines r a hierarchy unique name such as [TIME]

levelName - Defines hierarchy level name such as [QUARTER]

Method Detail

setNavigationFilterType

public void setNavigationFilterType(int type)

This method defines the type of navigation filter to be applied.

Parameters:

type - The type of navigation filter to be applied

getNavigationFilterType

public int getNavigationFilterType()

This method returns the type of navigation filter that is used.

Returns:

The type of navigation filter

setNavigationMemberName

public void setNavigationMemberName(String navigationName)

This method defines the name of the member to use for filtering.

Parameters:

navigationName - The name of the member to be used for filtering

getNavigationName

public String getNavigationName()

This method returns the name of the member or hierarchy unique level name to be used for filtering.

Returns:

The name of the member or hierarchy unique level name

setLevelName

public void setLevelName(String levelName)

This method defines the name of the level to be used when navigating to a particular branch of a Level. This only applies when the NavigationFilter type is set to LEVEL_NAVIGATION_FILTER_TYPE.

Parameters:

levelName - The name of the level to be used when navigating to a particular branch of a Level.

getLevelName

public String getLevelName()

This method returns the name of the level to be used when navigating to a particular branch of a Level. This only applies when the NavigationFilter type is set to LEVEL_NAVIGATION_FILTER_TYPE.

Returns:

The name of the level to be used when navigating to a particular branch of a Level.

*** This class is subject to change ***