Package com.microstrategy.web.objects.rw
Interface RWInstance
- 
- All Superinterfaces:
 EnumWebPersistableState,Persistable,WebResultSetInstance
public interface RWInstance extends WebResultSetInstance
This interface represents an instance of RW report- Since:
 - MicroStrategy Web 8.0.0
 
 
- 
- 
Field Summary
Fields Modifier and Type Field Description static java.lang.StringPROPERTY_SET_CONFIGURATIONstatic java.lang.StringPROPERTY_SET_DOCUMENTstatic java.lang.StringPROPERTY_SET_FORMATTING_PAGE- 
Fields inherited from interface com.microstrategy.utils.serialization.EnumWebPersistableState
BARE_MINIMAL_STATE_INFO, MAXIMAL_STATE_INFO, MINIMAL_STATE_INFO, TYPICAL_STATE_INFO 
 - 
 
- 
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description voidappendNodesFilter(java.lang.String units)java.lang.StringcheckImageExist(java.lang.String shaValue)check whether the image has been stored in MD or in current instancevoidclearGridIncrementalFetch()Clear grid incremental fetch settingvoiddisablePartialCSSForGridGraph(java.lang.String ggKey)Disables the partial update of the specified objectvoiddiscardState()Discards current state.voiddiscardState(boolean preserveChanges)Discards current state.java.lang.StringgetCurrentLayoutKey()Returns the current layout key.RWDatagetData()Returns report dataRWDataSettingsgetDataSettings()Returns document data settings.RWGridGraphSettingsgetDefaultGridGraphSettings()This method returns the default grid/graph settings.RWDefinitiongetDefinition()Returns report definition.RWDefinitiongetDefinitionNoLoad()Returns report definition or null if it is not presentRWDetailsFormattergetDetailsFormatter()Returns the details formatter object associated with this instance.RWDocumentDetailsgetDocumentDetails()Return the document details objectWebPropertyGroupgetDocumentProperties()Returns the properties at the document leveljava.lang.StringgetElementFromGraph(java.lang.String sessionID, java.lang.String messageID, java.lang.String nodeKey, java.lang.String sliceID, int x, int y, int width, int height, java.lang.String dpi)Get elements from graph in document.java.lang.StringgetElementFromGraph(java.lang.String sessionID, java.lang.String messageID, java.lang.String nodeKey, java.lang.String sliceID, int x, int y, java.lang.String dpi)Get elements from graph in document.byte[]getExcelData()Returns data for Excel exportintgetExecutionMode()Returns exectuon mode fromEnumRWExecutionModesbyte[]getExportCacheID()byte[]getExportData()Retrieves from the IServer binary data for export.RWExportSettingsgetExportSettings()Returns export settings object that corresponds to the current execution mode (getExecutionMode()).RWExportSettingsgetExportSettings(int executionMode)Returns export settings for the given execution mode.intgetGatewayJsonVersion()gatewayJsonVersion is transient property for gateway JSON generation.WebGraphgetGraphObject(java.lang.String nodeKey)Returns the graph definition object associated with the specified node.WebGraphgetGraphObject(java.lang.String nodeKey, int slicedWindowID)Returns the graph definition object associated with the specified node.WebResultSettingsgetGridGraphSettings()Return aWebResultSettingsobject which can be used to control some of theEnumDSSXMLResult2Flagsthat will be used for all theRWGridGraphDefobjects in the report writing document.RWGridGraphSettingsgetGridGraphSettings(int mode)This method returns the grid/graph settings for a specific visualization mode.intgetInboxMsgResultFlags()Get Inbox message result flags, integral value of EnumDSSXMLInboxMsgResultFlags constants.RWIncrementalFetchSettingsgetIncrementalFetchSettings()booleangetIsClientAuto()Get isClientAuto, which indicates whether the manipulation is client autointgetJobID()Get job id of dossier instances / dossier manipulationsjava.lang.StringgetLastUpdate()Returns the time and date when this document was last updated against the warehouse.java.lang.StringgetLogMessageAsXML()Returns log message for the current report.RWMessagegetMessage()Returns ARWMessageobject for the current RW doc.RWMessagegetMessage(boolean populate)Returns ARWMessageobject for the current RW doc.java.lang.StringgetMSTRPredictedFileSize(java.lang.String documentID)Get the predicted MSTR file size for a document or a report.java.util.Set<java.lang.String>getNodesFilter()returns list of node keys those are set for the filterbyte[]getPDFData()Returns data for PDF exportPersonalViewExecutionInfogetPersonalViewExecutionInfo()Get PersonalViewExecutionInfo, which indicates if personal manipulations all appliedWebPropertyGroupgetProperties(java.lang.String nodeKey)returns the properties corresponding to a specific nodeintgetResultFilterMode()Returns the filter mode that is currently set.java.lang.StringgetResultsAsJson(int resultFlags)java.lang.ObjectgetResultsAsJson(int resultFlags, int mode)THIS METHOD IS NOT SUPPORTED FOR USE IN CUSTOM APPLICATION DEVELOPMENT.java.lang.StringgetResultsAsXML()Returns execution results as XML stringRWSettingsgetResultSettings()RWManipulationgetRWManipulator()Returns RW manipulatorRWManipulationgetRWManipulator(boolean validateStatus)Returns RW manipulatorintgetSaveAsDisplayMode()Returns the display mode for the saveAs call.intgetSaveAsFlags()Returns the flags for the saveAs call.RWSecondaryDataProviderHelpergetSecondaryDataProviderHelper()Returns a helper class for working with widget secondary data providers.booleangetSupportsUndo()Indicate that the application using this instance supports undo/redojava.util.Set<java.lang.String>getUpdatedUnits()WebVisualizationSettingsgetVisualizationSettings()This method exposes the visualization settings for the RW document.java.lang.StringimportImageToDocument(java.lang.String binaryID, int blockCount, int blockIndex, int blockSize, java.lang.String treeType, java.lang.String nodeKey, java.lang.String fieldKey, java.lang.String fieldName, java.lang.String imgName, int index, long fileSize, java.lang.String imgID, java.lang.String hashCode, int isEdit, java.io.InputStream data)Import image to documentjava.lang.StringimportImageToDocument(java.lang.String treeType, java.lang.String nodeKey, java.lang.String fieldKey, java.lang.String fieldName, java.lang.String imgName, int index, long fileSize, java.lang.String imgID, java.lang.String hashCode, int isEdit, java.io.InputStream data)Import image to documentvoidincludeFilterUnits()Include filter units in partial update resultbooleanisDirty()Indicates whether the instance has been modified since it was first executed.booleanisMultiLayout()Returns true if this is a multi-layout documentbooleanisPromptStatus()Whether the current result status is a prompt result statusvoiditerate(RWVisitor visitor, RWIterateSettings settings)Iteration method for visiting the underlying object model.WebObjectInfosaveAs(WebFolder parentFolder)Saves the current report instance, or template of the current report instance, or filter of the current report instance into the given folder with the given name and description.WebObjectInfosaveAs(WebFolder parentFolder, java.lang.String name)Saves the current report instance, or template of the current report instance, or filter of the current report instance into the given folder with the given name and description.WebObjectInfosaveAs(WebFolder parentFolder, java.lang.String name, java.lang.String description)Saves the current report instance, or template of the current report instance, or filter of the current report instance into the given folder with the given name and description.java.lang.StringsaveAsForManagedDataset(java.lang.String folderID, java.lang.String docName, java.lang.String docDesc, boolean documentLevel, java.lang.String reportSaveAsOptions)java.lang.StringsaveAsForManagedDataset(java.lang.String folderID, java.lang.String docName, java.lang.String docDesc, boolean documentLevel, java.lang.String reportSaveAsOptions, IntWrapper status, int requestTimeout)Saves managed dataset or standalone dataset within the current report instance.java.lang.StringsaveAsReport(java.lang.String folderId, java.lang.String name, java.lang.String description)Saves the current instance for report.java.lang.StringsaveAsSegment(WebFolder parentFolder, java.lang.String name, java.lang.String description, int flags, java.lang.String nodeKey)Save segment from RWD.java.lang.StringsaveAsTheme(java.lang.String folderID, java.lang.String themeName, java.lang.String themeDesc, int flags)Save the document theme as a standalone object.java.lang.StringsaveDerivedElements(java.lang.String unitKey, java.lang.String attId, java.lang.String folderId, java.lang.String name, java.lang.String description, boolean overwrite)voidsendExportData(IContentConsumer contentConsumer)Streams binary export data received from IServe to a content consumer.voidsetControlFilter(java.util.Set<java.lang.String> units)Sets control filtervoidsetCurrentLayoutKey(java.lang.String value)Switches to a new current layout.voidsetCurrentPageKey(java.lang.String value)Set pageKey to specify the tag 'target_key' value in grtex command to get the specific node info.voidsetDocumentProperty(java.lang.String propertySetName, java.lang.String propertyName, java.lang.String propertyValue)Sets document's propertyvoidsetExecutionMode(int mode)Sets execution modevoidsetExportCacheID(byte[] exportCacheID)set the exportCacheID of the instancevoidsetGatewayJsonVersion(int version)voidsetGridIncrementalFetch(java.lang.String unitKey, int rowPosition, int maxRows, int colPosition, int maxColumns)Sets grid incremental fetch positionvoidsetGridIncrementalFetch(java.lang.String unitKey, int rowMode, int rowPosition, int maxRows, int colMode, int colPosition, int maxColumns)Sets grid incremental fetch positionvoidsetInboxMsgResultFlags(int inboxMsgResultFlags)Set inbox message result flags, integral value of EnumDSSXMLInboxMsgResultFlags constants..voidsetIsClientAuto(boolean isClientAuto)Set isClientAuto, which indicates whether the manipulation is client autovoidsetNodesFilter(java.util.Set<java.lang.String> units)Sets nodes filtervoidsetPersonalViewExecutionInfo(PersonalViewExecutionInfo pvInfo)Set PersonalViewExecutionInfo, which indicates if personal manipulations all appliedvoidsetProperty(java.lang.String unitKey, java.lang.String propertySetName, java.lang.String propertyName, java.lang.String propertyValue)Sets a property value for the specified unitvoidsetResultFilterMode(int resultFilterMode)Sets the filter mode.voidsetSaveAsDisplayMode(int saveAsDisplayMode)Sets the display mode for the saveAs call.voidsetSaveAsFlags(int saveAsFlags)Sets the flags for the saveAs call.voidsetStateID(int stateID)set the steateID of inboxMessage of instancevoidsetSupportsUndo(boolean value)Sets flag indication that application using this instance supports undo/redovoidsetUnitsFilter(java.util.Set units)Sets units filtervoidsetUnitsFilterProps(java.util.Map defnFilterProps, java.util.Map dataFilterProps)Sets the JSON properties in the units filter for the server to return.voidsetUpdatedObjectsFilter(java.util.Set<MojoRWUpdatedObjectsSettings> objects)Set the partial update on object keys.voidsetUpdatedUnitsFilter(java.util.Set<java.lang.String> nodes)Sets update units filtervoidsubscribe(WebSubscriptionTrigger trigger, WebSubscriptionAddress address, java.lang.String subject, boolean sendNow, java.lang.String customMessage, WebSubscriptionContentFormat format, boolean zip)Subscibes a user to this document- 
Methods inherited from interface com.microstrategy.utils.serialization.Persistable
restoreState, restoreState, saveState, saveState, saveState, saveState 
- 
Methods inherited from interface com.microstrategy.web.objects.WebResultSetInstance
CancelReprompt, createNewSchedule, createNewSubscription, getCacheID, getCacheLastUpdate, getCacheType, getIconPath, getIsPVPartialExecution, getMaxWait, getMessageID, getPollingFrequency, getPrompts, getPrompts, getStateID, getStatus, getViewMediaSettings, isAsync, isModified, isPrompted, isPromptStatus, isReprompted, isResolved, isResultOrPromptStatus, isResultStatus, isResultStatus, pollStatus, pollStatusOnly, schedule, schedule, setAsync, setIconPath, setIsPVPartialExecution, setMaxWait, setPollingFrequency 
 - 
 
 - 
 
- 
- 
Field Detail
- 
PROPERTY_SET_DOCUMENT
static final java.lang.String PROPERTY_SET_DOCUMENT
- See Also:
 - Constant Field Values
 
 
- 
PROPERTY_SET_FORMATTING_PAGE
static final java.lang.String PROPERTY_SET_FORMATTING_PAGE
- See Also:
 - Constant Field Values
 
 
- 
PROPERTY_SET_CONFIGURATION
static final java.lang.String PROPERTY_SET_CONFIGURATION
- See Also:
 - Constant Field Values
 
 
 - 
 
- 
Method Detail
- 
getJobID
int getJobID()
Get job id of dossier instances / dossier manipulations- Returns:
 - Job id of dossier instances / dossier manipulations
 
 
- 
getDefinition
RWDefinition getDefinition() throws WebObjectsException
Returns report definition. If the definition is not currently present in the object state, it will be loaded from the server.- Returns:
 - report definition
 - Throws:
 WebObjectsException
 
- 
getDefinitionNoLoad
RWDefinition getDefinitionNoLoad()
Returns report definition or null if it is not present- Returns:
 - report definition
 
 
- 
getData
RWData getData() throws WebObjectsException
Returns report data- Returns:
 - report data
 - Throws:
 WebObjectsException
 
- 
getLogMessageAsXML
java.lang.String getLogMessageAsXML() throws WebObjectsExceptionReturns log message for the current report. The parse method didn't provide here, if you want to parse the log message, please refer to com.microstrategy.MSTRTester.MSTRTesterModel#parseToMap(java.io.BufferedReader) and com.microstrategy.MSTRTester.MSTRTesterModel#parseToCSV(com.microstrategy.utils.json.JSONObject) for more detail- Returns:
 - log message for the current report.
 - Throws:
 WebObjectsException- indicates an inability to obtain the message information from the Intelligence Server.
 
- 
getResultsAsXML
java.lang.String getResultsAsXML() throws WebObjectsExceptionReturns execution results as XML string- Returns:
 - execution results as XML string
 - Throws:
 WebObjectsException
 
- 
iterate
void iterate(RWVisitor visitor, RWIterateSettings settings) throws WebObjectsException
Iteration method for visiting the underlying object model.RWIterateSettingsmay be obtained fromRWSource.createIterateSettings().- Parameters:
 visitor- the visitorsettings- settings governing the behavior of the iteration- Throws:
 WebObjectsException- if an error occurs during iteration- Since:
 - MicroStrategy Web 8.1.0
 
 
- 
setSaveAsFlags
void setSaveAsFlags(int saveAsFlags)
Sets the flags for the saveAs call. These flags determine what is saved and the state it is saved in. This value should be the bitwise or (|) of values fromEnumDSSXMLReportSaveAsFlags.- Parameters:
 saveAsFlags- The value to use as the save as flags.- See Also:
 getSaveAsFlags()
 
- 
getSaveAsFlags
int getSaveAsFlags()
Returns the flags for the saveAs call. These flags determine what is saved and the state it is saved in. This value should be the bitwise or (|) of values fromEnumDSSXMLReportSaveAsFlags.- Returns:
 - The current setting of the save as flags.
 - See Also:
 setSaveAsFlags(int)
 
- 
setSaveAsDisplayMode
void setSaveAsDisplayMode(int saveAsDisplayMode)
Sets the display mode for the saveAs call. These flags determine the format that the report is saved in. This value should be fromEnumDSSXMLDisplayMode.- Parameters:
 saveAsDisplayMode- The value to use as the save as display mode.- See Also:
 getSaveAsDisplayMode()
 
- 
getSaveAsDisplayMode
int getSaveAsDisplayMode()
Returns the display mode for the saveAs call. These flags determine the format that the report is saved in. This value should be fromEnumDSSXMLDisplayMode.- Returns:
 - The current setting for display mode.
 - See Also:
 setSaveAsDisplayMode(int)
 
- 
saveAs
WebObjectInfo saveAs(WebFolder parentFolder) throws WebObjectsException
Saves the current report instance, or template of the current report instance, or filter of the current report instance into the given folder with the given name and description. The saveAsFlags and saveAsDisplayMode control how the object is saved. One flag in saveAsFlags controls whether to save the report or template or filter of the current report. The new saved object returned without being populated.- Parameters:
 parentFolder- The folder to place the new report in, an object of typeWebFolder.- Returns:
 - The WebObjectInfo object of saved object, it can be report or a filter or a template.
 - Throws:
 WebObjectsException- Signals an error in sending the command to the Intelligence Server, or receiving of an invalid DSS ID from the IServer corresponding to the saved object.
 
- 
saveAsReport
java.lang.String saveAsReport(java.lang.String folderId, java.lang.String name, java.lang.String description) throws WebObjectsException, MSTRWebAPIExceptionSaves the current instance for report.- Parameters:
 folderId- The folder ID.name- The name of the new report to be saved.description- The description of the new report.- Returns:
 - The object ID of saved report.
 - Throws:
 WebObjectsException- Signals an error in sending the command to the Intelligence Server, receiving of an invalid DSS ID from the IServer corresponding to the saved object, or an invalid object name.MSTRWebAPIException
 
- 
saveAs
WebObjectInfo saveAs(WebFolder parentFolder, java.lang.String name, java.lang.String description) throws WebObjectsException
Saves the current report instance, or template of the current report instance, or filter of the current report instance into the given folder with the given name and description. The saveAsFlags and saveAsDisplayMode control how the object is saved. One flag in saveAsFlags controls whether to save the report or template or filter of the current report. The new saved object returned without being populated.- Parameters:
 parentFolder- The folder to place the new report in, an object of typeWebFolder.name- The name of the new object to be saved.description- The description of the new object.- Returns:
 - The WebObjectInfo object of saved object, it can be report or a filter or a template.
 - Throws:
 WebObjectsException- Signals an error in sending the command to the Intelligence Server, receiving of an invalid DSS ID from the IServer corresponding to the saved object, or an invalid object name.
 
- 
saveAs
WebObjectInfo saveAs(WebFolder parentFolder, java.lang.String name) throws WebObjectsException
Saves the current report instance, or template of the current report instance, or filter of the current report instance into the given folder with the given name and description. The saveAsFlags and saveAsDisplayMode control how the object is saved. One flag in saveAsFlags controls whether to save the report or template or filter of the current report. The new saved object returned without being populated.- Parameters:
 parentFolder- The folder to place the new report in, an object of typeWebFolder.name- The name of the new object to be saved.- Returns:
 - The WebObjectInfo object of saved object, it can be report or a filter or a template.
 - Throws:
 WebObjectsException- Signals an error in sending the command to the Intelligence Server, receiving of an invalid DSS ID from the IServer corresponding to the saved object, or an invalid object name.
 
- 
saveAsForManagedDataset
java.lang.String saveAsForManagedDataset(java.lang.String folderID, java.lang.String docName, java.lang.String docDesc, boolean documentLevel, java.lang.String reportSaveAsOptions) throws WebObjectsException, MSTRWebAPIException 
- 
saveAsForManagedDataset
java.lang.String saveAsForManagedDataset(java.lang.String folderID, java.lang.String docName, java.lang.String docDesc, boolean documentLevel, java.lang.String reportSaveAsOptions, IntWrapper status, int requestTimeout) throws WebObjectsException, MSTRWebAPIExceptionSaves managed dataset or standalone dataset within the current report instance. The saveAsFlags is set to 16 to indicate this is a dataset level saveas, or other value depending on user input to enter document level saveas. The status is returned.- Parameters:
 folderID- The id of the folder to place the document. When dataset level saveas, it doesn't matter.docName- The name of the new document to be saved.docDesc- The description of the new document.documentLevel- Whether this is a document level saveasreportSaveAsOptions- The xml delta of the report SaveAs options for datasets within document.status- Contains the current status of the document.requestTimeout- the amount to wait in milliseconds for the xml command- Returns:
 - objectID
 - Throws:
 WebObjectsException- Signals an error in sending the command to the Intelligence Server, receiving of an invalid DSS ID from the IServer corresponding to the saved object, or an invalid object name.MSTRWebAPIException- Signals duplicated name error or other errors.
 
- 
saveAsSegment
java.lang.String saveAsSegment(WebFolder parentFolder, java.lang.String name, java.lang.String description, int flags, java.lang.String nodeKey) throws WebObjectsException
Save segment from RWD.- Parameters:
 parentFolder- The folder to place the new segment in, an object of typeWebFolder.name- A name for the segment.description- A description for the segment.flags- Flags which modify the behavior of the call.nodeKey- the key to locate the node- Returns:
 - the new created segment's id
 - Throws:
 WebObjectsException
 
- 
getRWManipulator
RWManipulation getRWManipulator() throws WebObjectsException
Returns RW manipulator- Returns:
 - RW manipulator
 - Throws:
 WebObjectsException
 
- 
getRWManipulator
RWManipulation getRWManipulator(boolean validateStatus) throws WebObjectsException
Returns RW manipulator- Parameters:
 validateStatus- - boolean indicating whether we need to validate the ready status.- Returns:
 - RW manipulator
 - Throws:
 WebObjectsException
 
- 
getResultFilterMode
int getResultFilterMode()
Returns the filter mode that is currently set. This is a value from the enumerationEnumRWResultFilterModes 
- 
setResultFilterMode
void setResultFilterMode(int resultFilterMode)
Sets the filter mode. The value to be set is one defined inEnumRWResultFilterModesIf one is not specified, the default used would beEnumRWResultFilterModes.RW_RESULT_FILTER_DEFAULT 
- 
getMessage
RWMessage getMessage() throws WebObjectsException
Returns ARWMessageobject for the current RW doc.- Returns:
 RWMessagefor the current RW doc.- Throws:
 WebObjectsException- indicates an inability to obtain the message information from the Intelligence Server.
 
- 
getMessage
RWMessage getMessage(boolean populate) throws WebObjectsException
Returns ARWMessageobject for the current RW doc. If populate is true, the information is retreived from Intelligence Server.- Parameters:
 populate- Whether the message should be populated with the inbox information for the message. This may cause an additional call to the Intelligence Server if it is set to true.- Returns:
 RWMessagefor the current report.- Throws:
 WebObjectsException- indicates an inability to obtain the message information from the Intelligence Server.
 
- 
getDocumentProperties
WebPropertyGroup getDocumentProperties() throws WebObjectsException
Returns the properties at the document level- Returns:
 - the properties at the document level
 - Throws:
 WebObjectsException
 
- 
getProperties
WebPropertyGroup getProperties(java.lang.String nodeKey) throws WebObjectsException
returns the properties corresponding to a specific node- Parameters:
 nodeKey- the key of the node- Returns:
 - the properties
 - Throws:
 WebObjectsException
 
- 
setProperty
void setProperty(java.lang.String unitKey, java.lang.String propertySetName, java.lang.String propertyName, java.lang.String propertyValue) throws WebObjectsExceptionSets a property value for the specified unit- Parameters:
 unitKey- unit keypropertySetName- property set namepropertyName- property namepropertyValue- value- Throws:
 WebObjectsException
 
- 
setDocumentProperty
void setDocumentProperty(java.lang.String propertySetName, java.lang.String propertyName, java.lang.String propertyValue) throws WebObjectsExceptionSets document's property- Parameters:
 propertySetName- property set namepropertyName- property namepropertyValue- value- Throws:
 WebObjectsException
 
- 
subscribe
void subscribe(WebSubscriptionTrigger trigger, WebSubscriptionAddress address, java.lang.String subject, boolean sendNow, java.lang.String customMessage, WebSubscriptionContentFormat format, boolean zip) throws WebObjectsException
Subscibes a user to this document- Parameters:
 trigger- subscription triggeraddress- subscription addresssubject- subject stringsendNow- flag indicating that a message shall be send immediatelycustomMessage- custom message stringformat- subscription formatzip- flag indication that content must be compressed- Throws:
 WebObjectsException
 
- 
getGraphObject
WebGraph getGraphObject(java.lang.String nodeKey) throws WebObjectsException, java.lang.IllegalArgumentException
Returns the graph definition object associated with the specified node. The graph object returned should not be used for retrieving data as the sliced window ID is missing for such a graph object.- Parameters:
 nodeKey- the key of the node.- Returns:
 - the graph object.
 - Throws:
 WebObjectsException- if there was an error encountered while retrieving the graph object.java.lang.IllegalArgumentException- if an invalid node key is passed.
 
- 
getGraphObject
WebGraph getGraphObject(java.lang.String nodeKey, int slicedWindowID) throws WebObjectsException, java.lang.IllegalArgumentException
Returns the graph definition object associated with the specified node. The graph object returned can be used for retrieving data- Parameters:
 nodeKey- the node keyslicedWindowID- the window ID of sliced graph object to be fetched.- Returns:
 - the graph object.
 - Throws:
 WebObjectsException- if there was an error encountered while retrieving the graph object.java.lang.IllegalArgumentException- if an invalid node key or slice ID (<0) is passed
 
- 
getExecutionMode
int getExecutionMode()
Returns exectuon mode fromEnumRWExecutionModes- Returns:
 - exectuon mode from 
EnumRWExecutionModes 
 
- 
setExecutionMode
void setExecutionMode(int mode)
Sets execution mode- Parameters:
 mode- exectuon mode fromEnumRWExecutionModes
 
- 
getPDFData
byte[] getPDFData() throws WebObjectsExceptionReturns data for PDF export- Returns:
 - byte[] PDS data
 - Throws:
 WebObjectsException
 
- 
getExcelData
byte[] getExcelData() throws WebObjectsExceptionReturns data for Excel export- Returns:
 - byte[] Excel data
 - Throws:
 WebObjectsException
 
- 
getExportSettings
RWExportSettings getExportSettings()
Returns export settings object that corresponds to the current execution mode (getExecutionMode()).
If the execution mode is not a known export mode,EnumRWExecutionModes.RW_MODE_PDFis assumed.
The following describes the execution mode associations, and the export settings subclass, whichRWExportSettingsmay be cast into (if any):EnumRWExecutionModes.RW_MODE_EXCEL:RWExcelExportSettingsEnumRWExecutionModes.RW_MODE_PDF:RWExportSettings(no subclass)EnumRWExecutionModes.RW_MODE_FLASH_EXPORT:RWExportSettings(no subclass)
It can be used as follows:
getRWInstance().setExecutionMode(EnumRWExecutionModes.RW_MODE_EXCEL);
getRWInstance().getExportSettings().setMode(EnumRWExportModes.RW_EXPORT_ALL);
byte[] data = getRWInstance().getExportData();
String stringData = new String(data, "UnicodeLittle"); // optional (this should be avoided if possible)
- Returns:
 - export settings object associated with the current execution mode.
 
 
- 
getExportSettings
RWExportSettings getExportSettings(int executionMode)
Returns export settings for the given execution mode. Note that this does not change the execution mode on theRWInstance.If the execution mode is not a known export mode,EnumRWExecutionModes.RW_MODE_PDFis assumed.- Parameters:
 executionMode- Constant fromEnumRWExecutionModes.- Returns:
 - Excel export settings.
 - See Also:
 getExportSettings()
 
- 
isDirty
boolean isDirty()
Indicates whether the instance has been modified since it was first executed. This means that the version of the document in memory is different from the one saved in the metadata- Returns:
 - boolean indicating if the document has been modified
 - See Also:
 WebResultSetInstance.isModified()
 
- 
discardState
void discardState() throws WebObjectsExceptionDiscards current state.- Throws:
 WebObjectsException
 
- 
discardState
void discardState(boolean preserveChanges) throws WebObjectsExceptionDiscards current state.- Throws:
 WebObjectsException- Since:
 - MicroStrategy Web 9.2.1
 
 
- 
getCurrentLayoutKey
java.lang.String getCurrentLayoutKey()
Returns the current layout key.- Returns:
 - the current layout key.
 - Since:
 - MicroStrategy Web 9.0.0
 
 
- 
setCurrentLayoutKey
void setCurrentLayoutKey(java.lang.String value)
Switches to a new current layout.- Parameters:
 value- the key of a layout that must be set current.- Since:
 - MicroStrategy Web 9.0.0
 
 
- 
getDataSettings
RWDataSettings getDataSettings()
Returns document data settings.- Returns:
 - document data settings.
 - Since:
 - MicroStrategy Web 9.0.0
 
 
- 
setUnitsFilter
void setUnitsFilter(java.util.Set units)
Sets units filter- Parameters:
 units- a list of unit keys that will be returned from the server- Since:
 - MicroStrategy Web 8.1.0
 
 
- 
setCurrentPageKey
void setCurrentPageKey(java.lang.String value)
Set pageKey to specify the tag 'target_key' value in grtex command to get the specific node info.- Parameters:
 value- the key of a page that must be set current.- Since:
 - MicroStrategy Web 11.3.2
 
 
- 
setUnitsFilterProps
void setUnitsFilterProps(java.util.Map defnFilterProps, java.util.Map dataFilterProps)Sets the JSON properties in the units filter for the server to return.- Parameters:
 defnFilterProps-dataFilterProps-
 
- 
setControlFilter
void setControlFilter(java.util.Set<java.lang.String> units)
Sets control filter- Parameters:
 units- a list of control keys that updated by user- Since:
 - MicroStrategy Web 9.1.0
 
 
- 
setUpdatedUnitsFilter
void setUpdatedUnitsFilter(java.util.Set<java.lang.String> nodes)
Sets update units filter- Parameters:
 nodes- a list of node keys that updated by user
 
- 
setUpdatedObjectsFilter
void setUpdatedObjectsFilter(java.util.Set<MojoRWUpdatedObjectsSettings> objects)
Set the partial update on object keys. Added for html5 vi.- Parameters:
 objects- a list of updated object keys.
 
- 
setNodesFilter
void setNodesFilter(java.util.Set<java.lang.String> units)
Sets nodes filter- Parameters:
 units- a list of node keys that updated by user
 
- 
appendNodesFilter
void appendNodesFilter(java.lang.String units)
- Parameters:
 units- Adds Node key to the list. if the nodes list is empty, it creates a new HashSet before appending.
 
- 
getNodesFilter
java.util.Set<java.lang.String> getNodesFilter()
returns list of node keys those are set for the filter 
- 
includeFilterUnits
void includeFilterUnits()
Include filter units in partial update result 
- 
getUpdatedUnits
java.util.Set<java.lang.String> getUpdatedUnits()
- Since:
 - MicroStrategy Web 9.0.3 return a set of keys for the updated units when doing partial update
 
 
- 
getGridGraphSettings
WebResultSettings getGridGraphSettings()
Return aWebResultSettingsobject which can be used to control some of theEnumDSSXMLResult2Flagsthat will be used for all theRWGridGraphDefobjects in the report writing document.- Returns:
 WebResultSettings- Since:
 - MicroStrategy Web 8.1.0
 
 
- 
getVisualizationSettings
WebVisualizationSettings getVisualizationSettings() throws WebObjectsException
This method exposes the visualization settings for the RW document.- Returns:
 - A 
WebVisualizationSettingsobject containing the visualization settings for the document. - Throws:
 WebObjectsException- Since:
 - MicroStrategy Web 8.0.2
 
 
- 
getDefaultGridGraphSettings
RWGridGraphSettings getDefaultGridGraphSettings()
This method returns the default grid/graph settings. This object can be used to change the result flags and other settings of all grids embedded in the RW document.- Returns:
 - A 
RWGridGraphSettingsobject, which can be used to change the grid graph settings for all grids in the RWD. - Since:
 - MicroStrategy Web 8.0.2
 
 
- 
getGridGraphSettings
RWGridGraphSettings getGridGraphSettings(int mode)
This method returns the grid/graph settings for a specific visualization mode. This object can be used to change the result flags and other settings of all grids embedded in the RW document with their visualization view mode set to the given value.- Parameters:
 mode- The visualization view mode that the given settings are for. If a grid has this visualization view mode, then these settings will apply, otherwise they will not.- Returns:
 - A 
RWGridGraphSettingsobject, which can be used to change the grid graph settings for grids in the RWD with the given visualization mode. - Since:
 - MicroStrategy Web 8.0.2
 
 
- 
getSecondaryDataProviderHelper
RWSecondaryDataProviderHelper getSecondaryDataProviderHelper()
Returns a helper class for working with widget secondary data providers.- Returns:
 - a helper class for working with widget secondary data providers.
 - Since:
 - MicroStrategy Web 8.1.1
 
 
- 
getExportData
byte[] getExportData() throws WebObjectsExceptionRetrieves from the IServer binary data for export.- Returns:
 - binary export data.
 - Throws:
 WebObjectsException- Since:
 - MicroStrategy Web 9.0.0
 
 
- 
sendExportData
void sendExportData(IContentConsumer contentConsumer) throws WebObjectsException
Streams binary export data received from IServe to a content consumer. This method is used to avoid buffering export data inside web server.- Parameters:
 contentConsumer- a consumer of export data.- Throws:
 WebObjectsException- Since:
 - MicroStrategy Web 9.0.0
 
 
- 
saveDerivedElements
java.lang.String saveDerivedElements(java.lang.String unitKey, java.lang.String attId, java.lang.String folderId, java.lang.String name, java.lang.String description, boolean overwrite) throws WebObjectsException, WebReportValidationException- Throws:
 WebObjectsExceptionWebReportValidationException- Since:
 - MicroStrategy Web 9.0.0
 
 
- 
getIncrementalFetchSettings
RWIncrementalFetchSettings getIncrementalFetchSettings()
- Since:
 - MicroStrategy Web 9.0.0
 
 
- 
getDetailsFormatter
RWDetailsFormatter getDetailsFormatter()
Returns the details formatter object associated with this instance. To retrieve document details, the formatter should be configured to indicate which parts of the details are retrieved from the server.- Since:
 - MicroStrategy Web 9.0.0
 
 
- 
getDocumentDetails
RWDocumentDetails getDocumentDetails() throws WebObjectsException
Return the document details object- Throws:
 WebObjectsException- Since:
 - MicroStrategy Web 9.0.0
 
 
- 
isMultiLayout
boolean isMultiLayout() throws WebObjectsExceptionReturns true if this is a multi-layout document- Throws:
 WebObjectsException- Since:
 - MicroStrategy Web 9.0.0
 
 
- 
getResultSettings
RWSettings getResultSettings()
- Since:
 - MicroStrategy Web 9.0.1
 
 
- 
setGridIncrementalFetch
void setGridIncrementalFetch(java.lang.String unitKey, int rowPosition, int maxRows, int colPosition, int maxColumns)Sets grid incremental fetch position- Parameters:
 unitKey- the grid unit keyrowPosition- rows positionmaxRows- maximum number of rows per pagecolPosition- columns positionmaxColumns- maximum number of columns per page- Since:
 - MicroStrategy Web 9.0.1
 
 
- 
setGridIncrementalFetch
void setGridIncrementalFetch(java.lang.String unitKey, int rowMode, int rowPosition, int maxRows, int colMode, int colPosition, int maxColumns)Sets grid incremental fetch position- Parameters:
 unitKey- the grid unit keyrowMode- row incremental fetch moderowPosition- rows positionmaxRows- maximum number of rows per pagecolMode- column incremental fetch modecolPosition- columns positionmaxColumns- maximum number of columns per page- Since:
 - MicroStrategy Web 9.0.1
 
 
- 
clearGridIncrementalFetch
void clearGridIncrementalFetch()
Clear grid incremental fetch setting- Since:
 - MicroStrategy Web 11.2.2
 
 
- 
getLastUpdate
java.lang.String getLastUpdate()
Returns the time and date when this document was last updated against the warehouse.- Returns:
 - A string representing the last updated time and date.
 
 
- 
disablePartialCSSForGridGraph
void disablePartialCSSForGridGraph(java.lang.String ggKey)
Disables the partial update of the specified object- Parameters:
 ggKey- The key corresponding to the grid/graph for which partial update is disabled and forces the iserver to send the entire css
 
- 
getResultsAsJson
java.lang.Object getResultsAsJson(int resultFlags, int mode) throws WebObjectsExceptionTHIS METHOD IS NOT SUPPORTED FOR USE IN CUSTOM APPLICATION DEVELOPMENT. THE METHOD IS SUBJECT TO CHANGE IN FUTURE RELEASES AND SOME METHODS AND PROPERTIES MAY NOT BE SUITABLE FOR CUSTOM DEVELOPMENT.- Parameters:
 resultFlags-mode- result data moda seeEnumWebApiResultMode- Returns:
 - Throws:
 WebObjectsException
 
- 
getResultsAsJson
java.lang.String getResultsAsJson(int resultFlags) throws WebObjectsException- Throws:
 WebObjectsException
 
- 
setStateID
void setStateID(int stateID)
set the steateID of inboxMessage of instance- Parameters:
 stateID- the steateID of inboxMessage of instance
 
- 
setSupportsUndo
void setSupportsUndo(boolean value)
Sets flag indication that application using this instance supports undo/redo- Parameters:
 value-
 
- 
getSupportsUndo
boolean getSupportsUndo()
Indicate that the application using this instance supports undo/redo- Returns:
 
 
- 
saveAsTheme
java.lang.String saveAsTheme(java.lang.String folderID, java.lang.String themeName, java.lang.String themeDesc, int flags) throws WebObjectsException, MSTRWebAPIExceptionSave the document theme as a standalone object.- Parameters:
 folderID- The id of the folder to place the theme.themeName- The name of the new document theme to be saved.themeDesc- The description of the new document theme.flags- Flags which modify the behavior of the call, fromEnumDSSXMLDocSaveAsFlags.- Returns:
 - objectID the id of the new document theme.
 - Throws:
 WebObjectsExceptionMSTRWebAPIException
 
- 
getElementFromGraph
java.lang.String getElementFromGraph(java.lang.String sessionID, java.lang.String messageID, java.lang.String nodeKey, java.lang.String sliceID, int x, int y, java.lang.String dpi) throws WebObjectsExceptionGet elements from graph in document.- Returns:
 - Throws:
 WebObjectsException
 
- 
getElementFromGraph
java.lang.String getElementFromGraph(java.lang.String sessionID, java.lang.String messageID, java.lang.String nodeKey, java.lang.String sliceID, int x, int y, int width, int height, java.lang.String dpi) throws WebObjectsExceptionGet elements from graph in document.- Throws:
 WebObjectsException
 
- 
importImageToDocument
java.lang.String importImageToDocument(java.lang.String treeType, java.lang.String nodeKey, java.lang.String fieldKey, java.lang.String fieldName, java.lang.String imgName, int index, long fileSize, java.lang.String imgID, java.lang.String hashCode, int isEdit, java.io.InputStream data) throws WebObjectsExceptionImport image to document- Returns:
 - Throws:
 WebObjectsException
 
- 
importImageToDocument
java.lang.String importImageToDocument(java.lang.String binaryID, int blockCount, int blockIndex, int blockSize, java.lang.String treeType, java.lang.String nodeKey, java.lang.String fieldKey, java.lang.String fieldName, java.lang.String imgName, int index, long fileSize, java.lang.String imgID, java.lang.String hashCode, int isEdit, java.io.InputStream data) throws WebObjectsExceptionImport image to document- Returns:
 - Throws:
 WebObjectsException
 
- 
checkImageExist
java.lang.String checkImageExist(java.lang.String shaValue) throws WebObjectsExceptioncheck whether the image has been stored in MD or in current instance- Parameters:
 shaValue- the SHA result of image binary stream- Returns:
 - If the image exists, return the id of the image. else return a string with all zero
 - Throws:
 WebObjectsException
 
- 
setExportCacheID
void setExportCacheID(byte[] exportCacheID)
set the exportCacheID of the instance- Parameters:
 exportCacheID- the cacheID of the instance
 
- 
getExportCacheID
byte[] getExportCacheID()
 
- 
getMSTRPredictedFileSize
java.lang.String getMSTRPredictedFileSize(java.lang.String documentID) throws WebObjectsExceptionGet the predicted MSTR file size for a document or a report.- Parameters:
 documentID-- Returns:
 - a json String e.g.{"mstr_size":0,"IsSetting":false}, the "mstr_size" is the predicted MSTR file size calculated by the i-Server. "IsSetting" indicates if the "mstr_size" is obtained by returning the value of 'MicroStrategy .(mstr) file size(MB)' set on the developer directly. If IsSetting is true meaning that the value of "mstr_size" was returned based on the value of 'MicroStrategy .(mstr) file size(MB)' set on developer; if IsSetting is false meaning that the value of "mstr_size" was calculated for a given document or report by the i-Server.
 - Throws:
 WebObjectsException
 
- 
getPersonalViewExecutionInfo
PersonalViewExecutionInfo getPersonalViewExecutionInfo()
Get PersonalViewExecutionInfo, which indicates if personal manipulations all applied- Returns:
 - PersonalViewExecutionInfo
 
 
- 
setPersonalViewExecutionInfo
void setPersonalViewExecutionInfo(PersonalViewExecutionInfo pvInfo)
Set PersonalViewExecutionInfo, which indicates if personal manipulations all applied- Parameters:
 pvInfo-
 
- 
setIsClientAuto
void setIsClientAuto(boolean isClientAuto)
Set isClientAuto, which indicates whether the manipulation is client auto- Parameters:
 isClientAuto-
 
- 
getIsClientAuto
boolean getIsClientAuto()
Get isClientAuto, which indicates whether the manipulation is client auto- Returns:
 - isClientAuto
 
 
- 
isPromptStatus
boolean isPromptStatus()
Whether the current result status is a prompt result status- Specified by:
 isPromptStatusin interfaceWebResultSetInstance- Returns:
 - boolean
 
 
- 
getGatewayJsonVersion
int getGatewayJsonVersion()
gatewayJsonVersion is transient property for gateway JSON generation. It is currently only used for gateway JSON generation workflow Version 1: all attributes in rows and metrics in column; Subtotal not supported; Result in de-normalized JSON tree structure Version 2: Normalized JSON structure including lookup table for attribute elements, row and column headers; Cross-tab and subtotal supported. 
- 
setGatewayJsonVersion
void setGatewayJsonVersion(int version)
 
- 
getInboxMsgResultFlags
int getInboxMsgResultFlags()
Get Inbox message result flags, integral value of EnumDSSXMLInboxMsgResultFlags constants.- Returns:
 - inbox message flags.
 
 
- 
setInboxMsgResultFlags
void setInboxMsgResultFlags(int inboxMsgResultFlags)
Set inbox message result flags, integral value of EnumDSSXMLInboxMsgResultFlags constants..- Parameters:
 inboxMsgResultFlags- inbox messagee result flags.
 
 - 
 
 -