#Izenda Webform Integration Guide (Sub-directory)
##About
This guide is designed to instruct first-time users how to integrate Izenda webform kit into a basic ASP.NET website using Visual Studio Express 2013 for Web. In this integration guide, all Izenda files will be placed in a sub-directory called 'Izenda' within the hosting website. This guide will use an Izenda webform kit and a basic ASP.NET website, which can be created using Visual Studio Express 2013 for Web.
Izenda webform kit download link
##Instructions
###Step 1. Open the host website in Visual Studio
You can also create a new web site in Visual Studio in ASP.NET web forms
###Step 2. Copy contents of /Bin folder in webform kit to the Bin folder of host website
###Step 3. Copy contents of Global.asax in webform kit to Global.asax of the website
Copy the below code from Global.asax of webform kit to Global.asax of website
[Serializable]
public class CustomAdHocConfig : FileSystemAdHocConfig {
public static void InitializeReporting() {
//Check to see if we've already initialized.
if (HttpContext.Current.Session == null || HttpContext.Current.Session["ReportingInitialized"] != null)
return;
//Initialize System
AdHocSettings.LicenseKey = "INSERT_LICENSE_KEY_HERE";
AdHocSettings.SqlServerConnectionString = @"INSERT_CONNECTION_STRING_HERE";
AdHocSettings.GenerateThumbnails = true;
AdHocSettings.ChartingEngine = ChartingEngine.HtmlChart;
AdHocSettings.ShowSimpleModeViewer = true;
AdHocSettings.IdentifiersRegex = "^.*[iI][Dd]$";
AdHocSettings.TabsCssUrl = "Resources/css/tabs.css";
AdHocSettings.ReportCssUrl = "Resources/css/Report.css";
AdHocSettings.ShowBetweenDateCalendar = true;
AdHocSettings.AdHocConfig = new CustomAdHocConfig();
AdHocSettings.ChartingEngine = ChartingEngine.HtmlChart;
// AdHocSettings.ShowHtmlButton = true;
//AdHocSettings.ShowPDFButton = true;
//Initialize User
//AdHocSettings.VisibleDataSources=
//AdHocSettings.CurrentUserName=
//AdHocSettings.HiddenFilters["Field"] = new string [] {"value1","value2"};
//Success!
HttpContext.Current.Session["ReportingInitialized"] = true;
AdHocSettings.DashboardDateSliderMode = DashboardDateSliderMode.None;
AdHocSettings.DashboardViewer = "Dash.aspx";
AdHocSettings.DashboardDesignerUrl = "Dash.aspx";
//EOPDF uses a DLL that converts HTML
//AdHocSettings.PdfPrintMode = PdfMode.EOPDF;
//PhantomJS PDF uses an EXE on the web server that produces the export
AdHocSettings.PdfPrintMode = PdfMode.PhantomJs;
}
public override void ProcessDataSet(System.Data.DataSet ds, string reportPart) {
base.ProcessDataSet(ds, reportPart);
}
public override void PreExecuteReportSet(ReportSet reportSet) {
base.PreExecuteReportSet(reportSet);
}
}
And add Izenda.Adhoc namespace. now global.asax of website should look like as below
<%@ Application Language="C#" %>
<%@ Import Namespace="_Sub_Final" %>
<%@ Import Namespace="System.Web.Optimization" %>
<%@ Import Namespace="System.Web.Routing" %>
<%@ Import Namespace="Izenda.AdHoc" %>
<script runat="server">
void Application_Start(object sender, EventArgs e)
{
RouteConfig.RegisterRoutes(RouteTable.Routes);
BundleConfig.RegisterBundles(BundleTable.Bundles);
}
[Serializable]
public class CustomAdHocConfig : FileSystemAdHocConfig {
public static void InitializeReporting() {
//Check to see if we've already initialized.
if (HttpContext.Current.Session == null || HttpContext.Current.Session["ReportingInitialized"] != null)
return;
//Initialize System
AdHocSettings.LicenseKey = "INSERT_LICENSE_KEY_HERE";
AdHocSettings.SqlServerConnectionString = @"INSERT_CONNECTION_STRING_HERE";
AdHocSettings.GenerateThumbnails = true;
AdHocSettings.ChartingEngine = ChartingEngine.HtmlChart;
AdHocSettings.ShowSimpleModeViewer = true;
AdHocSettings.IdentifiersRegex = "^.*[iI][Dd]$";
AdHocSettings.TabsCssUrl = "Resources/css/tabs.css";
AdHocSettings.ReportCssUrl = "Resources/css/Report.css";
AdHocSettings.ShowBetweenDateCalendar = true;
AdHocSettings.AdHocConfig = new CustomAdHocConfig();
AdHocSettings.ChartingEngine = ChartingEngine.HtmlChart;
// AdHocSettings.ShowHtmlButton = true;
//AdHocSettings.ShowPDFButton = true;
//Initialize User
//AdHocSettings.VisibleDataSources=
//AdHocSettings.CurrentUserName=
//AdHocSettings.HiddenFilters["Field"] = new string [] {"value1","value2"};
//Success!
HttpContext.Current.Session["ReportingInitialized"] = true;
AdHocSettings.DashboardDateSliderMode = DashboardDateSliderMode.None;
AdHocSettings.DashboardViewer = "Dash.aspx";
AdHocSettings.DashboardDesignerUrl = "Dash.aspx";
//EOPDF uses a DLL that converts HTML
//AdHocSettings.PdfPrintMode = PdfMode.EOPDF;
//PhantomJS PDF uses an EXE on the web server that produces the export
AdHocSettings.PdfPrintMode = PdfMode.PhantomJs;
}
public override void ProcessDataSet(System.Data.DataSet ds, string reportPart) {
base.ProcessDataSet(ds, reportPart);
}
public override void PreExecuteReportSet(ReportSet reportSet) {
base.PreExecuteReportSet(reportSet);
}
}
</script>
Copy everything from webform kit except global.asax, web.config and bin folder to sub folder. In this integration guide, the sub folder is named as 'Izenda'
###Step 5. Copy OnInit method from Default.master.cs from webform kit to corresponding file/method of website master page
Copy the below method from Default.master.cs of webform kit to Site.master.cs of the website. And add Izenda.AdHoc namespace to Site.master.cs
protected override void OnInit(EventArgs e) {
if (!String.IsNullOrEmpty(AdHocSettings.ApplicationHeaderImageUrl)) {
rightLogo.Src = AdHocSettings.ApplicationHeaderImageUrl;
}
if (!AdHocSettings.ShowDesignLinks) {
string script = "<script type=\"text/javascript\" language=\"javascript\">";
script += "try { $(document).ready(function() {$('.designer-only').hide(); });}catch(e){}";
script += " try{ jq$(document).ready(function() {jq$('.designer-only').hide(); });}catch(e){} ";
script += "</script>";
Page.Header.Controls.Add(new LiteralControl(script));
}
AdHocSettings.ShowSettingsButtonForNonAdmins = false;
}
###Step 6. Copy 'Head' Section from Default.master
a. Copy the below code from < Head > section from Default.master of webform kit to the < Head > section of Site.master
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta http-equiv="Expires" content="0" />
<meta http-equiv="Pragma" content="no-cache" />
<meta name="robots" content="noindex, follow" />
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link rel="alternate" href="" title="Team Blog - RSS" type="application/rss+xml" />
<link rel="shortcut icon" href="Resources/FromDLL/Resources/ModernImages/report-icon.png" type='image/png' />
<link rel="stylesheet" href="Resources/css/reset2.css" type="text/css" />
<link rel="stylesheet" href="Resources/css/print.css" type="text/css" media="print" />
<link rel="stylesheet" href="Resources/css/fun.css" type="text/css" />
<asp:ContentPlaceHolder ID="ChangeableHeader" runat="server">
<link href="./rs.aspx?css=ModernStyles.bootstrap-responsive" rel="stylesheet" />
<link href="./rs.aspx?css=ModernStyles.bootstrap" rel="stylesheet" />
<link href="./rs.aspx?css=ModernStyles.bootstrap-modals" rel="stylesheet" />
<link href="./rs.aspx?css=ModernStyles.bootstrap-override" rel="stylesheet" />
<script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.1/jquery.min.js"></script>
<script type="text/javascript" src="./rs.aspx?js=ModernScripts.jquery-1.7.2.min"></script>
</asp:ContentPlaceHolder>
<link rel="stylesheet" href="Resources/css/main.css" type="text/css" />
<script type="text/javascript" src="./rs.aspx?js=ModernScripts.bootstrap-dropdown"></script>
<script type="text/javascript" src="./rs.aspx?js=ModernScripts.bootstrap-tab"></script>
<script type="text/javascript" src="./rs.aspx?js=ModernScripts.bootstrap-transition"></script>
<script type="text/javascript" src="./rs.aspx?js=ModernScripts.bootstrap-modal"></script>
<script type="text/javascript" src="Resources/js/main.js"></script>
<script type="text/javascript">
//htmlChartColors = ['#ff0000', '#00ff00', '#0000ff', '#910000', '#1aadce', '#492970', '#f28f43', '#77a1e5', '#c42525', '#a6c96a'];
</script>
<!-- Page header injection -->
<asp:ContentPlaceHolder ID="HeadPlaceHolder" runat="server"></asp:ContentPlaceHolder>
b. In contents copied at previous step, locate five < link > tags which have the following href attribute
href="Resources/…." and change them to href="Izenda/Resources/…."
c. At the end < Head > section, insert the below code snippet. If the sub folder has a different name, replace the index of 'Izenda' below with that name.
<script type="text/javascript">
$(document).ready(function HideHeader() {
if (window.location.href.indexOf('Izenda') === -1) {
document.getElementById('blueHeader').style.display = 'none';
}
});
</script>
d. Now < Head > section of Site.master should look like as below
<head runat="server">
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title><%: Page.Title %> - My ASP.NET Application</title>
<asp:PlaceHolder runat="server">
<%: Scripts.Render("~/bundles/modernizr") %>
</asp:PlaceHolder>
<webopt:bundlereference runat="server" path="~/Content/css" />
<link href="~/favicon.ico" rel="shortcut icon" type="image/x-icon" />
<!-- Copied code from Default.master -->
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta http-equiv="Expires" content="0" />
<meta http-equiv="Pragma" content="no-cache" />
<meta name="robots" content="noindex, follow" />
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link rel="alternate" href="" title="Team Blog - RSS" type="application/rss+xml" />
<link rel="shortcut icon" href="Izenda/Resources/FromDLL/Resources/ModernImages/report-icon.png" type='image/png' />
<link rel="stylesheet" href="Izenda/Resources/css/reset2.css" type="text/css" />
<link rel="stylesheet" href="Izenda/Resources/css/print.css" type="text/css" media="print" />
<link rel="stylesheet" href="Izenda/Resources/css/fun.css" type="text/css" />
<asp:ContentPlaceHolder ID="ChangeableHeader" runat="server">
<link href="./rs.aspx?css=ModernStyles.bootstrap-responsive" rel="stylesheet" />
<link href="./rs.aspx?css=ModernStyles.bootstrap" rel="stylesheet" />
<link href="./rs.aspx?css=ModernStyles.bootstrap-modals" rel="stylesheet" />
<link href="./rs.aspx?css=ModernStyles.bootstrap-override" rel="stylesheet" />
<script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.1/jquery.min.js"></script>
<script type="text/javascript" src="./rs.aspx?js=ModernScripts.jquery-1.7.2.min"></script>
</asp:ContentPlaceHolder>
<link rel="stylesheet" href="Izenda/Resources/css/main.css" type="text/css" />
<script type="text/javascript" src="./rs.aspx?js=ModernScripts.bootstrap-dropdown"></script>
<script type="text/javascript" src="./rs.aspx?js=ModernScripts.bootstrap-tab"></script>
<script type="text/javascript" src="./rs.aspx?js=ModernScripts.bootstrap-transition"></script>
<script type="text/javascript" src="./rs.aspx?js=ModernScripts.bootstrap-modal"></script>
<script type="text/javascript" src="Resources/js/main.js"></script>
<script type="text/javascript">
//htmlChartColors = ['#ff0000', '#00ff00', '#0000ff', '#910000', '#1aadce', '#492970', '#f28f43', '#77a1e5', '#c42525', '#a6c96a'];
</script>
<!-- Page header injection -->
<asp:ContentPlaceHolder ID="HeadPlaceHolder" runat="server"></asp:ContentPlaceHolder>
<!-- Copied code ends -->
<!-- The below code makes Izenda code work only when sub folder name 'Izenda' is reached -->
<script type="text/javascript">
$(document).ready(function HideHeader() {
if (window.location.href.indexOf('Izenda') === -1) {
document.getElementById('blueHeader').style.display = 'none';
}
});
</script>
</head>
###Step 7. Copy 'Body' Section from Default.master
a. Copy the below code from < Body > section from Default.master of webform kit into the < Body > section of Site.master. Place the copied code between < hr / > and < footer >
<div class="layout container-fluid" style="margin: 0px; padding: 0px;">
<div class="header applyStyles" id="whiteHeader">
<div class="page" style="font-family: Segoe UI,Tahoma,Verdana,Arial,Helvetica,sans-serif">
<div class="left-logo">
<img src="Resources/FromDLL/Resources/ModernImages/bi-logo.png" alt="Business intelligence" />
</div>
<div class="right-logo">
<a href="http://izenda.com" style="position: relative; top: 4px;">
<img runat="server" class="right-logo" ID="rightLogo" src="Resources/FromDLL/Resources/ModernImages/IzendaNewLogoBlue.png" alt="Izenda Reports" /></a>
</div>
<div class="clearfix"></div>
</div>
</div>
<script type="text/javascript">
function insertParam(key, value) {
key = escape(key); value = escape(value);
var kvp = document.location.search.substr(1).split('&');
if (kvp.length == 1 && kvp[0] == '')
kvp.length = 0;
var i = kvp.length; var x; while (i--) {
x = kvp[i].split('=');
if (x[0] == key) {
x[1] = value;
kvp[i] = x.join('=');
break;
}
}
if (i < 0) { kvp[kvp.length] = [key, value].join('='); }
document.location.search = kvp.join('&');
}
function ShowRlToDbLoading() {
document.getElementById('mainContentDiv').style.display = 'none';
var dld = document.getElementById('dashLoadingVg');
dld.style.height = document.body.scrollHeight + 'px';
dld.style.display = '';
var limg = document.getElementById('limgDb');
var lw = document.getElementById('loadingWordDb');
var vSize = document.body.offsetHeight;
lw.style.paddingTop = (3 + vSize / 3) + 'px';
}
</script>
<div class="top-nav applyStyles" id="blueHeader">
<div class="page">
<ul id="topnav" style="margin: 0px; padding: 0px;">
<li class="top-nav-item" style="vertical-align: top;"><a href="ReportList.aspx">Reports</a></li>
<li class="top-nav-item" style="vertical-align: top;"><a href="Dashboards.aspx?clear=1" onclick="ShowRlToDbLoading();">Dashboards</a></li>
<li class="top-nav-item designer-only btn-group">
<a href="ReportDesigner.aspx?clear=1&tab=Data+Sources" style="padding-right: 8px!important;"><span class="plus">+</span> New</a>
<button type="button" class="btn dropdown-toggle" style="float: none; vertical-align: top; line-height: 20px; background-color: transparent; border: none !important;" data-toggle="dropdown">
<span class="caret" style="margin-top: 8px; vertical-align: top;"></span>
</button>
<ul class="dropdown-menu">
<li><a href="ReportDesigner.aspx?clear=1&tab=Data+Sources">Report</a></li>
<li runat="server" id="irItem"><a href="InstantReport.aspx">Instant Report</a></li>
<li><a href="<%=Izenda.AdHoc.AdHocSettings.DashboardDesignerUrl%>?clear=1">Dashboard</a></li>
</ul>
</li>
<% if (Izenda.AdHoc.AdHocSettings.ShowSettingsButton)
{
%>
<li class="top-nav-item" style="float: right;">
<a href="Settings.aspx" title="Settings">
<img class="icon" src="Resources/FromDLL/Resources/ModernImages/settings.png" alt="Settings" />
</a>
</li>
<% } %>
</ul>
<div class="clearfix"></div>
</div>
</div>
<div id="dashLoadingVg" style="text-align: center; width: 100%; height: 100%; top: 130px; left: 0px; background-color: #FFFFFF; z-index: 8000; display: none;">
<div id="loadingWordDb" style="font-size: 20px; margin-left: 70px; font-size: 20px; color: #1D5987; font-family: Verdana,Arial,Helvetica,sans-serif; font-weight: normal !important; font-size: 20px; font-style: normal;">Loading...</div>
<img id="limgDb" style="margin-left: 70px; margin-top: 40px;" src="Resources/FromDLL/Resources/loading.gif" alt="" />
</div>
<div class="main-content" id="mainContentDiv">
<asp:ContentPlaceHolder ID="PlaceHolder" runat="server"></asp:ContentPlaceHolder>
</div>
<div class="footer applyStyles">
<div class="line"></div>
<div class="page">
<p>
Copyright 2015 Izenda, Inc.
</p>
</div>
</div>
</div>
<!-- For Google analytics -->
<asp:ContentPlaceHolder ID="TrackerPlaceHolder" runat="server">
</asp:ContentPlaceHolder>
b. In the first part of the copied code, to make the right logo and left logo appear correctly, add the sub folder name to src path and runat="server" attribute after 'img' as below
<!-- logos can be customized -->
<div class="left-logo">
<img runat="server" src="Izenda/Resources/FromDLL/Resources/ModernImages/bi-logo.png" alt="Business intelligence" />
</div>
<div class="right-logo">
<a href="http://izenda.com" style="position: relative; top: 4px;">
<img runat="server" class="right-logo" ID="rightLogo" src="Izenda/Resources/FromDLL/Resources/ModernImages/IzendaNewLogoBlue.png" alt="Izenda Reports" /></a>
</div>
c. (To be added)
Add the Reporting folder in mvc5r3\Views to the project's Views
###Step 7. Add _sitelayout to project’s Views\Shared
Add _sitelayout from mvc5r3\Views\Shared to project’s Views\Shared
b. Paste it in project’s Global.asax
###Global.asax from Sample_MVCApp(C♯)
<%@ Application Codebehind="Global.asax.cs" Inherits="Sample_MVCApp.MvcApplication" Language="C#" %>
//THE BELOW IS PASTED CODE
<%@ Import Namespace="Izenda.AdHoc"%>
<%@ Import Namespace="System.IO"%>
<script runat="server">
void Application_AcquireRequestState(object sender, EventArgs e) {
CustomAdHocConfig.InitializeReporting();
}
[Serializable]
public class CustomAdHocConfig : FileSystemAdHocConfig {
public static void InitializeReporting() {
if (HttpContext.Current.Session == null || HttpContext.Current.Session["ReportingInitialized"] != null)
return;
AdHocSettings.LicenseKey = "INSERT_LICENSE_KEY_HERE";
AdHocSettings.SqlServerConnectionString = @"INSERT_CONNECTION_STRING_HERE";
AdHocSettings.GenerateThumbnails = true;
AdHocSettings.ShowSimpleModeViewer = true;
AdHocSettings.IdentifiersRegex = "^.*[iI][Dd]$";
AdHocSettings.TabsCssUrl = "/Resources/css/tabs.css";
AdHocSettings.ReportCssUrl = "../Resources/css/Report.css";
AdHocSettings.ShowBetweenDateCalendar = true;
AdHocSettings.DashboardViewer = "Dashboards";
AdHocSettings.ReportViewer = "ReportViewer";
AdHocSettings.InstantReport = "InstantReport";
AdHocSettings.ReportDesignerUrl = "ReportDesigner";
AdHocSettings.DashboardDesignerUrl = "DashboardDesigner";
AdHocSettings.ReportList = "ReportList";
AdHocSettings.SettingsPageUrl = "Settings";
AdHocSettings.ParentSettingsUrl = "Settings";
AdHocSettings.ResponseServer = "rs.aspx";
AdHocSettings.ReportsPath = Path.Combine(HttpContext.Current.Server.MapPath("~/"), "Reports");
AdHocSettings.PrintMode = PrintMode.Html2PdfAndHtml;
AdHocSettings.ChartingEngine = ChartingEngine.HtmlChart;
AdHocSettings.AdHocConfig = new CustomAdHocConfig();
HttpContext.Current.Session["ReportingInitialized"] = true;
}
}
</script>###Step 9. Copy constraints classes from Global.asax.cs
a. Copy below two constraints from Global.asax.cs of mvc5r3
//IRouteConstraint
public class SpecificFileRouterConstraint : IRouteConstraint {
private string extensionToBeRouted = null;
private string fileToBeRouted = null;
public bool Match(HttpContextBase httpContext, Route route, string parameterName, RouteValueDictionary values, RouteDirection routeDirection) {
return !String.IsNullOrEmpty(extensionToBeRouted) && !String.IsNullOrEmpty(fileToBeRouted) && values[extensionToBeRouted] != null && values[extensionToBeRouted].ToString().ToLower().Contains(fileToBeRouted);
}
public SpecificFileRouterConstraint() { }
public SpecificFileRouterConstraint(string extension, string fileName) {
extensionToBeRouted = extension.ToLower();
fileToBeRouted = fileName.ToLower();
}
}
//IRouteConstraint
public class IzendaResourceConstraint : IRouteConstraint {
private string extensionToBeRouted = null;
public bool Match(HttpContextBase httpContext, Route route, string parameterName, RouteValueDictionary values, RouteDirection routeDirection) {
if (String.IsNullOrEmpty(extensionToBeRouted) || values[extensionToBeRouted] == null) {
return false;
}
string requestUrl = values[extensionToBeRouted].ToString().ToLower();
bool result = false;
if (extensionToBeRouted == "js") {
result = result || requestUrl.Contains("reportviewerfilters.js");
result = result || requestUrl.Contains("reportlist.js");
result = result || requestUrl.Contains("data-sources.js");
result = result || requestUrl.Contains("data-sources-preview.js");
result = result || requestUrl.Contains("charts.js");
result = result || requestUrl.Contains("datasources-search.js");
result = result || requestUrl.Contains("jquery-1.6.1.min.js");
result = result || requestUrl.Contains("jquery-ui-1.8.13.custom.min.js");
result = result || requestUrl.Contains("elrte.full.js");
result = result || requestUrl.Contains("elrte.ru.js");
result = result || requestUrl.Contains("fieldproperties.js");
result = result || requestUrl.Contains("shrinkable-grid.js");
}
if (extensionToBeRouted == "css") {
result = result || requestUrl.Contains("tabs.css");
result = result || requestUrl.Contains("report.css");
result = result || requestUrl.Contains("filters.css");
result = result || requestUrl.Contains("base.css");
result = result || requestUrl.Contains("report-list-modal.css");
result = result || requestUrl.Contains("data-sources.css");
result = result || requestUrl.Contains("charts.css");
result = result || requestUrl.Contains("jquery-ui-1.8.13.custom.css");
result = result || requestUrl.Contains("elrte.min.css");
result = result || requestUrl.Contains("elrte-inner.css");
result = result || requestUrl.Contains("shrinkable-grid.css");
}
if (extensionToBeRouted == "png") {
result = result || requestUrl.Contains("elrtebg.png");
result = result || requestUrl.Contains("elrte-toolbar.png");
}
if (extensionToBeRouted == "gif") {
result = result || requestUrl.Contains("elrte/images/pixel.gif");
}
return result;
}
public IzendaResourceConstraint() { }
public IzendaResourceConstraint(string extension) {
extensionToBeRouted = extension.ToLower();
}
}
b. Paste it above MVCapplication class in Global.asax.cs of project
namespace Sample_MVCApp
{
public class SpecificFileRouterConstraint : IRouteConstraint
{
private string extensionToBeRouted = null;
private string fileToBeRouted = null;
public bool Match(HttpContextBase httpContext, Route route, string parameterName, RouteValueDictionary values, RouteDirection routeDirection)
{
return !String.IsNullOrEmpty(extensionToBeRouted) && !String.IsNullOrEmpty(fileToBeRouted) && values[extensionToBeRouted] != null && values[extensionToBeRouted].ToString().ToLower().Contains(fileToBeRouted);
}
public SpecificFileRouterConstraint() { }
public SpecificFileRouterConstraint(string extension, string fileName)
{
extensionToBeRouted = extension.ToLower();
fileToBeRouted = fileName.ToLower();
}
}
public class IzendaResourceConstraint : IRouteConstraint
{
private string extensionToBeRouted = null;
public bool Match(HttpContextBase httpContext, Route route, string parameterName, RouteValueDictionary values, RouteDirection routeDirection)
{
if (String.IsNullOrEmpty(extensionToBeRouted) || values[extensionToBeRouted] == null)
{
return false;
}
string requestUrl = values[extensionToBeRouted].ToString().ToLower();
bool result = false;
if (extensionToBeRouted == "js")
{
result = result || requestUrl.Contains("reportviewerfilters.js");
result = result || requestUrl.Contains("reportlist.js");
result = result || requestUrl.Contains("data-sources.js");
result = result || requestUrl.Contains("data-sources-preview.js");
result = result || requestUrl.Contains("charts.js");
result = result || requestUrl.Contains("datasources-search.js");
result = result || requestUrl.Contains("jquery-1.6.1.min.js");
result = result || requestUrl.Contains("jquery-ui-1.8.13.custom.min.js");
result = result || requestUrl.Contains("elrte.full.js");
result = result || requestUrl.Contains("elrte.ru.js");
result = result || requestUrl.Contains("fieldproperties.js");
result = result || requestUrl.Contains("shrinkable-grid.js");
}
if (extensionToBeRouted == "css")
{
result = result || requestUrl.Contains("tabs.css");
result = result || requestUrl.Contains("report.css");
result = result || requestUrl.Contains("filters.css");
result = result || requestUrl.Contains("base.css");
result = result || requestUrl.Contains("report-list-modal.css");
result = result || requestUrl.Contains("data-sources.css");
result = result || requestUrl.Contains("charts.css");
result = result || requestUrl.Contains("jquery-ui-1.8.13.custom.css");
result = result || requestUrl.Contains("elrte.min.css");
result = result || requestUrl.Contains("elrte-inner.css");
result = result || requestUrl.Contains("shrinkable-grid.css");
}
if (extensionToBeRouted == "png")
{
result = result || requestUrl.Contains("elrtebg.png");
result = result || requestUrl.Contains("elrte-toolbar.png");
}
if (extensionToBeRouted == "gif")
{
result = result || requestUrl.Contains("elrte/images/pixel.gif");
}
return result;
}
public IzendaResourceConstraint() { }
public IzendaResourceConstraint(string extension)
{
extensionToBeRouted = extension.ToLower();
}
}
// Note: For instructions on enabling IIS6 or IIS7 classic mode,
// visit http://go.microsoft.com/?LinkId=9394801
public class MvcApplication : System.Web.HttpApplication
{
protected void Application_Start()
{
AreaRegistration.RegisterAllAreas();
WebApiConfig.Register(GlobalConfiguration.Configuration);
FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters);
RouteConfig.RegisterRoutes(RouteTable.Routes);
BundleConfig.RegisterBundles(BundleTable.Bundles);
AuthConfig.RegisterAuth();
}
}
}
###Step 10. Copy over RegisterRoutes in MvcApplication
a. Copy the below class from Global.asax.cs of mvc5r3
public static void RegisterRoutes(RouteCollection routes) {
routes.IgnoreRoute("{resource}.axd/{*pathInfo}");
routes.MapRoute("IzendaResources", "Reporting/Resources/{*resource}", new { controller = "IzendaStaticResources", action = "Index" });
routes.MapRoute("IzendaJsResources", "{*js}", new { controller = "IzendaStaticResources", action = "Index" }, new { irc = new IzendaResourceConstraint("js") });
routes.MapRoute("IzendaCssResources", "{*css}", new { controller = "IzendaStaticResources", action = "Index" }, new { irc = new IzendaResourceConstraint("css") });
routes.MapRoute("IzendaPngResources", "{*png}", new { controller = "IzendaStaticResources", action = "Index" }, new { irc = new IzendaResourceConstraint("png") });
routes.MapRoute("IzendaGifResources", "{*gif}", new { controller = "IzendaStaticResources", action = "Index" }, new { irc = new IzendaResourceConstraint("gif") });
routes.MapRoute("IzendaReporting", "{controller}/{action}/{id}", new { controller = "Reporting", id = UrlParameter.Optional });
routes.MapRoute("StarterKitDefault", "{controller}/{action}/{id}", new { controller = "Reporting", action = "ReportList", id = UrlParameter.Optional });
routes.MapRoute("HomeDefault", "{*pathInfo}", new { controller = "Home", action = "Index", id = UrlParameter.Optional });
}b. Paste it inside MvcApplication class of tproject’s Global.asax.cs
public class MvcApplication : System.Web.HttpApplication
{
public static void RegisterRoutes(RouteCollection routes)
{
routes.IgnoreRoute("{resource}.axd/{*pathInfo}");
routes.MapRoute("IzendaResources", "Reporting/Resources/{*resource}", new { controller = "IzendaStaticResources", action = "Index" });
routes.MapRoute("IzendaJsResources", "{*js}", new { controller = "IzendaStaticResources", action = "Index" }, new { irc = new IzendaResourceConstraint("js") });
routes.MapRoute("IzendaCssResources", "{*css}", new { controller = "IzendaStaticResources", action = "Index" }, new { irc = new IzendaResourceConstraint("css") });
routes.MapRoute("IzendaPngResources", "{*png}", new { controller = "IzendaStaticResources", action = "Index" }, new { irc = new IzendaResourceConstraint("png") });
routes.MapRoute("IzendaGifResources", "{*gif}", new { controller = "IzendaStaticResources", action = "Index" }, new { irc = new IzendaResourceConstraint("gif") });
routes.MapRoute("IzendaReporting", "{controller}/{action}/{id}", new { controller = "Reporting", id = UrlParameter.Optional });
routes.MapRoute("StarterKitDefault", "{controller}/{action}/{id}", new { controller = "Reporting", action = "ReportList", id = UrlParameter.Optional });
routes.MapRoute("HomeDefault", "{*pathInfo}", new { controller = "Home", action = "Index", id = UrlParameter.Optional });
}
protected void Application_Start()
{
AreaRegistration.RegisterAllAreas();
WebApiConfig.Register(GlobalConfiguration.Configuration);
FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters);
RouteConfig.RegisterRoutes(RouteTable.Routes);
BundleConfig.RegisterBundles(BundleTable.Bundles);
AuthConfig.RegisterAuth();
}
}
###Step 11. Change the LicenseKey and ConnnectionString in Global.asax of project
To get a new trial key, you may contact sales@izenda.com.
AdHocSettings.LicenseKey = "INSERT_LICENSE_KEY_HERE";
AdHocSettings.SqlServerConnectionString = @"INSERT_CONNECTION_STRING_HERE";
###Step 12. Run it!
After Step#11, the Sample_MVCApp should build and work without a problem. To see if Izenda is integrated with this web application,
a. Open _Layout.cshtml in Views\Shared\ in Solution Explorer
b. Add an ActionLink which leads to Izenda as below
<li>@Html.ActionLink("Home", "Index", "Home")</li>
<li>@Html.ActionLink("About", "About", "Home")</li>
<li>@Html.ActionLink("Contact", "Contact", "Home")</li>
<li>@Html.ActionLink("Izenda", "ReportList", "Reporting")</li> //Add this linec. Notice 'Izenda' item added to the menu as below. Click it and see if it leads to Izenda ReportList page.
###Step 13. Change the Logo
a. Open _SiteLayout.cshtml in Views\Shared\ in Solution Explorer
b. Find below two lines in the body of the html and edit the source image directory, alt, and the link address for top-right image
<img src="~/Resources/FromDLL/Resources/ModernImages/bi-logo.png" alt="Business intelligence" /> //top-left image
<a href="http://izenda.com" style="position: relative; top: 4px;"><img class="right-logo" src="~/Resources/FromDLL/Resources/ModernImages/IzendaNewLogoBlue.png" alt="Izenda Reports" /></a> //top-right image
In this guide, two images, Logo.png and SeaEagle.png, were put in the project folder, /Sample_MVCApp, and the above two lines were edited as below
<img src="~/Logo.png" alt="Angry Sea Eagle" /> //top-left image
<a href="http://SeaEagle.com" style="position: relative; top: 4px;"><img class="right-logo" src="~/SeaEagle.png" alt="SeaEagle.Com" /></a> //top-right imageTwo top logos have changed as below
