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 Analysis Services and a client application.

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

<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

Description

Typ danych i długość

None

Wartość domyślna

None

Relacja

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

Relacje elementu

Relacja

Element

Elementy nadrzędne

None

Elementy podrzędność

Funkcja

Remarks

The ProtocolCapabilities element enables klient applications to negotiate protokół capabilities, such as binary XML or compression support, with an Analysis Services wystąpienie at any czas. Negocjacja protokół obejmuje następujące kroki:

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

  2. The Analysis Services wystąpienie receives and processes the SOAP request.

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

Po pomyślnie negocjowania protokół możliwości, jak długo aplikacja klient oraz Analysis Services użycie wystąpienie określonego protokół zależy od tego, czy sesja jest jawny lub niejawny:

  • Do jawnego sesja jest taka, która jest tworzona za pomocą BeginSession element nagłówka.Dla sesja jawnych negocjowany protokół jest używany, dopóki aplikacja kliencka wysyła nową ProtocolCapabilities Kończy sesja lub elementu.

  • Do sesja niejawne jest taki, który jest tworzony przez Analysis Services wystąpienie i nie zostało określone przez aplikację klient, podczas przesyłania żądań protokołu SOAP. Dla sesja niejawne negocjowany protokół jest używany tylko do momentu zakończenia żądania protokołu SOAP.

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