Generation of a simple web-application in the Microsoft Visual Studio 2008 with the use of Silverlight Viewer for Reporting Services 2008

Size: px

Start display at page:

Download "Generation of a simple web-application in the Microsoft Visual Studio 2008 with the use of Silverlight Viewer for Reporting Services 2008"

Ralph Berry
6 years ago
Views:

1 Generation of a simple web-application in the Microsoft Visual Studio 2008 with the use of Silverlight Viewer for Reporting Services 2008 Prerequisites.NET Framework 3.5 SP1/4.0 Silverlight v3 Silverlight v3 SDK Silverlight v3 Developer Tool Visual Studio 2008 Getting Started Microsoft SQL Server 2008 Reporting Services (Enterprise or Standard editions) Microsoft SQL Reporting Services 2008 Sample Reports Introduction The target of the following guide is to demonstrate the basic moments of the use of Silverlight Viewer for Reporting Services It gives minimum necessary knowledge in order to start working with the component. We will examine the process of generation of web application with the use of Silverlight Viewer for Reporting Services 2008 step by step. We will consider creation and configuration of the service and, at last, integration of the Report Viewer component into the application pages. Your application can be configured to use the processing capability of Microsoft SQL Server 2008 Reporting Services report server.

2 Step 1. Creating Web application using Microsoft SQL 2008 Reporting Services report server. Create a new Silverlight Application project named SampleApplication.

3 While creation of the project select the menu item Add a new ASP.NET Web project to the solution to host Silverlight and set name of the web-project to SampleApplication.Server

Step 2. Set the web application to use static port 5555. Set specific port to 5555 to the Web tab of the SampleApplication.

4 Step 2. Set the web application to use static port Set specific port to 5555 to the Web tab of the SampleApplication.Server properties (in the "Solution Explorer", item Properties in contextual menu of the SampleApplication.Server). Open SampleApplication.Server properties.

5 Check the Specific port option and set it to 5555 in the Web tab of the SampleApplication.Server properties.

6 Next, set the SampleApplication.Server project as Startup Project.

7 Step 3. Add Perpetuumsoft.ReportingServices.Viewer.Server assembly to the project references. This assembly is located in the Bin folder of the Silverlight Viewer for Reporting Services 2008 installation folder.

Step 4. Add WCF service named ReportService.svc to the SampleApplication.Server project. Add Silverlight-enabled WCF Service named ReportService.

9 Step 4. Add WCF service named ReportService.svc to the SampleApplication.Server project. Add Silverlight-enabled WCF Service named ReportService.svc to the SampleApplication.Server project. In order to do that, right-click SampleApplication.Server and choose Add->New Item in the popup menu.

Add Silverlight-enabled WCF Service template to your project. Inherit a new ReportService class from the ReportServiceRemote class for implementation and ability to change standard behavior.

10 Add Silverlight-enabled WCF Service template to your project. Inherit a new ReportService class from the ReportServiceRemote class for implementation and ability to change standard behavior. In order to make the ASP.NET context available for the service, service class should be marked with a special AspNetCompatibilityRequirements attribute. The ASP.NET context is required for the service to cache document data, if other mechanism of data storage is not implemented. Open source code of the ReportService class (ReportService.svc.cs) and change the code lines as follows: // ReportService.svc.cs using System.ServiceModel.Activation; using PerpetuumSoft.ReportingServices.Viewer.Server; namespace SampleApplication.Server { [AspNetCompatibilityRequirements(RequirementsMode = AspNetCompatibilityRequirementsMode.Required)] public class ReportService : ReportServiceRemote { Create the ServiceReportHostFactory.cs file and add the following code. It is required to avoid multi-domains site issue.

11 In order to do that, right-click SampleApplication.Server and select Add->Class... in the popup menu.

Open the source code of ReportServiceHostFactory (ReportServiceHostFactory.cs) and change the code lines as follows: using System; using System.ServiceModel; using System.ServiceModel.Activation; using System.

12 Open the source code of ReportServiceHostFactory (ReportServiceHostFactory.cs) and change the code lines as follows: using System; using System.ServiceModel; using System.ServiceModel.Activation; using System.Web; namespace SampleApplication.Server { public class ReportServiceHostFactory : ServiceHostFactory { protected override ServiceHost CreateServiceHost(Type servicetype, Uri[] baseaddresses) { return new ReportServiceHost(serviceType, HttpContext.Current.Request.Url); public class ReportServiceHost : ServiceHost { public ReportServiceHost(Type servicetype, params Uri[] baseaddresses) : base(servicetype, baseaddresses) { Now, you need to add Factory property to the ServiceHost definition in the ServiceReport.svc markup.

13 Open markup of the ReportService class (ReportService.svc). Change the code lines as follows: ServiceHost Language="C#" Debug="true" Service="SampleApplication.Server.ReportService" Factory="SampleApplication.Server.ReportServiceHostFactory" CodeBehind="ReportService.svc.cs" %>

14 Step 5. Now, you need to configure the created ReportService WCF-service. Make modifications to the web.config file in the system.servicemodel section. Add the following code to the endpointbehaviors section: <endpointbehaviors> <behavior name="webbehavior"> <webhttp/> </behavior> </endpointbehaviors> In the services section, you can find definition for the created service (<service name="sampleapplication.server.reportservice...). Change the binding attribute value of the endpoint with empty address (address="") to "basichttpbinding" and contract value to "PerpetuumSoft.ReportingServices.Viewer.Server.IReportService". Add the following endpoint definition code to the definition of the service: <endpoint address="rest" behaviorconfiguration="webbehavior" binding="webhttpbinding" bindingconfiguration="webhttpbindingconf" contract="perpetuumsoft.reportingservices.viewer.server.ireportservicere sources"/> Note: The endpoint address="" is designated to work with the report, for instance, to get pages. The endpoint address="rest" is designated to work with the resources, for instance, to get localization. The endpoint address="mex"is is used to get meta-information about the service. The system.servicemodel section should look as follows after making the changes: <system.servicemodel> <behaviors> <endpointbehaviors> <behavior name="webbehavior"> <webhttp/> </behavior> </endpointbehaviors> <servicebehaviors> <behavior name="sampleapplication.server.reportservicebehavior"> <servicemetadata httpgetenabled="true"/> <servicedebug includeexceptiondetailinfaults="false"/> </behavior> </servicebehaviors> </behaviors> <servicehostingenvironment aspnetcompatibilityenabled="true"/> <services> <service behaviorconfiguration="sampleapplication.server.reportservicebehavior" name="sampleapplication.server.reportservice">

15 <endpoint address="" binding="basichttpbinding" bindingconfiguration="basichttpbindingconf" contract="perpetuumsoft.reportingservices.viewer.server.ireportservice"/> <endpoint address="rest" behaviorconfiguration="webbehavior" binding="webhttpbinding" bindingconfiguration="webhttpbindingconf" contract="perpetuumsoft.reportingservices.viewer.server.ireportservicere sources"/> <endpoint address="mex" binding="mexhttpbinding" contract="imetadataexchange"/> </service> </services> <bindings> <webhttpbinding> <binding name="webhttpbindingconf"/> </webhttpbinding> <basichttpbinding> <binding name="basichttpbindingconf"/> </basichttpbinding> </bindings> </system.servicemodel> The Report Service can also work over SSL. To do it you need to extend the service definition in the web.config file. Add some definition to the binding element. <security mode="transport"> <transport clientcredentialtype="none"/> </security> NOTE: If you set Security Mode equal to Transport then you have to set ServiceUrl of ReportViewer to Example: <webhttpbinding> <binding name="webhttpbindingconf"> <security mode="transport"> <transport clientcredentialtype="none"/> </security> </binding> </webhttpbinding> <basichttpbinding> <binding name="basichttpbindingconf"> <security mode="transport"> <transport clientcredentialtype="none"/> </security> </binding> </basichttpbinding>

16 Step 6. Now, it s necessary to setup Perpetuum Software Report Server environment. Make some changes in the web.config file. a) Add section element inside the configsections element. <section name="perpetuumsoftservices" type="perpetuumsoft.reportingservices.viewer.server.servicesconfiguratio nsection, PerpetuumSoft.ReportingServices.Viewer.Server" allowlocation="true" allowdefinition="everywhere"/> b) Add PerpetuumSoftServices below the configsection element to the web.config file. <PerpetuumSoftServices>  <LogMode value="on"/> <Service Type="SampleApplication.Server.ReportService, SampleApplication.Server">> <MsReportingServer Url=" <Credentials Domain="" UserName="" Password=""/> </MsReportingServer> </Service> </PerpetuumSoftServices>> The LogMode element is developed to log exception. Some Hosting Providers forbid saving into files. Try to change value attribute to Off if your SampleApplication cannot be executed properly. The MsReportingServer attributes and elements description: Url attribute specifies path to your Microsoft SQL Reporting Services 2008 web service. Credentials element defines credentials to access to the Reporting Service web service. If you omit the Credentials element or leave attributes blank, the server will use Default Network Credentials of Web Site. Full content can be found in the web.config file in Sample Application.

Step 7. It s necessary to add the report viewer component to the Silverlight application for the report display. Therefore you should add a reference to the PerpetuumSoft.ReportingServices.Viewer.

17 Step 7. It s necessary to add the report viewer component to the Silverlight application for the report display. Therefore you should add a reference to the PerpetuumSoft.ReportingServices.Viewer.Client assembly, containing ReportViewer (in "Solution Explorer", item Add Reference in context menu of SampleApplication). This assembly is located in the Bin folder of the Silverlight Viewer for Reporting Services installation folder.

18 Open MainPage.xaml in the markup designer and add xml namespace to the PerpetuumSoft.ReportingServices.Viewer.Client assembly.

Then add ReportViewer, set ServiceUrl="http://localhost:5555/ReportService.svc" and ReportName="/AdventureWorks 2008 Sample Reports/Product Line Sales 2008".

$cs source code and add the following code: public partial class MainPage : UserControl { public MainPage() { InitializeComponent(); Loaded += new RoutedEventHandler(Page_Loaded); void$

19 Then add ReportViewer, set ServiceUrl=" and ReportName="/AdventureWorks 2008 Sample Reports/Product Line Sales 2008". NOTE: We suppose that you have Microsoft SQL Reporting Services installed and configured. Open the MainPage.xaml.cs source code and add the following code: public partial class MainPage : UserControl { public MainPage() { InitializeComponent(); Loaded += new RoutedEventHandler(Page_Loaded); void Page_Loaded(object sender, RoutedEventArgs e) { reportviewer.debugmode = DebugModeEnum.Full; /* * HtmlPage.IsEnabled is set in false means that * the silverlight application started in Out-Of-Browser mode * * Unfortunately there no way to set ServiceUrl from outside * application if the application started in Out-Of-Browser mode */ if (HtmlPage.IsEnabled == false) {

20 reportviewer.serviceurl = " else { SilverlightInitParamsHelper initparamshelper = new SilverlightInitParamsHelper( HtmlPage.Plugin.GetProperty("initParams").ToString()); reportviewer.serviceurl = initparamshelper.serviceurl; reportviewer.debugmode = initparamshelper.debugmode; reportviewer.applytemplate(); reportviewer.renderdocument(); The RenderDocument method invocation leads to the rendering of the current report on the server and its displaying in the Report Viewer. Silverlight 3 application is added to the web page as Html object. <object data="data:application/x-silverlight-2," type="application/xsilverlight-2" width="100%" height="100%"> You need to make the following steps. Open Default.aspx as markup and add the following code: <%@ Page Language="C#" AutoEventWireup="true" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" " <html xmlns=" > <head runat="server"> <title>sampleapplication</title> <style type="text/css"> html, body { height: 100%; overflow: auto; body { padding: 0; margin: 0; #silverlightcontrolhost { height: 100%; text-align:center; </style> <script type="text/javascript" src="silverlight.js"></script> <script type="text/javascript"> function onsilverlighterror(sender, args) { var appsource = ""; if (sender!= null && sender!= 0) { appsource = sender.gethost().source; var errortype = args.errortype; var ierrorcode = args.errorcode; if (errortype == "ImageError" errortype == "MediaError") {

21 return; "\n" ; var errmsg = "Unhandled Error in Silverlight Application " + appsource + errmsg += "Code: "+ ierrorcode + " \n"; errmsg += "Category: " + errortype + " \n"; errmsg += "Message: " + args.errormessage + " \n"; if (errortype == "ParserError") { errmsg += "File: " + args.xamlfile + " \n"; errmsg += "Line: " + args.linenumber + " \n"; errmsg += "Position: " + args.charposition + " \n"; else if (errortype == "RuntimeError") { if (args.linenumber!= 0) { errmsg += "Line: " + args.linenumber + " \n"; errmsg += "Position: " + args.charposition + " errmsg += "MethodName: " + args.methodname + " \n"; \n"; throw new Error(errMsg); </script> </head> <body> <form id="form1" runat="server" style="height:100%"> <div id="silverlightcontrolhost"> <object data="data:application/x-silverlight-2," type="application/xsilverlight-2" width="100%" height="100%"> <param name="source" value="clientbin/sampleapplication.xap"/> <param name="onerror" value="onsilverlighterror" /> <param name="background" value="white" /> <param name="minruntimeversion" value=" " /> <param name="autoupgrade" value="true" /> <param name="initparams" value='serviceurl=<%= String.Format(" Request.Url.Authority, ResolveUrl("~/ReportService.svc")) %>;DebugMode=Full' /> <a href=" style="text-decoration:none"> <img src=" alt="get Microsoft Silverlight" style="border-style:none"/> </a> </object><iframe id="_sl_historyframe" style="visibility:hidden;height:0px;width:0px;border:0px"></iframe></div> </form> </body> </html> Please pay attention to the <param name= InitParams...> element. This element determines parameters for ReportViewer. The ServiceUrl attribute specifies Url to ReportService, the DebugMode attribute specifies the mode of exception display. There are two values: Simple and Full. The Full mode can be used if any errors occurred during execution.

22 Step 8. Install Microsoft SQL Reporting Services 2008 Xaml Rendering extension. Note: The extension must be installed ONLY to Microsoft SQL Reporting Services Run PerpetuumSoft.XamlExtension.msi. Follow the installer instructions on the screen.

Check/uncheck the instances to install/uninstall Rendering Extension to

23 The installer determines your SQL configurations and offers the list of available Reporting Services instances. Check/uncheck the instances to install/uninstall Rendering Extension to selected Reporting Services instances and click Apply Changes button. Restart the instance of Reporting Services.

24 Step 9. Run Sample Application. Press Ctrl+F5 in the Visual Studio 2008 environment to run the application.

If you cannot run application or any errors occurred during execution please contact Perpetuum Software support team at support@perpetuumsoft.com.

25 If you cannot run application or any errors occurred during execution please contact Perpetuum Software support team at You can select the error message and copy it to clipboard. Send error message which appeared inside the ReportViewer control and log.txt file (if it exists) which can be found in the Log folder of your web site root. Conclusion We have examined basic steps and got a simple and quite operable application. We didn t have to write thousand lines of code we only used ready-made implementation. It will be enough in the most cases. If required behavior differs greatly from the one provided by default, you can change not only many aspects of the Silverlight Viewer for Reporting Services 2008 work but also the appearance of the report viewer.

Creation of the application based on the DevForce Silverlight by IdeaBlade with the use of Report Sharp-Shooter for Silverlight by Perpetuum Software.

Creation of the application based on the DevForce Silverlight by IdeaBlade with the use of Report Sharp-Shooter for Silverlight by Perpetuum Software. Getting Started Table of Contents: Preface 2 Product