The Role of SOAP in Reporting ServicesThe Role of SOAP in Reporting Services

웹 서버 웹 서비스에서는 SOAP(Simple Object Access Protocol) 메시징을 사용하여 네트워크를 통해 텍스트 기반 명령을 보냅니다.The Report Server Web service uses Simple Object Access Protocol (SOAP) messaging to send text-based commands over a network. 이러한 명령은 HTTP를 사용하여 World Wide Web을 통해 전송되는 XML 텍스트 형식입니다.These commands take the form of XML text that is sent over the World Wide Web using HTTP. SOAP을 통신 프로토콜로 사용하면 보고서 서버 웹 서비스에서는 폭넓게 활용되는 개방형 인프라를 사용하여 응용 프로그램 및 구성 요소와 보고서 서버 간에 데이터 교환이 가능합니다.By using SOAP as its communication protocol, the Report Server Web service allows applications and components to exchange data with the report server using an open and widely accepted infrastructure. SOAP 표준은 www.w3.org/TR/SOAP에 정의되어 있습니다.The SOAP standard is defined at www.w3.org/TR/SOAP.

SOAP을 인식하고 SOAP 요청을 보낼 수 있으면 모든 클라이언트 응용 프로그램이 SOAP 클라이언트가 될 수 있습니다.Any client application can act as a SOAP client as long as it is SOAP-aware and can send SOAP requests. 보고서 관리자는 이러한 SOAP 클라이언트 중 하나이며Report Manager is one such SOAP client. 모든 보고서 및 보고서 관련 내용이 저장되는 보고서 서버 데이터베이스에 대한 인터페이스를 제공합니다.It provides an interface to the report server database in which all reports and report-related content is stored. 최종 사용자는 이 응용 프로그램을 사용하여 보고서 서버 네임스페이스에서 보고서 및 폴더를 탐색하고 관리할 수 있습니다.End users can use the application to browse through and manage reports and folders in the report server namespace. 보고서 관리자는 보고서 서버 웹 서비스 인프라를 기반으로 합니다.Report Manager is built on the Report Server Web service infrastructure.

보고서 서버는 SOAP 서버의 역할을 하며, SOAP 클라이언트로부터 요청을 수신하고 적절한 응답을 만들 수 있는 SOAP 인식 서비스입니다.A report server acts as a SOAP server, a SOAP-aware service that can accept requests from SOAP clients and create appropriate responses. 서버에서는 요청을 처리하고 인코딩된 응답을 다시 클라이언트로 보냅니다.The server handles the requests and sends encoded responses back to the client.

Reporting ServicesReporting Services의 SOAP 메시지의 형태는 클라이언트의 요청 유형에 따라 다양합니다.SOAP messages in Reporting ServicesReporting Services take many different forms, depending on the type of request made by the client. 다음 예는 보고서 서버 데이터베이스에서 항목을 제거하는 간단한 SOAP 클라이언트 요청을 나타냅니다.The following example represents a simple SOAP client request to remove an item from the report server database.

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">  
    <soap:Body>  
        <DeleteItem xmlns="http://www.microsoft.com/sql/ReportingServer">  
            <item>/Samples/Report1</item>  
        </DeleteItem>  
    </soap:Body>  
</soap:Envelope>  

자체 SOAP 메시지에 배치 될 필요는 봉투 (envelope) 요소 내 메시지의 많은 부분을 본문 요소입니다.The SOAP itself requires that messages be put into an Envelope element, with the bulk of the message inside a Body element. 이 예에서 본문에는 삭제할 항목의 경로를 나타내는 문자열 매개 변수를 가지는 DeleteItem 메서드 호출이 포함되어 있습니다.In this example, the body contains a call to the DeleteItem method, which takes a string parameter representing the path of the item to delete. 만들 수는 MicrosoftMicrosoft .NET Framework.NET Framework 모든 SOAP 작업을 메서드로 캡슐화 하는 클라이언트 프록시 클래스입니다.You can create a MicrosoftMicrosoft .NET Framework.NET Framework client proxy class that encapsulates all SOAP operations into methods. 다음 MicrosoftMicrosoft Visual C#Visual C# 메서드는 위의 SOAP 예를 나타냅니다.The following MicrosoftMicrosoft Visual C#Visual C# method represents the SOAP example given earlier.

public void DeleteItem(string item);  

서버의 응답은 다음과 같습니다.The response from the server might look like the following:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">  
    <soap:Body>  
        <DeleteItemResponse xmlns="http://www.microsoft.com/sql/ReportingServer" />  
    </soap:Body>  
</soap:Envelope>  

DeleteItem 메서드에는 반환 값이 없으므로 빈 응답이 반환됩니다.The DeleteItem method has no return value, so an empty response is returned.

관련 항목:See Also

SOAP API 액세스 Accessing the SOAP API
보고서 관리자 ( SSRS 기본 모드 ) Report Manager (SSRS Native Mode)
Reporting Services 보고서 서버 Reporting Services Report Server
보고서 서버 웹 서비스Report Server Web Service