WEBfactory 2010

Setting the windowless parameter for WEBfactory modules

When embedding web applications like the WEBfactory 2010 modules (WFMaintenancePro, WFMessengerPro, WFSchedulerPro and WFScenarioManagerPro) in visualizations, Silverlight requires the windowless parameter to be set on true in order for the web applications to run.

When creating the visualizations with WEBfactory 2010SmartEditor, the windowless parameter is set to true by default for every web application included in the visualization. With Expression Blend, the user needs to manually add this parameter in the HTML and/or ASPX file that Blend builds.

The windowless parameter tells Silverlight to load either in it's own rendering window (when windowless is set to false) or directly in the browser window (when windowless is set to true).

The windowless parameter is required to be true when using web applications embedded in Silverlight visualizations because it allows the Silverlight application to blend with the HTML.

By default, the windowless parameter is set to false.

Setting the windowless parameter manually is required only for Expression Blend web projects!

Setting the windowless parameter in Expression Blend web projects

To make the WEBfactory 2010 modules to work in a Silverlight visualization built with Expression Blend, the HTML and/or ASPX file of the resulted site project needs to be edited. The next steps will guide you through the process:

  1. Open the Expression Blend project folder after the project has been built for release. We need to locate the site project which lives in a folder named WFSilverlightApplicationSite (the same folder that needs to be placed in IIS in order to run the application). If the web project has been already loaded in IIS, you can find it in the wwwroot directory of inetpub, usually C:\inetpub\wwwroot\WFSilverlightApplicationSite.

  2. Inside the site folder, locate the Default.aspx file. If the site project has an additional Default.html file, both files will require the same modification.

  3. Open the ASPX and/or HTML file with your preferred text editor.

  4. In the body section of the file, locate the <object> node. The <object> node should be nested inside a <form>. Note how the parameters are defined inside the <object> node, using the <param> tags.

    ...
    <body>
        <form id="form1" runat="server" style="height:100%">
    	<div id="silverlightControlHost">
    	    <object data="data:application/x-silverlight-2," type="application/x-silverlight-2" width="100%" height="100%">
    		<param name="source" value="ClientBin/WFSilverlightApplication4.xap"/>
    		<param name="onError" value="onSilverlightError" />
    		<param name="background" value="white" />
    		<param name="autoUpgrade" value="true" />
    		<param name="splashscreensource" value="Splash.xaml" />
    		<param name="onSourceDownloadProgressChanged" value="OnSourceDownloadProgressChanged" />
    				
    		<a href="http://go.microsoft.com/fwlink/?LinkID=149156&v=4.0.50401.0" style="text-decoration:none">
    		  <img src="http://go.microsoft.com/fwlink/?LinkId=161376" 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>
    ...
  5. Now add the windowless parameter and set it to true, following the same structure of the existing parameters. Add the next line to the parameter list:

    <param name="windowless" value="true" />

    The code should now look like this:

    ...
    <body>
        <form id="form1" runat="server" style="height:100%">
    	<div id="silverlightControlHost">
    	    <object data="data:application/x-silverlight-2," type="application/x-silverlight-2" width="100%" height="100%">
    		<param name="source" value="ClientBin/WFSilverlightApplication4.xap"/>
    		<param name="onError" value="onSilverlightError" />
    		<param name="background" value="white" />
    		<param name="autoUpgrade" value="true" />
    		<param name="splashscreensource" value="Splash.xaml" />
    		<param name="onSourceDownloadProgressChanged" value="OnSourceDownloadProgressChanged" />
    		<param name="windowless" value="true" />		
    		<a href="http://go.microsoft.com/fwlink/?LinkID=149156&v=4.0.50401.0" style="text-decoration:none">
    		  <img src="http://go.microsoft.com/fwlink/?LinkId=161376" 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>
    ...
  6. Save the file and run the visualization in the web browser. The WEBfactory 2010 modules will now be displayed in the Silverlight visualization.