Sql Server Reporting Services sind ein mächtiges Werkzeug. Eine häufige Anforderung im Entwickleralltag ist das generieren von PDF Dokumenten. Bekannter massen lässt sich ein SSRS Report auch als PDF exportieren. Ist nun schon ein SSRS Server im Einsatz kann mittels der SSRS API ein Report als PDF gerendert werden.

Die SOAP API der SQL Server Reporting Serivces besteht aus 5 Endpoints, wobei nur zwei von Belangen und einer bei der Report Generierung von Nutzen ist.

1. Der Management Endpoint
   http:///ReportServer/ReportService2010.asmx?wsdl
   Zum verwalten (z.B. Report hochladen oder löschen) von SSRS.
2. Der Execution Endpoint
   http:///ReportServer/ReportExecution2005.asmx?wsdl
   Zum ausführen bzw. zum Render von Reports.

Report Server Web Service Endpoints

Für unsere Anforderung, benötigen wir den Execution Endpoint. Zuerst werden, wie bei jedem anderen Web Service, aus dem WSDL die Proxy Klassen generiert. Danach kann mit der Klasse “ReportExecutionServiceSoapClient” ein Report gerendert werden. Die folgende Klasse rendert einen Report der keine Parameter entgegennimmt. Dabei kommt Windows Authentication zum Einsatz.

public class SsrsService
{
    private readonly ReportExecutionServiceSoapClient reportExecutionService;

    public SsrsService(string endpointUrl, NetworkCredential credentials)
    {
        var binding = new BasicHttpBinding
        {
            Security =
            {
                Mode = BasicHttpSecurityMode.TransportCredentialOnly,
                Transport = { ClientCredentialType = HttpClientCredentialType.Ntlm }
            }
        };

        var endpointAddress = new EndpointAddress(endpointUrl);

        reportExecutionService = new ReportExecutionServiceSoapClient(binding, endpointAddress);
        reportExecutionService.ClientCredentials.Windows.ClientCredential = credentials;
        reportExecutionService.ClientCredentials.Windows.AllowedImpersonationLevel = TokenImpersonationLevel.Impersonation;
    }

    public byte[] RenderReport(string format, string path)
    {
        var trustedUserHeader = new TrustedUserHeader();

        ExecutionInfo executionInfo;
        ServerInfoHeader serviceInfoHeader;
        reportExecutionService.LoadReport(trustedUserHeader, path, null, out serviceInfoHeader, out executionInfo);

        const string deviceInfo = @"False";
        string extension;
        string mimeType;
        byte[] result;
        string[] streamIds;
        Warning[] warnings;
        string encoding;
        var executionHeader = new ExecutionHeader { ExecutionID = executionInfo.ExecutionID };

        reportExecutionService.Render(
          executionHeader, trustedUserHeader, format, deviceInfo,
            out result, out extension, out mimeType, out encoding, out warnings, out streamIds);

        return result;
    }
}

Der Aufruf zum generieren eines Reports als PDF zeigt folgendes Snippet.

const string ReportPath = @"/FolderXY/Untitled";
var ssrsService = new SsrsService(url, CredentialCache.DefaultNetworkCredentials);
var bytes = ssrsService.RenderReport("PDF", ReportPath);

Wichtig dabei:
Der ReportPath muss mit “/” beginnen und der Report wird ohne Filename Extension angegeben.