Package com.microstrategy.web.objects.rw
Interface RWGridGraphDef
- 
- All Superinterfaces:
 RWTransactable,RWUnitDef,WebThresholdsContainer
public interface RWGridGraphDef extends RWUnitDef, RWTransactable
Represents a view definition object (Grid or Graph).- Since:
 - MicroStrategy Web 8.0.0
 
 
- 
- 
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description voidaddAssociatedNodes(java.util.Set<java.lang.String> nodeKeys, int manipulationCategory)RWControladdControl(java.lang.String controlKey, int templateAxis, int templatePosition)Adds control to template unitRWControladdControl(java.lang.String controlKey, java.lang.String tuObjectId, int tuObjectType)Adds control to template unitWebTemplateMetricaddUserMetric(RWUserMetric userMetric)Adds the user derived metric to the view defintion.WebTemplateMetricaddUserMetric(RWUserMetric userMetric, int beforeKey)Adds the user derived metric to the view defintion.java.util.Set<java.lang.String>getAssociatedNodes(int manipulationCategory)Returns associated nodes for the specified manipulationCategory.RWControlgetControl(java.lang.String tuObjectId, int tuObjectType)Returns control for specified template unitjava.lang.StringgetControlKeysWithTopMost()get the keys of controls that are set to auto pick top most.java.util.ListgetControls()intgetCurrentSliceID()Get current grid's slice ID.RWDataSetgetDataSet()Returns the data set this object is based onRWDataSetgetDefaultDataSet()Returns the default dataset of RW definition, seeRWDataSets.getDefault().intgetDisplayMode()Returns the view mode fromEnumDSSXMLDisplayMode.RWDataSetgetEffectiveDataSet()Returns either Joined data set or data set this object is based onRWGridIfSettingsgetIfSettings()WebFiltergetViewFilter()Returns the view filter that is applied to the grid object within the RW document.WebViewInstancegetViewInstance()Returns a view instance representing grid/graph definitionWebExpressiongetViewLimits()WebVisualizationSettingsgetVisualizationSettings()Returns Visualization settingsbooleanhasControls()voiditerateDIC(RWDICVisitor visitor)voidremoveAssociatedNodes(java.util.Set<java.lang.String> nodeKeys, int manipulationCategory)voidremoveControl(java.lang.String ctlKey)Removes control by its keyvoidremoveControl(java.lang.String tuObjectId, int tuObjectType)Removes control from specified template unitvoidremovePlaceHolderTargets(java.util.Set<java.lang.Integer> phRemoves)Remove placeholders that has been targeted to a selectorvoidsetCurrentSliceID(int sliceID)Set current grid's slice ID, which will be used when rendering.voidsetDataSet(RWDataSet value)Connects this object to a data setvoidsetDataSet(java.lang.String id)Connects this object to a data setvoidsetDisplayMode(int displayMode)Sets the report view mode (EnumDSSXMLDisplayMode) By default, the view mode was set to the gride mode.- 
Methods inherited from interface com.microstrategy.web.objects.rw.RWTransactable
getAutomaticTransactionRecordNumber, getOfflineTransaction, getTransactionChangeType, getTransactionElement, setTransactionChangeType, setTransactionElement 
- 
Methods inherited from interface com.microstrategy.web.objects.rw.RWUnitDef
copyFormat, flushFormatChanges, getAllControlGroupBys, getElementControlGroupBys, getFilterDetailsFormatting, getFormat, getFormat, getFormat, getFormatTypes, getKey, getKeyContext, getName, getParent, getRwDefinition, getTheme, getThreshold, getThreshold, getThresholdCount, getTreeType, getType, isFirst, isLast, isVisible, nextSibling, prevSibling, revertToFormatDefaults, setName, setVisible 
- 
Methods inherited from interface com.microstrategy.web.objects.WebThresholdsContainer
getID, getObjectType, getThresholds, getTransactions, initElementSource 
 - 
 
 - 
 
- 
- 
Method Detail
- 
getDataSet
RWDataSet getDataSet()
Returns the data set this object is based on- Returns:
 - the data set this grid/graph is based on
 
 
- 
getEffectiveDataSet
RWDataSet getEffectiveDataSet()
Returns either Joined data set or data set this object is based on- Returns:
 - either Joined data set or data set this object is based on
 
 
- 
setDataSet
void setDataSet(java.lang.String id)
Connects this object to a data set- Parameters:
 id- data set ID
 
- 
setDataSet
void setDataSet(RWDataSet value)
Connects this object to a data set- Parameters:
 value- data set
 
- 
getViewInstance
WebViewInstance getViewInstance()
Returns a view instance representing grid/graph definition- Returns:
 - a view instance representing grid/graph definition
 
 
- 
getDisplayMode
int getDisplayMode()
Returns the view mode fromEnumDSSXMLDisplayMode. By default, the view mode is set to the grid mode.- Returns:
 - the report view mode.
 
 
- 
setDisplayMode
void setDisplayMode(int displayMode)
Sets the report view mode (EnumDSSXMLDisplayMode) By default, the view mode was set to the gride mode.- Parameters:
 displayMode- a new report view mode.
 
- 
addUserMetric
WebTemplateMetric addUserMetric(RWUserMetric userMetric, int beforeKey) throws java.lang.IllegalArgumentException, WebObjectsException
Adds the user derived metric to the view defintion. Note that this would change the TemplateMetrics collection for the view instance corresponding to this definition object.- Parameters:
 userMetric- the user metric to add. The user metric should be present on the dataset object associate with the definition.- Returns:
 - the template metric corresponding to the user metric added.
 - Throws:
 java.lang.IllegalArgumentException- if the user metric is not in the dataset.WebObjectsException
 
- 
addUserMetric
WebTemplateMetric addUserMetric(RWUserMetric userMetric) throws java.lang.IllegalArgumentException, WebObjectsException
Adds the user derived metric to the view defintion. Note that this would change the TemplateMetrics collection for the view instance corresponding to this definition object. The metric would be added at the end of the template metrics collection.- Parameters:
 userMetric- the user metric to add. The user metric should be present on the dataset object associate with the definition.- Returns:
 - the template metric corresponding to the user metric added.
 - Throws:
 java.lang.IllegalArgumentException- if the user metric is not in the dataset.WebObjectsException
 
- 
getViewFilter
WebFilter getViewFilter()
Returns the view filter that is applied to the grid object within the RW document. This filter can be edited to change the filter that is on the grid. In order to apply any filter changes, the applyChanges method on theRWManipulationinterface must be called.- Returns:
 - A 
WebFilterobject, that represents the view filter of the grid/graph def. - Since:
 - MicroStrategy Web 8.0.1
 
 
- 
getVisualizationSettings
WebVisualizationSettings getVisualizationSettings() throws WebObjectsException
Returns Visualization settings- Returns:
 - Visualization settings
 - Throws:
 WebObjectsException- Since:
 - MicroStrategy Web 8.0.2
 
 
- 
addControl
RWControl addControl(java.lang.String controlKey, int templateAxis, int templatePosition) throws WebObjectsException
Adds control to template unit- Parameters:
 controlKey- control keytemplateAxis- template axistemplatePosition- template unit position on the axis- Returns:
 - RWControl control
 - Throws:
 WebObjectsException- Since:
 - MicroStrategy Web 8.1.0
 
 
- 
addControl
RWControl addControl(java.lang.String controlKey, java.lang.String tuObjectId, int tuObjectType) throws WebObjectsException
Adds control to template unit- Parameters:
 controlKey- control keytuObjectId- template unit object IDtuObjectType- template unit object type- Returns:
 - RWControl control
 - Throws:
 WebObjectsException- Since:
 - MicroStrategy Web 8.1.0
 
 
- 
getControl
RWControl getControl(java.lang.String tuObjectId, int tuObjectType)
Returns control for specified template unit- Parameters:
 tuObjectId- template unit object IDtuObjectType- template unit object type- Returns:
 - control or null
 - Since:
 - MicroStrategy Web 8.1.0
 
 
- 
removeControl
void removeControl(java.lang.String ctlKey) throws WebObjectsExceptionRemoves control by its key- Parameters:
 ctlKey- control key- Throws:
 WebObjectsException- Since:
 - MicroStrategy Web 8.1.0
 
 
- 
removeControl
void removeControl(java.lang.String tuObjectId, int tuObjectType) throws WebObjectsExceptionRemoves control from specified template unit- Parameters:
 tuObjectId- template unit object IDtuObjectType- template unit object type- Throws:
 WebObjectsException- Since:
 - MicroStrategy Web 8.1.0
 
 
- 
getViewLimits
WebExpression getViewLimits() throws WebObjectsException
- Throws:
 WebObjectsException- Since:
 - MicroStrategy Web 9.0.1
 
 
- 
hasControls
boolean hasControls()
- Since:
 - MicroStrategy Web 9.0.1
 
 
- 
getControlKeysWithTopMost
java.lang.String getControlKeysWithTopMost()
get the keys of controls that are set to auto pick top most.- Returns:
 - keys join by ''
 
 
- 
getControls
java.util.List getControls()
 
- 
getIfSettings
RWGridIfSettings getIfSettings()
 
- 
getAssociatedNodes
java.util.Set<java.lang.String> getAssociatedNodes(int manipulationCategory)
Returns associated nodes for the specified manipulationCategory. The returned set is never null.- Parameters:
 manipulationCategory- inEnumDSSXMLRWManipulationCategory- Returns:
 - a set containing associated nodes. If no associated node is found returns a empty set
 
 
- 
removeAssociatedNodes
void removeAssociatedNodes(java.util.Set<java.lang.String> nodeKeys, int manipulationCategory) 
- 
addAssociatedNodes
void addAssociatedNodes(java.util.Set<java.lang.String> nodeKeys, int manipulationCategory) 
- 
getDefaultDataSet
RWDataSet getDefaultDataSet()
Returns the default dataset of RW definition, seeRWDataSets.getDefault().- Since:
 - MicroStrategy Web 9.4.0
 
 
- 
iterateDIC
void iterateDIC(RWDICVisitor visitor)
 
- 
removePlaceHolderTargets
void removePlaceHolderTargets(java.util.Set<java.lang.Integer> phRemoves)
Remove placeholders that has been targeted to a selector- Parameters:
 phRemoves-
 
- 
setCurrentSliceID
void setCurrentSliceID(int sliceID)
Set current grid's slice ID, which will be used when rendering. Since when we have page bys, different grids will share the same definition.- Parameters:
 sliceID-
 
- 
getCurrentSliceID
int getCurrentSliceID()
Get current grid's slice ID.- Returns:
 
 
 - 
 
 -