ee3b95751078c2b591a077bcb3b01716eae184f6
Guides/Webform-Integration-Sub-Folder.md
| ... | ... | @@ -16,7 +16,7 @@ Reference: [Integrating Izenda into a Web Application](http://wiki.izenda.us/Gui |
| 16 | 16 | |
| 17 | 17 | ###Step 1. Open the host website in Visual Studio |
| 18 | 18 | |
| 19 | -You can also create a new web site in Visual Studio in ASP.NET web forms |
|
| 19 | +You can also create a new web site in Visual Studio in ASP.NET Webforms. |
|
| 20 | 20 | |
| 21 | 21 |  |
| 22 | 22 | |
| ... | ... | @@ -26,9 +26,9 @@ You can also create a new web site in Visual Studio in ASP.NET web forms |
| 26 | 26 |  |
| 27 | 27 | |
| 28 | 28 | |
| 29 | -###Step 3. Copy contents of Global.asax in webform kit to Global.asax of the website |
|
| 29 | +###Step 3. Copy contents of Global.asax in Webforms kit to Global.asax of the website |
|
| 30 | 30 | |
| 31 | -Copy the below code from Global.asax of webform kit to Global.asax of website |
|
| 31 | +Copy the below code from Global.asax of Webforms kit to Global.asax of website: |
|
| 32 | 32 | |
| 33 | 33 | ```csharp |
| 34 | 34 | [Serializable] |
| ... | ... | @@ -78,7 +78,7 @@ Copy the below code from Global.asax of webform kit to Global.asax of website |
| 78 | 78 | |
| 79 | 79 | ``` |
| 80 | 80 | |
| 81 | -And add Izenda.Adhoc namespace. now global.asax of website should look like as below |
|
| 81 | +And add Izenda.Adhoc namespace. Now, the global.asax of website should look similar to the below: |
|
| 82 | 82 | |
| 83 | 83 | ```csharp |
| 84 | 84 | <%@ Application Language="C#" %> |
| ... | ... | @@ -145,15 +145,15 @@ And add Izenda.Adhoc namespace. now global.asax of website should look like as b |
| 145 | 145 | </script> |
| 146 | 146 | |
| 147 | 147 | ``` |
| 148 | -###Step 4. Copy everything except Global.asax, web.config, and Bin folder from webform kit into the sub folder 'Izenda' of website |
|
| 148 | +###Step 4. Copy everything except Global.asax, web.config, and Bin folder from Webforms kit into the sub-folder 'Izenda' of website |
|
| 149 | 149 | |
| 150 | -Create a folder named 'Izenda' in the website's root folder. 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' |
|
| 150 | +Create a folder named 'Izenda' in the website's root folder. Copy everything from Webforms kit except for global.asax, web.config and the bin folder to your sub-folder. In this integration guide, the sub folder is named 'Izenda'. |
|
| 151 | 151 | |
| 152 | 152 |  |
| 153 | 153 | |
| 154 | -###Step 5. Copy OnInit method from Default.master.cs from webform kit to corresponding file/method of website master page |
|
| 154 | +###Step 5. Copy OnInit method from Default.master.cs from Webforms kit to corresponding file/method of website master page |
|
| 155 | 155 | |
| 156 | -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 |
|
| 156 | +Copy the below method from Default.master.cs of Webforms kit to Site.master.cs of the website, and add Izenda.AdHoc namespace to Site.master.cs. |
|
| 157 | 157 | |
| 158 | 158 | ```csharp |
| 159 | 159 | |
| ... | ... | @@ -178,7 +178,7 @@ protected override void OnInit(EventArgs e) { |
| 178 | 178 | |
| 179 | 179 | ###Step 6. Copy 'Head' Section from Default.master |
| 180 | 180 | |
| 181 | -**a.** Copy the below code from < Head > section from Default.master of webform kit to the < Head > section of Site.master |
|
| 181 | +**a.** Copy the below code from < Head > section from Default.master of Webforms kit to the < Head > section of Site.master: |
|
| 182 | 182 | |
| 183 | 183 | ```html |
| 184 | 184 | <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> |
| ... | ... | @@ -216,18 +216,19 @@ protected override void OnInit(EventArgs e) { |
| 216 | 216 | |
| 217 | 217 | ``` |
| 218 | 218 | |
| 219 | -**b.** In contents copied at previous step, locate five < link > tags which have the following href attribute |
|
| 219 | +**b.** In contents copied at previous step, locate five < link > tags which have the following href attribute : |
|
| 220 | 220 | |
| 221 | 221 | href="Resources/...." and change them to href="Izenda/Resources/...." |
| 222 | 222 | |
| 223 | 223 | |
| 224 | -**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. |
|
| 224 | +**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. This Javascript snippet will hide Izenda's navbar unless you are on an Izenda page. |
|
| 225 | 225 | ```html |
| 226 | 226 | <!-- The below code hides Izenda from the main page --> |
| 227 | 227 | |
| 228 | 228 | <script type="text/javascript"> |
| 229 | 229 | $(document).ready(function HideHeader() { |
| 230 | 230 | if (window.location.href.indexOf('Izenda') === -1) { |
| 231 | + document.getElementById('whiteHeader').style.display = 'none'; |
|
| 231 | 232 | document.getElementById('blueHeader').style.display = 'none'; |
| 232 | 233 | } |
| 233 | 234 | }); |
| ... | ... | @@ -235,7 +236,7 @@ href="Resources/...." and change them to href="Izenda/Resources/...." |
| 235 | 236 | |
| 236 | 237 | ``` |
| 237 | 238 | |
| 238 | -**d.** Now < Head > section of Site.master should look like as below |
|
| 239 | +**d.** Now < Head > section of Site.master should look like the below: |
|
| 239 | 240 | ```html |
| 240 | 241 | |
| 241 | 242 | <head runat="server"> |
| ... | ... | @@ -287,10 +288,11 @@ href="Resources/...." and change them to href="Izenda/Resources/...." |
| 287 | 288 | <!-- Copied code ends --> |
| 288 | 289 | |
| 289 | 290 | |
| 290 | -<!-- The below code makes Izenda code work only when sub folder name 'Izenda' is reached --> |
|
| 291 | +<!-- The below code makes Izenda's navbar hidden only until sub-folder named 'Izenda' is reached --> |
|
| 291 | 292 | <script type="text/javascript"> |
| 292 | 293 | $(document).ready(function HideHeader() { |
| 293 | 294 | if (window.location.href.indexOf('Izenda') === -1) { |
| 295 | + document.getElementById('whiteHeader').style.display = 'none'; |
|
| 294 | 296 | document.getElementById('blueHeader').style.display = 'none'; |
| 295 | 297 | } |
| 296 | 298 | }); |
| ... | ... | @@ -304,7 +306,7 @@ href="Resources/...." and change them to href="Izenda/Resources/...." |
| 304 | 306 | |
| 305 | 307 | ###Step 7. Copy 'Body' Section from Default.master |
| 306 | 308 | |
| 307 | -**a.** Copy the below code from < Body > section from Default.master of webform kit into the < Body > section of Site.master. |
|
| 309 | +**a.** Copy the below code from < Body > section from Default.master of Webforms kit into the < Body > section of Site.master. |
|
| 308 | 310 | Place the copied code between < hr / > and < footer > |
| 309 | 311 | |
| 310 | 312 | ```html |
| ... | ... | @@ -413,10 +415,10 @@ Place the copied code between < hr / > and < footer > |
| 413 | 415 | |
| 414 | 416 | ``` |
| 415 | 417 | |
| 416 | -**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 |
|
| 418 | +**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: |
|
| 417 | 419 | |
| 418 | 420 | ```html |
| 419 | -<!-- logos can be customized --> |
|
| 421 | +<!-- logos can be customized, or removed entirely --> |
|
| 420 | 422 | |
| 421 | 423 | <div class="left-logo"> |
| 422 | 424 | <img runat="server" src="Izenda/Resources/FromDLL/Resources/ModernImages/bi-logo.png" alt="Business intelligence" /> |
| ... | ... | @@ -427,20 +429,8 @@ Place the copied code between < hr / > and < footer > |
| 427 | 429 | </div> |
| 428 | 430 | |
| 429 | 431 | ``` |
| 430 | -**c.** As in < Head >, to hide Izenda from the main page when Izenda is not reached, add the below code snippet at the end of < body > |
|
| 431 | 432 | |
| 432 | -```html |
|
| 433 | - |
|
| 434 | - <script type="text/javascript"> |
|
| 435 | - $(document).ready(function HideHeader() { |
|
| 436 | - if (window.location.href.indexOf('Izenda') === -1) { |
|
| 437 | - document.getElementById('whiteHeader').style.display = 'none'; |
|
| 438 | - } |
|
| 439 | - }); |
|
| 440 | - </script> |
|
| 441 | -``` |
|
| 442 | - |
|
| 443 | -**d.** In order to launch Izenda, add a link to Izenda report list page in the < body > of Site.master as below |
|
| 433 | +**c.** In order to launch Izenda, add a link to Izenda report list page in the < body > of Site.master as below: |
|
| 444 | 434 | |
| 445 | 435 | ```html |
| 446 | 436 | <ul class="nav navbar-nav"> |
| ... | ... | @@ -461,21 +451,21 @@ Change MasterPageFile="~/Default.master" to MasterPageFile="~/Site.master" in al |
| 461 | 451 |  |
| 462 | 452 | |
| 463 | 453 | |
| 464 | -###Step 9. In all izenda .aspx pages update paths to izenda .ascx controls |
|
| 454 | +###Step 9. In all Izenda .aspx pages, update paths to Izenda .ascx controls |
|
| 465 | 455 | |
| 466 | -In all izenda .aspx pages update paths to izenda .ascx controls, for example, |
|
| 456 | +For example: |
|
| 467 | 457 | |
| 468 | 458 | <%@ Register Src="~/Resources/html/ReportViewer-Head.ascx" TagName="ccn1" TagPrefix="ccp1" %> |
| 469 | 459 | |
| 470 | 460 | should be changed to |
| 471 | 461 | |
| 472 | -<%@ Register Src="~/RRR/Resources/html/ReportViewer-Head.ascx" TagName="ccn1" TagPrefix="ccp1" %> |
|
| 462 | +<%@ Register Src="~/Izenda/Resources/html/ReportViewer-Head.ascx" TagName="ccn1" TagPrefix="ccp1" %> |
|
| 473 | 463 | |
| 474 | 464 | As we did in the previous step, use 'Find and Replace' tool again as below |
| 475 | 465 | |
| 476 | 466 |  |
| 477 | 467 | |
| 478 | -###Step 10. Copy rs.aspx and rs.aspx.cs from webform kit to website root folder |
|
| 468 | +###Step 10. Copy rs.aspx and rs.aspx.cs from Webforms kit to website root folder |
|
| 479 | 469 | |
| 480 | 470 | ###Step 11. Comment out form tag from ReportDesginer.aspx in Izenda to avoid a form tag conflict |
| 481 | 471 | |
| ... | ... | @@ -508,8 +498,6 @@ AdHocSettings.SqlServerConnectionString = @"INSERT_CONNECTION_STRING_HERE"; |
| 508 | 498 | |
| 509 | 499 | ###Step 13. Launch the website |
| 510 | 500 | |
| 511 | -Launch the website and check if Izenda works fine. At this stage the website should look like as below. |
|
| 512 | - |
|
| 513 | 501 | |
| 514 | 502 |  |
| 515 | 503 |