Package com.microstrategy.web.beans
Interface ResultSetBean
-
- All Superinterfaces:
EnumWebPersistableState
,ObjectBean
,Persistable
,RequestPersistable
,Transformable
,WebBean
,WebComponent
- All Known Subinterfaces:
DocumentBean
,ReportBean
,RWBean
public interface ResultSetBean extends ObjectBean
- Since:
- MicroStrategy Web 8.0.0
-
-
Field Summary
-
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 Deprecated Methods Modifier and Type Method Description boolean
cancelRequest()
Cancels the current request.int
getExpiration()
Deprecated.As of WU 8.0.java.lang.String
getLastPromptMessageID()
Wheneverrefresh(boolean)
with the reprompt argument set to true, a duplicate message is made in order to answer all the new prompts, i.e.int
getMaxWait()
Returns the maximum amount of time, in milliseconds.java.lang.String
getMessageID()
Returns the message ID associated with the result set instance contained in thisResultSetBean
.int
getPollingFrequency()
Returns the polling frequency, in milliseconds, which will be used when retrieving the results synchronously.PromptsBean
getPromptsBean()
Returns the embeddedPromptsBean
.WebEventHandler
getPromptsEventHandler()
Returns the prompts event handler associated with thePromptsBean
.WebResultSetInstance
getResultSetInstance()
Returns the result set instance.boolean
getSaveToInbox()
Returns the flag indicating whether to save the result into user's Inbox.int
getStateID()
Returns the current state ID set on the result set instanceResultSetBean
.void
initializeFromSchedule(WebSchedule s)
Deprecated.Starting with version 9.0 and the advent of Distribution Services, all schedule objects are replaced by subscriptions.void
initializeFromSubscription(WebSubscription s)
Initializes the bean using aWebSubscription
object.boolean
isPrompted()
Returns a boolean value indicating whether the result set instance contains any prompt questions.boolean
isReady()
Indicates whether the result set is in a "ready" state where results can be retrieved.void
refresh()
Refreshes the underlyingWebResultSetInstance
.void
refresh(boolean rePrompt)
Refreshes the underlying objects encapsulated by this bean with the option to reopen the prompt.void
setDisplayName(java.lang.String displayName)
Set display name of the bean.void
setExpiration(int hoursExpire)
Deprecated.As of WU 8.0.void
setMaxWait(int millis)
Sets the maximum amount of time, in milliseconds.void
setMessageID(java.lang.String msgID)
Sets the message ID to the result set instance contained in thisResultSetBean
.void
setPollingFrequency(int millis)
Sets the polling frequency, in milliseconds, which will be used when retrieving the results synchronously.void
setPromptsEventHandler(WebEventHandler promptsEventHandler)
Sets the prompt event handler on this bean, which theResultSetBean
applies to the embeddedPromptsBean
.void
setSaveToInbox(boolean saveToInbox)
Sets the boolean value indicating whether to save the result into user's Inbox.void
setStateID(int stateID)
Sets a state ID on the result set instance contained in thisResultSetBean
.-
Methods inherited from interface com.microstrategy.web.beans.ObjectBean
getBlockBegin, getBlockCount, getDisplayName, getFlags, getLevel, getObjectID, getObjectInfo, getObjectName, getObjectType, getParentFolderBean, getParentFolderBean, getParentID, setBlockBegin, setBlockCount, setFlags, setLevel, setObjectID, setObjectInfo, setObjectName, setObjectType
-
Methods inherited from interface com.microstrategy.utils.serialization.Persistable
restoreState, restoreState, saveState, saveState, saveState, saveState
-
Methods inherited from interface com.microstrategy.web.beans.RequestPersistable
restoreStateFromRequest, restoreStateFromRequest
-
Methods inherited from interface com.microstrategy.web.beans.Transformable
addTransform, addTransformByClass, addTransformByStyle, addTransformByStyle, clearTransforms, getBeanContext, getMessageString, getMyTransformInstances, getTransformInstance, getTransformInstance, getTransformInstances, getType, hasTransform, hasTransform, invalidateTransformCache, setBeanContext, transform, transform
-
Methods inherited from interface com.microstrategy.web.beans.WebBean
getDocument, getErrorInfo, getSessionInfo, isStale, setSessionInfo, setStale
-
Methods inherited from interface com.microstrategy.web.beans.WebComponent
addChild, addChildStateInfo, addChildStateInfo, collectData, collectMinimalData, generateOutput, getBeanContext, getChild, getChild, getChildByClass, getChildByType, getChildCount, getChildrenByClass, getDefaultStateLevel, getFeaturesManager, getMaximumStateLevel, getName, getOutputFormat, getParent, getPath, getPersistMode, getRenderingFilter, getRoot, getTargetBean, getTargetBeanPath, getWebEvent, getWebEvent, getWebEventHandler, getXMLStatus, handleRequest, hasChanged, hasJustOpened, initBean, invalidateChildrenState, isBeanContextEmpty, isFeatureAvailable, prepareForReuse, removeChild, removeChild, searchChild, setBeanContext, setBeanContext, setChanged, setChanged, setDefaultStateLevel, setFeaturesManager, setName, setOutputFormat, setParent, setPersistMode, setRenderingFilter, setTargetBean, setTargetBeanPath, setWebEventHandler
-
-
-
-
Method Detail
-
getMessageID
java.lang.String getMessageID() throws WebBeanException
Returns the message ID associated with the result set instance contained in thisResultSetBean
.- Returns:
- the message ID of the result set instance.
- Throws:
WebBeanException
- thrown if error occurred when retrieving the message ID.
-
setMessageID
void setMessageID(java.lang.String msgID)
Sets the message ID to the result set instance contained in thisResultSetBean
.- Parameters:
msgID
- the message ID set on thisResultSetBean
.
-
getLastPromptMessageID
java.lang.String getLastPromptMessageID()
Wheneverrefresh(boolean)
with the reprompt argument set to true, a duplicate message is made in order to answer all the new prompts, i.e.getMessageID()
will return the new message ID of the duplicate. This method will return the original message ID prior to the reprompt.- Returns:
- the last message ID before the current prompt.
- Since:
- MicroStrategy Web 9.0.0
-
getStateID
int getStateID() throws WebBeanException
Returns the current state ID set on the result set instanceResultSetBean
.- Returns:
- the state ID set on the result set instance
- Throws:
WebBeanException
- thrown if error occurred when retrieving the state ID.
-
setStateID
void setStateID(int stateID)
Sets a state ID on the result set instance contained in thisResultSetBean
.- Parameters:
stateID
- the state ID set on the result set instance
-
getMaxWait
int getMaxWait()
Returns the maximum amount of time, in milliseconds.ResultSetBean
will wait for the execution result in synchronous mode. This can be used to provide an upper bound on synchronous execution time. The value of 0 means to run the result set will execute in asynchronous mode, while -1 means waiting indefinitely until the data is returned or error occurs.- Returns:
- the current setting for the maxWait property.
-
setMaxWait
void setMaxWait(int millis)
Sets the maximum amount of time, in milliseconds.ResultSetBean
will wait for the execution results synchronous mode. This can be used to provide an upper bound on synchronous execution time. The value of 0 means to run the result set in asynchronous mode, while -1 means waiting indefinitely until the data is returned or error occurs.- Parameters:
millis
- the maximum amount of time to wait in synchronous mode.
-
getPollingFrequency
int getPollingFrequency()
Returns the polling frequency, in milliseconds, which will be used when retrieving the results synchronously.- Returns:
- The current frequency, in milliseconds.
-
setPollingFrequency
void setPollingFrequency(int millis)
Sets the polling frequency, in milliseconds, which will be used when retrieving the results synchronously.- Parameters:
millis
- the polling frequency to use, in milliseconds.
-
isPrompted
boolean isPrompted() throws WebBeanException
Returns a boolean value indicating whether the result set instance contains any prompt questions.- Returns:
- true if the result set instance contains prompts
- Throws:
WebBeanException
- thrown if error occurred when retrieving the prompted information.
-
getSaveToInbox
boolean getSaveToInbox()
Returns the flag indicating whether to save the result into user's Inbox.- Returns:
- true if saving the result into Inbox
-
setSaveToInbox
void setSaveToInbox(boolean saveToInbox)
Sets the boolean value indicating whether to save the result into user's Inbox.- Parameters:
saveToInbox
- true if want to save the result set to Inbox
-
getExpiration
int getExpiration()
Deprecated.As of WU 8.0.Returns the amount of time, in hours, to expire the cached execution results on thisResultSetBean
of 0 means the results are immediately expired.- Returns:
- the expiration time, in hours, of the results cached in this
ResultSetBean
.
-
setExpiration
void setExpiration(int hoursExpire)
Deprecated.As of WU 8.0.Returns the amount of time, in hours, to expire the cached execution results on thisResultSetBean
. If a value of 0 is supplied, the results are immediately expired.- Parameters:
hoursExpire
- expiration time in hours.
-
getPromptsBean
PromptsBean getPromptsBean()
Returns the embeddedPromptsBean
. If thisResultSetBean
does not contains any prompt questions, the returnedPromptsBean
will not contain aPromptObject
. If theResultSetBean
represents a document, then all prompts in all reports within the document will be contained in the bean.- Returns:
- the embedded
PromptsBean
.
-
setPromptsEventHandler
void setPromptsEventHandler(WebEventHandler promptsEventHandler)
Sets the prompt event handler on this bean, which theResultSetBean
applies to the embeddedPromptsBean
. If any prompt events are sent to theResultSetBean
event handler, it may delegate it to thePromptsBean
event handler.- Parameters:
promptsEventHandler
- a prompts event handler instance.
-
getPromptsEventHandler
WebEventHandler getPromptsEventHandler()
Returns the prompts event handler associated with thePromptsBean
.- Returns:
- the prompts event handler
- See Also:
getPromptsBean()
-
cancelRequest
boolean cancelRequest()
Cancels the current request.- Returns:
- returns true if successfully canceled.
-
refresh
void refresh() throws WebBeanException
Refreshes the underlyingWebResultSetInstance
. This refresh will not reopen the answered prompt, if any.- Throws:
WebBeanException
- thrown if error occurs when refreshing.
-
refresh
void refresh(boolean rePrompt) throws WebBeanException
Refreshes the underlying objects encapsulated by this bean with the option to reopen the prompt.- Parameters:
rePrompt
- true if you want to re-open the answered prompt if there is any.- Throws:
WebBeanException
- thrown if any error occurs during refreshing.
-
initializeFromSchedule
void initializeFromSchedule(WebSchedule s) throws WebBeanException
Deprecated.Starting with version 9.0 and the advent of Distribution Services, all schedule objects are replaced by subscriptions. Hence please useinitializeFromSubscription(WebSubscription)
instead.Initializes the bean using aWebSchedule
object. Thus the bean is setup to a state similar to the scheduled publication.- Parameters:
s
- the schedule.- Throws:
WebBeanException
- thrown if any error occurs during setting up the bean using the schedule passed.
-
initializeFromSubscription
void initializeFromSubscription(WebSubscription s) throws WebBeanException
Initializes the bean using aWebSubscription
object. Thus the bean is setup to a state similar to the subscribed publication.- Parameters:
s
- the subscription instance.- Throws:
WebBeanException
- thrown if any error occurs during setting up the bean using the subscription passed.
-
getResultSetInstance
WebResultSetInstance getResultSetInstance() throws WebBeanException
Returns the result set instance.- Returns:
- the result set instance.
- Throws:
WebBeanException
-
setDisplayName
void setDisplayName(java.lang.String displayName) throws WebBeanException
Set display name of the bean. By default it is doing nothing. For report bean it will update the display name of its underlyingWebMessage
by callingcom.microstrategy.web.objects.WebDisplayUnit#setDisplayName()
as soon as the prompt is answered, but do not have to wait for the report being executed.- Throws:
WebBeanException
- Since:
- MicroStrategy Web 9.0.0
-
isReady
boolean isReady() throws WebBeanException, WebObjectsException
Indicates whether the result set is in a "ready" state where results can be retrieved.- Returns:
- True if the data for the result set can be retrieved now; otherwise, false.
- Throws:
WebBeanException
- If we are unable to retrieve the result set instance from the bean.WebObjectsException
- If we are unable to get the status of the result set instance from the Intelligence Server.
-
-