和我一起學Windows Workflow Foundation(微軟工作流)

在這一節，我們一起學習通過其他程式呼叫工作流，並且在工作流啟動時給工作流傳遞一些資料，使其在工作流中使用。

在workflow開始執行時，我們有兩種方式給工作流傳遞資料------引數和事件。今天，我們先說說怎樣通過引數來給工作流傳遞資料。

需要傳遞給workflow的引數，我們需要先在工作流中通過屬性來進行設定，而後在其他程式呼叫這個工作流建立一個工作流的例項時，通過 Dictionary<string, object>鍵值集合進行傳遞，如下：

繼續使用我們上一節用到的程式碼，給Workflow1 類新增兩個屬性FirstName和LastName

這裡我們將通過其他應用程式傳遞fristName和lastName並讓這兩個值在工作流執行過程中以對話方塊的形式顯示出來。

因為我們上一節中建立的是個控制檯應用程式，所以讓起彈出對話方塊需要應用System.Windows.Forms程式集。

然後修改我們的Workflow1類中的codeActivity1_CodeHandler

現在我們已經修改好我們要做的工作流程式碼了。

下面我們要建立一個winForm應用程式。

新增一個新的專案WinFormTestHost。

接下來我們要確認我們新建立的專案WinFormTestHost能夠呼叫工作流Workflow1。

給WinFormTestHost新增引用，引用專案HelloWorldWorkflow.

同時，我們還要讓我們的這個winfrom應用程式引用wwf程式集。繼續新增引用，選擇.net選項卡，新增如下三項：

System.Workflow.Activities

System.Workflow.ComponentModel

System.Workflow.Runtime

修改我們的Form1窗體。

新增兩個Label分別為Label1和Label2，Text屬性分別為First name和 LastName。

新增兩個TextBox分別為txtFirstName和txtLastName。

新增一個按鈕btnStartWorkflow，用來啟動我們的工作流，Name屬性為btnStartWorkflow，Text屬性為Start Workflow。

這個簡單的窗體就做完了，我們來新增程式碼。

首先在我們的類Form1.cs中新增工作流執行時宣告:

雙擊btnStartWorkflow新增事件處理程式。

最後給FormClosed事件新增一段程式碼，使其在關閉窗體時關閉工作流

現在，我們的程式就開發完成了，點選F5，將開啟窗體：

我們輸入名稱後點Start Workflow,將彈出窗體：

這個窗體是在Workflow1中執行的，同時，我們也看到，在winfrom窗體中輸入的值成功的傳遞到了工作流中。

上一節我們學習了怎樣通過引數傳遞資料，這節我們就說說通過事件傳遞資料的方法，由於這節除了我們自己寫的一部分程式碼外，還需要用到另外需要觸發事件的ExpenseApplication外部應用程式和所用事件示例程式碼，所以請下載示例程式原始碼，根據需要新增專案的引用。

另外，我們將學習到怎樣使用if/else 根據條件處理工作流 ，還將學習根據定製活動有條件的處理工作流。我們將在製作一個簡單的處理費用支出報表的工作流中學習到這些概念。當工作流在報表資料提交的時候將接收到一個事件，這個事件的引數將把包含實際的費用支出報表資料提交到程式。如果報表的支出費用少於1000，工作流將自動提交，否則，將自動拒絕。

首先，建立一個名稱為ExpenseWorkflows的空工作流專案。

新增一個含有單獨程式碼的順序工作流。預設名稱就叫Workflow1.xoml

我們將使用HandleExternalEvent 和 CallExternalMethod 這兩個活動來和支出報表建立聯絡，在這之前，先給我們的解決方案新增一個現有專案ExpenseLocalServices（從下載的原始碼中可以找到這個專案），然後給我們的專案ExpenseWorkflows新增一個引用，引用這個現有專案。

新增提交支出報表的活動

1. 在Workflow1這個類中我們需要新增兩個成員變數供將來使用，一個變數名稱為reportArgs，用於接收報表提交這個事件的引數物件。另外一個變數將儲存報表的支出費用。

(Snippet: Lab01_Ex03_Task03_MemberVariables)

public partial class Workflow1 : SequentialWorkflowActivity

{

public ExpenseLocalServices.ExpenseReportSubmittedEventArgs reportArgs =

default(ExpenseLocalServices.ExpenseReportSubmittedEventArgs);

public int amount = default(System.Int32);

}

2. 開啟workflow1.xoml的設計檢視。

3. 從工具箱中找到HandleExternalEvent 這個活動拖拽到我們的工作流設計檢視中，將其Name屬性設定為expenseReportSubmitted1。如圖：

4. 點選紅色的歎號選擇Property ‘InterfaceType’ is not set.來設定InterfaceType屬性。

5. 點選[…]按鈕將出現 .NET Type Browser 對話方塊。從引用程式集目錄樹中選擇 ExpenseLocalServices.IExpenseService 。如下圖所示：

6．現在我們的工作流設計檢視expenseReportSubmitted1上還有一個歎號，是因為我們的EventName還沒有設定。同樣點選它，設定EventName屬性。點選下拉選單框，選擇ExpenseReportSubmitted。

7．繼續設定expenseReportSubmitted1的屬性，找到e這個屬性，點[…]按鈕，選擇Bind to an existing member選項卡下的Workflow1---reportArgs.也就是把這個提交事件的e引數和我們定義的成員變數reportArgs繫結。

8．雙擊設計檢視中的expenseReportSubmitted1建立Invoked事件。

(Snippet: Lab01_Ex03_Task03_ReportSubmittedInvoked)

public void ReportSubmitted_Invoked(object sender, EventArgs e)

{

Console.WriteLine("ReportSubmitted_Invoked");

//給我們的成員變數amount設定事件觸發得到的值

this.amount = this.reportArgs.Report.Amount;

}

新增自動審批活動到我們的工作流

1. 我們將新增一個定製活動（我們還沒學到怎麼定製活動，所以先直接引用做好的定製活動吧，在下載的原始碼裡的ExpenseActivities，可以看一下，其實很容易理解，就象我們做定製控制元件。：））來判斷所做的提交是否進行自動審批。

2. 單擊工具|選擇工具箱項

3. 選擇 .NET Framework元件 選項卡並單擊瀏覽…

4. 導航到我們程式碼原始檔的ExpenseWorkflows/ExpenseActivities/bin/Debug/ExpenseActivities.dll.將其新增。

5. 現在我們的工具箱會多一個新的選項卡叫做ExpenseActivities，裡面有兩個新的活動：AutoApprove 和 GetManager。

6. 現在把我們把一個新的定製活動AutoApprove拖拽到我們的工作流設計檢視。

7. 現在我們的工作流設計檢視有兩個活動，如圖：

8. 在設計檢視中選擇活動autoApprove1 ，設定其Amount屬性,繫結到Workflow1.amount。

給工作流新增條件

1． 從工具箱中找到IfElse活動拖拽到設計檢視中autoApprove1的下面。

2． 將其（Name）屬性設定為EvaluateExpenseReport。

3． 選擇IfElse左邊活動分支設定：（Name屬性設定為IfAutoApproveReport；Condition屬性設定為Declaritive Rule Condition。

4． 展開Condition的“＋”，設定其中的ConditionName屬性為AutoApproveCondition。

5． 對Expression屬性編輯表示式：this.autoApprove1.Approved。如圖：

6． 選擇EvaluateExpenseReport右邊的活動分支將其(Name)屬性改為ElseRejected.

給支出報表是否通過新增邏輯判斷

1. 從工具箱中選擇CallExternalMethod活動新增到標籤為IfAutoApproveReport的條件分支裡面，設定這個活動（Name）屬性為approveExpenseReport1。

2. 象上面我們設定HandleExternalEvent活動時一樣，我們把InterfaceType屬性按照相同的方法設定成ExpenseLocalService.IExpenseService。

3. MethodName屬性選擇下拉選單框中的ApproveExpenseReport方法。

4. 同樣的，我們還要設定properties屬性，選擇report，設定如下所示：

5. 現在，左邊的IfAutoApproveReport條件分支我們配置完畢了。接下來配置右邊的條件分支ElseRejected。

6. 新增另一個CallExternalMethod活動到ElseRejected，設定Name屬性為rejectExpenseReport1。

7. 選擇InterfaceType屬性設定為：ExpenseLocalService.IExpenseService。

8. 選擇MethodName屬性設定為：RejectExpenseReport。

9. 選擇Report屬性繫結到：reportArgs.Report.

10. 現在我們的工作流設計檢視如圖所示：

除錯工作流

到現在，我們的工作流就做完了。接下來我們要除錯它，看他的執行過程。

不過，這裡我們還需要藉助兩個專案，來觸發我們所做的工作流事件。

1．進入ExpenseWorkflows/ExpenseHost/bin/Debug目錄，複製ExpenseHost.exe 和ExpenseHost.exe.config到我們的專案檔案目錄：ExpenseWorkflows/ExpenseWorkflows/bin/Debug。

還有ExpenseWorkflows/ExpenseApplication/這個專案（一會除錯用）。

2． 現在需要配置我們的ExpenseWorkflows專案，將其設定為啟動專案，然後右擊專案選擇屬性，選擇除錯，在啟動操作選擇“啟動外部程式”，瀏覽到ExpenseWorkflows/ExpenseWorkflows/bin/Debug/ExpenseHost.exe。

3． 現在可以按Ｆ５啟動除錯了，當然，為了看整個專案的執行過程，我們可以給各個工作流和其他感興趣的位置設定斷點來詳細學習工作流的執行過程。

Task 7 – Test the Expense Reporting Workflow

測試支出報表工作流

1. Compile and run the ExpenseWorkflows project under the Visual Studio debugger by pressing F5 or selecting the Debug | Start Debugging menu command.

2. 點F5啟動除錯，將顯示如下介面，執行ExpenseHost命令列程式。

4． 執行 ExpenseApplication.exe （在如下目錄：ExpenseWorkflows/ExpenseApplication/bin/Debug）。

我們提交一條報表資料，金額填寫了1500，

5． 在VS2005給活動 expenseReportSubmitted1設定斷點

6． 然後單步執行可以看到 ReportSubmitted_Invoked 事件處理的程式碼.

7． 繼續單步執行到活動 rejectExpenseReport1 。

8． 看到我們的支出報表請求被拒絕了，這裡會呼叫方法我們設定的RejectExpenseReport來更新剛才我們的那條report記錄，將起狀態設定為拒絕。

9． 我們可以看到應用程式狀態

10． 點選Refresh Reports 

 變成了拒絕（Rejected）。

11． 如果輸入小於1000的數，會看到

12． 狀態為通過。

大家可以仔細閱讀一下這些專案的程式碼，然後除錯一遍，應該就能瞭解其中工作的過程和工作流中HandleExternalEventActivity和CallExternalMethodActivity的使用方法了。

(4)-----使用Listen,Delay,和其他envnt-based定製活動

using System;
using System.Workflow.Activities;
using System.Workflow.ComponentModel;
using System.Workflow.ComponentModel.Compiler;
using System.Text.RegularExpressions;
using System.Net.Mail;
namespace SendMailActivityLibrary
{
public
			class ParametersValidator : ActivityValidator
{
}
}

public
			override ValidationErrorCollection ValidateProperties(ValidationManager manager, object obj)
{
ValidationErrorCollection validationErrors = new ValidationErrorCollection(base.ValidateProperties (manager, obj));
SendMailActivity sendMailActivityToBeValidated = obj as SendMailActivity;
if (sendMailActivityToBeValidated == null)
{
throw
			new InvalidOperationException("Parameter obj is not of type SendMailActivity");
}
if (!IsValidEmailAddress(sendMailActivityToBeValidated.To))
{
ValidationError CustomActivityValidationError =
new ValidationError(String.Format("/'{0}/' is an Invalid destination e-mail address", sendMailActivityToBeValidated.To), 1);
validationErrors.Add(CustomActivityValidationError);
}
if (!IsValidEmailAddress(sendMailActivityToBeValidated.From))
{
ValidationError CustomActivityValidationError =
new ValidationError(String.Format("/'{0}/' is an Invalid source e-mail address", sendMailActivityToBeValidated.From), 1);
validationErrors.Add(CustomActivityValidationError);
}
return validationErrors;
}
public Boolean IsValidEmailAddress(String address)
{
// must only proceed with validation if we have data    
			// to validate
			if (address == null || address.Length == 0)
return
			true;
Regex rx = new Regex(@"[^A-Za-z0-9@/-_.]", RegexOptions.Compiled);
MatchCollection matches = rx.Matches(address);
if (matches.Count > 0)
return
			false;
// Must have an '@' character
			int i = address.IndexOf('@');
// Must be at least three chars after the @
			if (i <= 0 || i >= address.Length - 3)
return
			false;
// Must only be one '@' character
			if (address.IndexOf('@', i + 1) >= 0)
return
			false;
// Find the last . in the address
			int j = address.LastIndexOf('.');
// The dot can't be before or immediately after the @ char
			if (j >= 0 && j <= i + 1)
return
			false;
return
			true;
}