Installing the Web Client Software Factory - June 2007

If you want to use all the assets in the Web Client Software Factory, you need to install the prerequisites which include Microsoft Visual Studio 2005 (C#, Visual Basic .NET, and Web Developer), Visual Studio 2005 Service Pack 1 (SP1), and Guidance Automation Extensions. You may also decide to install the optional components which include Enterprise Library 3.1, .NET Framework 3.0, Visual Studio 2005 extensions for .NET framework 3.0 for Windows Workflow Foundation, and Guidance Automation Toolkit.

Note: For directions on how to upgrade from the Web Client Software Factory June 2006 release see How to upgrade from the Web Client Software Factory January 2007.
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.

Summary of Installation Steps


Installation Steps

Use the following steps to install the Web Client Software Factory and its prerequisites:
Note: If you are in the evaluation stage, and you only want to review the documentation and source code, you do not need to download the dependencies.

Install the Web Client Software Factory


WCSFSplash.png

Install Web Client Software Factory dependencies

  • Select the Check dependencies button from the splash screen (optional)
  • Select Next to install the factory from the Installer splash screen


DependencyChecker.PNG

Install Web Client Software Factory components

  • Download any required components that are not on your machine (optional)
  • Download the optional components that are not on your machine (optional)


CustomSetup.png
  • Note: If you want to install the documentation or source code, you do not need to install the prerequisites.
  • Note: You should download the Guidance Automation Toolkit if you want to modify the guidance package included in the factory.
  • Note: Download the Visual Studio 2005 extensions for .NET framework 3.0 if you want to run the reference implementaiton or create an application that uses Page Flow.

Install Web Client Software Factory Source code

Once you install the Windows Installer for Factory Source Code, you can install the source code.

SourceInstaller.png

  • Select the All Programs from the Start menu
  • Select the Microsoft patterns & practices
  • Select Web Client Software Factory - 2007
  • Select Web Client Software Factory 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 Feb 27, 2008 at 7:55 PM by blainew, version 18

Comments

sheir Feb 22, 2008 at 4:29 PM 
There is a new version of GAX and GAT available for VS2008.
http://blogs.msdn.com/tomholl/archive/2008/02/16/gosh-gat-gax-is-golden.aspx?CommentPosted=true#commentmessage

sheir Feb 21, 2008 at 7:25 PM 
I manage to get the WCSF solution to compile with VS2008 but now when
I try the step "To test the Recipes were Successfully Registered";
the create a new project using using the WebClient Software Factory Solution template from the Web Client Software Factory Development guidance package
does not show up.

Any ideas?

blaze Oct 2, 2007 at 3:50 AM 
Please help!

I am getting this error when attempting to build the solution in the instructions of the section "To run the Recipes in the Guidance Package "

C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\Microsoft.Common.targets : warning MSB3245: Could not resolve this reference. Could not locate the assembly "Microsoft.Practices.RecipeFramework.Library, Version=1.2.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a, processorArchitecture=MSIL". Check to make sure the assembly exists on disk. If this reference is required by your code, you may get compilation errors.

blaze Oct 1, 2007 at 4:19 AM 
Hi,
I am trying to buld the sln in the …WCSF Source\GPs\WebClientFactory folder as described above and it is failing. where can I post the output of the build errors to get some help.
Thank You!

Livrish Jul 20, 2007 at 2:51 AM 
i had the same problem which i think comes from installing the latest version for the GAT GAC.
I fixed it by changing the specific version attrubute in the properties of the reference in VS 2005
haven't tested it yet but I hope that works

sanguedemonstro Jun 12, 2007 at 1:46 PM 
well, if some body has the same problem, my work around: edit file "devenv.exe.config" add the follow content:




<configuration>
<runtime>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<probing privatePath="PublicAssemblies;PrivateAssemblies"/>
<dependentAssembly>
<assemblyIdentity name="Microsoft.Practices.RecipeFramework.Common" publicKeyToken="b03f5f7f11d50a3a" culture="neutral"/>
<bindingRedirect oldVersion="1.0.60429.0" newVersion="1.2.0.0"/>
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Microsoft.Practices.ComponentModel" publicKeyToken="b03f5f7f11d50a3a" culture="neutral"/>
<bindingRedirect oldVersion="1.0.60429.0" newVersion="1.2.0.0"/>
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Microsoft.Practices.Common" publicKeyToken="b03f5f7f11d50a3a" culture="neutral"/>
<bindingRedirect oldVersion="1.0.60429.0" newVersion="1.2.0.0"/>
</dependentAssembly>
<dependentAssembly>
<assemblyIdentity name="Microsoft.Practices.RecipeFramework" publicKeyToken="b03f5f7f11d50a3a" culture="neutral"/>
<bindingRedirect oldVersion="1.0.60429.0" newVersion="1.2.0.0"/>
</dependentAssembly>
</assemblyBinding>
</runtime>
</configuration>


// again, sorry about my bad english... :)

sanguedemonstro Jun 12, 2007 at 12:52 PM 
hi, i just download this last WCSF june release candidate, uninstall all requisites, and then reinstall the new version of WCSF and new version of requesites...
all good!
but!
File / New / project / Web Client Solution (Web Site) (C#) - an error come out:

Microsoft.Practices.RecipeFramework.ActionExecutionException: An exception occurred during the binding of reference or execution of recipe BindingRecipe. Error was: Action CreatePageFlowRefCS failed to execute:
Could not load file or assembly 'Microsoft.Practices.RecipeFramework.Common, Version=1.0.60429.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a' or one of its dependencies. O sistema não pode encontrar o arquivo especificado..
You can remove the reference to this recipe through the Guidance Package Manager. ---> System.IO.FileNotFoundException: Could not load file or assembly 'Microsoft.Practices.RecipeFramework.Common, Version=1.0.60429.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a' or one of its dependencies.


--------
i've found the dll BUT with other version (Assembly Version 1.2.0.0 File Version 1.2.0.3) at C:\Arquivos de programas\Microsoft Visual Studio 8\Common7\IDE\PublicAssemblies ..
that dll come from GAX installation (the last one)....


some body??? help!?
// sorry about my english..