Request
|
Uses the
saveUserSettingsRequest
element (from the
UserSettingsService schema)
|
Parameter notes
|
- storageKey: Any arbitrary value. Can also be a resource identifier if storage is resource-specific. But it can be any value identifying the data the application needs to persist on the server.
If the
restrictUserSettings property in the
de.properties file is set to false, there are no restrictions on what you can pass in the
storageKey attribute.
However, if the
restrictUserSettings property in the
de.properties file is set to true (the default), and you are passing a GUID in the
storageKey attribute, it
must be the GUID of the calling user. This prevents the user from saving user settings for other users.
For additional information about the
restrictUserSettings property, see "Configuration of the TIBCO ActiveMatrix BPM Directory Engine" in the
TIBCO ActiveMatrix BPM Administration guide.
Note: A System Administrator (that is, a user holding the "All System Actions" privilege) can save the user settings for any user, even if the
restrictUserSettings property is set to true.
- settingId: Any arbitrary value (with one exception—see below). Identifies the specific setting stored that relates to the value passed in
storageKey. For each storageKey, there can be many settingIds. Note that the TIBCO Workspace application reserves settingIds that begin with "workspace".
- settingProperties.Name: Identifies the value stored.
- settingProperties.Value: The value being stored on the server for later retrieval.
|
Response
|
Returns a
saveUserSettingsResponse
element (from the
UserSettingsService schema)
|
Example
|
Request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:user="http://usersettingsservice.api.de.n2.tibco.com">
<soapenv:Header/>
<soapenv:Body>
<user:saveUserSettingsRequest>
<settings storageKey="configStore" settingId="viewSettings">
<settingProperties Name="listSize" Value="20" xmlns=""/>
<settingProperties Name="caption" Value="Description" xmlns=""/>
<settingProperties Name="winSize" Value="600,400" xmlns=""/>
<settingProperties Name="layout" Value="tabbed" xmlns=""/>
</settings>
</user:saveUserSettingsRequest>
</soapenv:Body>
</soapenv:Envelope>
|
Response:
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<saveUserSettingsResponse xmlns="http://usersettingsservice.api.de.n2.tibco.com">
<empty xmlns="">0</empty>
</saveUserSettingsResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
|