Freigeben über


ProtocolCapabilities-Element (XMLA)

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

Namespace https://schemas.microsoft.com/analysisservices/2003/engine

Syntax

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

Elementmerkmale

Merkmal

Beschreibung

Datentyp und -länge

Keiner

Standardwert

Keiner

Kardinalität

0-1: Optionales Element, das nur einmal auftreten kann.

Elementbeziehungen

Beziehung

Element

Übergeordnete Elemente

Keine

Untergeordnete Elemente

Capability

Hinweise

Das ProtocolCapabilities-Element ermöglicht es Clientanwendungen, Protokollfunktionen auszuhandeln, z. B. Support für binäres XML und Komprimierung, mit jeweils einer Analysis Services-Instanz. Die Protokollaushandlung schließt die folgenden Schritte ein:

  1. Die Clientanwendung identifiziert die Protokollfunktion, indem sie eine SOAP-Anforderung sendet, die sowohl das ProtocolCapabilities-Element als auch den SOAP-Header enthält.

  2. Die Analysis Services-Instanz empfängt und verarbeitet die SOAP-Anforderung.

  3. Wenn die Analysis Services-Instanz über die gleiche Protokollfunktion wie die angeforderte verfügt, sendet die Instanz eine SOAP-Antwort, zu der das gleiche ProtocolCapabilities-Element gehört, das in der SOAP-Anforderung gesendet wurde; außerdem wurde das Protokoll erfolgreich ausgehandelt. Andernfalls werden die Protokollfunktionen nicht erfolgreich ausgehandelt, und die Instanz gibt einen SOAP-Fehler zurück.

Nach der erfolgreichen Aushandlung der Protokollfunktionen hängt die Dauer der Verwendung eines bestimmten Protokolls durch die Clientanwendung und die Analysis Services-Instanz davon ab, ob die Sitzung implizit oder explizit 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 ist eine Sitzung, die über eine Analysis Services-Instanz erstellt wird und nicht beim Übermitteln einer SOAP-Anforderung explizit von der Clientanwendung angegeben wird. 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 Analysis Services-Instanz unter Verwendung des gleichen Formats wie die SOAP-Anforderung.

Siehe auch

Konzepte

Andere Ressourcen