SOAP API - saveUserSettings

The table summarizes the SOAP API - saveUserSettings.

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>