2.2.4.20 CommandParameter

  • Article

Namespace: http://schemas.microsoft.com/office/Excel/Server/WebServices/ExcelServerInternalService/

The CommandParameter complex type is an input used by some protocol server operations.

 <xs:complexType name="CommandParameter" xmlns:xs="http://www.w3.org/2001/XMLSchema">
   <xs:sequence>
     <xs:element minOccurs="0" maxOccurs="1" name="ClientUdfListInfo" type="tns:ClientUdfListInfo"/>
     <xs:element minOccurs="0" maxOccurs="1" name="WorkbookId" type="xs:string"/>
     <xs:element minOccurs="1" maxOccurs="1" name="StateId" type="xs:int"/>
     <xs:element minOccurs="0" maxOccurs="1" name="VisibleSheetRangeRequest" type="tns:VisibleSheetRange"/>
     <xs:element minOccurs="0" maxOccurs="1" name="WorkOnBehalfRequest" type="tns:WorkOnBehalf"/>
     <xs:element minOccurs="1" maxOccurs="1" name="Confirmation" type="tns:ExcelServerMessageId"/>
     <xs:element minOccurs="0" maxOccurs="1" name="ProtocolClientId" type="xs:string"/>
     <xs:element minOccurs="0" maxOccurs="1" name="Zone" type="xs:string"/>
     <xs:element minOccurs="0" maxOccurs="1" name="PreviousOwnerId" type="xs:string"/>
     <xs:element xmlns:q3="http://microsoft.com/wsdl/types/" minOccurs="1" maxOccurs="1" name="RequestSiteId" type="q3:guid"/>
     <xs:element minOccurs="0" maxOccurs="1" name="RequestId" type="xs:string"/>
     <xs:element minOccurs="1" maxOccurs="1" name="CompleteResponseTimeout" type="xs:int"/>
     <xs:element minOccurs="1" maxOccurs="1" name="Flags" type="tns:CommandParameterFlags"/>
     <xs:element minOccurs="0" maxOccurs="1" name="RequestLimits" type="tns:RequestLimits"/>
     <xs:element minOccurs="0" maxOccurs="1" name="DebugInfo" type="xs:string"/>
     <xs:element minOccurs="0" maxOccurs="1" name="CollaborationParameter" type="tns:CollaborationParameter"/>
     <xs:element minOccurs="0" maxOccurs="1" name="WorkbookMetadataParameter" type="tns:WorkbookMetadataParameter"/>
     <xs:element minOccurs="0" maxOccurs="1" name="FrontEndMachineName" type="xs:string"/>
   </xs:sequence>
 </xs:complexType>

ClientUdfListInfo: A list of client side UDFs that the protocol client knows how to execute. When this element is present, the protocol server will start using the content as the list of client side UDFs.

WorkbookId: The session identifier that is returned in the workbookId as specified in OpenWorkbookResponse (section 3.1.4.30.2.2). See section 2.2.5.33. If present, it MUST NOT be empty. For all operations other than OpenWorkbook (section 3.1.4.30), MUST have a value which has been obtained from a previous call to OpenWorkbook. For the OpenWorkbook, the following apply:

  • If a session identifier has already been returned by the protocol server for a previous OpenWorkbook, WorkbookId MUST have that value.

  • If this operation is used to create a new session (2) on the protocol server then MUST NOT be present.

StateId: The state identifier as specified in Section 3.1.1. MUST be incremented by the protocol server on every operation that changes the state of the session.

VisibleSheetRangeRequest: The requested range that will be returned by the protocol server in SpreadsheetData, as specified in section 2.2.4.21. See section 2.2.4.44.

WorkOnBehalfRequest: MUST NOT be present.

Confirmation: The external data refresh confirmation. MUST be either "ConfirmDataRefresh" or "Blank". MUST be ConfirmDataRefresh, with the ConfirmationChoiceTrue value of Flags set to allow external data refresh for the lifetime of the session, or with ConfirmationChoiceTrue value of Flags not set to prevent external data refresh for the current operation. Otherwise, the protocol server MUST ignore the ConfirmationChoiceTrue value of Flags.

ProtocolClientId: The protocol server MUST ignore the value unless specified otherwise. The protocol client MAY pass any value.

Zone: The URL zone of the site collection. MUST be present. MUST be set to either one of the following values: "Internet", "Intranet", "Extranet", "Default", or "Custom".

PreviousOwnerId: The instance identifier of a protocol server as specified in section 3.1.1. If the current request is not OpenWorkbook, then MUST NOT be present. Otherwise, if the last response from a protocol server has returned a soap fault, as specified in section 2.2.2, with the WrongEcs value in the Id element of the returned ExcelServerMessage, then the protocol client MUST send a PreviousOwnerId with the value of the WrongEcsServerId element from that ExcelServerMessage.

RequestSiteId: The site identifier. MUST be present.

RequestId: An identifier of an ongoing asynchronous request on the protocol server, as specified in section 3.1.1. If the last response on the same session from the protocol server has returned a CommandResult which contained a non-empty value for the RequestId element, then it MUST contain the same value. Otherwise, MUST NOT be present.

CompleteResponseTimeout: The estimated timeout, in milliseconds, after which the protocol server returns a response in cases where the operation has not yet finished, as specified in section 3.1.1.

Flags: Control flags as specified in section 2.2.5.5.

RequestLimits: Request limits as specified in section 2.2.4.32.

DebugInfo: An opaque string sent to the protocol server – it does not affect the operation.

CollaborationParameter: End user presence information as specified in section 2.2.4.17. MUST NOT be present if the associated session (2) is not an edit session. The UserListVersion element of CollaborationState will contain the last non-empty CollaborationState value received in a response on the same session from the protocol server.

WorkbookMetadataParameter: A WorkbookMetadataItem that represents the workbook metadata state known by the protocol client.

FrontEndMachineName: The protocol client machine name.