ProtocolCapabilities-Element (XMLA)

Artikel
05/08/2023

Verwendet den SOAP-Header in einer SOAP-Anforderungsnachricht, um Protokollfunktionen zwischen einer Instanz von Analysis Services und einer Clientanwendung zu identifizieren.

Namespacehttp://schemas.microsoft.com/analysisservices/2003/engine

Syntax

  
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">  
   <soap:Header>  
      ...  
      <ProtocolCapabilities xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">  
         <Capability>...</Capability>  
      </ProtocolCapabilities>  
      ...  
   </soap:Header>  
   <soap:Body>  
      ...  
   </soap:Body>  
</soap:Envelope>

Elementmerkmale

Merkmal	BESCHREIBUNG
Datentyp und -länge	Keine
Standardwert	Keine
Kardinalität	0-1: Optionales Element, das nur einmal auftreten kann.

Elementbeziehungen

Beziehung	Element
Übergeordnete Elemente	Keine
Untergeordnete Elemente	Funktion

Hinweise

Mit dem ProtocolCapabilities-Element können Clientanwendungen jederzeit Protokollfunktionen wie binäre XML- oder Komprimierungsunterstützung mit einer Serverinstanz aushandeln. Die Protokollaushandlung schließt die folgenden Schritte ein:

Die Clientanwendung identifiziert die Protokollfunktion, indem sie eine SOAP-Anforderung sendet, die sowohl das ProtocolCapabilities -Element als auch den SOAP-Header enthält.
Die -Instanz empfängt und verarbeitet die SOAP-Anforderung.
Wenn die Instanz über die gleiche Protokollfunktion wie die angeforderte verfügt, sendet die Instanz eine SOAP-Antwort, die das gleiche ProtocolCapabilities-Element enthält, das in der SOAP-Anforderung gesendet wurde, und das Protokoll wurde erfolgreich ausgehandelt. Andernfalls werden die Protokollfunktionen nicht erfolgreich ausgehandelt, und die Instanz gibt einen SOAP-Fehler zurück.

Nach dem erfolgreichen Aushandeln von Protokollfunktionen hängt die Dauer der Verwendung eines bestimmten Protokolls durch die Clientanwendung und die Instanz davon ab, ob die Sitzung explizit oder implizit ist:

Eine explizite Sitzung ist eine Sitzung, die über das BeginSession -Headerelement erstellt wird. Bei einer expliziten Sitzung wird das verhandelte Protokoll so lange verwendet, bis die Clientanwendung ein neues ProtocolCapabilities -Element sendet oder bis die Sitzung endet.
Eine implizite Sitzung wird von einer -Instanz erstellt und nicht explizit von der Clientanwendung beim Übermitteln einer SOAP-Anforderung angegeben. Bei einer impliziten Sitzung wird das ausgehandelte Protokoll nur so lange verwendet, bis die SOAP-Anforderung abgeschlossen ist.

Protokollfunktionen müssen nicht explizit ausgehandelt werden. Das heißt, dass eine Clientanwendung kein ProtocolCapabilities -Element als Teil der SOAP-Anforderung enthalten muss. Wenn eine SOAP-Anforderung kein ProtocolCapabilities-Element enthält, antwortet die Instanz im gleichen Format wie die SOAP-Anforderung.

Freigeben über