3.1.4.73 DdaSaveSettings

  • Article

Replaces all existing settings on the Office Web Extension with the given settings.

The following is the WSDL port type specification of the DdaSaveSettings WSDL operation.

 <wsdl:operation name="DdaSaveSettings" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
   <wsdl:input wsaw:Action="http://schemas.microsoft.com/office/Excel/Server/WebServices/ExcelServerInternalService/ExcelServiceSoap/DdaSaveSettings" message="tns:ExcelServiceSoap_DdaSaveSettings_InputMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:output wsaw:Action="http://schemas.microsoft.com/office/Excel/Server/WebServices/ExcelServerInternalService/ExcelServiceSoap/DdaSaveSettingsResponse" message="tns:ExcelServiceSoap_DdaSaveSettings_OutputMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://schemas.microsoft.com/office/Excel/Server/WebServices/ExcelServerInternalService/ExcelServiceSoap/DdaSaveSettingsExcelServerMessageFault" name="ExcelServerMessageFault" message="tns:ExcelServiceSoap_DdaSaveSettings_ExcelServerMessageFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
 </wsdl:operation>

The protocol client sends an ExcelServiceSoap_DdaSaveSettings_InputMessage request message, and the protocol server responds with an ExcelServiceSoap_DdaSaveSettings_OutputMessage response message, as follows:

  1. The protocol client sends information identifying the Office Web Extension and a list of settings to associate with the extension.

  2. If overwriteIfStale is false, the protocol server compares the client version number with the server version number and MUST fail if they are not equal. If true, the protocol server replaces the list of settings with the given list and increments the settings version number.

This operation is a state changing operation on the protocol server.

In the event of an application error on the protocol server during this operation, a SOAP fault is returned, as specified in section 2.2.2. The Id element of the ExcelServerMessage SHOULD<89> be one of the values specified in section 2.2.2.1 or any of the following values:

  • DdaStaleSettings