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.String
PROPERTY_SET_CONFIGURATION
static java.lang.String
PROPERTY_SET_DOCUMENT
static java.lang.String
PROPERTY_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 void
appendNodesFilter(java.lang.String units)
java.lang.String
checkImageExist(java.lang.String shaValue)
check whether the image has been stored in MD or in current instancevoid
clearGridIncrementalFetch()
Clear grid incremental fetch settingvoid
disablePartialCSSForGridGraph(java.lang.String ggKey)
Disables the partial update of the specified objectvoid
discardState()
Discards current state.void
discardState(boolean preserveChanges)
Discards current state.java.lang.String
getCurrentLayoutKey()
Returns the current layout key.RWData
getData()
Returns report dataRWDataSettings
getDataSettings()
Returns document data settings.RWGridGraphSettings
getDefaultGridGraphSettings()
This method returns the default grid/graph settings.RWDefinition
getDefinition()
Returns report definition.RWDefinition
getDefinitionNoLoad()
Returns report definition or null if it is not presentRWDetailsFormatter
getDetailsFormatter()
Returns the details formatter object associated with this instance.RWDocumentDetails
getDocumentDetails()
Return the document details objectWebPropertyGroup
getDocumentProperties()
Returns the properties at the document leveljava.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)
Get elements from graph in document.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)
Get elements from graph in document.byte[]
getExcelData()
Returns data for Excel exportint
getExecutionMode()
Returns exectuon mode fromEnumRWExecutionModes
byte[]
getExportCacheID()
byte[]
getExportData()
Retrieves from the IServer binary data for export.RWExportSettings
getExportSettings()
Returns export settings object that corresponds to the current execution mode (getExecutionMode()
).RWExportSettings
getExportSettings(int executionMode)
Returns export settings for the given execution mode.int
getGatewayJsonVersion()
gatewayJsonVersion is transient property for gateway JSON generation.WebGraph
getGraphObject(java.lang.String nodeKey)
Returns the graph definition object associated with the specified node.WebGraph
getGraphObject(java.lang.String nodeKey, int slicedWindowID)
Returns the graph definition object associated with the specified node.WebResultSettings
getGridGraphSettings()
Return aWebResultSettings
object which can be used to control some of theEnumDSSXMLResult2Flags
that will be used for all theRWGridGraphDef
objects in the report writing document.RWGridGraphSettings
getGridGraphSettings(int mode)
This method returns the grid/graph settings for a specific visualization mode.int
getInboxMsgResultFlags()
Get Inbox message result flags, integral value of EnumDSSXMLInboxMsgResultFlags constants.RWIncrementalFetchSettings
getIncrementalFetchSettings()
boolean
getIsClientAuto()
Get isClientAuto, which indicates whether the manipulation is client autoint
getJobID()
Get job id of dossier instances / dossier manipulationsjava.lang.String
getLastUpdate()
Returns the time and date when this document was last updated against the warehouse.java.lang.String
getLogMessageAsXML()
Returns log message for the current report.RWMessage
getMessage()
Returns ARWMessage
object for the current RW doc.RWMessage
getMessage(boolean populate)
Returns ARWMessage
object for the current RW doc.java.lang.String
getMSTRPredictedFileSize(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 exportPersonalViewExecutionInfo
getPersonalViewExecutionInfo()
Get PersonalViewExecutionInfo, which indicates if personal manipulations all appliedWebPropertyGroup
getProperties(java.lang.String nodeKey)
returns the properties corresponding to a specific nodeint
getResultFilterMode()
Returns the filter mode that is currently set.java.lang.String
getResultsAsJson(int resultFlags)
java.lang.Object
getResultsAsJson(int resultFlags, int mode)
THIS METHOD IS NOT SUPPORTED FOR USE IN CUSTOM APPLICATION DEVELOPMENT.java.lang.String
getResultsAsXML()
Returns execution results as XML stringRWSettings
getResultSettings()
RWManipulation
getRWManipulator()
Returns RW manipulatorRWManipulation
getRWManipulator(boolean validateStatus)
Returns RW manipulatorint
getSaveAsDisplayMode()
Returns the display mode for the saveAs call.int
getSaveAsFlags()
Returns the flags for the saveAs call.RWSecondaryDataProviderHelper
getSecondaryDataProviderHelper()
Returns a helper class for working with widget secondary data providers.boolean
getSupportsUndo()
Indicate that the application using this instance supports undo/redojava.util.Set<java.lang.String>
getUpdatedUnits()
WebVisualizationSettings
getVisualizationSettings()
This method exposes the visualization settings for the RW document.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)
Import image to documentjava.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)
Import image to documentvoid
includeFilterUnits()
Include filter units in partial update resultboolean
isDirty()
Indicates whether the instance has been modified since it was first executed.boolean
isMultiLayout()
Returns true if this is a multi-layout documentboolean
isPromptStatus()
Whether the current result status is a prompt result statusvoid
iterate(RWVisitor visitor, RWIterateSettings settings)
Iteration method for visiting the underlying object model.WebObjectInfo
saveAs(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.WebObjectInfo
saveAs(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.WebObjectInfo
saveAs(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.String
saveAsForManagedDataset(java.lang.String folderID, java.lang.String docName, java.lang.String docDesc, boolean documentLevel, java.lang.String reportSaveAsOptions)
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)
Saves managed dataset or standalone dataset within the current report instance.java.lang.String
saveAsReport(java.lang.String folderId, java.lang.String name, java.lang.String description)
Saves the current instance for report.java.lang.String
saveAsSegment(WebFolder parentFolder, java.lang.String name, java.lang.String description, int flags, java.lang.String nodeKey)
Save segment from RWD.java.lang.String
saveAsTheme(java.lang.String folderID, java.lang.String themeName, java.lang.String themeDesc, int flags)
Save the document theme as a standalone object.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)
void
sendExportData(IContentConsumer contentConsumer)
Streams binary export data received from IServe to a content consumer.void
setControlFilter(java.util.Set<java.lang.String> units)
Sets control filtervoid
setCurrentLayoutKey(java.lang.String value)
Switches to a new current layout.void
setCurrentPageKey(java.lang.String value)
Set pageKey to specify the tag 'target_key' value in grtex command to get the specific node info.void
setDocumentProperty(java.lang.String propertySetName, java.lang.String propertyName, java.lang.String propertyValue)
Sets document's propertyvoid
setExecutionMode(int mode)
Sets execution modevoid
setExportCacheID(byte[] exportCacheID)
set the exportCacheID of the instancevoid
setGatewayJsonVersion(int version)
void
setGridIncrementalFetch(java.lang.String unitKey, int rowPosition, int maxRows, int colPosition, int maxColumns)
Sets grid incremental fetch positionvoid
setGridIncrementalFetch(java.lang.String unitKey, int rowMode, int rowPosition, int maxRows, int colMode, int colPosition, int maxColumns)
Sets grid incremental fetch positionvoid
setInboxMsgResultFlags(int inboxMsgResultFlags)
Set inbox message result flags, integral value of EnumDSSXMLInboxMsgResultFlags constants..void
setIsClientAuto(boolean isClientAuto)
Set isClientAuto, which indicates whether the manipulation is client autovoid
setNodesFilter(java.util.Set<java.lang.String> units)
Sets nodes filtervoid
setPersonalViewExecutionInfo(PersonalViewExecutionInfo pvInfo)
Set PersonalViewExecutionInfo, which indicates if personal manipulations all appliedvoid
setProperty(java.lang.String unitKey, java.lang.String propertySetName, java.lang.String propertyName, java.lang.String propertyValue)
Sets a property value for the specified unitvoid
setResultFilterMode(int resultFilterMode)
Sets the filter mode.void
setSaveAsDisplayMode(int saveAsDisplayMode)
Sets the display mode for the saveAs call.void
setSaveAsFlags(int saveAsFlags)
Sets the flags for the saveAs call.void
setStateID(int stateID)
set the steateID of inboxMessage of instancevoid
setSupportsUndo(boolean value)
Sets flag indication that application using this instance supports undo/redovoid
setUnitsFilter(java.util.Set units)
Sets units filtervoid
setUnitsFilterProps(java.util.Map defnFilterProps, java.util.Map dataFilterProps)
Sets the JSON properties in the units filter for the server to return.void
setUpdatedObjectsFilter(java.util.Set<MojoRWUpdatedObjectsSettings> objects)
Set the partial update on object keys.void
setUpdatedUnitsFilter(java.util.Set<java.lang.String> nodes)
Sets update units filtervoid
subscribe(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 WebObjectsException
Returns 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 WebObjectsException
Returns 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.RWIterateSettings
may 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, MSTRWebAPIException
Saves 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, MSTRWebAPIException
Saves 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 inEnumRWResultFilterModes
If one is not specified, the default used would beEnumRWResultFilterModes.RW_RESULT_FILTER_DEFAULT
-
getMessage
RWMessage getMessage() throws WebObjectsException
Returns ARWMessage
object for the current RW doc.- Returns:
RWMessage
for 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 ARWMessage
object 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:
RWMessage
for 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 WebObjectsException
Sets 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 WebObjectsException
Sets 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 WebObjectsException
Returns data for PDF export- Returns:
- byte[] PDS data
- Throws:
WebObjectsException
-
getExcelData
byte[] getExcelData() throws WebObjectsException
Returns 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_PDF
is assumed.
The following describes the execution mode associations, and the export settings subclass, whichRWExportSettings
may be cast into (if any):EnumRWExecutionModes.RW_MODE_EXCEL
:RWExcelExportSettings
EnumRWExecutionModes.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_PDF
is 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 WebObjectsException
Discards current state.- Throws:
WebObjectsException
-
discardState
void discardState(boolean preserveChanges) throws WebObjectsException
Discards 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 aWebResultSettings
object which can be used to control some of theEnumDSSXMLResult2Flags
that will be used for all theRWGridGraphDef
objects 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
WebVisualizationSettings
object 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
RWGridGraphSettings
object, 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
RWGridGraphSettings
object, 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 WebObjectsException
Retrieves 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:
WebObjectsException
WebReportValidationException
- 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 WebObjectsException
Returns 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 WebObjectsException
THIS 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, MSTRWebAPIException
Save 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:
WebObjectsException
MSTRWebAPIException
-
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 WebObjectsException
Get 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 WebObjectsException
Get 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 WebObjectsException
Import 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 WebObjectsException
Import image to document- Returns:
- Throws:
WebObjectsException
-
checkImageExist
java.lang.String checkImageExist(java.lang.String shaValue) throws WebObjectsException
check 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 WebObjectsException
Get 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:
isPromptStatus
in 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.
-
-