com.microstrategy.web.objects.WebObjectSource |
The WebObjectSource object is used to execute object-related operations and instantiate objects
such as WebObjectInfo
and WebSearch
. In addition, many of the other API objects
take WebObjectInfo
objects as arguments, and this is the only method which can create
instances of WebObjectInfo
.
Note that many WebObjectInfo
objects obtained from the methods on this interfaces
are read-only. But there are several types of objects are editable. Among the editable objects,
some of them are editable and can be saved back to metadata: WebMonitor
, WebServerDef
,
WebMDSecurityFilter, WebSecurityRole, WebShortcut
and WebUser objects;
some of them are editable but can not be saved back to metadata: WebFilter
and WebSearch
objects.
However, the WebAccessControlList
is editable for any type of object.
Also note that in order to modify an object which exists in metadata, the object must be populated, either by specifying the populate
flag when obtaining an object as true, or by calling populate()
on it. However, if an object which is
not read-only is obtained from the getNewObject(int)
call(monitor, serverdef, or user), then it can also be
modified without population.
This list of objects is of the 8.0 release, which can be modified may change from release to release.
All objects, including both read-only and read-write objects, are able to be copied via the copy method. All objects also may be renamed or moved -- see the "save" methods below for details on how to move or rename an object.
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
abstract String |
certifyObject(String objectID, int objectType, boolean certify)
Certify or decertify object in the metadata.
| ||||||||||
abstract void |
changeObjectID(WebObjectInfo object, String newId)
Change DSS ID of the given object.
| ||||||||||
abstract void |
changeObjectID(String objectId, int type, String newId)
Change DSS ID of the given object.
| ||||||||||
abstract WebObjectInfo |
copy(WebObjectInfo sourceObject, String targetObjectName)
Creates a copy of the object passed (sourceObject).
| ||||||||||
abstract WebObjectInfo |
copy(WebObjectInfo sourceObject, String targetObjectName, WebFolder location)
Creates a copy of the object passed (sourceObject).
| ||||||||||
abstract WebObjectInfo |
copy(WebObjectInfo sourceObject, WebFolder location)
Creates a copy of the object passed (sourceObject).
| ||||||||||
abstract String |
createFolder(String folderName, String parentFolderID)
Creates a folder in metadata with the given name and parent folder ID.
| ||||||||||
abstract String |
createFolder(String folderName, String parentFolderID, String folderDesc)
Creates a folder in metadata with the given name, parent folder ID, and description.
| ||||||||||
abstract String |
createLocale(String name, int localeID, int localeFlag, String folderID, int objectFlag)
This manipulation allows the caller to create a locale object.
| ||||||||||
abstract void |
deleteObject(String objectID, int objectType)
Deletes the object with the given DSS ID and type from the metadata.
| ||||||||||
abstract void |
deleteObject(WebObjectInfo object)
Deletes the given object from the metadata.
| ||||||||||
abstract String |
deleteTranslation(String objectID, int objectType, String key, int localeID)
This manipulation allows user to delete one translation at any locale for one unembedded object.
| ||||||||||
abstract void |
destroyCrawl(String projectID)
To destroy crawl on project
| ||||||||||
abstract void |
enableSearch(String projectID, boolean enable)
To enable/disable project
| ||||||||||
abstract WebServerDef |
getActiveServerDef()
Returns the
WebServerDef object corresponding to the Server Definition object
currently being used by the Intelligence Server. | ||||||||||
abstract WebFolder |
getAllAvailableLocales()
Return all the available locales supported by the IServer
| ||||||||||
abstract WebFolder |
getAllStyles()
Returns a populated
WebFolder which contains both the system styles and the user styles. | ||||||||||
abstract void | getAndSetExternalSourceSessionInfo(int flags, String sourceID, int sourceType, String userName, String localeDateNumber, Map<String, String> tokenInfo) | ||||||||||
abstract WebFolder |
getAvailableDBRoles()
Retrieves a list of the available db roles.
| ||||||||||
abstract int |
getBlockBegin()
Returns the current setting for the blockBegin parameter which is used upon
retrieving folder definitions from the Intelligence Server.
| ||||||||||
abstract int |
getBlockCount()
Returns the current setting for the blockCount parameter which is used upon
retrieving folder definitions from the Intelligence Server.
| ||||||||||
abstract List<WebDSN> |
getConfiguredDSNs()
Returns a list of DSNs configured on the I-Server machine.
| ||||||||||
abstract WebConnectionMapSource |
getConnectionMapSource()
Obtain
WebConnectionMapSource object to find and create
WebConnectionMap objects | ||||||||||
abstract WebExpression |
getCubeSecurityFilter(String userID, String cubeID)
This method get an cube's security filter for certain user.
| ||||||||||
abstract Map<String, WebExpression> |
getCubeSecurityFilters(String cubeID)
This method get the cube's security filters.
| ||||||||||
abstract String |
getCubeSecurityFiltersXML(String userID, String cubeID)
This method get the cube's security filters.
| ||||||||||
abstract WebElementSource | getElementSource() | ||||||||||
abstract WebEmailNotification |
getEmailNotification()
Returns a
WebEmailNotification object, which can be used to send email notification | ||||||||||
abstract int |
getFlags()
Returns the current setting of the flags which will determine what data will
be obtained when retrieving object definitions from the Intelligence Server.
| ||||||||||
abstract String |
getFolderID(int folderName)
Returns the folder ID of one of the special folders in metadata.
| ||||||||||
abstract ProjectIndexMetadata |
getIndexMetadata(String projectID)
To get the index metedata
| ||||||||||
abstract String |
getInstanceVLDBInheritedValuesAsJSON(String messageID, int objectType, String propertySetID, List<Integer> propertyIDs)
This method is used for getting the VLDB property inherited value of an instance.
| ||||||||||
abstract WebObjectInfo |
getLeanObject(String objectID, int objectType)
To get the device/transmitter object
| ||||||||||
abstract int |
getLevel()
Returns the current level parameter, which will be used when obtaining folder contents.
| ||||||||||
abstract WebMDXCubeSource |
getMDXCubeSource()
This method will return the
WebMDXCubeSource interface, which can be used to
initiate cube browsing and cube object browsing requests. | ||||||||||
abstract String |
getMessageID()
Returns the messageID for get object command.
| ||||||||||
abstract WebChangeJournalSearch |
getNewChangeJournalSearch()
Returns a
WebChangeJournalSearch object, which can be used to execute a change journal search. | ||||||||||
abstract WebFilter |
getNewFilter()
Returns a
WebFilter object. | ||||||||||
abstract WebObjectInfo |
getNewObject(int objectType, int subType, String name)
Returns a new object of the type and subtype passed.
| ||||||||||
abstract WebObjectInfo |
getNewObject(int objectType, int subType)
Returns a new object of the type and subtype passed.
| ||||||||||
abstract WebObjectInfo |
getNewObject(int objectType, String name)
Returns a new object of the type passed.
| ||||||||||
abstract WebObjectInfo |
getNewObject(int objectType)
Returns a new object of the type passed.
| ||||||||||
abstract WebSearch |
getNewSearchObject()
Returns a
WebSearch object, which can be used to execute a search. | ||||||||||
abstract int |
getNumberOfDependencies(String objectID, int objectType, int objectSubType)
This manipulation returns the dependencies for the current object.
| ||||||||||
abstract WebObjectInfo |
getObject(String objectID, int objectType)
Returns a
WebObjectInfo object representing an object which resides in metadata. | ||||||||||
abstract WebObjectInfo |
getObject(String objectID, int objectType, int objectSubType, boolean populate)
Returns a
WebObjectInfo object representing an object which resides in metadata. | ||||||||||
abstract WebObjectInfo |
getObject(String objectID, int objectType, boolean populate)
Returns a
WebObjectInfo object representing an object which resides in metadata. | ||||||||||
abstract WebObjectInfo |
getObject(String objectID, int objectType, int objectSubType)
Returns a
WebObjectInfo object representing an object which resides in metadata. | ||||||||||
abstract WebObjectInfo |
getObjectByPath(String fullPath, int objectType, int objectSubType)
Returns a
WebObjectInfo object representing an object which resides in metadata by folderPath. | ||||||||||
abstract WebObjectInfo |
getObjectByPath(String fullPath, int objectType)
Returns a
WebObjectInfo object representing an object which resides in metadata by folderPath. | ||||||||||
abstract WebObjectInfo |
getObjectFromState(String state)
This method will take the given object state and return the
WebObjectInfo object that the
state describes. | ||||||||||
abstract String |
getObjectVLDBInheritedValuesAsJSON(String objectID, int objectType, String propertySetID, List<Integer> propertyIDs)
This method is used for getting the VLDB property inherited value of an object.
| ||||||||||
abstract WebParsedMetric |
getParsedMetric(String metricID)
Get a parsed metric object with the specified metric ID.
| ||||||||||
abstract int |
getPropertyFlags()
Retrieve the current property flags
| ||||||||||
abstract WebPushNotification |
getPushNotification()
Returns a
WebPushNotification object, which can be used to push mobile notification on a dossier. | ||||||||||
abstract String | getQuickSearchStatus() | ||||||||||
abstract WebFolder |
getRoot()
Returns a populated
WebFolder which contains the contents of the root folder. | ||||||||||
abstract SearchEngineProperties |
getSearchEngineProperties()
To get the search engine properties
| ||||||||||
abstract List<WebSearchSuggestion> | getSearchSuggestions(String searchKey, int localeId) | ||||||||||
abstract Map<Integer, String> | getServerSettings() | ||||||||||
abstract WebSourceManipulator | getSourceManipulator() | ||||||||||
abstract WebFunctionFolders |
getSystemFunctions(int functionFlags)
Retrieves the list of system functions based on the flags.
| ||||||||||
abstract WebFolder |
getSystemStyles()
Returns a populated
WebFolder which contains the system styles. | ||||||||||
abstract String | getThumbnailObjectXML(String objectID, int objectType) | ||||||||||
abstract TransactionElement | getTransactionElement(String transactionReportID) | ||||||||||
abstract WebFolder |
getTransformationRoles()
This method will return a
WebFolder containing the transformation roles that are available in the project. | ||||||||||
abstract WebUserServicesSource |
getUserServicesSource()
This method returns the
WebUserServicesSource interface, which contains
user-management related operations. | ||||||||||
abstract WebFolder |
getUserStyles()
Returns a populated
WebFolder which contains the user styles. | ||||||||||
abstract boolean |
isChangeJournalEnabled()
To get if change journal enabled
if true, it is enabled, else disabled.
| ||||||||||
abstract boolean |
isSearchEnabled(String projectID)
To check if search on project
| ||||||||||
abstract boolean |
isSearchEngineStarted()
To check if search engine has been started
| ||||||||||
abstract WebLocaleTranslation[] |
listTranslations(WebObjectInfo objectInfo, String[] keyList, int[] localeIDList, int qualities)
This manipulation allows user to list any translations at any locales for any keys for multiple objects and their embedded objects.
| ||||||||||
abstract void |
moveObject(String objectID, int objectType, String newName)
Move an existing object in the metadata.
| ||||||||||
abstract WebElements |
newElements(WebAttribute attribute)
Creates an empty element collection associated with the specified attribute
| ||||||||||
abstract WebExpression |
newExpression()
Creates new expression object
| ||||||||||
abstract WebPrompts | newPrompts(String messageId, int objectType) | ||||||||||
abstract void |
pauseCrawl(String projectID)
To pause crawl on project
| ||||||||||
abstract void | propagateACLToChildren(WebObjectInfo objectToSave, int flag) | ||||||||||
abstract void |
purgeChangeJournal(String timestamp, String comment, int allProjects)
To purge specific time stamp change journal
| ||||||||||
abstract void |
resumeCrawl(String projectID)
To resume crawl on project
| ||||||||||
abstract WebObjectInfo |
save(WebObjectInfo objectToSave, WebFolder folder)
Saves the object passed, to the new location (specified by folder) in metadata.
| ||||||||||
abstract WebObjectInfo |
save(WebObjectInfo objectToSave)
Saves the object passed, to metadata.
| ||||||||||
abstract WebObjectInfo |
save(WebObjectInfo objectToSave, String name, WebFolder folder)
Saves the object passed, to the new location (specified by folder) in metadata.
| ||||||||||
abstract WebObjectInfo |
save(WebObjectInfo objectToSave, String name)
Saves the object passed, to metadata.
| ||||||||||
abstract WebObjectInfo | saveAs(WebObjectInfo objectToSave, String name, WebFolder folder, boolean overwrite) | ||||||||||
abstract void |
saveObjects(HashMap<WebObjectInfo, WebFolder> objectInfos)
Bulk Save the object to metadata.
| ||||||||||
abstract void | saveWithDssID(WebObjectInfo objectToSave, String name, WebFolder folder, String dssID) | ||||||||||
abstract void |
setBlockBegin(int blockBegin)
Sets the blockBegin parameter which is used upon
retrieving folder definitions from the Intelligence Server.
| ||||||||||
abstract void |
setBlockCount(int blockCount)
Sets the blockCount parameter which is used upon
retrieving folder definitions from the Intelligence Server.
| ||||||||||
abstract void |
setChangeJournalStatus(boolean enabled, String comment, int allProjects)
To set change journal to enabled/disabled
| ||||||||||
abstract void |
setFlags(int flags)
Sets the current setting of the flags which will determine what data will
be obtained when retrieving object definitions from the Intelligence Server.
| ||||||||||
abstract void |
setLevel(int level)
Sets the current level parameter, which will be used when obtaining folder contents.
| ||||||||||
abstract void |
setMessageID(String _messageID)
Set the messageID for get object command.
| ||||||||||
abstract void |
setPropertyFlags(int flags)
Set the current property flags
| ||||||||||
abstract void |
startCrawl(String projectID)
To start crawl on project
| ||||||||||
abstract void |
startIncrementalCrawl(String projectID)
To start incremental crawl on project
| ||||||||||
abstract void |
startSearchEngine()
To start search engine
| ||||||||||
abstract void |
stopIncrementalCrawl(String projectID)
To stop incremental crawl on project
| ||||||||||
abstract void |
stopSearchEngine()
To stop search engine
| ||||||||||
abstract String |
updateCubeSecurityFilters(String cubeID, Map<String, WebExpression> cubeSecurityFilters)
This method is for partially updating cube's security filters.
| ||||||||||
abstract String |
updateTranslation(String objectID, int objectType, String key, int localeID, String name)
This manipulation allows user to add, update one translation at any locale for one unembedded object.
| ||||||||||
abstract String |
updateTranslations(WebObjectInfo objectInfo, WebLocaleTranslation[] toUpdateList, WebLocaleTranslation[] toDeleteList)
This manipulation allows user to add, update, and delete any translations at any locale for one object.
| ||||||||||
abstract void |
validateObjectName(String name)
This method will ensure that the given object name is a valid name for a first
class object.
|
Certify or decertify object in the metadata.
objectID | The DSS ID of the object to certify or decertify. |
---|---|
objectType | The type of the object in the metadata EnumDSSXMLObjectTypes , only support document and report type now. |
certify | 1 for certify object, 0 for decertify object |
WebObjectsException | Thrown if an error occurs upon attempting to move the object |
---|
Change DSS ID of the given object.
object | The object to be changed. |
---|---|
newId | The new DSS ID. |
WebObjectsException |
---|
Creates a copy of the object passed (sourceObject). The new object is created in the same location as the source object. The object to be copied
should thus be an existing object in the metadata. Further, if the object passed is an editable object (e.g. WebMonitor
,WebPerformanceMonitor
, WebServerDef
),
the changes done to the object after loading it from metadata are saved in the copied object too. Changes done to non-editable objects cannot be saved/copied and
attempt to copy such objects will end in error.
This will work on non-editable objects whose definition has not been changed.
sourceObject | The object to be copied. |
---|---|
targetObjectName | The name of the copied object. |
WebObjectsException | thrown if an error is encountered by IServer. |
---|
Creates a copy of the object passed (sourceObject). The new object, will be named by targetObjectName and will be created in the location
specified by location. If the object passed is an editable object (e.g. WebMonitor
,WebPerformanceMonitor
, WebServerDef
), that already exists in the
metadata, the changes done to the object after loading from metadata are saved in the copied object too. If the editable object passed however, is a new object
that does not exist in the metadata, a new object will be created in the metadata at the location specified. For non-editable objects, copy can be created only
if the object is an existing object in the metadata and no changes have been done to object since loading it from the metadata.
This will work on non-editable objects whose definition has not been changed.
sourceObject | The object to be copied. |
---|---|
targetObjectName | The name of the copied object. |
location | The target folder for copying the object. |
WebObjectsException | thrown if an error is encountered by IServer. |
---|
Creates a copy of the object passed (sourceObject). The new object will be created in the location
specified by location. If the object passed is an editable object (e.g. WebMonitor
,WebPerformanceMonitor
, WebServerDef
), that already exists in the
metadata, the changes done to the object after loading from metadata are saved in the copied object too. The name of the copied object will be the same
as the sourceObject. If the editable object passed however, is a new object
that does not exist in the metadata, a new object will be created in the metadata at the location specified. For non-editable objects, copy can be created only
if the object is an existing object in the metadata and no changes have been done to object since loading it from the metadata.
sourceObject | The object to be copied. |
---|---|
location | The target folder for copying the object. |
WebObjectsException | thrown if an error is encountered by IServer. |
---|
Creates a folder in metadata with the given name and parent folder ID.
folderName | The name to give to the folder. |
---|---|
parentFolderID | The DSS ID of the parent folder. |
WebObjectsException | Thrown if the folder could not be created. |
---|
Creates a folder in metadata with the given name, parent folder ID, and description.
folderName | The name to give to the folder. |
---|---|
parentFolderID | The DSS ID of the parent folder. |
folderDesc | The description to give to the newly created folder. |
WebObjectsException | Thrown if the folder could not be created. |
---|
This manipulation allows the caller to create a locale object.
name | the name of new locale |
---|---|
localeID | locale id |
localeFlag | 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 |
objectFlag | EnumDSSXMLObjectFlags, the default value is DssXmlObjectSaveOverwrite(16777216) |
WebObjectsException |
---|
Deletes the object with the given DSS ID and type from the metadata.
objectID | The DSS ID of the object to be deleted. |
---|---|
objectType | The type of the object to be deleted. This value comes from EnumDSSXMLObjectTypes . |
WebObjectsException | Thrown if an error occurs upon attempting to delete the object. |
---|
Deletes the given object from the metadata.
object | The object to be deleted. |
---|
WebObjectsException | Thrown if an error occurs upon attempting to delete the object. |
---|
This manipulation allows user to delete one translation at any locale for one unembedded object.
objectID | object id |
---|---|
objectType | object type |
key | translation key |
localeID | locale id |
WebObjectsException | |
IllegalArgumentException | |
WebObjectsException |
To destroy crawl on project
WebObjectsException |
---|
To enable/disable project
WebObjectsException |
---|
Returns the WebServerDef
object corresponding to the Server Definition object
currently being used by the Intelligence Server. This object will already be populated
when it is returned.
WebServerDef
object which is being used by the server.WebObjectsException | Thrown if an error occurs. |
---|
Return all the available locales supported by the IServer
WebFolder
containing WebLocaleObjectInfo
objects representing all
available localesWebObjectsException | |
WebObjectsException |
Returns a populated WebFolder
which contains both the system styles and the user styles.
WebFolder
object which contains both the system styles and the user styles.WebObjectsException | Signals an error condition while attempting to obtain the folder XML. |
---|
WebObjectsException |
---|
Retrieves a list of the available db roles. One possible db role from this list should be
WebObjectInfo
objects; each representing a db roleWebObjectsException |
---|
Returns the current setting for the blockBegin parameter which is used upon retrieving folder definitions from the Intelligence Server. This parameter, along with blockCount, are used for incremental fetch. This will be propagated to all child objects.
Returns the current setting for the blockCount parameter which is used upon retrieving folder definitions from the Intelligence Server. This parameter, along with blockBegin, are used for incremental fetch. This will be propagated to all child objects.
Returns a list of DSNs configured on the I-Server machine.
WebDSN
WebObjectsException | |
WebObjectsException |
Obtain WebConnectionMapSource
object to find and create
WebConnectionMap
objects
WebConnectionMapSource
object associated with this WebObjectSource
objectThis method get an cube's security filter for certain 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.@return
userID | user id |
---|---|
cubeID | cube id |
WebObjectsException |
---|
This method get the 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. Currently,backend returns cube's security filters through checking userIds in cube's ACL when only provided cubeId.@return
cubeID | cube id |
---|
WebObjectsException |
---|
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.@return
userID | user id |
---|---|
cubeID | cube id |
WebObjectsException |
---|
Returns a WebEmailNotification
object, which can be used to send email notification
WebEmailNotification
object.
Returns the current setting of the flags which will determine what data will be obtained when retrieving object definitions from the Intelligence Server. This value will come from the bitwise or (|) of values from EnumDSSXMLObjectFlags.
Returns the folder ID of one of the special folders in metadata. The folder which will have information returned for it comes from EnumDSSXMLFolderNames.
folderName | A value from EnumDSSXMLFolderNames. |
---|
WebObjectsException | Thrown if an error occurs in obtaining the ID. |
---|
This method is used for getting the VLDB property inherited value of an instance. The internal logic can be seen in the doc "VLDB Overall design"
messageID | message id of report/document instance |
---|---|
objectType | object type, which can be found in EnumDSSXMLObjectTypes.java |
propertySetID | the id of VLDB property set, which is a GUID |
propertyIDs | the ids of VLDB properties that you want to get value |
WebObjectsException |
---|
Returns the current level parameter, which will be used when obtaining folder contents.
This method will return the WebMDXCubeSource
interface, which can be used to
initiate cube browsing and cube object browsing requests.
WebMDXCubeSource
.Returns the messageID for get object command.
Returns a WebChangeJournalSearch
object, which can be used to execute a change journal search.
WebChangeJournalSearch
object.
Returns a new object of the type and subtype passed. The object returned will have the name passed. Only monitor, search, ServerDef, and filter objects are supported.
objectType | the object type. |
---|---|
subType | the object sub type. |
name | the object name for the new object. |
Returns a new object of the type and subtype passed. Only monitor, search, ServerDef, and filter objects are supported.
objectType | object type. |
---|---|
subType | object subtype. |
Returns a new object of the type passed. The object returned will have the name passed. Only search, ServerDef, and filter objects are supported. New monitor objects can be obtained too, but they require a subType. Hence
use getNewObject(int, int)
or getNewObject(int, int, String)
for new new monitor objects.
objectType | the object type. |
---|---|
name | the object name for the new object. |
Returns a new object of the type passed. Only search, serverdef, user, and filter objects are supported. New monitor objects can be obtained too, but they require a subType. Hence
use getNewObject(int, int)
or getNewObject(int, int, String)
for new new monitor objects.
objectType | object type. |
---|
This manipulation returns the dependencies for the current object.
objectID | The unique id of the object. |
---|---|
objectType | The type of the object, from EnumDSSXMLObjectTypes . |
objectSubType | The type of the object, from EnumDSSXMLObjectSubTypes . |
WebObjectsException | |
IllegalArgumentException | |
WebObjectsException |
Returns a WebObjectInfo
object representing an object which resides in metadata.
This object will NOT be populated with the object's definition from the
Intelligence Server.
objectID | The DSS ID of the object. |
---|---|
objectType | The type of the object. This value comes from EnumDSSXMLObjectTypes . |
WebObjectInfo
object corresponding to the given DSS ID and type.WebObjectsException | Thrown if the object could not be created. |
---|---|
IllegalArgumentException | Thrown if the object ID is invalid. |
Returns a WebObjectInfo
object representing an object which resides in metadata.
This object may or may not be populated with information about this object from the
Intelligence Server, depending upon the populate parameter.
objectID | The DSS ID of the object. |
---|---|
objectType | The type of the object. This value comes from EnumDSSXMLObjectTypes . |
objectSubType | The subtype of the object. This value comes from EnumDSSXMLObjectTypes . |
populate | If this is true, then the WebObjectInfo object will populate itself with
the object's definition from the Intelligence Server. |
WebObjectInfo
object corresponding to the given DSS ID and type.WebObjectsException | Thrown if the object could not be created. |
---|---|
IllegalArgumentException | Thrown if the object ID is invalid. |
Returns a WebObjectInfo
object representing an object which resides in metadata.
This object may or may not be populated with information about this object from the
Intelligence Server, depending upon the populate parameter.
objectID | The DSS ID of the object. |
---|---|
objectType | The type of the object. This value comes from EnumDSSXMLObjectTypes . |
populate | If this is true, then the WebObjectInfo object will populate itself with
the object's definition from the Intelligence Server. |
WebObjectInfo
object corresponding to the given DSS ID and type.
the object definition of this object from the Intelligence Server. If this is false, then
the object will not be populated.WebObjectsException | Thrown if the object could not be created or populated. |
---|---|
IllegalArgumentException | Thrown if the object ID is invalid. |
Returns a WebObjectInfo
object representing an object which resides in metadata.
This object will NOT be populated with the object's definition from the
Intelligence Server.
objectID | The DSS ID of the object. |
---|---|
objectType | The type of the object. This value comes from EnumDSSXMLObjectTypes . |
objectSubType | The subtype of the object. This value comes from EnumDSSXMLObjectTypes . |
WebObjectInfo
object corresponding to the given DSS ID and type.WebObjectsException | Thrown if the object could not be created. |
---|---|
IllegalArgumentException | Thrown if the object ID is invalid. |
Returns a WebObjectInfo
object representing an object which resides in metadata by folderPath.
fullPath | The full path of the object. If the object is shortcut, it includes the target name of the shortcut. |
---|---|
objectType | The type of the object. This value comes from EnumDSSXMLObjectTypes . |
objectSubType | The subtype of the object. This value comes from EnumDSSXMLObjectSubTypes . |
WebObjectInfo
object corresponding to the given DSS ID and type.WebObjectsException | Thrown if the object could not be created. |
---|---|
IllegalArgumentException | Thrown if the object ID is invalid. |
Returns a WebObjectInfo
object representing an object which resides in metadata by folderPath.
fullPath | The full path of the object. If the object is shortcut, it includes the target name of the shortcut. |
---|---|
objectType | The type of the object. This value comes from EnumDSSXMLObjectTypes . |
WebObjectInfo
object corresponding to the given DSS ID and type.WebObjectsException | Thrown if the object could not be created. |
---|---|
IllegalArgumentException | Thrown if the object ID is invalid. |
This method will take the given object state and return the WebObjectInfo
object that the
state describes. This is used to restore the state of a WebObjectInfo
object.
state | The object state that describes the object. |
---|
WebObjectInfo
object corresponding to the given state.IllegalArgumentException | Thrown if the state passed is invalid. |
---|---|
WebObjectsException |
This method is used for getting the VLDB property inherited value of an object. The internal logic can be seen in the doc "VLDB Overall design"
objectID | object id |
---|---|
objectType | object type, which can be found in EnumDSSXMLObjectTypes.java |
propertySetID | the id of VLDB property set, which is a GUID |
propertyIDs | the ids of VLDB properties that you want to get value |
WebObjectsException |
---|
Get a parsed metric object with the specified metric ID. The metricID argument could be null when trying to create a new metric.
Retrieve the current property flags
EnumDSSXMLPropertyXmlFlags
Returns a WebPushNotification
object, which can be used to push mobile notification on a dossier.
WebPushNotification
object.
Returns a populated WebFolder
which contains the contents of the root folder.
WebFolder
object, corresponding to the root folder.WebObjectsException | Signals an error condition while attempting to obtain the folder XML. |
---|
To get the search engine properties
WebObjectsException |
---|
WebObjectsException |
---|
Retrieves the list of system functions based on the flags.
functionFlags | - values from EnumDSSXMLFunctionsFlags |
---|
WebObjectsException | thrown if there is any error. |
---|
Returns a populated WebFolder
which contains the system styles.
WebFolder
object which contains the system styles.WebObjectsException | Signals an error condition while attempting to obtain the folder XML. |
---|
WebObjectsException |
---|
WebObjectsException | |
WebObjectsException |
This method will return a WebFolder
containing the transformation roles that are available in the project.
Transformation roles are used in dealing with shortcut metrics.
WebFolder
object containing the transformation roles in the project.WebObjectsException | Thrown if an error occurs in obtaining transformation roles. |
---|
This method returns the WebUserServicesSource
interface, which contains
user-management related operations. The WebUserServicesSource
interface
exists primarily for organizational purposes.
WebUserServicesSource
interface.Returns a populated WebFolder
which contains the user styles.
WebFolder
object which contains the user styles.WebObjectsException | Signals an error condition while attempting to obtain the folder XML. |
---|
To get if change journal enabled if true, it is enabled, else disabled.
WebObjectsException |
---|
To check if search on project
WebObjectsException |
---|
To check if search engine has been started
WebObjectsException |
---|
This manipulation allows user to list any translations at any locales for any keys for multiple objects and their embedded objects.
objectInfo | only translations under this object will be listed. If this object is embedded, it should contains its containers imformation(container id and container type). |
---|---|
keyList | Translation will be in the result only if its key is in this array. If is empty, will have the effect of listing translations for all keys. |
localeIDList | Translation will be in the result only if its locale id is in this array. If is empty, will have the effect of listing translations at all locales. |
qualities | have the effect of filtering multilingual strings during iteration: |
WebObjectsException | |
IllegalArgumentException | |
WebObjectsException |
Move an existing object in the metadata.
objectID | The DSSID of the object to move. |
---|---|
objectType | The type of the object to move. |
newName | The name of the moved object. |
WebObjectsException | Thrown if an error occurs upon attempting to move the object |
---|
Creates an empty element collection associated with the specified attribute
attribute | attribute. |
---|
To pause crawl on project
WebObjectsException |
---|
WebObjectsException |
---|
To purge specific time stamp change journal
WebObjectsException |
---|
To resume crawl on project
WebObjectsException |
---|
Saves the object passed, to the new location (specified by folder) in metadata. If the object passed is
an already existing object in the metadata, this call will effectively move the object to the new location specified by folder.
For editable object, using this method will ensure that the changes done to the object after loading it from metadata will be saved back.
For non-editable objects, if its WebAccessControlList
has been changed, those changes will be saved.
If a non-existing editable object is passed (one created through getNewObject(int)
), this method will create a
new corresponding object in metadata at the location specified and return it.
objectToSave | the object to save. |
---|---|
folder | The target folder for saving the object. |
WebObjectsException | thrown if an error is encountered by IServer. |
---|
Saves the object passed, to metadata.
The object passed should be an already existing object in the metadata.
For editable object, using this method will ensure that the changes done to the object after loading it from metadata will be saved back.
For non-editable objects, if its WebAccessControlList
has been changed, those changes will be saved.
objectToSave | An object to save. |
---|
WebObjectsException | thrown if an error is encountered by IServer. |
---|
Saves the object passed, to the new location (specified by folder) in metadata. If the object passed is
an already existing object in the metadata, this call will effectively move the object to the new location specified by folder.
This method will rename the object passed in to the new name specified by the name.
For editable object, using this method will ensure that the changes done to the object after loading it from metadata will be saved back.
For non-editable objects, if its WebAccessControlList
has been changed, those changes will be saved.
If a non-existing editable object is passed (one created through getNewObject(int)
), this method will create a
new corresponding object in metadata at the location specified and return it.
objectToSave | the object to save. |
---|---|
name | Name to be set to the saved object. |
folder | The target folder for saving the object. |
WebObjectsException | thrown if an error is encountered by IServer. |
---|
Saves the object passed, to metadata. The object passed should be an already existing object in the metadata.
This method will rename the object passed in to the new name specified by the name.
For editable object, using this method will ensure that the changes done to the object after loading it from metadata will be saved back.
For non-editable objects, if its WebAccessControlList
has been changed, those changes will be saved.
objectToSave | An object to save. |
---|---|
name | New name for the object passed. |
WebObjectsException | thrown if an error is encountered by IServer. |
---|
WebObjectsException |
---|
Bulk Save the object to metadata.
The object passed should be an already existing object in the metadata.
For editable object, using this method will ensure that the changes done to the object after loading it from metadata will be saved back.
For non-editable objects, if its WebAccessControlList
has been changed, those changes will be saved.
WebObjectsException | thrown if an error is encountered by IServer. |
---|
WebObjectsException |
---|
Sets the blockBegin parameter which is used upon retrieving folder definitions from the Intelligence Server. This parameter, along with blockCount, are used for incremental fetch. This will be propagated to all child objects.
blockBegin | The new blockBegin setting to use for folder retrieval. |
---|
Sets the blockCount parameter which is used upon retrieving folder definitions from the Intelligence Server. This parameter, along with blockBegin, are used for incremental fetch. This will be propagated to all child objects.
blockCount | The new blockCount setting to use for folder retrieval. |
---|
To set change journal to enabled/disabled
WebObjectsException |
---|
Sets the current setting of the flags which will determine what data will be obtained when retrieving object definitions from the Intelligence Server. This value should come from the bitwise or (|) of values from EnumDSSXMLObjectFlags.
flags | The current object flag value. |
---|
Sets the current level parameter, which will be used when obtaining folder contents.
level | The new level setting. |
---|
Set the messageID for get object command.
_messageID | the messageID for get object command |
---|
Set the current property flags
flags | int binary OR of EnumDSSXMLPropertyXmlFlags
|
---|
To start crawl on project
WebObjectsException |
---|
To start incremental crawl on project
WebObjectsException |
---|
To stop incremental crawl on project
WebObjectsException |
---|
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.@return
cubeID | cube id |
---|---|
cubeSecurityFilters | userId map to cube security filter expression |
WebObjectsException |
---|
This manipulation allows user to add, update one translation at any locale for one unembedded object.
objectID | object id |
---|---|
objectType | object type |
key | translation key |
localeID | locale id |
name | translation name |
WebObjectsException | |
IllegalArgumentException | |
WebObjectsException |
This manipulation allows user to add, update, and delete any translations at any locale for one object.
objectInfo | object |
---|
WebObjectsException | |
IllegalArgumentException | |
WebObjectsException |
This method will ensure that the given object name is a valid name for a first class object. If it is not a valid name, an exception will be thrown.
name | The name to check for validity. |
---|
WebObjectsException | Thrown if the name is not valid. |
---|