com.microstrategy.web.objects.WebReportSource |
The WebReportSource interface allows the user to execute and retrieve report instances, along with giving access to many objects which have a supplemental usage in report execution. All report instances returned from this interface will have default result flag as EnumDSSXMLResultFlags.DssXmlResultPreserve bitwise or (|) EnumDSSXMLResultFlags.DssXmlResultNoDerivedPromptXML.
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
abstract WebReportInstance |
changeImportedCube(int sheetIndex, String colHeaders, String reportID, String msgID, boolean isUrl, String transformations)
Change the sheet index or insert new column headers on a imported cube@return
| ||||||||||
abstract WebReportInstance |
changeImportedCube(int sheetIndex, String colHeaders, String reportID, String msgID, boolean isUrl, String transformations, String dbRoleID, String sourceAccountID, int behaviorFlags)
Change the sheet index or insert new column headers on a imported cube, with support to cubes imported from OAuth source, and support idc behavior change flags@return
| ||||||||||
abstract WebReportInstance |
changeImportedCube(int sheetIndex, String colHeaders, String reportID, String msgID, boolean isUrl, String transformations, String dbRoleID, String sourceAccountID, int behaviorFlags, String documentID)
Change the sheet index or insert new column headers on a imported cube, with support to cubes imported from OAuth source, and support idc behavior change flags@return
| ||||||||||
abstract String |
getBinaryFileContent(PostedFile fileInfo, int maxNumElements, boolean preserveWhiteSpace, String outputDelimiter)
get the contents from binary file
| ||||||||||
abstract String |
getDIProjectSettings(int settingID)
get the Data import related project settings.
| ||||||||||
abstract WebElementSource |
getElementSource(String messageID)
Returns a
WebElementSource object which can be used to get elements within the working
set of the given report. | ||||||||||
abstract int |
getExecutionFlags()
Returns the current setting for the execution flags, which will be used when
submitting a report for execution to the Intelligence Server.
| ||||||||||
abstract WebReportExportSettings |
getExportSettings(int executionMode)
Returns
WebReportExportSettings which can be used to define the type of export
and the various parameters for the export | ||||||||||
abstract WebGraphProperties |
getGraphProperties()
Return a
WebGraphProperties object, which can be used to set the
web graph properties. | ||||||||||
abstract WebReportInstance |
getInstance(String messageID)
Returns a
WebReportInstance representing the report execution with the given message ID. | ||||||||||
abstract WebReportInstance |
getInstance(String messageID, int stateID)
Returns a
WebReportInstance representing the report execution with the given message ID and state ID. | ||||||||||
abstract WebReportInstance |
getInstanceFromRWDrill(RWDrill2ReportSettings drillSettings)
Create a report instance based on the drill from a document.
| ||||||||||
abstract WebReportInstance |
getInstanceFromSchedule(WebSchedule schedule)
This method is deprecated.
Starting with version 9.0 and the advent of Distribution Services, all schedule objects are replaced by subscriptions.
Please use
getInstanceFromSubscription(WebSubscription) instead.
| ||||||||||
abstract WebReportInstance |
getInstanceFromState(SAXSupport parser, String uri, String local, String qName, Attributes attrs)
Create a report instance based on the pre-stored report state, which can be obtained by calling WebReportInstance.saveState().
| ||||||||||
abstract WebReportInstance |
getInstanceFromState(String savedStateStr)
Create a report instance based on the pre-stored report state, which can be obtained by calling WebReportInstance.saveState().
| ||||||||||
abstract WebReportInstance |
getInstanceFromSubscription(WebSubscription subscription)
Create a report instance based on the subscription object.
| ||||||||||
abstract WebReportInstance |
getNewInstance(String reportID)
Generates a new report instance by executing the report with the given report ID, and
returns the resultant
WebReportInstance . | ||||||||||
abstract WebReportInstance |
getNewInstance()
Generates a report instance by executing what is considered to be the "new report" report
in metadata.
| ||||||||||
abstract WebReportInstance |
getNewInstance(WebReportExecutionSettings settings)
Generates a new report instance by executing the report with the given report ID, and
returns the resultant
WebReportInstance . | ||||||||||
abstract WebReportInstance |
getNewInstanceEx(String reportID, String extParams, int requestTimeout)
Generates a new report instance by executing the report with the given report ID and extendable parameter, and
returns the resultant
WebReportInstance . | ||||||||||
abstract WebReportInstance |
getNewInstanceFT(String filterID, String templateID)
Generates a new report instance by executing the given filter and template IDs as a report, and
returning the resultant
WebReportInstance . | ||||||||||
abstract String |
getPromptAnswer()
Returns the prompt answer, if any, which will be used to pre-answer prompts
when executing a new report.
| ||||||||||
abstract RWDrill2ReportSettings | getRWDrill2ReportSettings() | ||||||||||
abstract int |
getResultFlags()
Returns the current setting for the result flags, which will be used when
submitting a report for execution to the Intelligence Server or getting the results of a
report.
| ||||||||||
abstract WebResultWindow |
getResultWindow()
Returns a
WebResultWindow object, which can be used to set the
window of data that an execution or results retrieval will return. | ||||||||||
abstract String |
getStyleID()
Get the DSSID of the style on this report source, if the style was set by ID.
| ||||||||||
abstract String |
getStyleName()
Get the name of the style on this report, if the style was set by name.
| ||||||||||
abstract String |
getViewSettings()
Returns the current setting of the view settings XML, which will be sent
to the Intelligence Server upon executing a report.
| ||||||||||
abstract WebReportInstance |
importCube(String url, String msgID, String tableID, String reportID, String documentID, int behaviorFlags)
Create a cube on the IServer based on a file at the specified url, with support to msgID and tableID for EMMA cube
| ||||||||||
abstract WebReportInstance |
importCube(PostedFile fileInfo, String reportID)
Create a cube on the IServer based on an imported file
| ||||||||||
abstract WebReportInstance |
importCube(String url, String reportID, String documentID)
Create a cube on the IServer based on a file at the specified url
| ||||||||||
abstract WebReportInstance |
importCube(String url, String reportID, String documentID, int behaviorFlags)
Create a cube on the IServer based on a file at the specified url, with support to idc import behavior change flags
| ||||||||||
abstract WebReportInstance |
importCube(PostedFile fileInfo, String reportID, String documentID)
Create a cube on the IServer based on an imported file
| ||||||||||
abstract WebReportInstance |
importCube(String reportID, String documentID, int behaviorFlags, String data)
Create a cube on the IServer based on a file at the specified url, with support to idc import behavior change flags
| ||||||||||
abstract WebReportInstance |
importCube(PostedFile fileInfo, String msgID, String tableID, String reportID, String documentID, String numOfChunks, String chunkSize, String index, int behaviorFlags)
Create a cube on the IServer based on an imported file, with support to EMMA source table ID.
| ||||||||||
abstract WebReportInstance |
importCube(String url, String reportID)
Create a cube on the IServer based on a file at the specified url
| ||||||||||
abstract WebReportInstance |
importCube(PostedFile fileInfo, String reportID, String documentID, int behaviorFlags)
Create a cube on the IServer based on an imported file, with support to idc import behavior change flags
| ||||||||||
abstract WebReportInstance |
importCube(PostedFile fileInfo, String msgID, String tableID, String reportID, String documentID, int behaviorFlags)
Create a cube on the IServer based on an imported file, with support to EMMA source table ID
| ||||||||||
abstract WebReportInstance |
importCube(String msgID, String tableID, String reportID, String documentID, String numOfChunks, String chunkSize, String index, long fileSize, String fileName, String fileType, int behaviorFlags)
Create a cube on the IServer based on an imported file, with support to EMMA source table ID.
| ||||||||||
abstract WebReportInstance |
importCube(String msgID, String tableID, String reportID, String documentID, int behaviorFlags, String data)
Create a cube on the IServer based on an imported file, with support to EMMA source table ID
| ||||||||||
abstract WebReportExecutionSettings | newExecutionSettings() | ||||||||||
abstract WebReportInstance |
refresh(String messageID, int stateID, boolean reprompt)
Refresh the report instance specified by the message id and state id.
| ||||||||||
abstract WebReportInstance |
refresh(String messageID, int stateID)
Refresh the report instance specified by the message id and state id.
| ||||||||||
abstract WebReportInstance |
refresh(String messageID)
Refresh the report instance specified by the message id and latest state.
| ||||||||||
abstract WebReportInstance |
refresh(String messageID, boolean reprompt)
Refresh the report instance specified by the message id and latest state.
| ||||||||||
abstract String |
setCubeMapping(String msgID, String mappingXML, String cubeRepublishBehavior)
Set the row/column to attribute/metric mapping for the specified imported cube, with support to cube republishing behavior flag
| ||||||||||
abstract String |
setCubeMapping(String msgID, String mappingXML, String cubeRepublishBehavior, String documentID)
Set the row/column to attribute/metric mapping for the specified imported cube, with support to cube republishing behavior flag
| ||||||||||
abstract String |
setCubeMapping(String msgID, String mappingXML)
Set the row/column to attribute/metric mapping for the specified imported cube
| ||||||||||
abstract void |
setExecutionFlags(int executionFlags)
Sets the execution flags, which will be used when
submitting a report for execution to the Intelligence Server.
| ||||||||||
abstract void | setLastExecutionMode(int execMode) | ||||||||||
abstract void |
setPromptAnswer(String promptAnswer)
Sets a prompt answer which will be used to pre-answer any reports executed by this object.
| ||||||||||
abstract void |
setResultFlags(int resultFlags)
Sets the result flags, which will be used when
submitting a report for execution to the Intelligence Server.
| ||||||||||
abstract void |
setStyleID(String styleID)
Set a style by style DSSID.
| ||||||||||
abstract void |
setStyleName(String styleName)
Set a style by style name.
| ||||||||||
abstract void |
setViewSettings(String viewSettings)
Sets the view settings XML, which will be sent
to the Intelligence Server upon executing a report.
|
Change the sheet index or insert new column headers on a imported cube@return
WebObjectsException |
---|
Change the sheet index or insert new column headers on a imported cube, with support to cubes imported from OAuth source, and support idc behavior change flags@return
WebObjectsException |
---|
Change the sheet index or insert new column headers on a imported cube, with support to cubes imported from OAuth source, and support idc behavior change flags@return
WebObjectsException |
---|
get the contents from binary file
fileInfo | The PostedFile that represents the file. |
---|---|
maxNumElements | the maximum number of elements to return |
preserveWhiteSpace | indicates if to strip off element’s leading and trailing space |
outputDelimiter | output delimiter |
WebObjectsException |
---|
get the Data import related project settings.
WebObjectsException |
---|
Returns a WebElementSource
object which can be used to get elements within the working
set of the given report.
messageID | The message ID of the report instance of the working set that the elements will come from. |
---|
WebElementSource
object set to return elements within the given
report's working set.
Returns the current setting for the execution flags, which will be used when submitting a report for execution to the Intelligence Server.
EnumDSSXMLExecutionFlags
.Returns WebReportExportSettings
which can be used to define the type of export
and the various parameters for the export
executionMode | a value from EnumWebReportExecutionModes |
---|
Return a WebGraphProperties
object, which can be used to set the
web graph properties. These properties will be passed as a parameter when a report is executed.
First time call of this method will return a WebGraphProperties
object
with no property inside it. User can use the methods exposed by WebGraphProperties
interface
to add and manipulate the properties inside it. The other calls will return the current setting.
WebGraphProperties
object to represent current
settings of graph properties. First call will return an empty WebGraphProperties
.
Returns a WebReportInstance
representing the report execution with the given message ID.
Note that this does not cause a report execution to begin, but rather can be used to obtain the
results of an already existing report instance.
messageID | The message ID of the job submitted to the Intelligence Server. |
---|
WebReportInstance
object, representing the report with the given message ID.WebObjectsException | Thrown if the operation cannot be completed successfully. |
---|
Returns a WebReportInstance
representing the report execution with the given message ID and state ID.
Note that this does not cause a report execution to begin, but rather can be used to obtain the
results of an already existing report instance.
messageID | The message ID of the job submitted to the Intelligence Server. |
---|---|
stateID | The state ID of the job submitted to the iIntelligence Server. |
WebReportInstance
object, representing the report with the given message ID.WebObjectsException | Thrown if the operation cannot be completed successfully. |
---|
Create a report instance based on the drill from a document.
drillSettings | RWDrill2ReportSettings The drill parameters object. |
---|
WebObjectsException | |
---|---|
WebObjectsException | Thrown when error ocurrs during creating the report instance |
This method is deprecated.
Starting with version 9.0 and the advent of Distribution Services, all schedule objects are replaced by subscriptions.
Please use getInstanceFromSubscription(WebSubscription)
instead.
Create a report instance based on the schedule object. Thus, a report instance with the state similar to a scheduled report can be obtained using this method.
schedule | The schedule object. |
---|
WebObjectsException | Thrown when error ocurrs during creating the report instance |
---|
Create a report instance based on the pre-stored report state, which can be obtained by calling WebReportInstance.saveState().
parser | SAX parser. |
---|---|
uri | The Namespace URI, or the empty string if the element has no Namespace URI or if Namespace processing is not being performed. |
local | The local name (without prefix), or the empty string if Namespace processing is not being performed. |
qName | The qualified name (with prefix), or the empty string if qualified names are not available. attrs The attributes attached to the element. If there are no attributes, it shall be an empty Attributes object |
WebObjectsException | Thrown when error ocurrs during create the report instance according to the input. |
---|
Create a report instance based on the pre-stored report state, which can be obtained by calling WebReportInstance.saveState().
savedStateStr | The saved state of a report instance, which is obtained by calling WebReportInstance.saveState(). |
---|
WebObjectsException | Thrown when error ocurrs during create the report instance according to the input string. |
---|
Create a report instance based on the subscription object. Thus, a report instance with the state similar to a subscribed report can be obtained using this method.
subscription | The subscription object. |
---|
WebObjectsException | Thrown when error ocurrs during creating the report instance |
---|
Generates a new report instance by executing the report with the given report ID, and
returns the resultant WebReportInstance
.
reportID | The DSSID of the report to execute. |
---|
WebReportInstance
object, representing the report executed by this method.WebObjectsException | Signals an error when executing the report. |
---|
Generates a report instance by executing what is considered to be the "new report" report in metadata.
WebReportInstance
object representing the executed report.WebObjectsException | Signals an error when executing the report. |
---|
Generates a new report instance by executing the report with the given report ID, and
returns the resultant WebReportInstance
.
settings | The WebReportExecutionSettings |
---|
WebReportInstance
object, representing the report executed by this method.WebObjectsException | Signals an error when executing the report. |
---|
Generates a new report instance by executing the report with the given report ID and extendable parameter, and
returns the resultant WebReportInstance
.
reportID | The DSSID of the report to execute. |
---|---|
extParams | extendable parameter when executing the report |
requestTimeout | Request timeout value. It is used to override the default session request timeout value for the saving job. By default it's -1. |
WebReportInstance
object, representing the report executed by this method.WebObjectsException | Signals an error when executing the report. |
---|
Generates a new report instance by executing the given filter and template IDs as a report, and
returning the resultant WebReportInstance
.
filterID | The filter ID of the report to execute. |
---|---|
templateID | The template ID of the report to execute. |
WebReportInstance
object, representing the report executed by this method.WebObjectsException | Signals an error when executing the report. |
---|
Returns the prompt answer, if any, which will be used to pre-answer prompts when executing a new report.
RWDrill2ReportSettings
Returns the current setting for the result flags, which will be used when submitting a report for execution to the Intelligence Server or getting the results of a report.
EnumDSSXMLResultFlags
.Returns a WebResultWindow
object, which can be used to set the
window of data that an execution or results retrieval will return.
WebResultWindow
object, which can be edited to change
the result window of the report.
Get the DSSID of the style on this report source, if the style was set by ID.
Get the name of the style on this report, if the style was set by name.
Returns the current setting of the view settings XML, which will be sent to the Intelligence Server upon executing a report.
WebObjectsException | Thrown when error in generating the current view setting. |
---|
Create a cube on the IServer based on a file at the specified url, with support to msgID and tableID for EMMA cube
url | String containing location of the file used to create the new cube |
---|---|
msgID | EMMA cube msgID |
tableID | EMMA source table ID |
reportID | reportID for republish |
documentID | the document ID (used for mapping) |
behaviorFlags | idc behavior change flags 'fg' |
WebReportInstance
of the cube created from the file at the specified locationWebObjectsException |
---|
Create a cube on the IServer based on an imported file
fileInfo | PostedFile representing the file to be imported |
---|---|
reportID | reportID for republish |
WebReportInstance
of the cube created from the fileWebObjectsException |
---|
Create a cube on the IServer based on a file at the specified url
url | String containing location of the file used to create the new cube |
---|---|
reportID | reportID for republish |
documentID | the document ID (used for mapping) |
WebReportInstance
of the cube created from the file at the specified locationWebObjectsException |
---|
Create a cube on the IServer based on a file at the specified url, with support to idc import behavior change flags
url | String containing location of the file used to create the new cube |
---|---|
reportID | reportID for republish |
documentID | the document ID (used for mapping) |
behaviorFlags | idc behavior change flags 'fg' |
WebReportInstance
of the cube created from the file at the specified locationWebObjectsException |
---|
Create a cube on the IServer based on an imported file
fileInfo | PostedFile representing the file to be imported |
---|---|
reportID | reportID for republish |
documentID | the document ID (used for mapping) |
WebReportInstance
of the cube created from the fileWebObjectsException |
---|
Create a cube on the IServer based on a file at the specified url, with support to idc import behavior change flags
reportID | reportID for republish |
---|---|
documentID | the document ID (used for mapping) |
behaviorFlags | idc behavior change flags 'fg' |
data | String containing contents of file |
WebReportInstance
of the cube created from the file at the specified locationWebObjectsException |
---|
Create a cube on the IServer based on an imported file, with support to EMMA source table ID. Import the file by chunks.
fileInfo | The PostedFile that represents the file. |
---|---|
msgID | message ID for EMMA cube |
tableID | source table ID for EMMA cube |
reportID | reportID for republish |
documentID | the document ID (used for mapping) |
numOfChunks | the total number of chunks the file split into |
chunkSize | the size of each chunk |
index | the index of each chunks |
behaviorFlags | idc behavior change flags 'fg' |
WebReportInstance
of the cube created from the fileWebObjectsException |
---|
Create a cube on the IServer based on a file at the specified url
url | String containing location of the file used to create the new cube |
---|---|
reportID | reportID for republish |
WebReportInstance
of the cube created from the file at the specified locationWebObjectsException |
---|
Create a cube on the IServer based on an imported file, with support to idc import behavior change flags
fileInfo | PostedFile representing the file to be imported |
---|---|
reportID | reportID for republish |
documentID | the document ID (used for mapping) |
behaviorFlags | idc behavior change flags 'fg' |
WebReportInstance
of the cube created from the fileWebObjectsException |
---|
Create a cube on the IServer based on an imported file, with support to EMMA source table ID
fileInfo | PostedFile representing the file to be imported |
---|---|
msgID | message ID for EMMA cube |
tableID | source table ID for EMMA cube |
reportID | reportID for republish |
documentID | the document ID (used for mapping) |
behaviorFlags | idc behavior change flags 'fg' |
WebReportInstance
of the cube created from the fileWebObjectsException |
---|
Create a cube on the IServer based on an imported file, with support to EMMA source table ID. Import the file by chunks.
msgID | message ID for EMMA cube |
---|---|
tableID | source table ID for EMMA cube |
reportID | reportID for republish |
documentID | the document ID (used for mapping) |
numOfChunks | the total number of chunks the file split into |
chunkSize | the size of each chunk |
index | the index of each chunks |
fileSize | total size of the file |
fileName | name of the file |
fileType | type of the file |
behaviorFlags | idc behavior change flags 'fg' |
WebReportInstance
of the cube created from the fileWebObjectsException |
---|
Create a cube on the IServer based on an imported file, with support to EMMA source table ID
msgID | message ID for EMMA cube |
---|---|
tableID | source table ID for EMMA cube |
reportID | reportID for republish |
documentID | the document ID (used for mapping) |
behaviorFlags | idc behavior change flags 'fg' |
data | {@String } representing the contents of the file |
WebReportInstance
of the cube created from the fileWebObjectsException |
---|
WebReportExecutionSettings
Refresh the report instance specified by the message id and state id. If there is any prompt in this report, based on the reprompt parameter, this refresh will or will not reopen the answered prompt.
messageID | The message ID of the report instance to be refreshed. |
---|---|
stateID | The state ID of the report instance to be refreshed. |
reprompt | When there is prompt in this report, if this is true, the refresh will reopen the prompt; if this is false, the refresh will use the original prompt answer. |
WebReportInstance
.WebObjectsException | Thrown when there is any error occurs during refresh process. |
---|
Refresh the report instance specified by the message id and state id. This refresh will not reopen the answered prompt, if there is any. Dynamic reports (e.g. drilled reports) cannot be refreshed.
messageID | The message ID of the report instance to be refreshed. |
---|---|
stateID | The state ID of the report instance to be refreshed. |
WebReportInstance
.WebObjectsException | Thrown when there is any error occurs during refresh process. |
---|
Refresh the report instance specified by the message id and latest state. This refresh will not reopen the answered prompt, if there is any. Dynamic reports (e.g. drilled reports) cannot be refreshed.
messageID | The message ID of the report instance to be refreshed. |
---|
WebReportInstance
.WebObjectsException | Thrown when there is any error occurs during refresh process. |
---|
Refresh the report instance specified by the message id and latest state. If there is any prompt in this report, based on the reprompt parameter, this refresh will or will not reopen the answered prompt.
messageID | The message ID of the report instance to be refreshed. |
---|---|
reprompt | When there is prompt in this report, if this is true, the refresh will reopen the prompt; if this is false, the refresh will use the original prompt answer. |
WebReportInstance
.WebObjectsException | Thrown when there is any error occurs during refresh process. |
---|
Set the row/column to attribute/metric mapping for the specified imported cube, with support to cube republishing behavior flag
msgID | String containing the message id of the cube to be modified |
---|---|
mappingXML | String containing the XML that IServer will use to modify the mapping |
cubeRepublishBehavior | String containing the cube republishing behavior flag |
WebObjectsException |
---|
Set the row/column to attribute/metric mapping for the specified imported cube, with support to cube republishing behavior flag
msgID | String containing the message id of the cube to be modified |
---|---|
mappingXML | String containing the XML that IServer will use to modify the mapping |
cubeRepublishBehavior | String containing the cube republishing behavior flag |
documentID | String containing the ID of the document for Cube Join |
WebObjectsException |
---|
Set the row/column to attribute/metric mapping for the specified imported cube
msgID | String containing the message id of the cube to be modified |
---|---|
mappingXML | String containing the XML that IServer will use to modify the mapping |
WebObjectsException |
---|
Sets the execution flags, which will be used when submitting a report for execution to the Intelligence Server.
executionFlags | The execution flags setting to use. This should be
the bitwise or of values from EnumDSSXMLExecutionFlags . |
---|
Sets a prompt answer which will be used to pre-answer any reports executed by this object.
promptAnswer | The value to pre-answer prompts with when executing reports via getNewInstance() or getNewInstanceFT(). |
---|
Sets the result flags, which will be used when submitting a report for execution to the Intelligence Server.
resultFlags | The result flags setting to use. This should be
the bitwise or of values from EnumDSSXMLResultFlags . |
---|
Set a style by style DSSID.
styleID | the DSSID of the style object to be applied. |
---|
Set a style by style name.
styleName | the name of the style object to be applied. |
---|
Sets the view settings XML, which will be sent to the Intelligence Server upon executing a report.
viewSettings | The new value of the view settings XML. |
---|
WebObjectsException | Thrown when the format of the input string is wrong. |
---|