Installing the Web Client Software Factory

The Web Client Software Factory contains a variety of software assets, such as reusable code components, documentation, reference implementations, and tools, including wizards, code generators, and visual designers.

Summary of Installation Steps

Installing Web Client Software Factory - June 2007 release

Use the following steps to install the Web Client Software Factory and its prerequisites. These steps assume that you do not have a previous version of the factory installed.
  1. Install the Guidance Automation Extensions (February 2007) CTP Release.
  2. Install the Guidance Automation Toolkit (February 2007) CTP Release.
  3. Install the .NET Framework 3.0 and the Visual Studio 2005 Extensions for Windows WorkFlow Foundation.
  4. View the Web Client Software Factory Documentation (optional).
  5. Install the Web Client Software Factory - June 2007 release.

Upgrading from Web Client Software Factory - January 2007 release

The following steps describe how to upgrade from Web Client Software Factory - January 2007 release.
  1. Uninstall Web Client Software Factory - January 2007 release. To do this, go to Control Panel | Add or Remove Programs (Programs and Features in Windows Vista) and uninstall "Web Client Software Factory - January 2007".
  2. If you have a version of GAT/GAX different to the February 2007 CTP, you need to uninstall it. This will require you to uninstall all the guidance packages you have currently installed. See this post from Tom Hollander for uninstallation instructions. After uninstalling it, install Guidance Automation Extensions (February 2007) CTP Release and Guidance Automation Toolkit (February 2007) CTP Release.
  3. Install the Web Client Software Factory - June 2007 release.

Note: For instructions on how to enable existing Web client solutions (created with the Web Client Software Factory – January 2007 release) to use the guidance package provided in the June 2007 release, see Enabling January 2007 Solutions in the documentation.

--------------------------------------------------------------------------------------------------

To run the reference implementation you need to install two databases by running the SetUpDatabase.cmd script. To run the Guidance Package, you need to copy the Composite Web Application Block DLLs to the location with the Enterprise Library DLLs. This allows the recipes to create the references to these DLLs.
  • Run the MSI and install the WCSF Guidance Packages, Documentation, and Source Code Installer

To run the Reference Implementation

To install the databases in SQL Server Express
  • Run the SetUpDatabase.cmd script in the RI1\Scripts folder.
  • Build and run the reference implementation using the GlobalBank.Commercial.EBanking.sln.

To install the databases in SQL Server 2005 or SQL Server 2000
  • Edit the command file SetUpDatabase.cmd in the RI1\Scripts folder.
  • Locate the following line:
  SET serverName="(local)\SQLEXPRESS"
  • Replace the string "(local)\SQLExpress" with your SQL Server instance name. If you are using the default SQL Server instance, use "localhost".
  • Save and run the command file.
  • Open the solution file RI1\GlobalBank.Commercial.EBanking.sln.
  • Open the configuration file Web.config located in the WebUI Web site root folder.
  • Locate the <connectionStrings> section and update the Data Source parameter of the RI_SqlConnection and the PageFlowPersistanceStore connection strings to point to the SQL Server instance where you installed the reference implementation database.
  • Locate the <hostingWorkflowRuntime> section and update the connectionString parameter of the SqlWorkflowPersistenceService service configuration to point to the SQL Server instance where you installed the reference implementation database.
  • Build and run the reference implementation using the GlobalBank.Commercial.EBanking.sln.

To run the QuickStarts

  • Run the SetUpDatabase.cmd script in the ..WCSF Source\QuickStarts\Scripts folder to setup the SQLExpress database for the Reference Implementation

To install the database in SQL Server 2005 or SQL Server 2000
  • Edit the command file SetUpDatabase.cmd located in the script folder of the QuickStarts solution.
  • Replace all instances of the string "(local)\SQLExpress" with your SQL Server instance name. If you are using the default SQL Server instance, use "localhost".
  • Select the QuickStart that you want to Run
    • Module QuickStart: Compile and build the QuickStart using the ModuleQuickstart.sln in the WCSF Source\QuickStart\Module folder
    • Object Container Data Source Quickstart: Compile and build the QuickStart using the ObjectContainerDataSourceQuickstart.sln in the …WCSF Source\QuickStart\ObjectContainerDataSource folder
    • PageFlow QuickStart: Compile and build the QuickStart using the PageFlowQuickstart.sln in the …WCSF Source\QuickStart\PageFlow folder
    • PageFlow With Shopping Cart QuickStart: Compile and build the QuickStart using the PageFlowWithShoppingCartQuickstart.sln in the …WCSF Source\QuickStart\PageFlowWithShoppingCart folder
    • ViewPresenter QuickStart: Compile and build the QuickStart using the ViewPresenterQuickStart.sln…WCSF Source\QuickStart\ViewPresenter folder

To run the Recipes in the Guidance Package

  • Compile and build the Guidance Package
  • Using Visual Studio, open and build the solution file WebClientFactory Guidance Package.sln in the …WCSF Source\GPs\WebClientFactory folder
  • Use the Guidance Package Manager to enable the Guidance Package Development guidance package.

Note: You must do this before you can use the Register Guidance Package, Quick Register, 
and Unregister Guidance Package recipes.


Note: You can find the Guidance Package Manager under the Tools menu.

  • In Solution Explorer, right-click the project named WebClientFactoryPackage, and then click Register Guidance Package.
  • To test the Recipes were Successfully Registered
    • Open a new instance of Visual Studio. In this new instance, create a new project using using the WebClient Software Factory Solution template from the Web Client Software Factory Development guidance package to create a new solution.

To run the PageFlow Designer

The application block contains custom Windows Workflow activities that you can use to define your page flows. You drag these controls from the Toolbox onto the design surface to create a page flow definition.
  • To add the custom controls to the Visual Studio Toolbox
    • Open the Toolbox in Visual Studio and right-click the Data tab in the Toolbox and select Choose Items.
    • In the .NET Framework Components tab, click Browse. Navigate to the folder that contains the assembly Microsoft.Practices.PageFlow.WorkflowFoundation. dll, select the assembly and then click Open.
  • Select the PageActivity and TransitionListenerActivity controls in the list of components and click OK.

Last edited Jun 6, 2007 at 6:48 PM by blainew, version 1

Comments

No comments yet.