Export (0) Print
Expand All

3 Protocol Details

SharePoint

In the following sections, the schema definition might differ from the processing rules imposed by the protocol. The WSDL in this specification matches the WSDL that shipped with the product and provides a base description of the schema. The text that introduces the WSDL might specify differences that reflect actual Microsoft product behavior. For example, the schema definition might allow for an element to be empty, null, or not present but the behavior of the protocol as specified restricts the same elements to being non-empty, not null, and present.

The client side of this protocol is simply a pass-through. That is, no additional timers or other state is required on the client side of this protocol. Calls made by the higher-layer protocol or application are passed directly to the transport, and the results returned by the transport are passed directly back to the higher-layer protocol or application.

Except where specified, protocol clients SHOULD interpret HTTP status codes returned by the protocol server as specified in [RFC2616], section 10.

This protocol allows protocol servers to perform implementation-specific authorization checks and notify protocol clients of authorization faults as specified previously in this section.

This protocol allows protocol servers to perform implementation-specific localization of text in various messages. Except where specified, the localization of this text is an implementation-specific behavior of the protocol server and not significant for interoperability.

The following high-level sequence diagram illustrates the operation of the protocol.

Dd932719.5be9fcd9-b445-49c8-83e7-b026d1cfa157(en-us,office.12).jpg

Figure 2: Excel Calculation Web Service Protocol high-level sequence diagram

Session Behavior

View Sessions

A view session is created on a successful OpenWorkbook request, as specified in OpenWorkbook (section 3.1.4.30). A view session stops responding to operations after a successful call to the CloseWorkbook operation or after the view session has timed out.

NewWorkbook Sessions

A new workbook session is created on a successful OpenWorkbook request, as specified in OpenWorkbook. A new workbook session stops responding to operations after a successful call to the CloseWorkbook operation or after the new workbook session has timed out.

Edit Sessions

An edit session is created on a successful OpenWorkbook request, unless one already exists for the same workbook, as specified by the url element in OpenWorkbook. A new participant is added to the edit session on a successful OpenWorkbook request.

The current participant is removed from the edit session on a successful call to CloseWorkbook. An edit session stops responding to operations when all of its participants have been removed.

Request Behavior

A request is created when a Web service operation starts running on the protocol server, and ends when the Web service operation finishes, when it is successfully cancelled by a CancelRequest call, or after the request has timed out.

Show:
© 2015 Microsoft