Share via

2.2.2.1 BeginSession

  • Article

A client MUST attach a <BeginSession> header to a DSML SOAP message that contains a <dsml:batchRequest> payload in order to instruct the server to initiate a new session and to process the <dsml:batchRequest> payload in the context of that session.

The client specifies the <BeginSession> header as follows:

  • The "urn:schema-microsoft-com:activedirectory:dsmlv2" XML namespace MUST be specified.<2>

  • The soap:mustUnderstand attribute MUST be set to 1.

The following XML shows a <BeginSession> header and a <dsml:batchRequest> payload in a SOAP message.

[SOAP]

 <soap:Envelope>
   <soap:Header>
     <BeginSession xmlns="urn:schema-microsoft-com:activedirectory:dsmlv2"
       soap:mustUnderstand="1" />
   </soap:Header>
   <soap:Body>
     <dsml:batchRequest>
       DSML payload
     </dsml:batchRequest>
   </soap:Body>
 </soap:Envelope>