Udostępnij za pośrednictwem

  • Artykuł

Element ProtocolCapabilities (XMLA)

Uses the SOAP header in a SOAP request message to identify protocol capabilities between an instance of Microsoft SQL Server Usługi Analysis Services and a client application.

Obszar nazw https://schemas.microsoft.com/analysisservices/2003/engine

Składnia

<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>

Właściwości elementu

Charakterystyka

Opis

Typ danych i długości

Brak

Wartość domyślna

Brak

Kardynalność

0-1: Opcjonalnego elementu, który może występować tylko raz i tylko raz.

Relacje elementu

Relacja

Element

Elementy nadrzędne

Brak

Elementy podrzędne

Możliwości

Uwagi

ProtocolCapabilities Element umożliwia aplikacjom klient do negocjowania protokół możliwości, takich jak XML binarny lub obsługi kompresji z Usługi Analysis Services instancji w dowolnym czas.Negocjacja protokołu obejmuje następujące etapy:

  1. klient Aplikacji identyfikuje zdolność protokół, wysyłając żądanie protokół SOAP zawiera ProtocolCapabilities element jako część nagłówek protokół SOAP.

  2. Usługi Analysis Services Wystąpienie odbiera i przetwarza żądanie protokołu SOAP.

  3. Jeśli Usługi Analysis Services wystąpienie ma te same możliwości protokół jako żądany, wystąpienie wysyła odpowiedź protokół SOAP, która zawiera takie same ProtocolCapabilities elementów wysłanych w żądaniu protokół SOAP i protokół została wynegocjowana.W przeciwnym razie funkcje protokół nie są pomyślnie wynegocjowane i wystąpienie zwraca błąd protokół SOAP.

Po pomyślnym negocjowania protokół możliwości, jak długo aplikacja klient i Usługi Analysis Services użycie wystąpienie konkretnego protokół zależy od tego, czy sesja jest jawny lub niejawny:

  • Jawne sesja jest utworzony za pomocą BeginSession element nagłówka.Jawne sesja, negocjowany protokół jest używany, dopóki aplikacja klient wysyła nowe ProtocolCapabilities element lub zakończenia sesja.

  • Niejawna sesja jest utworzony przez Usługi Analysis Services wystąpienie i nie są wyraźnie określone przez aplikację klient podczas przesyłania żądania protokołu SOAP.Niejawna sesja negocjowany protokół jest używany tylko zakończenia żądania protokołu SOAP.

Funkcje protokołu nie trzeba jawnie negocjowane.Oznacza to, że aplikacja klient musi zawierać ProtocolCapabilities element jako część żądania protokołu SOAP.Jeśli żądanie protokołu SOAP nie zawiera ProtocolCapabilities element, Usługi Analysis Services wystąpienie odpowiada za pomocą tego samego formatu jak żądanie protokołu SOAP.