Interface IDSSXMLObjectServer
-
public interface IDSSXMLObjectServer
Provides the interface for an application to retrieve objects by object ID or search criteria.- Since:
- MicroStrategy Web 7.3.1 or earlier
-
-
Nested Class Summary
Nested Classes Modifier and Type Interface Description static interface
IDSSXMLObjectServer.StringFormatAndErrorData
-
Field Summary
Fields Modifier and Type Field Description static int
DEFAULT_FindObject_blockBegin
Default value for the blockBegin parameter of the FindObject methodstatic int
DEFAULT_FindObject_blockCount
Default value for the blockCount parameter of the FindObject methodstatic int
DEFAULT_FindObject_flags
Default value for the flags parameter of the FindObject methodstatic int
DEFAULT_FindObject_level
Default value for the level parameter of the FindObject methodstatic int
DEFAULT_FindObject_type
Default value for the type parameter of the FindObject methodstatic int
DEFAULT_getRoot_blockBegin
Default value for the blockBegin parameter of the getRoot methodstatic int
DEFAULT_getRoot_blockCount
Default value for the blockCount parameter of the getRoot methodstatic int
DEFAULT_getRoot_flags
Default value for the flags parameter of the getRoot methodstatic int
DEFAULT_getRoot_level
Default value for the level parameter of the getRoot methodstatic int
DEFAULT_GetSearchResults_blockBegin
Default value for the blockBegin parameter of the GetSearchResults methodstatic int
DEFAULT_GetSearchResults_blockCount
Default value for the blockCount parameter of the GetSearchResults methodstatic int
DEFAULT_GetSearchResults_objectFlags
Default value for the objectFlags parameter of the GetSearchResults method
-
Method Summary
All Methods Instance Methods Abstract Methods Deprecated Methods Modifier and Type Method Description void
ApplyRuntimeSettings(java.lang.String sessionID)
This method will cause the Intelligence Server to reload it's ServerDef object from the metadata.java.lang.String
CertifyObject(java.lang.String sessionID, java.lang.String objectID, int objectType, int certify, int resultFlag)
This method handles the certify and decertify of the object(only support document and report now).java.lang.String
ChangeFeatureStatus(java.lang.String sessionID, java.lang.String deltaXML)
This method is used to change the status of featuresjava.lang.String
ChangeJournalCommon(java.lang.String sessionID, int type, java.lang.String extParams)
This method purge/enable/disable change journal.java.lang.String
ChangeJournalSearch(java.lang.String sessionID, int maxEntries, java.lang.String searchContentXML)
This method finds a set of DSS objects with the given conditions.java.lang.String
ChangeObjectID(java.lang.String sessionID, java.lang.String objectId, int type, java.lang.String newId)
This method changes DSS ID of the given object.java.lang.String
CopyObject(java.lang.String sessionID, java.lang.String objectID, int objectType, int flags, java.lang.String newName, java.lang.String folderDID)
This method is used to create a copy of an existing object in the metadata.java.lang.String
CreateFolder(java.lang.String sessionID, java.lang.String folderName, java.lang.String parentFolderID, java.lang.String folderDesc)
This method creates an empty folder in metadata.java.lang.String
createLocale(java.lang.String sessionID, java.lang.String objectName, int localeID, int localeFlag, java.lang.String folderID, int objectFlag)
This manipulation allows the caller to create a locale object.void
DeleteLinkItems(java.lang.String sessionID, java.lang.String requestXML)
This method is used to delete link items on the Intelligence Server.void
DeleteObject(java.lang.String sessionID, java.lang.String objectID, int objectType)
This method deletes an object.void
DeletePalette(java.lang.String sessionID, java.lang.String paletteID)
This method deletes an object.void
ExecuteBulkSave(java.lang.String sessionID, java.lang.String objectXML)
This method is used to submit bulk save.java.lang.String
FindObject(java.lang.String sessionID, java.lang.String objectID, int type, int flags, int level, int blockBegin, int blockCount)
Retrieves the representation of an object in XML.java.lang.String
FindObject(java.lang.String sessionID, java.lang.String objectID, int type, int flags, int level, int blockBegin, int blockCount, int propertyFlags)
Retrieves the representation of an object in XML.java.lang.String
FindObject(java.lang.String sessionID, java.lang.String objectID, int type, int flags, int level, int blockBegin, int blockCount, int propertyFlags, java.lang.String extParams)
Retrieves the representation of an object in XML.java.lang.String
FindObject(java.lang.String sessionID, java.lang.String objectID, int type, int flags, int level, int blockBegin, int blockCount, int propertyFlags, java.lang.String extParams, boolean isLeanObject)
Retrieves the representation of an object in XML.java.lang.String
FindObject(java.lang.String sessionID, java.lang.String messageID, java.lang.String objectID, int type, int flags, int level, int blockBegin, int blockCount, int propertyFlags, java.lang.String extParams)
java.lang.String
FindObject(java.lang.String sessionID, java.lang.String messageID, java.lang.String objectID, int type, int flags, int level, int blockBegin, int blockCount, int propertyFlags, java.lang.String extParams, boolean isLeanObject)
java.lang.String
FindObject(java.lang.String sessionID, java.lang.String messageID, java.lang.String objectID, int type, int flags, int level, int blockBegin, int blockCount, int propertyFlags, java.lang.String extParams, boolean isLeanObject, boolean needThumbnail)
java.lang.String
FindObjectByPath(java.lang.String sessionID, int type, int flags, int level, int blockBegin, int blockCount, java.lang.String fullPath)
Retrieves the representation of an object in XML.java.lang.String
FindObjectByPath(java.lang.String sessionID, int type, int flags, int level, int blockBegin, int blockCount, java.lang.String fullPath, int searchFlags)
Retrieves the representation of an object in XML.java.lang.String
FindUserObjects(java.lang.String sessionID, java.util.List<java.lang.String> userIds, int flags)
Retrieves the representation of a list of user object in XML.java.lang.String
getAllPalettes(java.lang.String sessionId)
Get all palettes (including system and custom)java.lang.String
getAndSetExternalDatasourceInfo(java.lang.String sessionID, int flags, java.lang.String dbrid, java.util.Map<java.lang.String,java.lang.String> tokenInfo)
Retrieve external datasource information after setting new tokenjava.lang.String
getAndSetExternalSourceInfo(java.lang.String sessionID, int flags, java.lang.String sourceID, int sourceType, java.lang.String u, java.lang.String localeDateNumber, java.util.Map<java.lang.String,java.lang.String> tokenInfo)
Retrieve external source information after setting new tokenjava.lang.String
GetChangeJournalSearchResults(java.lang.String sessionID, java.lang.String searchID, IntWrapper status, int blockBegin, int blockCount)
This method retrieves the results of a change journal search.java.lang.String
GetConfiguredDSNs(java.lang.String sessionID)
Returns XML containing a list of Data Source Names configured on the I-Server machine.java.lang.String
GetCubeSecurityFilters(java.lang.String sessionID, java.lang.String userID, java.lang.String cubeID)
This method get the cube's security filters. if only provide cubeId, the method will return cube's all security filters for provided cube. if provide cubeId and userId, the method will return an cube's security filter for provided cube related to provided user.java.lang.String
GetDependencies(java.lang.String sessionID, java.lang.String objectID, int objectType, int objectSubType, int detailFlag)
This method retrieves the results of dependency search.java.lang.String
GetDimensionAttributeLock(java.lang.String sessionID, java.lang.String dimensionID)
Returns XML containing the System Dimension Attributes that have lock properties specifiedjava.lang.String
getExternalSourceInfo(java.lang.String sessionID, int flags, java.lang.String sourceID, int sourceType)
Retrieve external source informationjava.lang.String
GetFeatureInfos(java.lang.String sessionID)
This method retrieves the information of all features.java.lang.String
GetFilterExpression(java.lang.String sessionID, java.lang.String commandXML)
Returns the filter expression that the given filter expression resolves into.java.lang.String
GetFlexProperties(java.lang.String sessionID)
java.lang.String
GetFolderID(java.lang.String sessionID, int folderName)
This method returns the ID of a special folder.java.lang.String
GetFolderID(java.lang.String sessionID, int folderName, int requestTimeout)
This method returns the ID of a special folder with specified request timeout.java.lang.String
GetFolderID(java.lang.String sessionID, int folderName, int requestTimeout, boolean attemptFailover)
java.lang.String
GetLinkItems(java.lang.String sessionID, java.lang.String requestXML, int blockBegin, int blockCount, int flags)
This method is used to retrieve link items from the Intelligence Server.java.lang.String
GetProperties(java.lang.String sessionID, java.lang.String requestXML, int flags)
Gets a property set from the server.java.lang.String
GetPublishInfo(java.lang.String sessionID, java.lang.String objectID)
This method will provide the publish information for an object, if unpublished an empty response xml will be returnedjava.lang.String
GetQuickSearchStatus(java.lang.String sessionID, int qscmd)
Returns XML containing quick search status.java.lang.String
getRoot(java.lang.String sessionID, int flags, int level, int blockBegin, int blockCount)
This method retrieves the root of an object hierarchy.java.lang.String
GetRootExpression(java.lang.String sessionID, java.lang.String metricID)
Returns the root expression of the specified metric.java.lang.String
GetSearchResults(java.lang.String sessionID, java.lang.String searchID, int objectFlags, boolean treeInfo, int blockBegin, int blockCount, StringWrapper searchObject, IntWrapper status)
This method retrieves the results of a search.java.lang.String
GetSearchResults(java.lang.String sessionID, java.lang.String searchID, int objectFlags, boolean treeInfo, int blockBegin, int blockCount, StringWrapper searchObject, IntWrapper status, int searchType)
Add a new parameter 'searchType' to send as a flag to backend to stop putting 'folder' objects at top of search results.java.lang.String
GetSearchResults(java.lang.String sessionID, java.lang.String searchID, int objectFlags, int blockBegin, int blockCount, StringWrapper searchObject, IntWrapper status)
This method retrieves the results of a search.java.lang.String
GetSearchSuggestions(java.lang.String sessionID, java.lang.String searchKey, int blockCount, int localeId)
Returns XML containing a list of search suggestions based on the search key provided.java.lang.String
GetServerDef(java.lang.String sessionID)
java.lang.String
GetServerDef(java.lang.String sessionID, java.lang.Boolean defaultFlag)
This method returns the ServerDef which is currently being used by a running server.java.lang.String
GetServerDefID(java.lang.String sessionID)
This method returns the DSSID of the ServerDef which is currently being used by a running server.java.lang.String
GetSourceInfo(java.lang.String sessionID, int type, java.lang.String deltaXML)
This method is used to get source info.byte[]
GetSourceManipulatorDelta(java.lang.String sessionID, java.lang.String manipulationXML)
Invoke the source manipulator to return a metadata delta package.java.lang.String
GetSystemFunctions(java.lang.String sessionID, int flags)
This method retrieves the list of System functions.java.lang.String
GetSystemLinkID(java.lang.String sessionID, java.lang.String projectID, int systemLink)
This method returns the DSSID of the Link specified by the project and link type.java.lang.String
GetTransactionReportXML(java.lang.String sessionID, java.lang.String transactionReportID)
Returns the XML contains the inputMapping for the transactionReportjava.lang.String
GetUserDICubeInfo(java.lang.String sessionId, java.lang.String[] ids, int option)
java.lang.String
GetUserLibrary(java.lang.String confSessionID)
Deprecated.java.lang.String
GetUserLibrary(java.lang.String confSessionID, java.util.List<EnumDSSXMLLibraryOutputFlag> outputFlags)
Deprecated.IDSSXMLObjectServer.StringFormatAndErrorData
GetUserLibraryEx(java.lang.String confSessionID, java.util.List<EnumDSSXMLLibraryOutputFlag> outputFlags)
This method retrieves the results of all dossiers belonged to specified user.IDSSXMLObjectServer.StringFormatAndErrorData
GetUserLibraryEx(java.lang.String confSessionID, java.util.List<EnumDSSXMLLibraryOutputFlag> outputFlags, java.lang.String applicationId)
This method retrieves the results of all dossiers belonged to specified user in a specific custom application.java.lang.String
GetVLDBInheritedValuesAsJSON(java.lang.String sessionID, java.lang.String objectID, int objectType, java.lang.String messageID, java.lang.String propertySetID, java.util.List<java.lang.Integer> propertyIDs)
This method is used for getting the inherited value of VLDB property.java.lang.String
InvokeSourceManipulator(java.lang.String sessionID, java.lang.String manipulationXML)
Invoke the source manipulator to perform project merge or metadata deltas in a bulk operation.boolean
IsFeatureEnabled(java.lang.String sessionID, java.lang.String featureName)
This method retrieves whether the specified feature is enabled.boolean
isFeatureFlagExisted(java.lang.String sessioinID, java.lang.String featureID)
This method checks the existence of specific feature flag, to see if this is set in FeatureFlags.PDS or not.java.lang.String
listTranslations(java.lang.String sessionID, java.lang.String listXml)
This manipulation allows user to list any translations at any locales for any keys for multiple objects and their embedded objects.java.lang.String
manipulateLocaleLinkedToInterfaceLanguage(java.lang.String sessionID, java.lang.String objectName, int localeID, java.lang.String interfaceLanguageId, int localeFlag, java.lang.String folderID, int objectFlag)
This manipulation allows the caller to create a locale object linked to interface language.java.lang.String
ManipulateUserAnswer(java.lang.String sessionID, java.lang.String commandXML)
This method loads, edits and saves user prompt answers.java.lang.String
ManipulateUserAnswer(java.lang.String sessionID, java.lang.String commandXML, int flag)
This method loads, edits and saves user prompt answers.java.lang.String
MoveObject(java.lang.String sessionID, java.lang.String objectID, int objectType, int flags, java.lang.String newName, java.lang.String folderDID)
This method is used to move an existing object in the metadata.java.lang.String
MoveObject(java.lang.String sessionID, java.lang.String objectID, int objectType, int flags, java.lang.String newName, java.lang.String folderDID, boolean solveNameConflict)
This method is used to move an existing object in the metadata.java.lang.String
ObjectLock(java.lang.String sessionID, java.lang.String command)
This method locks, unlocks and queries object locks in the metadata.java.lang.String
ParseMetric(java.lang.String sessionID, java.lang.String metricID, java.lang.String mtXML, java.lang.String tokenStreamXML, java.lang.String localSymbolFolderXML, int parserActionFlags, int parserOutFlags, java.lang.String folderID)
This method is used to parse a metric.java.lang.String
ParseMetric(java.lang.String sessionID, java.lang.String messageID, java.lang.String metricID, java.lang.String mtXML, java.lang.String tokenStreamXML, java.lang.String localSymbolFolderXML, int parserActionFlags, int parserOutFlags, java.lang.String folderID)
This method is used to parse a metric.java.lang.String
ParseMetricAndAttribute(java.lang.String sessionID, java.lang.String messageID, java.lang.String objectID, int objectType, java.lang.String mtXML, java.lang.String tokenStreamXML, java.lang.String localSymbolFolderXML, int parserActionFlags, int parserOutFlags, java.lang.String folderID, java.lang.String formId)
This method is used to parse a metric, derived metric or derived attribute.java.lang.String
ParseModel(java.lang.String sessionID, java.lang.String objectID, int targetType, java.util.OptionalInt dssType, java.lang.String tokenStreamXML, java.lang.String localSymbolFolderXML, java.lang.String availableObjectsXML, int parserActionFlags, int parserOutFlags)
This method is used to parse a model except metric and attributes, including fact, filter and any other objects.java.lang.String
ParseModel(java.lang.String sessionID, java.lang.String objectID, int objectType, java.util.OptionalInt dssType, java.lang.String tokenStreamXML, java.lang.String localSymbolFolderXML, java.lang.String availableObjectsXML, int parserActionFlags, int parserOutFlags, java.lang.String messageId)
This method is used to parse a model except metric and attributes, including fact, filter and any other objects.java.lang.String
PropagateToChildren(java.lang.String sessionID, java.lang.String id, int objFlags)
java.lang.String
PublishInstance(java.lang.String sessionID, java.lang.String messageID, EnumDSSXMLObjectPublishActions publishFlag, java.util.List<java.lang.String> userOrGroupIds)
The publish instance method will handle the publishing, republish, unpublish workflow of an objects instance when published the personal view will contain manipulationsin the definition of the instance.java.lang.String
PublishObject(java.lang.String sessionID, java.lang.String objectID, EnumDSSXMLObjectPublishActions publishFlag, java.util.List<java.lang.String> userOrGroupIds, java.util.List<java.lang.Integer> userOrGroupOperations)
The publish object method will handle the publishing, republish, unpublish workflow of an object in the metadata.java.lang.String
PublishObject(java.lang.String sessionID, java.lang.String objectID, EnumDSSXMLObjectPublishActions publishFlag, java.util.List<java.lang.String> userOrGroupIds, java.util.List<java.lang.Integer> userOrGroupOperations, java.lang.Integer objectType)
The publish object method will handle the publishing, republish, unpublish workflow of an object in the metadata.java.lang.String
PublishObjects(java.lang.String sessionID, java.util.List<java.lang.String> docIds, java.util.List<java.lang.String> reportIds, EnumDSSXMLObjectPublishActions publishFlag, java.util.List<java.lang.String> userOrGroupIds, java.util.List<java.lang.Integer> userOrGroupOperation)
The publish object method will handle the publishing, republish, unpublish workflow of a collection of document and report objects in the metadata.void
PurgeSearch(java.lang.String sessionID, java.lang.String searchID)
If there are too many searches in a session, it is desirable to purge the searches the session is holding.java.lang.String
PushNotification(java.lang.String sessionID, PushNotification pushNotification)
Send Notificationjava.lang.String
SaveAsObject(java.lang.String sessionID, java.lang.String objectName, int objectType, java.lang.String folderID, java.lang.String objectXML, int flags, int xmlFlags)
This method is used to create a new object in the metadata.void
SaveObject(java.lang.String sessionID, java.lang.String objectID, int objectType, java.lang.String objectXML, int flags)
This method is used to save changes to an existing object in the metadata.void
SaveObject(java.lang.String sessionID, java.lang.String objectID, int objectType, java.lang.String objectXML, int flags, byte[] walletInfo, java.util.List<byte[]> walletBinaries)
This method is used to save changes to existing object in metadata with wallet attached.void
SaveSearchEngineProperties(java.lang.String sessionID, java.lang.String autoStartQuickSearch, java.lang.String indexLocation, java.lang.String stopwordsXML)
This method is used to save SearchEnginePropertiesjava.lang.String
Search(java.lang.String sessionID, java.lang.String searchObjectXML)
Deprecated.UseSearch(String,String,boolean,int,String)
insteadjava.lang.String
Search(java.lang.String sessionID, java.lang.String searchObjectXML, boolean useQuickSearch, int searchType, java.lang.String searchFields)
This method finds a set of DSS objects with the given conditions.java.lang.String
Search(java.lang.String sessionID, java.lang.String searchObjectXML, boolean useQuickSearch, int searchType, java.lang.String searchFields, int firstObjectIndex)
This method finds a set of DSS objects with the given conditions.java.lang.String
SearchIndexCommon(java.lang.String sessionID, int quickSearchCommand, java.lang.String projeceID, java.lang.String enabled)
This method is a common method to start/stop SearchEngine,get its properties, start/pause/destroy crawl and so onjava.lang.String
SendEmail(java.lang.String sessionID, java.util.List<java.lang.String> userOrGroupIds, int notificationType, java.lang.String emailSubject, java.lang.String emailBody, java.lang.String emailHeader, java.lang.String emailFooter, java.util.Map<java.lang.String,java.lang.String> extraProperties, boolean emailIsHTML)
Send emailvoid
SetLinkItems(java.lang.String sessionID, java.lang.String requestXML)
This method is used to set link items on the Intelligence Server.void
SetProperties(java.lang.String sessionID, java.lang.String requestXML, int flags)
This method allows for the manipulation of property sets.java.lang.String
ShareObject(java.lang.String sessionID, java.lang.String messageID, EnumDSSXMLObjectShareActions shareFlag, EnumDSSXMLObjectSharedToUsersFlags sharedToUsersFlag, java.lang.String[] userOrGroupIds)
This method handles the Share, re-share and unshare workflowjava.lang.String
SynchronousQuickSearch(SynchronousQuickSearch synchronousQuickSearch)
java.lang.String
SynchronousQuickSearch(java.lang.String sessionID, int quickSearchCmd, java.lang.String namePattern, int startObject, int count, int searchType, java.lang.String descriptionPattern, int recursive, int includeManagedObjec, int resolveShortcut, java.lang.String searchFolders, java.lang.String ownerIds, java.lang.String types, java.lang.String beginCreateTime, java.lang.String endCreateTime, java.lang.String beginModifyTime, java.lang.String endModifyTime, int outputType)
This method retrieves the results of a Synchronous Quick SearchIDSSXMLObjectServer.StringFormatAndErrorData
SynchronousQuickSearchEx(SynchronousQuickSearch iSynchronousQuickSearch)
java.lang.String
UpdateCubeSecurityFilters(java.lang.String sessionID, java.lang.String cubeID, java.util.Map<java.lang.String,java.lang.String> cubeSecurityFilters)
This method is for partially updating cube's security filters.void
UpdateTheme(java.lang.String sessionId, java.lang.String themeID, java.lang.String defaultPaletteID, java.lang.String[] paletteIDs, int flag)
Update theme info - add/remove palettes to/from theme; set default palettejava.lang.String
updateTranslations(java.lang.String sessionID, java.lang.String objectID, int objectType, java.lang.String updateXml)
This manipulation allows user to add, update, and delete any translations at any locale for one object.java.lang.String
UploadWallet(java.lang.String sessionID, java.lang.String objectID, java.lang.String objectType, java.lang.String walletName, int executionFlags, int resultFlags, java.util.List<byte[]> walletBinaries)
Uploads the wallet binary to IServer through the socket and retrieves services list derived from wallet.
-
-
-
Field Detail
-
DEFAULT_FindObject_type
static final int DEFAULT_FindObject_type
Default value for the type parameter of the FindObject method- See Also:
- Constant Field Values
-
DEFAULT_FindObject_flags
static final int DEFAULT_FindObject_flags
Default value for the flags parameter of the FindObject method- See Also:
- Constant Field Values
-
DEFAULT_FindObject_level
static final int DEFAULT_FindObject_level
Default value for the level parameter of the FindObject method- See Also:
- Constant Field Values
-
DEFAULT_FindObject_blockBegin
static final int DEFAULT_FindObject_blockBegin
Default value for the blockBegin parameter of the FindObject method- See Also:
- Constant Field Values
-
DEFAULT_FindObject_blockCount
static final int DEFAULT_FindObject_blockCount
Default value for the blockCount parameter of the FindObject method- See Also:
- Constant Field Values
-
DEFAULT_GetSearchResults_objectFlags
static final int DEFAULT_GetSearchResults_objectFlags
Default value for the objectFlags parameter of the GetSearchResults method- See Also:
- Constant Field Values
-
DEFAULT_GetSearchResults_blockBegin
static final int DEFAULT_GetSearchResults_blockBegin
Default value for the blockBegin parameter of the GetSearchResults method- See Also:
- Constant Field Values
-
DEFAULT_GetSearchResults_blockCount
static final int DEFAULT_GetSearchResults_blockCount
Default value for the blockCount parameter of the GetSearchResults method- See Also:
- Constant Field Values
-
DEFAULT_getRoot_flags
static final int DEFAULT_getRoot_flags
Default value for the flags parameter of the getRoot method- See Also:
- Constant Field Values
-
DEFAULT_getRoot_level
static final int DEFAULT_getRoot_level
Default value for the level parameter of the getRoot method- See Also:
- Constant Field Values
-
DEFAULT_getRoot_blockBegin
static final int DEFAULT_getRoot_blockBegin
Default value for the blockBegin parameter of the getRoot method- See Also:
- Constant Field Values
-
DEFAULT_getRoot_blockCount
static final int DEFAULT_getRoot_blockCount
Default value for the blockCount parameter of the getRoot method- See Also:
- Constant Field Values
-
-
Method Detail
-
CreateFolder
java.lang.String CreateFolder(java.lang.String sessionID, java.lang.String folderName, java.lang.String parentFolderID, java.lang.String folderDesc) throws MSTRWebAPIException
This method creates an empty folder in metadata.- Parameters:
sessionID
- A valid Session ID.folderName
- The name of the new folder.parentFolderID
- The object ID of the parent folder.folderDesc
- Description for the folder.- Returns:
- The ID of the newly created folder.
- Throws:
MSTRWebAPIException
- Signals an error condition.
-
DeleteObject
void DeleteObject(java.lang.String sessionID, java.lang.String objectID, int objectType) throws MSTRWebAPIException
This method deletes an object.- Parameters:
sessionID
- A valid Session IDobjectID
- The object ID of the object to delete.objectType
- The type of the object, fromEnumDSSXMLObjectTypes
. Note that even though the ObjectID uniquely identifies the object, we still need its type to perform this operation.- Throws:
MSTRWebAPIException
- Signals an error condition.
-
DeletePalette
void DeletePalette(java.lang.String sessionID, java.lang.String paletteID) throws MSTRWebAPIException
This method deletes an object.- Parameters:
sessionID
- A valid Session IDpaletteID
- The palette ID of the object to delete.- Throws:
MSTRWebAPIException
- Signals an error condition.
-
FindObject
java.lang.String FindObject(java.lang.String sessionID, java.lang.String objectID, int type, int flags, int level, int blockBegin, int blockCount) throws MSTRWebAPIException
Retrieves the representation of an object in XML.If the type is DssXMLTypeFolder, level, which is not implemented yet, specifies the maximum level of children of the folder to be brought back. 0 level means the folder itself, n means n levels below this folder, and -1 means all levels. By default, the objectType is folder.
Each object contains several bits of information such as browsing information and definition. To optimize the amount of data to bring back, applications can use objectFlags to specify the information that they are interested in.
When blockCount > 0, blockbegin and blockCount will define the subset of the children objects to be returned.
- Parameters:
sessionID
- A valid Session ID.objectID
- ID of the object.type
- Object type listed in the enumerationEnumDSSXMLObjectTypes
. [Default=DssXmlTypeFolder]flags
- Flags to specify what part of the object information should be put in the returning XML. Flags are also used to specify if the application wants to refresh the object. This value is the bitwise "and" of values take from the enumerationEnumDSSXMLObjectFlags
. [Default=0]level
- The number of sublevels for which to return children. Only valid when the object is a folder. [Default=-1] (Note: not implemented yet)blockBegin
- Starting children object index. Only valid when the object is a folder. [Default=1]blockCount
- Maximum number of children objects to return. Only valid when the object is a folder. [Default=-1]- Returns:
- The XML of the requested object.
- Throws:
MSTRWebAPIException
- Signals an error condition.
-
FindObject
java.lang.String FindObject(java.lang.String sessionID, java.lang.String messageID, java.lang.String objectID, int type, int flags, int level, int blockBegin, int blockCount, int propertyFlags, java.lang.String extParams) throws MSTRWebAPIException
- Throws:
MSTRWebAPIException
-
FindObject
java.lang.String FindObject(java.lang.String sessionID, java.lang.String objectID, int type, int flags, int level, int blockBegin, int blockCount, int propertyFlags) throws MSTRWebAPIException
Retrieves the representation of an object in XML.If the type is DssXMLTypeFolder, level, which is not implemented yet, specifies the maximum level of children of the folder to be brought back. 0 level means the folder itself, n means n levels below this folder, and -1 means all levels. By default, the objectType is folder.
Each object contains several bits of information such as browsing information and definition. To optimize the amount of data to bring back, applications can use objectFlags to specify the information that they are interested in.
When blockCount > 0, blockbegin and blockCount will define the subset of the children objects to be returned.
- Parameters:
sessionID
- A valid Session ID.objectID
- ID of the object.type
- Object type listed in the enumerationEnumDSSXMLObjectTypes
. [Default=DssXmlTypeFolder]flags
- Flags to specify what part of the object information should be put in the returning XML. Flags are also used to specify if the application wants to refresh the object. This value is the bitwise "and" of values take from the enumerationEnumDSSXMLObjectFlags
. [Default=0]level
- The number of sublevels for which to return children. Only valid when the object is a folder. [Default=-1] (Note: not implemented yet)blockBegin
- Starting children object index. Only valid when the object is a folder. [Default=1]blockCount
- Maximum number of children objects to return. Only valid when the object is a folder. [Default=-1]propertyFlags
- binary OR ofEnumDSSXMLPropertyXmlFlags
- Returns:
- The XML of the requested object.
- Throws:
MSTRWebAPIException
- Signals an error condition.
-
FindObject
java.lang.String FindObject(java.lang.String sessionID, java.lang.String objectID, int type, int flags, int level, int blockBegin, int blockCount, int propertyFlags, java.lang.String extParams) throws MSTRWebAPIException
Retrieves the representation of an object in XML.If the type is DssXMLTypeFolder, level, which is not implemented yet, specifies the maximum level of children of the folder to be brought back. 0 level means the folder itself, n means n levels below this folder, and -1 means all levels. By default, the objectType is folder.
Each object contains several bits of information such as browsing information and definition. To optimize the amount of data to bring back, applications can use objectFlags to specify the information that they are interested in.
When blockCount > 0, blockbegin and blockCount will define the subset of the children objects to be returned.
- Parameters:
sessionID
- A valid Session ID.objectID
- ID of the object.type
- Object type listed in the enumerationEnumDSSXMLObjectTypes
. [Default=DssXmlTypeFolder]flags
- Flags to specify what part of the object information should be put in the returning XML. Flags are also used to specify if the application wants to refresh the object. This value is the bitwise "and" of values take from the enumerationEnumDSSXMLObjectFlags
. [Default=0]level
- The number of sublevels for which to return children. Only valid when the object is a folder. [Default=-1] (Note: not implemented yet)blockBegin
- Starting children object index. Only valid when the object is a folder. [Default=1]blockCount
- Maximum number of children objects to return. Only valid when the object is a folder. [Default=-1]propertyFlags
- binary OR ofEnumDSSXMLPropertyXmlFlags
extParam
- extendable parameter- Returns:
- The XML of the requested object.
- Throws:
MSTRWebAPIException
- Signals an error condition.
-
FindObject
java.lang.String FindObject(java.lang.String sessionID, java.lang.String objectID, int type, int flags, int level, int blockBegin, int blockCount, int propertyFlags, java.lang.String extParams, boolean isLeanObject) throws MSTRWebAPIException
Retrieves the representation of an object in XML.If the type is DssXMLTypeFolder, level, which is not implemented yet, specifies the maximum level of children of the folder to be brought back. 0 level means the folder itself, n means n levels below this folder, and -1 means all levels. By default, the objectType is folder.
Each object contains several bits of information such as browsing information and definition. To optimize the amount of data to bring back, applications can use objectFlags to specify the information that they are interested in.
When blockCount > 0, blockbegin and blockCount will define the subset of the children objects to be returned.
- Parameters:
sessionID
- A valid Session ID.objectID
- ID of the object.type
- Object type listed in the enumerationEnumDSSXMLObjectTypes
. [Default=DssXmlTypeFolder]flags
- Flags to specify what part of the object information should be put in the returning XML. Flags are also used to specify if the application wants to refresh the object. This value is the bitwise "and" of values take from the enumerationEnumDSSXMLObjectFlags
. [Default=0]level
- The number of sublevels for which to return children. Only valid when the object is a folder. [Default=-1] (Note: not implemented yet)blockBegin
- Starting children object index. Only valid when the object is a folder. [Default=1]blockCount
- Maximum number of children objects to return. Only valid when the object is a folder. [Default=-1]propertyFlags
- binary OR ofEnumDSSXMLPropertyXmlFlags
extParam
- extendable parameterisLeanObject
- indicate web needs the lean XML, this is true when getting Device and Transmitter object- Returns:
- The XML of the requested object.
- Throws:
MSTRWebAPIException
- Signals an error condition.
-
FindObject
java.lang.String FindObject(java.lang.String sessionID, java.lang.String messageID, java.lang.String objectID, int type, int flags, int level, int blockBegin, int blockCount, int propertyFlags, java.lang.String extParams, boolean isLeanObject) throws MSTRWebAPIException
- Throws:
MSTRWebAPIException
-
FindObject
java.lang.String FindObject(java.lang.String sessionID, java.lang.String messageID, java.lang.String objectID, int type, int flags, int level, int blockBegin, int blockCount, int propertyFlags, java.lang.String extParams, boolean isLeanObject, boolean needThumbnail) throws MSTRWebAPIException
- Throws:
MSTRWebAPIException
-
FindUserObjects
java.lang.String FindUserObjects(java.lang.String sessionID, java.util.List<java.lang.String> userIds, int flags) throws MSTRWebAPIException
Retrieves the representation of a list of user object in XML.This method is to fetch user object only and will not return the object which type is not user. The user object will not be returned if the id is not existing in the metadata and there will not be any error.
Each user object in the list contains several bits of information such as browsing information and definition. To optimize the amount of data to bring back, applications can use objectFlags to specify the information that they are interested in.
- Parameters:
sessionID
- A valid Session ID.userIds
- ID list of the user.flags
- Flags to specify what part of the object information should be put in the returning XML. Flags are also used to specify if the application wants to refresh the object. This value is the bitwise "and" of values take from the enumerationEnumDSSXMLObjectFlags
. [Default=0]- Returns:
- The XML of the requested user object list.
- Throws:
MSTRWebAPIException
- Signals an error condition.
-
FindObjectByPath
java.lang.String FindObjectByPath(java.lang.String sessionID, int type, int flags, int level, int blockBegin, int blockCount, java.lang.String fullPath) throws MSTRWebAPIException
Retrieves the representation of an object in XML.If the type is DssXMLTypeFolder, level, which is not implemented yet, specifies the maximum level of children of the folder to be brought back. 0 level means the folder itself, n means n levels below this folder, and -1 means all levels. By default, the objectType is folder.
Each object contains several bits of information such as browsing information and definition. To optimize the amount of data to bring back, applications can use objectFlags to specify the information that they are interested in.
When blockCount > 0, blockbegin and blockCount will define the subset of the children objects to be returned.
- Parameters:
sessionID
- A valid Session ID.type
- Object type listed in the enumerationEnumDSSXMLObjectTypes
. [Default=DssXmlTypeFolder]flags
- Flags to specify what part of the object information should be put in the returning XML. Flags are also used to specify if the application wants to refresh the object. This value is the bitwise "and" of values take from the enumerationEnumDSSXMLObjectFlags
. [Default=0]level
- The number of sublevels for which to return children. Only valid when the object is a folder. [Default=-1] (Note: not implemented yet)blockBegin
- Starting children object index. Only valid when the object is a folder. [Default=1]blockCount
- Maximum number of children objects to return. Only valid when the object is a folder. [Default=-1]fullPath
- String of full path of the target object. If the object is shortcut, it includes the target name of the shortcut.- Returns:
- The XML of the requested object.
- Throws:
MSTRWebAPIException
- Signals an error condition.- Since:
- MicroStrategy Web 9.0.0
-
FindObjectByPath
java.lang.String FindObjectByPath(java.lang.String sessionID, int type, int flags, int level, int blockBegin, int blockCount, java.lang.String fullPath, int searchFlags) throws MSTRWebAPIException
Retrieves the representation of an object in XML.If the type is DssXMLTypeFolder, level, which is not implemented yet, specifies the maximum level of children of the folder to be brought back. 0 level means the folder itself, n means n levels below this folder, and -1 means all levels. By default, the objectType is folder.
Each object contains several bits of information such as browsing information and definition. To optimize the amount of data to bring back, applications can use objectFlags to specify the information that they are interested in.
When blockCount > 0, blockbegin and blockCount will define the subset of the children objects to be returned.
- Parameters:
sessionID
- A valid Session ID.type
- Object type listed in the enumerationEnumDSSXMLObjectTypes
. [Default=DssXmlTypeFolder]flags
- Flags to specify what part of the object information should be put in the returning XML. Flags are also used to specify if the application wants to refresh the object. This value is the bitwise "and" of values take from the enumerationEnumDSSXMLObjectFlags
. [Default=0]level
- The number of sublevels for which to return children. Only valid when the object is a folder. [Default=-1] (Note: not implemented yet)blockBegin
- Starting children object index. Only valid when the object is a folder. [Default=1]blockCount
- Maximum number of children objects to return. Only valid when the object is a folder. [Default=-1]fullPath
- String of full path of the target object. If the object is shortcut, it includes the target name of the shortcut.searchFlags
- Flags to specify whether the object is shortcut or not.- Returns:
- The XML of the requested object.
- Throws:
MSTRWebAPIException
- Signals an error condition.- Since:
- MicroStrategy Web 9.0.0
-
GetFolderID
java.lang.String GetFolderID(java.lang.String sessionID, int folderName) throws MSTRWebAPIException
This method returns the ID of a special folder.This method returns the ID of a given folder. With the folder ID, a user can call FindObject to retrieve the objects under this folder. The folderName parameter must be one of the values from
.EnumDSSXMLFolderNames
- Parameters:
sessionID
- A valid Session IDfolderName
- The name of the folder taken fromEnumDSSXMLFolderNames
.- Returns:
- An object ID corresponding to a folder.
- Throws:
MSTRWebAPIException
- Signals an error condition.
-
GetFolderID
java.lang.String GetFolderID(java.lang.String sessionID, int folderName, int requestTimeout) throws MSTRWebAPIException
This method returns the ID of a special folder with specified request timeout.This method returns the ID of a given folder. With the folder ID, a user can call FindObject to retrieve the objects under this folder. The folderName parameter must be one of the values from
.EnumDSSXMLFolderNames
- Parameters:
sessionID
- A valid Session IDfolderName
- The name of the folder taken fromEnumDSSXMLFolderNames
.requestTimeout
- The request timeout.- Returns:
- An object ID corresponding to a folder.
- Throws:
MSTRWebAPIException
- Signals an error condition.
-
GetFolderID
java.lang.String GetFolderID(java.lang.String sessionID, int folderName, int requestTimeout, boolean attemptFailover) throws MSTRWebAPIException
- Throws:
MSTRWebAPIException
-
GetProperties
java.lang.String GetProperties(java.lang.String sessionID, java.lang.String requestXML, int flags) throws MSTRWebAPIException
Gets a property set from the server.- Parameters:
sessionID
- A valid session ID from an Intelligence Server.requestXML
- An XML String describing the information to retrieve.flags
- A value fromEnumDSSXMLPropertyFlags
, specifying flags which apply to this operation.- Returns:
- The requested property information, in XML format.
- Throws:
MSTRWebAPIException
- Signals an error condition.
-
GetFlexProperties
java.lang.String GetFlexProperties(java.lang.String sessionID) throws MSTRWebAPIException
- Parameters:
sessionID
- A valid Intelligence Server session ID.- Returns:
- Properties governing Flash/flex visualization.
- Throws:
MSTRWebAPIException
- Since:
- MicroStrategy Web 8.1.1
-
getRoot
java.lang.String getRoot(java.lang.String sessionID, int flags, int level, int blockBegin, int blockCount) throws MSTRWebAPIException
This method retrieves the root of an object hierarchy. Based on the sessionID, an application can get the root of the project object hierarchy or configuration object hierarchy.level specifies the maximum level of children of the folder will be bring back. 0 level means the folder itself, n means n levels below this folder and -1 means all levels.
Each object contains several bits of information such as browsing information, definition. To optimize the amount of data to bring back, application can use flags to specify the information that it is interested in.
When blockCount > 0, blockBegin and blockCount will define a subset of the children objects to returned.
- Parameters:
sessionID
- A valid Session IDflags
- Flags -EnumDSSXMLObjectFlags
- to specify what part of the object information should be put in the returning XML. Flags are also used to specify if the application wants to refresh the object. [Default=0]level
- The amount of sublevels for which to return children. Only valid when the object is a folder. Default is -1, meaning all levels.blockBegin
- Starting children object index. Only valid when the object is a folder. Default is 1.blockCount
- Maximum number of children objects to return. Only valid when the object is a folder. Default is -1, which means all objects.- Returns:
- XML string represents the root folder.
- Throws:
MSTRWebAPIException
- Signals an error condition.
-
GetSearchResults
java.lang.String GetSearchResults(java.lang.String sessionID, java.lang.String searchID, int objectFlags, int blockBegin, int blockCount, StringWrapper searchObject, IntWrapper status) throws MSTRWebAPIException
This method retrieves the results of a search.When blockCount > 0, blockBegin and blockCount will define a subset of the found objects to returned.
All search results will be returned inside a search folder, which is generated by the Search function in order to store the results. The folder will have no name and - unlike other search objects - a reference to it will be absent beneath the <fct> node of the XML. Additional characteristics are that it will be the only object with an "mf='1'" attribute in its <oi> node, and that the value of the "id" attribute in its <oi> node must be equal to the value of the "rfd" attribute in the <mi> node of the search document.
Even if no results are found in the search, a search folder will still be referenced in the XML returned.
- Parameters:
sessionID
- A valid Session IDsearchID
- The unique id for the search.objectFlags
- A value (or sum of values) of typeEnumDSSXMLObjectFlags
. [Default=DssXmlObjectDefn]blockBegin
- The index for the first object in the searching result set (incremental fetching). [Default=1]blockCount
- The total number of objects to be returned. [Default=-1]searchObject
- Output Parameter - The search object in XML format.status
- Output Parameter - Search status: a value of typeEnumDSSXMLObjectSearchStatus
. DssXmlObjectSearchStatusRunning is returned if the search is still running; DssXmlObjectSearchStatusResultXML is returned if the search is finished and search results are ready.- Returns:
- The XML definition of a folder which contains the dss objects that meet the search criteria (same format as the FindObject output).
- Throws:
MSTRWebAPIException
- Signals an error condition.
-
GetSearchResults
java.lang.String GetSearchResults(java.lang.String sessionID, java.lang.String searchID, int objectFlags, boolean treeInfo, int blockBegin, int blockCount, StringWrapper searchObject, IntWrapper status) throws MSTRWebAPIException
This method retrieves the results of a search.When blockCount > 0, blockBegin and blockCount will define a subset of the found objects to returned.
All search results will be returned inside a search folder, which is generated by the Search function in order to store the results. The folder will have no name and - unlike other search objects - a reference to it will be absent beneath the <fct> node of the XML. Additional characteristics are that it will be the only object with an "mf='1'" attribute in its <oi> node, and that the value of the "id" attribute in its <oi> node must be equal to the value of the "rfd" attribute in the <mi> node of the search document.
Even if no results are found in the search, a search folder will still be referenced in the XML returned.
- Parameters:
sessionID
- A valid Session IDsearchID
- The unique id for the search.objectFlags
- A value (or sum of values) of typeEnumDSSXMLObjectFlags
. [Default=DssXmlObjectDefn]treeInfo
- A boolean value to indicate whether the results should include the tree structure of the results.blockBegin
- The index for the first object in the searching result set (incremental fetching). [Default=1]blockCount
- The total number of objects to be returned. [Default=-1]searchObject
- Output Parameter - The search object in XML format.status
- Output Parameter - Search status: a value of typeEnumDSSXMLObjectSearchStatus
. DssXmlObjectSearchStatusRunning is returned if the search is still running; DssXmlObjectSearchStatusResultXML is returned if the search is finished and search results are ready.- Returns:
- The XML definition of a folder which contains the dss objects that meet the search criteria (same format as the FindObject output).
- Throws:
MSTRWebAPIException
- Signals an error condition.
-
GetSearchResults
java.lang.String GetSearchResults(java.lang.String sessionID, java.lang.String searchID, int objectFlags, boolean treeInfo, int blockBegin, int blockCount, StringWrapper searchObject, IntWrapper status, int searchType) throws MSTRWebAPIException
Add a new parameter 'searchType' to send as a flag to backend to stop putting 'folder' objects at top of search results. This method retrieves the results of a search.When blockCount > 0, blockBegin and blockCount will define a subset of the found objects to returned.
All search results will be returned inside a search folder, which is generated by the Search function in order to store the results. The folder will have no name and - unlike other search objects - a reference to it will be absent beneath the <fct> node of the XML. Additional characteristics are that it will be the only object with an "mf='1'" attribute in its <oi> node, and that the value of the "id" attribute in its <oi> node must be equal to the value of the "rfd" attribute in the <mi> node of the search document.
Even if no results are found in the search, a search folder will still be referenced in the XML returned.
- Parameters:
sessionID
- A valid Session IDsearchID
- The unique id for the search.objectFlags
- A value (or sum of values) of typeEnumDSSXMLObjectFlags
. [Default=DssXmlObjectDefn]treeInfo
- A boolean value to indicate whether the results should include the tree structure of the results.blockBegin
- The index for the first object in the searching result set (incremental fetching). [Default=1]blockCount
- The total number of objects to be returned. [Default=-1]searchObject
- Output Parameter - The search object in XML format.status
- Output Parameter - Search status: a value of typeEnumDSSXMLObjectSearchStatus
. DssXmlObjectSearchStatusRunning is returned if the search is still running; DssXmlObjectSearchStatusResultXML is returned if the search is finished and search results are ready.searchType
- Search Type: a value of type- Returns:
- The XML definition of a folder which contains the dss objects that meet the search criteria (same format as the FindObject output).
- Throws:
MSTRWebAPIException
- Signals an error condition.
-
SendEmail
java.lang.String SendEmail(java.lang.String sessionID, java.util.List<java.lang.String> userOrGroupIds, int notificationType, java.lang.String emailSubject, java.lang.String emailBody, java.lang.String emailHeader, java.lang.String emailFooter, java.util.Map<java.lang.String,java.lang.String> extraProperties, boolean emailIsHTML) throws MSTRWebAPIException
Send email- Parameters:
sessionID
- A valid Session IDuserOrGroupIds
- A list of ids (String) which will this object will be shared to, these can be user or user group idsnotificationType
- User specific flagEnumDSSXMLExternalNotificationType
emailSubject
- Subject of the emailemailBody
- Content of the emailemailHeader
- Header of the emailemailFooter
- Footer of the emailextraProperties
- Extra properties of the commandemailIsHTML
- True is the content of the email is HTML- Returns:
- The returned response from IServer
- Throws:
MSTRWebAPIException
- Signals an error condition
-
PushNotification
java.lang.String PushNotification(java.lang.String sessionID, PushNotification pushNotification) throws MSTRWebAPIException
Send Notification- Parameters:
sessionID
- A valid Session IDpushNotification
- A object reprensenting the push notification that need to be sent- Returns:
- The returned response from IServer
- Throws:
MSTRWebAPIException
- Signals an error condition
-
PublishObject
java.lang.String PublishObject(java.lang.String sessionID, java.lang.String objectID, EnumDSSXMLObjectPublishActions publishFlag, java.util.List<java.lang.String> userOrGroupIds, java.util.List<java.lang.Integer> userOrGroupOperations) throws MSTRWebAPIException
The publish object method will handle the publishing, republish, unpublish workflow of an object in the metadata.- Parameters:
sessionID
- A valid Session IDobjectID
- The object ID of an object in the metadata to be publishedpublishFlag
- The publish action to be performedEnumDSSXMLObjectPublishActions
userOrGroupIds
- An array of object ids which will this object will be shared to, these can be user or group object ids- Returns:
- An xml string representing the published object, in the case of unpublish we will be returning an id of 0000000000000000000000000000
- Throws:
MSTRWebAPIException
- Signals an error condition
-
PublishObject
java.lang.String PublishObject(java.lang.String sessionID, java.lang.String objectID, EnumDSSXMLObjectPublishActions publishFlag, java.util.List<java.lang.String> userOrGroupIds, java.util.List<java.lang.Integer> userOrGroupOperations, java.lang.Integer objectType) throws MSTRWebAPIException
The publish object method will handle the publishing, republish, unpublish workflow of an object in the metadata.- Parameters:
sessionID
- A valid Session IDobjectID
- The object ID of an object in the metadata to be publishedpublishFlag
- The publish action to be performedEnumDSSXMLObjectPublishActions
userOrGroupIds
- An array of object ids which will this object will be shared to, these can be user or group object idsobjectType
- Integer value of the object to be published. When not supplied, defaults to the document/dossier object type- Returns:
- An xml string representing the published object, in the case of unpublish we will be returning an id of 0000000000000000000000000000
- Throws:
MSTRWebAPIException
- Signals an error condition
-
PublishObjects
java.lang.String PublishObjects(java.lang.String sessionID, java.util.List<java.lang.String> docIds, java.util.List<java.lang.String> reportIds, EnumDSSXMLObjectPublishActions publishFlag, java.util.List<java.lang.String> userOrGroupIds, java.util.List<java.lang.Integer> userOrGroupOperation) throws MSTRWebAPIException
The publish object method will handle the publishing, republish, unpublish workflow of a collection of document and report objects in the metadata.- Parameters:
sessionID
- A valid Session IDdocIds
- A list of object IDs of documents in the metadata to be publishedreportIds
- A list of object IDs of reports in the metadata to be publishedpublishFlag
- The publish action to be performedEnumDSSXMLObjectPublishActions
userOrGroupIds
- An array of object ids which will this object will be shared to, these can be user or group object ids- Returns:
- An xml string representing the published object, in the case of unpublish we will be returning an id of 0000000000000000000000000000
- Throws:
MSTRWebAPIException
- Signals an error condition
-
PublishInstance
java.lang.String PublishInstance(java.lang.String sessionID, java.lang.String messageID, EnumDSSXMLObjectPublishActions publishFlag, java.util.List<java.lang.String> userOrGroupIds) throws MSTRWebAPIException
The publish instance method will handle the publishing, republish, unpublish workflow of an objects instance when published the personal view will contain manipulationsin the definition of the instance.- Parameters:
sessionID
- A valid Session IDmessageID
- The message ID of an object instance in memory to be publishedpublishFlag
- The publish action to be performedEnumDSSXMLObjectPublishActions
userOrGroupIds
- An array of object ids which will this object will be shared to, these can be user or group object ids- Returns:
- An xml string representing the published object, in the case of unpublish we will be returning an id of 0000000000000000000000000000
- Throws:
MSTRWebAPIException
- Signals an error condition
-
GetPublishInfo
java.lang.String GetPublishInfo(java.lang.String sessionID, java.lang.String objectID) throws MSTRWebAPIException
This method will provide the publish information for an object, if unpublished an empty response xml will be returned- Parameters:
sessionID
- A valid Session IDobjectID
- The ID of an object in the metadata- Returns:
- An xml string representing the published object,
. In the case that an object is not published an empty xml response will be provided; - Throws:
MSTRWebAPIException
- Signals an error condition
-
CertifyObject
java.lang.String CertifyObject(java.lang.String sessionID, java.lang.String objectID, int objectType, int certify, int resultFlag) throws MSTRWebAPIException
This method handles the certify and decertify of the object(only support document and report now).- Parameters:
sessionID
- A valid project session idobjectID
- The ID of the object in the metadataobjectType
- The type of the object in the metadataEnumDSSXMLObjectFlags
, only support document and report type now.certify
- 1 for certify object, 0 for decertify objectresultFlag
- By default is 0 , the result will include every item's execution result, if set as 1, success item will be by-passed, only failure items process result will be return.- Returns:
- Certified: [{"oid":"#Object_ID#","result_code":0,"ctfs":1, "crfid": "#Certifier's ID", "ctfr":"#Certifer's name#","ctfl":"#Certifer's login#","ctft":"#certify time#"}] Not certified: [{ "oid":"#Object_ID#", "result_code":0,"ctfs":0}] Error: [{ "oid":"#Object_ID#", "result_code":"#result code#","er":"#Error_string#"}]
- Throws:
MSTRWebAPIException
- Signals an error condition
-
ShareObject
java.lang.String ShareObject(java.lang.String sessionID, java.lang.String messageID, EnumDSSXMLObjectShareActions shareFlag, EnumDSSXMLObjectSharedToUsersFlags sharedToUsersFlag, java.lang.String[] userOrGroupIds) throws MSTRWebAPIException
This method handles the Share, re-share and unshare workflow- Parameters:
sessionID
- A valid Session IDmessageID
- The message ID of an object to be sharedshareFlag
- action to be performedEnumDSSXMLObjectShareActions
sharedToUsersFlag
- User specific flagEnumDSSXMLObjectSharedToUsersFlags
userOrGroupIds
- An array of object ids which will this object will be shared to, these can be user or group object ids- Returns:
- The id of the newly shared object
- Throws:
MSTRWebAPIException
-
PurgeSearch
void PurgeSearch(java.lang.String sessionID, java.lang.String searchID) throws MSTRWebAPIException
If there are too many searches in a session, it is desirable to purge the searches the session is holding. The responsibility to purge is with the user, because only the user can decide when a search is not useful to him.- Parameters:
sessionID
- A valid Session ID.searchID
- If the SearchID is left out, all the searches corresponding to this session are deleted.- Throws:
MSTRWebAPIException
- Signals an error condition.
-
SynchronousQuickSearch
java.lang.String SynchronousQuickSearch(java.lang.String sessionID, int quickSearchCmd, java.lang.String namePattern, int startObject, int count, int searchType, java.lang.String descriptionPattern, int recursive, int includeManagedObjec, int resolveShortcut, java.lang.String searchFolders, java.lang.String ownerIds, java.lang.String types, java.lang.String beginCreateTime, java.lang.String endCreateTime, java.lang.String beginModifyTime, java.lang.String endModifyTime, int outputType) throws MSTRWebAPIException
This method retrieves the results of a Synchronous Quick SearchThe search results will be returned by this call directly without get search ID first.
- Parameters:
sessionID
- : A valid Session ID.quickSearchCmd
- : Mean what type of data need to get back from the quick search command. quickSearchCmd=1 means get quick search status, quickSearchCmd=2 means do quick search.namePattern
- : Query in object name, If namePattern is empty, it means search all objects.startObject
- : 0 based, the start index of returned objects.count
- : The max number of objects to be returned, usually equals to the page size.searchType
- : The type of quick search, 0=contains, 2=exactly, 3=beginwith, 5=endwith; -1=not use quick searchOptional parameter
descriptionPattern
- : Query in object description.recursive
- : Whether search in sub folders recursively, 0 means false, others means true.includeManagedObjec
- : Whether include managed objects, 0 means false, others means true.resolveShortcut
- : Resolve shortcut to target, 0 means false, others means true.searchFolders
- : Define folder ID(s) we need to search in which folder/folders. If there are multiple folders, the ids should be separated by space.ownerIds
- : Define owner ID(s) we need to search in objects owned by. If there are multiple owners, the ids should be separated by space.types
- : Define the object type(s) we need to search. If there are multiple types, the types should be separated by space. It could be either type or subtype.beginCreateTime
- : Begin Create Time GMT. The time is in ISO 8601 format (YYYY-MM-DD hh:mm:ss.msec).endCreateTime
- : End Create Time GMT. The time is in ISO 8601 format (YYYY-MM-DD hh:mm:ss.msec).beginModifyTime
- : Begin Modify Time GMT. The time is in ISO 8601 format (YYYY-MM-DD hh:mm:ss.msec).endModifyTime
- : End Modify Time GMT. The time is in ISO 8601 format (YYYY-MM-DD hh:mm:ss.msec).outputType
- : Define the output type of the search result. "1" means json type, "2" means XML type.- Returns:
- The result XML, should be transfer into folder object later.
Must have parameters
- Throws:
MSTRWebAPIException
- Signals an error condition.
-
SynchronousQuickSearch
java.lang.String SynchronousQuickSearch(SynchronousQuickSearch synchronousQuickSearch) throws MSTRWebAPIException
- Parameters:
synchronousQuickSearch
- Use a parameter object seeSynchronousQuickSearch
- Returns:
- The result XML, should be transfer into folder object later.
- Throws:
MSTRWebAPIException
- Signals an error condition.
-
SynchronousQuickSearchEx
IDSSXMLObjectServer.StringFormatAndErrorData SynchronousQuickSearchEx(SynchronousQuickSearch iSynchronousQuickSearch) throws MSTRWebAPIException
- Throws:
MSTRWebAPIException
-
Search
@Deprecated java.lang.String Search(java.lang.String sessionID, java.lang.String searchObjectXML) throws MSTRWebAPIException
Deprecated.UseSearch(String,String,boolean,int,String)
insteadThis method finds a set of DSS objects with the given conditions.The search results will not be returned in this call. GetSearchResults needs to be called to retrieve the results.
- Parameters:
sessionID
- A valid Session ID.searchObjectXML
- searchObjectXML must contain the definition of the search object. This is in XML format and needs to be constructed by the Web API user. If the user desires to execute a search that is already in the metadata, he needs to extract the object's definition and pass it here.- Returns:
- The unique ID of the search. This will be passed to GetSearchResults to get the result XML.
- Throws:
MSTRWebAPIException
- Signals an error condition.
-
Search
java.lang.String Search(java.lang.String sessionID, java.lang.String searchObjectXML, boolean useQuickSearch, int searchType, java.lang.String searchFields) throws MSTRWebAPIException
This method finds a set of DSS objects with the given conditions.The search results will not be returned in this call. GetSearchResults needs to be called to retrieve the results.
- Parameters:
sessionID
- A valid Session ID.searchObjectXML
- searchObjectXML must contain the definition of the search object. This is in XML format and needs to be constructed by the Web API user. If the user desires to execute a search that is already in the metadata, he needs to extract the object's definition and pass it here.useQuickSearch
-searchType
-EnumDSSXMLSearchTypes
searchFields
- - combination of "name", "description" and "comment" delimited by ","- Returns:
- The unique ID of the search. This will be passed to GetSearchResults to get the result XML.
- Throws:
MSTRWebAPIException
- Signals an error condition.
-
Search
java.lang.String Search(java.lang.String sessionID, java.lang.String searchObjectXML, boolean useQuickSearch, int searchType, java.lang.String searchFields, int firstObjectIndex) throws MSTRWebAPIException
This method finds a set of DSS objects with the given conditions.The search results will not be returned in this call. GetSearchResults needs to be called to retrieve the results.
- Parameters:
sessionID
- A valid Session ID.searchObjectXML
- searchObjectXML must contain the definition of the search object. This is in XML format and needs to be constructed by the Web API user. If the user desires to execute a search that is already in the metadata, he needs to extract the object's definition and pass it here.useQuickSearch
-searchType
-EnumDSSXMLSearchTypes
searchFields
- combination of "name", "description" and "comment" delimited by ","firstObjectIndex
- the index to begin searching from- Returns:
- The unique ID of the search. This will be passed to GetSearchResults to get the result XML.
- Throws:
MSTRWebAPIException
- Signals an error condition.
-
SetProperties
void SetProperties(java.lang.String sessionID, java.lang.String requestXML, int flags) throws MSTRWebAPIException
This method allows for the manipulation of property sets.- Parameters:
sessionID
- A valid session ID from an Intelligence Server.requestXML
- An XML String describing the information to change.flags
- A value fromEnumDSSXMLPropertyFlags
, specifying flags which apply to this operation.- Throws:
MSTRWebAPIException
- Signals an error condition.
-
GetLinkItems
java.lang.String GetLinkItems(java.lang.String sessionID, java.lang.String requestXML, int blockBegin, int blockCount, int flags) throws MSTRWebAPIException
This method is used to retrieve link items from the Intelligence Server.- Parameters:
sessionID
- A valid session ID from an Intelligence Server.requestXML
- An XML string describing the information to get.blockBegin
- The first item to return in the link item list. Used for incremental fetch.blockCount
- The maximum number of items to return in the link item list.flags
- The flags to use in the retrieval of the properties. This value should come fromEnumDSSXMLPropertyFlags
.- Returns:
- An XML String containing the results of the request.
- Throws:
MSTRWebAPIException
- Signals an error condition.
-
SetLinkItems
void SetLinkItems(java.lang.String sessionID, java.lang.String requestXML) throws MSTRWebAPIException
This method is used to set link items on the Intelligence Server.- Parameters:
sessionID
- A valid session ID from an Intelligence Server.requestXML
- An XML String describing the link items to be set.- Throws:
MSTRWebAPIException
- Signals an error condition.
-
DeleteLinkItems
void DeleteLinkItems(java.lang.String sessionID, java.lang.String requestXML) throws MSTRWebAPIException
This method is used to delete link items on the Intelligence Server.- Parameters:
sessionID
- A valid session ID from an Intelligence Server.requestXML
- An XML String describing the link items to be deleted.- Throws:
MSTRWebAPIException
- Signals an error condition.
-
CopyObject
java.lang.String CopyObject(java.lang.String sessionID, java.lang.String objectID, int objectType, int flags, java.lang.String newName, java.lang.String folderDID) throws MSTRWebAPIException
This method is used to create a copy of an existing object in the metadata.- Parameters:
sessionID
- A valid session ID from an Intelligence Server.objectID
- The DSSID of the object to copy.objectType
- The type of the object to copy.flags
- The object flags.newName
- The name of the copied object.folderDID
- The target folder where to create the copied object.- Returns:
- object ID of the newly created object.
- Throws:
MSTRWebAPIException
- Signals an error condition.- Since:
- MicroStrategy Web 7.5.0
-
ExecuteBulkSave
void ExecuteBulkSave(java.lang.String sessionID, java.lang.String objectXML) throws MSTRWebAPIException
This method is used to submit bulk save.- Parameters:
sessionID
- A valid session ID from an Intelligence Server.objectXML
- The object XML representing the latest state of the object.- Throws:
MSTRWebAPIException
- Signals an error condition.
-
SaveObject
void SaveObject(java.lang.String sessionID, java.lang.String objectID, int objectType, java.lang.String objectXML, int flags) throws MSTRWebAPIException
This method is used to save changes to an existing object in the metadata.- Parameters:
sessionID
- A valid session ID from an Intelligence Server.objectID
- The DSSID of the object to copy.objectType
- The type of the object to copy.flags
- The object flags.objectXML
- The object XML representing the latest state of the object.- Throws:
MSTRWebAPIException
- Signals an error condition.- Since:
- MicroStrategy Web 7.5.0
-
SaveObject
void SaveObject(java.lang.String sessionID, java.lang.String objectID, int objectType, java.lang.String objectXML, int flags, byte[] walletInfo, java.util.List<byte[]> walletBinaries) throws MSTRWebAPIException
This method is used to save changes to existing object in metadata with wallet attached.- Parameters:
sessionID
- A valid session ID from an Intelligence Server.objectID
- The DSSID of the object to copy.objectType
- The type of the object to copy.objectXML
- The object XML representing the latest state of the object.flags
- The object flags.walletInfo
- Wallet info in bytes.walletBinaries
- wallet binary in bytes and stored in ArrayList.- Throws:
MSTRWebAPIException
-
UploadWallet
java.lang.String UploadWallet(java.lang.String sessionID, java.lang.String objectID, java.lang.String objectType, java.lang.String walletName, int executionFlags, int resultFlags, java.util.List<byte[]> walletBinaries) throws MSTRWebAPIException
Uploads the wallet binary to IServer through the socket and retrieves services list derived from wallet.- Parameters:
sessionID
- A valid session ID from an Intelligence Server.objectID
- The DSSID of the object.objectType
- The type of the object.walletName
- The name of the wallet.executionFlags
- Flags specify different options for the execution. Value must be a bitwise "or" (addition) of values fromEnumDSSXMLExecutionFlags
.resultFlags
- Tells the server how to present the results. This value must be a bitwise "or" (addition) of values fromEnumDSSXMLResultFlags
.walletBinaries
- Wallet binaries in bytes and stored in ArrayList.- Returns:
- JSON response representing the wallet services.
- Throws:
MSTRWebAPIException
-
SaveAsObject
java.lang.String SaveAsObject(java.lang.String sessionID, java.lang.String objectName, int objectType, java.lang.String folderID, java.lang.String objectXML, int flags, int xmlFlags) throws MSTRWebAPIException
This method is used to create a new object in the metadata.- Parameters:
sessionID
- A valid session ID from an Intelligence Server.objectName
- The name of the new object.objectType
- The type of the object to copy.flags
- The object flags.objectXML
- The object XML representing the new object.folderID
- The target folder where to create the new object.xmlFlags
- the XML object flag.EnumDSSXMLObjectXMLFlags
.Only device/transmitter needs it.- Returns:
- ID of the newly created object.
- Throws:
MSTRWebAPIException
- Signals an error condition.- Since:
- MicroStrategy Web 7.5.0
-
MoveObject
java.lang.String MoveObject(java.lang.String sessionID, java.lang.String objectID, int objectType, int flags, java.lang.String newName, java.lang.String folderDID) throws MSTRWebAPIException
This method is used to move an existing object in the metadata.- Parameters:
sessionID
- A valid session ID from an Intelligence Server.objectID
- The DSSID of the object to move.objectType
- The type of the object to move.flags
- The object flags.newName
- The name of the moved object.folderDID
- The target folder where to create the moved object.- Throws:
MSTRWebAPIException
- Signals an error condition.- Since:
- MicroStrategy Web 7.5.0
-
MoveObject
java.lang.String MoveObject(java.lang.String sessionID, java.lang.String objectID, int objectType, int flags, java.lang.String newName, java.lang.String folderDID, boolean solveNameConflict) throws MSTRWebAPIException
This method is used to move an existing object in the metadata.- Parameters:
sessionID
- A valid session ID from an Intelligence Server.objectID
- The DSSID of the object to move.objectType
- The type of the object to move.flags
- The object flags.newName
- The name of the moved object.folderDID
- The target folder where to create the moved object.solveNameConflict
- indicate if we need to resolve name conflicts if there's any.- Throws:
MSTRWebAPIException
- Signals an error condition.- Since:
- Cloud Pro
-
ApplyRuntimeSettings
void ApplyRuntimeSettings(java.lang.String sessionID) throws MSTRWebAPIException
This method will cause the Intelligence Server to reload it's ServerDef object from the metadata. This is used to propagate changes to the ServerDef to the runtime environment.- Parameters:
sessionID
- A valid session ID from the Intelligence Server.- Throws:
MSTRWebAPIException
- Thrown if an error occurs.- Since:
- MicroStrategy Web 7.5.2
-
GetServerDefID
java.lang.String GetServerDefID(java.lang.String sessionID) throws MSTRWebAPIException
This method returns the DSSID of the ServerDef which is currently being used by a running server.- Parameters:
sessionID
- A valid session ID from the Intelligence Server.- Returns:
- The DSSID of the ServerDef being used by the server.
- Throws:
MSTRWebAPIException
- Thrown if an error occurs.- Since:
- MicroStrategy Web 7.5.2
-
GetServerDef
java.lang.String GetServerDef(java.lang.String sessionID) throws MSTRWebAPIException
- Throws:
MSTRWebAPIException
-
GetServerDef
java.lang.String GetServerDef(java.lang.String sessionID, java.lang.Boolean defaultFlag) throws MSTRWebAPIException
This method returns the ServerDef which is currently being used by a running server.- Parameters:
sessionID
- A valid session ID from the Intelligence Server.- Returns:
- The ServerDef being used by the server.
- Throws:
MSTRWebAPIException
- Thrown if an error occurs.- Since:
- MicroStrategy Web Polaris
-
GetSystemLinkID
java.lang.String GetSystemLinkID(java.lang.String sessionID, java.lang.String projectID, int systemLink) throws MSTRWebAPIException
This method returns the DSSID of the Link specified by the project and link type.- Parameters:
sessionID
- A valid session ID from the Intelligence Server.projectID
- The projectID of the project whose link object is queried.systemLink
- A valid link type from the enumerationEnumDSSXMLSystemLinks
.- Returns:
- DSSID of the Link specified by the project and the link type
- Throws:
MSTRWebAPIException
- Thrown if IServer encountered an error.- Since:
- MicroStrategy Web 7.5.2
-
ManipulateUserAnswer
java.lang.String ManipulateUserAnswer(java.lang.String sessionID, java.lang.String commandXML) throws MSTRWebAPIException
This method loads, edits and saves user prompt answers.- Parameters:
sessionID
- A valid session ID from the Intelligence Server.- Returns:
- the resultant XML.
- Throws:
MSTRWebAPIException
- Thrown if IServer encountered an error.- Since:
- MicroStrategy Web 9.0.0
-
ManipulateUserAnswer
java.lang.String ManipulateUserAnswer(java.lang.String sessionID, java.lang.String commandXML, int flag) throws MSTRWebAPIException
This method loads, edits and saves user prompt answers.- Parameters:
sessionID
- A valid session ID from the Intelligence Server.commandXML
- The body of manipulation command.flag
- Flag Whether to return detailed object information. It is based onEnumDSSXMLSourceFlags
- Returns:
- the resultant XML.
- Throws:
MSTRWebAPIException
- Thrown if IServer encountered an error.- Since:
- MicroStrategy Web 9.0.0
-
GetSystemFunctions
java.lang.String GetSystemFunctions(java.lang.String sessionID, int flags) throws MSTRWebAPIException
This method retrieves the list of System functions.- Parameters:
sessionID
- A valid session ID from the Intelligence Server.flags
- the function flags value. It is based onEnumDSSXMLFunctionsFlags
- Returns:
- the resultant XML.
- Throws:
MSTRWebAPIException
- Thrown if IServer encountered an error.- Since:
- MicroStrategy Web 9.0.0
-
ObjectLock
java.lang.String ObjectLock(java.lang.String sessionID, java.lang.String command) throws MSTRWebAPIException
This method locks, unlocks and queries object locks in the metadata.- Parameters:
sessionID
- A valid session ID from the Intelligence Server.command
- the command XML to lock, unlock or query object locks.- Returns:
- the resultant XML for the query object lock command. Returns empty string for lock and unlock object locks.
- Throws:
MSTRWebAPIException
- Thrown if IServer encountered an error.- Since:
- MicroStrategy Web 9.0.0
-
InvokeSourceManipulator
java.lang.String InvokeSourceManipulator(java.lang.String sessionID, java.lang.String manipulationXML) throws MSTRWebAPIException
Invoke the source manipulator to perform project merge or metadata deltas in a bulk operation. The order of manipulations which appear in the command XML is important and is strictly followed. If one of the manipulations fails it will abort processing and return an error, but there is no attemp to undo any manipulations that is already proecessed.- Parameters:
sessionID
- A valid session ID.manipulationXML
- the XML command to- Returns:
- the result XML string reserved for future use cases. For the time being, it is an empty string.
- Throws:
MSTRWebAPIException
- thrown if there is any error- Since:
- MicroStrategy Web 9.0.0
-
GetSourceManipulatorDelta
byte[] GetSourceManipulatorDelta(java.lang.String sessionID, java.lang.String manipulationXML) throws MSTRWebAPIException
Invoke the source manipulator to return a metadata delta package.- Parameters:
sessionID
- A valid session ID.manipulationXML
- the XML command to- Returns:
- the result XML string reserved for future use cases. For the time being, it is an empty string.
- Throws:
MSTRWebAPIException
- thrown if there is any error- Since:
- MicroStrategy Web 9.0.0
-
GetFilterExpression
java.lang.String GetFilterExpression(java.lang.String sessionID, java.lang.String commandXML) throws MSTRWebAPIException
Returns the filter expression that the given filter expression resolves into.- Parameters:
sessionID
- A valid session ID.commandXML
- A command XML describing the command to use.- Returns:
- The result of the call.
- Throws:
MSTRWebAPIException
- thrown if an error occurs.- Since:
- MicroStrategy Web 9.0.0
-
GetRootExpression
java.lang.String GetRootExpression(java.lang.String sessionID, java.lang.String metricID) throws MSTRWebAPIException
Returns the root expression of the specified metric.- Parameters:
sessionID
- A valid session IDmetricID
- DSS ID of the metric whose expression is requested- Returns:
- XML representing the root expression of the metric
- Throws:
MSTRWebAPIException
- thwon if an error is encountered.- Since:
- MicroStrategy Web 9.0.0
-
GetDimensionAttributeLock
java.lang.String GetDimensionAttributeLock(java.lang.String sessionID, java.lang.String dimensionID) throws MSTRWebAPIException
Returns XML containing the System Dimension Attributes that have lock properties specified- Parameters:
sessionID
-dimensionID
-- Throws:
MSTRWebAPIException
-
GetConfiguredDSNs
java.lang.String GetConfiguredDSNs(java.lang.String sessionID) throws MSTRWebAPIException
Returns XML containing a list of Data Source Names configured on the I-Server machine.- Parameters:
sessionID
-- Returns:
- XML representing a list of DSNs
- Throws:
MSTRWebAPIException
- Since:
- MicroStrategy Web 9.0.3
-
GetTransactionReportXML
java.lang.String GetTransactionReportXML(java.lang.String sessionID, java.lang.String transactionReportID) throws MSTRWebAPIException
Returns the XML contains the inputMapping for the transactionReport- Parameters:
sessionID
-transactionReportID
-- Returns:
- the XML contains the inputMapping for the transactionReport
- Throws:
MSTRWebAPIException
-
ParseMetric
java.lang.String ParseMetric(java.lang.String sessionID, java.lang.String metricID, java.lang.String mtXML, java.lang.String tokenStreamXML, java.lang.String localSymbolFolderXML, int parserActionFlags, int parserOutFlags, java.lang.String folderID) throws MSTRWebAPIException
This method is used to parse a metric.- Parameters:
sessionID
-metricID
-mtXML
- scaled down metric XMLtokenStreamXML
- token stream XMLlocalSymbolFolderXML
- local symbol folder XMLparserActionFlags
- flags indicating the parse actions fromEnumDSSXMLParserActionFlags
parserOutFlags
- flags fromEnumDSSXMLParserOutFlags
indicating which part should be returnedfolderID
- DSS ID of the parent folder- Returns:
- scaled down metric and token stream XMLs
- Throws:
MSTRWebAPIException
- Since:
- MicroStrategy Web 9.2.2
-
ParseMetric
java.lang.String ParseMetric(java.lang.String sessionID, java.lang.String messageID, java.lang.String metricID, java.lang.String mtXML, java.lang.String tokenStreamXML, java.lang.String localSymbolFolderXML, int parserActionFlags, int parserOutFlags, java.lang.String folderID) throws MSTRWebAPIException
This method is used to parse a metric.- Parameters:
sessionID
-messageID
-metricID
-mtXML
- scaled down metric XMLtokenStreamXML
- token stream XMLlocalSymbolFolderXML
- local symbol folder XMLparserActionFlags
- flags indicating the parse actions fromEnumDSSXMLParserActionFlags
parserOutFlags
- flags fromEnumDSSXMLParserOutFlags
indicating which part should be returnedfolderID
- DSS ID of the parent folder- Returns:
- scaled down metric and token stream XMLs
- Throws:
MSTRWebAPIException
- Since:
- MicroStrategy Web 9.2.2
-
ParseMetricAndAttribute
java.lang.String ParseMetricAndAttribute(java.lang.String sessionID, java.lang.String messageID, java.lang.String objectID, int objectType, java.lang.String mtXML, java.lang.String tokenStreamXML, java.lang.String localSymbolFolderXML, int parserActionFlags, int parserOutFlags, java.lang.String folderID, java.lang.String formId) throws MSTRWebAPIException
This method is used to parse a metric, derived metric or derived attribute.- Parameters:
sessionID
-messageID
-objectID
-objectType
-mtXML
- scaled down metric XMLtokenStreamXML
- token stream XMLlocalSymbolFolderXML
- local symbol folder XMLparserActionFlags
- flags indicating the parse actions fromEnumDSSXMLParserActionFlags
parserOutFlags
- flags fromEnumDSSXMLParserOutFlags
indicating which part should be returnedfolderID
- DSS ID of the parent folderformId
- DSS ID of the validating attribute form- Returns:
- scaled down metric and token stream XMLs
- Throws:
MSTRWebAPIException
- Since:
- MicroStrategy Web 9.2.2
-
ParseModel
java.lang.String ParseModel(java.lang.String sessionID, java.lang.String objectID, int targetType, java.util.OptionalInt dssType, java.lang.String tokenStreamXML, java.lang.String localSymbolFolderXML, java.lang.String availableObjectsXML, int parserActionFlags, int parserOutFlags) throws MSTRWebAPIException
This method is used to parse a model except metric and attributes, including fact, filter and any other objects. This method is overloading the ParseModel by introducing another parameter `availableObjectsJSON` to support object context.- Parameters:
sessionID
-objectID
-targetType
- the type matching up with the object. We will set the value in an attribute called Att_TargetType inEnumDSSXMLObjectTypes
, as there is no messageID as the parameter, this parameter only stands for the Att_TargetTypedssType
- the DSS type in order to support the target object for parse_model command inEnumDSSXMLObjectTypes
tokenStreamXML
- token stream XMLlocalSymbolFolderXML
- local symbol folder XMLavailableObjectsXML
- JSON representation of the objects in an XML node which is used to support object contextparserActionFlags
- flags indicating the parse actions fromEnumDSSXMLParserActionFlags
parserOutFlags
- flags fromEnumDSSXMLParserOutFlags
indicating which part should be returned- Returns:
- result returned from IServer token stream XMLs
- Throws:
MSTRWebAPIException
- Since:
- MicroStrategy Web 11.2.1
-
ParseModel
java.lang.String ParseModel(java.lang.String sessionID, java.lang.String objectID, int objectType, java.util.OptionalInt dssType, java.lang.String tokenStreamXML, java.lang.String localSymbolFolderXML, java.lang.String availableObjectsXML, int parserActionFlags, int parserOutFlags, java.lang.String messageId) throws MSTRWebAPIException
This method is used to parse a model except metric and attributes, including fact, filter and any other objects. This method is overloading the ParseModel by introducing another parameter `availableObjectsJSON` to support object context.- Parameters:
sessionID
-objectID
-objectType
- the type matching up with the object. We will set the value in an attribute called Att_TargetType or Att_ObjectType for report instance support inEnumDSSXMLObjectTypes
dssType
- the DSS type in order to support the target object for parse_model command inEnumDSSXMLObjectTypes
tokenStreamXML
- token stream XMLlocalSymbolFolderXML
- local symbol folder XMLavailableObjectsXML
- JSON representation of the objects in an XML node which is used to support object contextparserActionFlags
- flags indicating the parse actions fromEnumDSSXMLParserActionFlags
parserOutFlags
- flags fromEnumDSSXMLParserOutFlags
indicating which part should be returnedmessageId
- The optional message id corresponding to a report instance- Returns:
- result returned from IServer token stream XMLs
- Throws:
MSTRWebAPIException
- Since:
- MicroStrategy Web 11.3.4
-
GetSearchSuggestions
java.lang.String GetSearchSuggestions(java.lang.String sessionID, java.lang.String searchKey, int blockCount, int localeId) throws MSTRWebAPIException
Returns XML containing a list of search suggestions based on the search key provided.- Parameters:
sessionID
-searchKey
-blockCount
-localeId
-- Returns:
- XML representing a list of search suggestions
- Throws:
MSTRWebAPIException
- Since:
- MicroStrategy Web 9.2.2
-
GetQuickSearchStatus
java.lang.String GetQuickSearchStatus(java.lang.String sessionID, int qscmd) throws MSTRWebAPIException
Returns XML containing quick search status.- Parameters:
sessionID
-qscmd
-- Returns:
- XML quick search status
- Throws:
MSTRWebAPIException
-
ChangeJournalCommon
java.lang.String ChangeJournalCommon(java.lang.String sessionID, int type, java.lang.String extParams) throws MSTRWebAPIException
This method purge/enable/disable change journal.- Parameters:
sessionID
- A valid Session IDEnable
- /Disable/Purge commands typeEnumDSSXMLChangeJournalCommandType
extParam
- extendable parameter- Throws:
MSTRWebAPIException
- Signals an error condition.
-
PropagateToChildren
java.lang.String PropagateToChildren(java.lang.String sessionID, java.lang.String id, int objFlags) throws MSTRWebAPIException
- Throws:
MSTRWebAPIException
-
ChangeObjectID
java.lang.String ChangeObjectID(java.lang.String sessionID, java.lang.String objectId, int type, java.lang.String newId) throws MSTRWebAPIException
This method changes DSS ID of the given object.- Parameters:
sessionID
- A valid session id.objectId
- The DSS ID of the object to be changed.type
- The type of the object to be changed.newId
- The new DSS ID of the object.- Throws:
MSTRWebAPIException
-
getAllPalettes
java.lang.String getAllPalettes(java.lang.String sessionId) throws MSTRWebAPIException
Get all palettes (including system and custom)- Parameters:
sessionId
- A valid session id.- Returns:
- String with json format of Palettes List
- Throws:
MSTRWebAPIException
-
UpdateTheme
void UpdateTheme(java.lang.String sessionId, java.lang.String themeID, java.lang.String defaultPaletteID, java.lang.String[] paletteIDs, int flag) throws MSTRWebAPIException
Update theme info - add/remove palettes to/from theme; set default palette- Parameters:
sessionId
-themeID
-defaultPaletteID
-paletteIDs
-flag
-- Throws:
MSTRWebAPIException
-
GetUserDICubeInfo
java.lang.String GetUserDICubeInfo(java.lang.String sessionId, java.lang.String[] ids, int option) throws MSTRWebAPIException
- Parameters:
sessionId
-ids
-option
-- Returns:
- Throws:
MSTRWebAPIException
-
getExternalSourceInfo
java.lang.String getExternalSourceInfo(java.lang.String sessionID, int flags, java.lang.String sourceID, int sourceType) throws MSTRWebAPIException
Retrieve external source information- Parameters:
sessionID
- A valid Session IDflags
- XML Command flagssourceID
- XML Command srcidsourceType
- XML Command srct- Returns:
- External source information
- Throws:
MSTRWebAPIException
-
getAndSetExternalSourceInfo
java.lang.String getAndSetExternalSourceInfo(java.lang.String sessionID, int flags, java.lang.String sourceID, int sourceType, java.lang.String u, java.lang.String localeDateNumber, java.util.Map<java.lang.String,java.lang.String> tokenInfo) throws MSTRWebAPIException
Retrieve external source information after setting new token- Parameters:
sessionID
- A valid Session IDflags
- XML Command flagssourceID
- XML Command srcidsourceType
- XML Command srctu
- User name attribute "un" for token infocount
- Count attribute "cn" for token infolocaleDateNumber
- Locale date number attribute "lcldn" for token infotokenInfo
- Token information map. Example keys: SESSION_ID, SERVER_URL, REFRESH_ID, CLIENT_ID, CLIENT_ID- Returns:
- External source information
- Throws:
MSTRWebAPIException
-
getAndSetExternalDatasourceInfo
java.lang.String getAndSetExternalDatasourceInfo(java.lang.String sessionID, int flags, java.lang.String dbrid, java.util.Map<java.lang.String,java.lang.String> tokenInfo) throws MSTRWebAPIException
Retrieve external datasource information after setting new token- Parameters:
sessionID
- A valid Session IDflags
- XML Command flagsdbrid
- XML Command dbridtokenInfo
- Token information map. Example keys: CODE, dynamicRedirectURI- Returns:
- External datasource information
- Throws:
MSTRWebAPIException
-
createLocale
java.lang.String createLocale(java.lang.String sessionID, java.lang.String objectName, int localeID, int localeFlag, java.lang.String folderID, int objectFlag) throws MSTRWebAPIException
This manipulation allows the caller to create a locale object.- Parameters:
sessionID
- A valid Session IDobjectName
- the name of new localelocaleID
- locale idlocaleFlag
- It has the effect of adding the new locale to the list of supported metadata and / or data locales in the project. If it is not needed, you can set it to 0;folderID
- folder id where the locale is stored- Returns:
- the id of newly created locale
- Throws:
MSTRWebAPIException
-
manipulateLocaleLinkedToInterfaceLanguage
java.lang.String manipulateLocaleLinkedToInterfaceLanguage(java.lang.String sessionID, java.lang.String objectName, int localeID, java.lang.String interfaceLanguageId, int localeFlag, java.lang.String folderID, int objectFlag) throws MSTRWebAPIException
This manipulation allows the caller to create a locale object linked to interface language.- Parameters:
sessionID
- A valid Session IDobjectName
- the name of new localelocaleID
- locale idinterfaceLanguageId
- interface language idlocaleFlag
- It has the effect of adding the new locale to the list of supported metadata and / or data locales in the project. If it is not needed, you can set it to 0;folderID
- folder id where the locale is stored- Returns:
- the id of newly created locale
- Throws:
MSTRWebAPIException
-
updateTranslations
java.lang.String updateTranslations(java.lang.String sessionID, java.lang.String objectID, int objectType, java.lang.String updateXml) throws MSTRWebAPIException
This manipulation allows user to add, update, and delete any translations at any locale for one object.- Parameters:
sessionID
- A valid Session IDobjectID
- object idobjectType
- object typeupdateXml
- extendable parameter- Returns:
- the number of added/updated/deleted translations.
- Throws:
MSTRWebAPIException
-
listTranslations
java.lang.String listTranslations(java.lang.String sessionID, java.lang.String listXml) throws MSTRWebAPIException
This manipulation allows user to list any translations at any locales for any keys for multiple objects and their embedded objects.- Parameters:
sessionID
- A valid Session IDlistXml
- extendable parameter- Returns:
- xml string contains the result of list translations
- Throws:
MSTRWebAPIException
-
SearchIndexCommon
java.lang.String SearchIndexCommon(java.lang.String sessionID, int quickSearchCommand, java.lang.String projeceID, java.lang.String enabled) throws MSTRWebAPIException
This method is a common method to start/stop SearchEngine,get its properties, start/pause/destroy crawl and so on- Parameters:
sessionID
- A valid Session IDquickSearchCommand
-EnumDSSXMLQuickSearchCommands
projectID
- , needs to specified when the command is 6,7,8,9,10,11,12,13 and 14enabled
- , "1" means enable search on the project specified in projectID, "0" means disable- Throws:
MSTRWebAPIException
- Signals an error condition.
-
SaveSearchEngineProperties
void SaveSearchEngineProperties(java.lang.String sessionID, java.lang.String autoStartQuickSearch, java.lang.String indexLocation, java.lang.String stopwordsXML) throws MSTRWebAPIException
This method is used to save SearchEngineProperties- Parameters:
sessionID
- A valid Session IDautoStartQuickSearch
- , "1" means autoStartQuickSearch of SearchEngineProperties is true, "0" means false.indexLocation
- , the indexlocation of SearchEnginePropertiesstopwordsXML
- , the stopwords of SearchEngineProperties- Throws:
MSTRWebAPIException
- Signals an error condition.
-
ChangeJournalSearch
java.lang.String ChangeJournalSearch(java.lang.String sessionID, int maxEntries, java.lang.String searchContentXML) throws MSTRWebAPIException
This method finds a set of DSS objects with the given conditions.The search results will not be returned in this call. GetChangeJournalSearchResults needs to be called to retrieve the results.
- Parameters:
sessionID
- A valid Session ID.maxEntries
- The maximum number of change journal entries to retrieve, by default up to the last 100 entries will be retrieved, if the caller passes in 0 all entries associated with the object will be retrievedsearchContentXML
- searchObjectXML must contain the definition of the search object. This is in XML format and constructed by the Web API to reflect the filter of this search.- Returns:
- The unique ID of the search. This will be passed to GetChangeJournalSearchResults to get the result XML.
- Throws:
MSTRWebAPIException
- Signals an error condition.
-
GetChangeJournalSearchResults
java.lang.String GetChangeJournalSearchResults(java.lang.String sessionID, java.lang.String searchID, IntWrapper status, int blockBegin, int blockCount) throws MSTRWebAPIException
This method retrieves the results of a change journal search.- Parameters:
sessionID
- A valid Session IDsearchID
- The unique id for the search.status
- Output Parameter - Search status: a value of typeEnumDSSXMLObjectSearchStatus
.blockBegin
- The index for the first object in the searching result set (incremental fetching). [Default=1]blockCount
- The total number of objects to be returned. [Default=-1]- Returns:
- The XML contains the collection of the change journal entries that meet the search criteria
- Throws:
MSTRWebAPIException
- Signals an error condition.
-
GetDependencies
java.lang.String GetDependencies(java.lang.String sessionID, java.lang.String objectID, int objectType, int objectSubType, int detailFlag) throws MSTRWebAPIException
This method retrieves the results of dependency search.- Parameters:
sessionID
- A valid Session IDobjectID
- The unique id of the object.objectType
- The type of the object, fromEnumDSSXMLObjectTypes
.objectSubType
- The type of the object, fromEnumDSSXMLObjectSubTypes
.detailFlag
- Specifying the type of data to return. Should come fromEnumDSSXMLNCSInstanceSourceField
.Only DssXmlNCSInstanceCountField & DssXmlNCSInstanceDefinitionField are supported. Optional, default value is DssXmlNCSInstanceCountField, and only object counts will be returned.- Returns:
- The XML contains the collection of objects that depend on current objectID.
- Throws:
MSTRWebAPIException
- Signals an error condition.
-
GetUserLibrary
@Deprecated java.lang.String GetUserLibrary(java.lang.String confSessionID) throws MSTRWebAPIException
Deprecated.This method retrieves the results of all dossiers belonged to specified user. This method is deprecated. Use GetUserLibraryEx instead.- Parameters:
confSessionID
- The configuration session id- Returns:
- The JSON format String of all dossiers
- Throws:
MSTRWebAPIException
-
GetUserLibrary
@Deprecated java.lang.String GetUserLibrary(java.lang.String confSessionID, java.util.List<EnumDSSXMLLibraryOutputFlag> outputFlags) throws MSTRWebAPIException
Deprecated.This method retrieves the results of all dossiers belonged to specified user. This method is deprecated. Use GetUserLibraryEx instead.- Parameters:
confSessionID
- The configuration session idoutputFlags
- Characterize what is contained or filtered out of the library output- Returns:
- The JSON format String of all dossiers
- Throws:
MSTRWebAPIException
-
GetUserLibraryEx
IDSSXMLObjectServer.StringFormatAndErrorData GetUserLibraryEx(java.lang.String confSessionID, java.util.List<EnumDSSXMLLibraryOutputFlag> outputFlags) throws MSTRWebAPIException
This method retrieves the results of all dossiers belonged to specified user. If dossiers for any particular project could not be retrieved, then the Project ID and its exception (reason for failure) is also returned.- Parameters:
confSessionID
- The configuration session idoutputFlags
- Characterize what is contained or filtered out of the library output, this might be null- Returns:
- The GULData object that holds the JSON format String of all dossiers and the project related errors
- Throws:
MSTRWebAPIException
-
GetUserLibraryEx
IDSSXMLObjectServer.StringFormatAndErrorData GetUserLibraryEx(java.lang.String confSessionID, java.util.List<EnumDSSXMLLibraryOutputFlag> outputFlags, java.lang.String applicationId) throws MSTRWebAPIException
This method retrieves the results of all dossiers belonged to specified user in a specific custom application. If dossiers for any particular project could not be retrieved, then the Project ID and its exception (reason for failure) is also returned.- Parameters:
confSessionID
- The configuration session idoutputFlags
- Characterize what is contained or filtered out of the library output, this might be nullapplicationId
- The custom application id used to filter the library content- Returns:
- The GULData object that holds the JSON format String of all dossiers and the project related errors
- Throws:
MSTRWebAPIException
-
isFeatureFlagExisted
boolean isFeatureFlagExisted(java.lang.String sessioinID, java.lang.String featureID)
This method checks the existence of specific feature flag, to see if this is set in FeatureFlags.PDS or not.- Parameters:
sessioinID
- the session idfeatureID
- the feature id of specific feature- Returns:
- Boolean value: whether this flag is set or not.
- Throws:
MSTRWebAPIException
-
IsFeatureEnabled
boolean IsFeatureEnabled(java.lang.String sessionID, java.lang.String featureName) throws MSTRWebAPIException
This method retrieves whether the specified feature is enabled.- Parameters:
sessionID
- the session idfeatureName
- the name of the specified feature- Returns:
- whether the feature is enabled.
- Throws:
MSTRWebAPIException
-
GetFeatureInfos
java.lang.String GetFeatureInfos(java.lang.String sessionID) throws MSTRWebAPIException
This method retrieves the information of all features.- Parameters:
sessionID
- the session id- Returns:
- the information of all features.
- Throws:
MSTRWebAPIException
-
ChangeFeatureStatus
java.lang.String ChangeFeatureStatus(java.lang.String sessionID, java.lang.String deltaXML) throws MSTRWebAPIException
This method is used to change the status of features- Parameters:
sessionID
- the session iddeltaXML
- deltaXML- Returns:
- Throws:
MSTRWebAPIException
-
GetCubeSecurityFilters
java.lang.String GetCubeSecurityFilters(java.lang.String sessionID, java.lang.String userID, java.lang.String cubeID) throws MSTRWebAPIException
This method get the cube's security filters. if only provide cubeId, the method will return cube's all security filters for provided cube. if provide cubeId and userId, the method will return an cube's security filter for provided cube related to provided user. Explain for backend implement of cube level's security filter: there is no first class object for cube security filter which actually is combined to user level's security filter in MD, the cube security filter expression is pruned form user level's filter by backend. Currently,backend returns cube's security filters through checking userIds in cube's ACL when only provided cubeId.- Parameters:
sessionID
- the session iduserID
- user idcubeID
- cube id- Returns:
- Throws:
MSTRWebAPIException
-
UpdateCubeSecurityFilters
java.lang.String UpdateCubeSecurityFilters(java.lang.String sessionID, java.lang.String cubeID, java.util.Map<java.lang.String,java.lang.String> cubeSecurityFilters) throws MSTRWebAPIException
This method is for partially updating cube's security filters. Explain for backend implement of cube level's security filter: there is no first class object for cube security filter which actually is combined to user level's security filter in MD, the cube security filter expression is pruned form user level's filter by backend. Note that this method requires include the above 10.8 version for IServer due to changed backend.- Parameters:
sessionID
- the session idcubeID
- cube idcubeSecurityFilters
- userId map to filter expression xml- Returns:
- Throws:
MSTRWebAPIException
-
GetVLDBInheritedValuesAsJSON
java.lang.String GetVLDBInheritedValuesAsJSON(java.lang.String sessionID, java.lang.String objectID, int objectType, java.lang.String messageID, java.lang.String propertySetID, java.util.List<java.lang.Integer> propertyIDs) throws MSTRWebAPIException
This method is used for getting the inherited value of VLDB property. The internal logic can be seen in the doc "VLDB Overall design"- Parameters:
sessionID
- the session idobjectID
- object idobjectType
- object type, which can be found in EnumDSSXMLObjectTypes.javamessageID
- message idpropertySetID
- the id of VLDB property set, which is a GUIDpropertyIDs
- the id of VLDB property that you want to get value- Returns:
- the json string that contains the VLDB inherited property value
- Throws:
MSTRWebAPIException
-
GetSourceInfo
java.lang.String GetSourceInfo(java.lang.String sessionID, int type, java.lang.String deltaXML) throws MSTRWebAPIException
This method is used to get source info.- Parameters:
sessionID
- A valid session ID from an Intelligence Server.type
- Get source info command type.deltaXML
- XML string to be concatenated into command XML.- Returns:
- Throws:
MSTRWebAPIException
-
-