The CE Web Form Renderer provides support for dropping multiple controls on the same web page. This allows displaying/running Ispec forms from different host applications on the same web page, each in their own CE Web Form Renderer control. The controls and therefore the applications within the controls run independently of each other but can be viewed at the same time on web page. Each renderer control is configured individually which means they have their own set of configuration parameters in the Web.config file. This means each control can be configured to access applications on different host systems.
When using multiple renderer controls on the same page the individual applications should be generated normally as bundles to the application views directory. The web application/web page which hosts the multiple renderer controls is developed in a separate project. When deploying the web application, the generated application files including the associated infrastructure files must be copied into subdirectories under the main web application directory. Essentially, the top level directory must be created to contain the main web page and dll's that are common for the entire application. Below the top level, a subdirectory for each application to run in a renderer control must be created. The required directories should be created according to the following structure:
<Main Web App> <bin> <App for Renderer Control 1 for example, Purchase Order system)> <Images> <Lang 1> . . <Lang n> <App for Renderer Control 2 for example, Stock Control system> <Images> <Lang 1> . . <Lang n> <App for Renderer Control N>
In this structure, the main web application directory contains all infrastructure files from the installed “ASP.NET Generator\Common\User” directory including the Web.config file. A virtual directory pointing to the “Main Web App” directory must be configured in IIS. A set of configuration parameters must be added for each renderer control to the “appsettings” section of the Web.config file. Each configuration is given a config name specified using the “ConfigName” parameter and each configuration parameter is given a prefix to maintain unique parameter names across multiple renderer controls. The ConfigName property of each renderer control is then set to the value of the ConfigName parameter.
The “bin” subdirectory contains all required dll's for each application to run within the renderer controls on the web page. This includes:
UniCombo.dll
UniMenu.dll
CEWebFormRenderer.dll
CEASPNETWebForm.dll (dll built/compiled from main web application user project)
PurchaseOrder.dll (dll built/compiled from generated Purchase Order Application project)
StockControl.dll (dll built/compiled from generated Stock Control Application project)
Each application subdirectory contains files that are specific to the generated application. The application subdirectory also contains infrastructure files from the installed “ASP.NET Generator\Common\Generated” directory. The Images subdirectory contains image files required for that application. The files generated from the Bundle into the “Views\Lang” subdirectories must be copied to the corresponding “Lang” subdirectories for the application.
The name of each application subdirectory can be any name chosen by the user. The names of the application subdirectories are then configured in the “AppDirRelativePath” configuration parameters for each renderer control. This associates a renderer control with the appropriate application.