IF UPGRADING: Please be sure to follow our upgrade best practices: http://wiki.izenda.us/FAQ/Izenda-Update-Best-Practices
This guide is designed to instruct first-time users how to integrate Izenda with simple Web Forms application. This guide will use Izenda Web Forms C# kit and a simple Web Forms application, and Visual Studio 2015.
a. In Visual Studio, select File -> New -> Website.
b. In the New Website pop-up choose ASP.NET Web Forms Site in Visual C#.
c. Make sure to set your new website's name and folder location. We're going to name our website NewWebsite.
d. Visual Studio will now open the application, and you should see this in your Solution Explorer.
e. Alternatively, you can download the application directly from the following link.
Open the folder as a Website in Visual Studio.
a. Unzip your Izenda webforms-cs folder, and open both the Izenda directory and the NewWebsite's directory.
Copy Izenda's bin directory into the NewWebsite's Bin directory.
You will get a conflict around the NewtonJSON DLL and its' XML configuration file. Either use the Izenda NewtonJSON DLL and XML file or address the conflicting version issues by implement a strategy to use multiple versions of the same DLL.
b. Copy Izenda's remaining folders and other miscellaneous files, except for the bin and node__modules.
You'll see conflicts for four files:
Keep NewWebsite's files, and discard the Izenda files. We will walk through merging the Global.asax files in the next step.
a. Open the Izenda Global.asax and the NewWebsite Global.asax and add the Izenda namespace to NewWebsite's Global.asax.
b. Add Izenda's CustomAdHocConfig class to NewWebsite's Global.asax.
c. If you haven't done so already, empty the contents of your Izenda.config (or leave it out of the merge process entirely) and set your license key and connection string in the InitializeReporting() method.
In order to avoid routing issues, you'll need to set the RedirectMode to off. Open \App_Code\RouteConfig.cs and set the RedirectMode as seen below.
At this point all the Izenda pages will run, and function appropriately, from a technical perspective Izenda is integrated with the application, and the whole app will run as one website from one application pool.
The next steps will be to merge the Default.master and Site.master files, and change the Izenda page references.
Past that you'll need to change each Izenda page to point at the Site.Master instead of the Default.Master.
For each page you'll need to:
Last edited by Michael Hornaday, 2016-03-09 10:13:46