다음을 통해 공유

ProtocolCapabilities 요소(XMLA)

  • 아티클

SOAP 요청 메시지의 SOAP 헤더를 사용하여 Analysis Services 인스턴스와 클라이언트 애플리케이션 간의 프로토콜 기능을 식별합니다.

네임 스페이스http://schemas.microsoft.com/analysisservices/2003/engine

구문

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

요소 특성

특성 Description
데이터 형식 및 길이 None
기본값 None
카디널리티 0-1: 한 번만 나타날 수 있는 선택적 요소입니다.

요소 관계

관계 요소
부모 요소 None
자식 요소 기능

설명

ProtocolCapabilities 요소를 사용하면 클라이언트 애플리케이션이 언제든지 서버 인스턴스와 이진 XML 또는 압축 지원과 같은 프로토콜 기능을 협상할 수 있습니다. 프로토콜 협상에는 다음과 같은 단계가 포함됩니다.

  1. 클라이언트 애플리케이션이 SOAP 헤더의 일부로 ProtocolCapabilities 요소를 포함하는 SOAP 요청을 전송하여 해당 프로토콜 기능을 식별합니다.

  2. 인스턴스는 SOAP 요청을 수신하고 처리합니다.

  3. 인스턴스에 요청된 것과 동일한 프로토콜 기능이 있는 경우 인스턴스는 SOAP 요청에 전송된 동일한 ProtocolCapabilities 요소를 포함하는 SOAP 응답을 보내고 프로토콜이 성공적으로 협상되었습니다. 그렇지 않으면 프로토콜이 성공적으로 협상되지 않으며 인스턴스가 SOAP 오류를 반환합니다.

프로토콜 기능을 성공적으로 협상한 후 클라이언트 애플리케이션과 인스턴스가 특정 프로토콜을 사용하는 기간은 세션이 명시적 또는 암시적인지 여부에 따라 달라집니다.

  • 명시적 세션은 BeginSession 헤더 요소에서 만드는 세션입니다. 명시적 세션의 경우 협상된 프로토콜은 클라이언트 애플리케이션에서 새로운 ProtocolCapabilities 요소를 보내거나 세션이 종료될 때까지 사용됩니다.

  • 암시적 세션은 인스턴스에서 만들어지고 SOAP 요청을 제출할 때 클라이언트 애플리케이션에서 명시적으로 지정하지 않은 세션입니다. 암시적 세션의 경우 협상된 프로토콜은 SOAP 요청이 완료될 때까지만 사용됩니다.

프로토콜 기능은 명시적으로 협상될 필요가 없습니다. 즉 클라이언트 애플리케이션은 SOAP 요청의 일부로 ProtocolCapabilities 요소를 포함하지 않아도 됩니다. SOAP 요청에 ProtocolCapabilities 요소가 포함되지 않은 경우 인스턴스는 SOAP 요청과 동일한 형식으로 응답합니다.