Share via

3.1.4.11 OpenSession

  • Article

This operation creates a new session.

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

 <wsdl:operation name="OpenSession" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
   <wsdl:input wsaw:Action="http://schemas.microsoft.com/office/Access/2010/11/Server/WebServices/AccessServerInternalService/IAccessServiceSoap/OpenSession" message="tns2:IAccessServiceSoap_OpenSession_InputMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:output wsaw:Action="http://schemas.microsoft.com/office/Access/2010/11/Server/WebServices/AccessServerInternalService/IAccessServiceSoap/OpenSessionResponse" message="tns2:IAccessServiceSoap_OpenSession_OutputMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://schemas.microsoft.com/office/Access/2010/11/Server/WebServices/AccessServerInternalService/IAccessServiceSoap/OpenSessionAccessServerMessageFault" name="AccessServerMessageFault" message="tns2:IAccessServiceSoap_OpenSession_AccessServerMessageFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
 </wsdl:operation>

The protocol client sends an IAccessServiceSoap_OpenSession_InputMessage (section 3.1.4.11.1.1) request message and the protocol server responds with an IAccessServiceSoap_OpenSession_OutputMessage (section 3.1.4.11.1.2) response message as follows:

  • If the operation succeeds, the protocol server MUST return the SessionIdentifier (section 3.1.1.2) for the newly created session in the response message to be used in any future operations against the newly created session. This SessionIdentifier MUST be returned in the sessionId element of the OpenSessionResponse element (section 3.1.4.11.2.2).

  • If an error occurs on the protocol server during this operation, the protocol server MUST respond with a SOAP fault, as specified in section 2.2.9.