Implementing and Using Custom IReportResolver

The Silverlight Report Viewer and its WCF Reporting Service are no longer supported and deployed with the installation of Telerik Reporting. The last release of Telerik Reporting with included Silverlight Report Viewer is R1 2023.

The client programs invoke the report rendering from the service using a string report description. Based on the report description the service’s report resolvers try to create an IReportDocument instance needed by the ReportProcessor.

The IReportDocument interface represents a report document. This includes a single Report or ReportBook. The IReportDocument returned by the report resolver will be further handled by the ReportProcessor.

The service includes default report resolvers that are capable to resolve IReportDocument from relative and physical path that points to trdp or trdx file (report definition serialized in XML) or from assembly qualified name. This way we cover most of the scenarios. However if you have requirements that are not covered by the default report resolvers, such as retrieving report definitions stored in database or building a report book based on the report description, you can plug into the Telerik Reporting Service report resolving workflow.

The report resolvers implement the IReportResolver interface. This interface has only one method Resolve with a string argument - the report description. In custom resolver implementations you should use that description as you like in order to map it to IReportDocument instance.

If you use the Silverlight report viewer the report description is provided by the ReportViewer.Report property.

Extending Telerik Reporting WCF service with custom IReportResolver implementation:

Prerequisites
- Web application
- Reference to System.ServiceModel.dll assembly
- Reference to Telerik.Reporting.Service.dll assembly
- Telerik Reports definitions to be exposed through the Reporting Service

Steps to implement and use custom IReportResolver

Implement the Telerik.Reporting.Service.IReportResolver

class CustomReportService : ReportService
{
    static readonly IReportResolver resolver = new ReportResolver();

    public CustomReportService()
    {
        this.ReportResolver = resolver;
    }
}

Class CustomReportService
    Inherits ReportService
    Shared ReadOnly resolver As IReportResolver = New ReportResolver()

    Public Sub New()
        Me.ReportResolver = resolver
    End Sub
End Class

In order to utilize your IReportResolver implementation, create a Telerik.Reporting.Service subclass and in your subclass constructor pass your IReportResolver implementation to the Telerik.Reporting.ServiceBase.ReportResolver property:

class CustomReportService : ReportService
{
    static readonly IReportResolver resolver = new ReportResolver();

    public CustomReportService()
    {
        this.ReportResolver = resolver;
    }
}

Class CustomReportService
    Inherits ReportService
    Shared ReadOnly resolver As IReportResolver = New ReportResolver()

    Public Sub New()
        Me.ReportResolver = resolver
    End Sub
End Class

Even if you use your own IReportResolver implementation you can still fallback to the default IReportResolver implementations as shown in the following walkthrough.

Steps to implement and use custom IReportResolver with fallback mechanism

Add to your IReportResolver implementation a constructor with parameter IReportDocument parentResolver. Then use the parentResolver if the custom report resolving mechanism fails.

class ReportServiceWithResolverFallback : ReportService
{
    static readonly IReportResolver resolvers = new ReportResolverWithFallBack(
                                                  new ReportTypeResolver(
                                                   new ReportFileResolverWeb(null)));
    public ReportServiceWithResolverFallback()
    {
        this.ReportResolver = resolvers;
    }
}

Class ReportServiceWithResolverFallback
    Inherits ReportService
    Shared ReadOnly resolvers As IReportResolver = New ReportResolverWithFallBack(New ReportTypeResolver(New ReportFileResolverWeb(Nothing)))
    Public Sub New()
        Me.ReportResolver = resolvers
    End Sub
End Class

Add to Telerik.Reporting.Service subclass the IReportResolver implementations in a chain. Thus the custom one will be executed first, if it fails the second one and so on.

class ReportServiceWithResolverFallback : ReportService
{
    static readonly IReportResolver resolvers = new ReportResolverWithFallBack(
                                                  new ReportTypeResolver(
                                                   new ReportFileResolverWeb(null)));
    public ReportServiceWithResolverFallback()
    {
        this.ReportResolver = resolvers;
    }
}

Class ReportServiceWithResolverFallback
    Inherits ReportService
    Shared ReadOnly resolvers As IReportResolver = New ReportResolverWithFallBack(New ReportTypeResolver(New ReportFileResolverWeb(Nothing)))
    Public Sub New()
        Me.ReportResolver = resolvers
    End Sub
End Class

You can use for fallback the default IReportResolver implementations:

ReportTypeResolver - Resolves IReportDocument from assembly qualified name
ReportFileResolver - Resolves IReportDocument from physical path to trdp or trdx file
ReportFileResolverWeb - Resolves IReportDocument from a relative path to trdp or trdx file

Hosting Telerik.Reporting.Service.ReportService subclass in IIS

Add .svc file (e.g. ReportService.svc) to reference your Telerik.Reporting.Service.ReportService subclass. The file would contain the following line only:
```
<%@ServiceHost Service="CSharp.SilverlightDemo.Web.CustomReportService, CSharp.SilverlightDemo.Web" %>
```

Register the Reporting Service endpoints with service name your Telerik.Reporting.Service.ReportService subclass in the web.config:

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <system.serviceModel>
        <services>
            <service name="CSharp.SilverlightDemo.Web.CustomReportService"
                     behaviorConfiguration="ReportServiceBehavior">
                <endpoint
                       address=""
                       binding="basicHttpBinding"
                       contract="Telerik.Reporting.Service.IReportService">
                    <identity>
                        <dns value="localhost" />
                    </identity>
                </endpoint>
                <endpoint
                        address="resources"
                        binding="webHttpBinding"
                        behaviorConfiguration="WebBehavior"
                        contract="Telerik.Reporting.Service.IResourceService"/>
                <endpoint
                        address="mex"
                        binding="mexHttpBinding"
                        contract="IMetadataExchange" />
            </service>
        </services>
        <behaviors>
            <serviceBehaviors>
                <behavior name="ReportServiceBehavior">
                    <serviceMetadata httpGetEnabled="true" />
                    <serviceDebug includeExceptionDetailInFaults="false" />
                </behavior>
            </serviceBehaviors>
            <endpointBehaviors>
                <behavior name="WebBehavior">
                    <webHttp />
                </behavior>
            </endpointBehaviors>
        </behaviors>
    </system.serviceModel>
</configuration>

The custom resolver's Resolve method is called on each interaction with the report in the Silverlight ReportViewer e.g., changing report parameters' values or hitting refresh. To avoid unexpected results the recommended Report Sources to work with are UriReportSource and TypeReportSource.

Implementing and Using Custom IReportResolver

Extending Telerik Reporting WCF service with custom IReportResolver implementation:

Getting Started

Support Resources

Community