Elemento ProtocolCapabilities (XMLA)

Usa o cabeçalho SOAP em uma mensagem de solicitação SOAP para identificar os recursos de protocolo entre uma instância do Analysis Services e um aplicativo cliente.

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>  

Características do elemento

Característica	Descrição
Comprimento e tipo de dados	Nenhum
Valor padrão	Nenhum
Cardinalidade	0-1: elemento opcional que pode ocorrer apenas uma única vez.

Relações de elementos

Relação	Elemento
Elementos pai	Nenhum
Elementos filho	Recurso

Comentários

O elemento ProtocolCapabilities permite que aplicativos cliente negociem recursos de protocolo, como suporte a compactação ou XML binário, com uma instância de servidor a qualquer momento. A negociação dos recursos de protocolo envolve as seguintes etapas:

1. O aplicativo cliente identifica seu recurso de protocolo enviando uma solicitação SOAP que inclua o elemento ProtocolCapabilities como parte do cabeçalho SOAP.

2. A instância recebe e processa a solicitação SOAP.

3. Se a instância tiver a mesma funcionalidade de protocolo que a solicitada, a instância enviará uma resposta SOAP que inclui o mesmo elemento ProtocolCapabilities enviado na solicitação SOAP e o protocolo foi negociado com êxito. Caso contrário, os recursos de protocolo não serão negociadas com êxito e a instância retornará uma falha SOAP.

Depois de negociar os recursos de protocolo com êxito, o tempo que o aplicativo cliente e a instância usam um protocolo específico depende se a sessão é explícita ou implícita:

• Uma sessão explícita é aquela que foi criada usando o elemento de cabeçalho BeginSession . Em uma sessão explícita, o protocolo negociado é usado até que o aplicativo cliente envie um novo elemento ProtocolCapabilities ou até o término da sessão.

• Uma sessão implícita é aquela que é criada por uma instância do e não explicitamente especificada pelo aplicativo cliente ao enviar uma solicitação SOAP. Em uma sessão implícita, o protocolo negociado só é usado até que a solicitação SOAP seja concluída.

Os recursos de protocolo não precisam ser negociados explicitamente. Ou seja, um aplicativo cliente não precisa incluir um elemento ProtocolCapabilities como parte da solicitação SOAP. Se uma solicitação SOAP não incluir um elemento ProtocolCapabilities , a instância responderá usando o mesmo formato que a solicitação SOAP.