Elemento ProtocolCapabilities (XMLA)

Utiliza el encabezado SOAP en un mensaje de solicitud SOAP para identificar las capacidades de protocolo entre una instancia de MicrosoftSQL ServerAnalysis Services y una aplicación cliente.

Espacio de nombres https://schemas.microsoft.com/analysisservices/2003/engine

Sintaxis

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

Características del elemento

Característica	Descripción
Tipo y longitud de los datos	Ninguno
Valor predeterminado	Ninguno
Cardinalidad	0-1: Elemento opcional que puede aparecer una y sólo una vez.

Relaciones del elemento

Relación	Elemento
Elementos primarios	Ninguno
Elementos secundarios	Capability

Notas

El elemento ProtocolCapabilities permite a las aplicaciones cliente negociar las capacidades de protocolo, como XML binario o compatibilidad de compresión, con una instancia Analysis Services en cualquier momento. La negociación de protocolo conlleva los pasos siguientes:

1. La aplicación cliente identifica su capacidad de protocolo enviando una solicitud SOAP que incluye el elemento ProtocolCapabilities como parte del encabezado SOAP.

2. La instancia de Analysis Services recibe y procesa la solicitud SOAP.

3. Si la instancia de Analysis Services tiene la misma capacidad de protocolo que la solicitada, la instancia envía una respuesta SOAP que incluye el mismo elemento ProtocolCapabilities enviado en la solicitud SOAP y el protocolo se negocia correctamente. En caso contrario, las capacidades de protocolo no se negocian correctamente y la instancia devuelve un error de SOAP.

Después de negociar correctamente las capacidades de protocolo, el tiempo que las aplicaciones cliente y la instancia de Analysis Services utilicen un protocolo determinado depende de si la sesión es explícita o implícita:

• Una sesión explícita se crea utilizando el elemento de encabezado BeginSession. Para una sesión explícita, el protocolo negociado se utiliza bien hasta que la aplicación cliente envía un nuevo elemento ProtocolCapabilities o bien hasta que la sesión termina.

• Una sesión implícita la crea una instancia de Analysis Services y no es especificada explícitamente por la aplicación cliente al enviar una solicitud SOAP. Para una sesión implícita, el protocolo negociado se utiliza sólo hasta que se completa la solicitud SOAP.

Las capacidades de protocolo no tienen que ser negociadas explícitamente. Es decir, una aplicación cliente no tiene que incluir un elemento ProtocolCapabilities como parte de la solicitud SOAP. Si una solicitud SOAP no incluye un elemento ProtocolCapabilities, la instancia Analysis Services responde utilizando el mismo formato que la solicitud SOAP.

Vea también

Conceptos

Administrar conexiones y sesiones (XMLA)

Otros recursos

Encabezados [XMLA]