使用.NET程式集作為Business Data Connectivity資料來源（三）

 在這一系列的上一篇文章中，我們在Microsoft Visual Studio 2010中建立了BCS模型，並為我們的Department實體定義了 Finder，Specific Finder和ID Enumerator方法。本文將繼續擴充我們的BCS模型，看一看如何為Department實體定義Creator和Updater方法，讓使用者能夠在Department實體中插入/編輯記錄。

首先，開始建立我們的Creator方法。

1）右擊Department實體的Methods一節，並選擇“Add new Method”。

2）為方法起一個名字“AddDepartment”。 

接下來，我們要為該Creator方法建立參數。你需要定義所有希望出現在“建立項目”對話方塊中的欄位，作為Creator方法的輸入參數。該方法還需要一個返回參數，而且應為一個結構體，其中包含了該Department實體的標識符類資訊。 

 

3）在Department實體中選中AddDepartment方法，然後在BDC Method Details面板中點擊“<Add a Parameter>” 

4)本例中我們將建立3個方向為“In”的參數，分別名為“Name”，“GroupName”，“DepartmentId”。 

5)接下來我們需要修改每個參數的type descriptor屬性。在BDC Explorer視窗中展開樹狀檢視，找到這些參數的type descriptor。

這些type descriptor的屬性設定為：

 

DepartmentID:

Name: DepartmentId

TypeName: System.Int16

Identifier: DepartmentId

GroupName:

Name: GroupName

TypeName: System.String

CreatorField:True

Name:

Name: Name

TypeName: System.String

CreatorField: True

 

 

6) 現在我們需要為AddDepartment方法定義返回參數。該返回參數應為一個描述Department實體的標識符的結構體。

 

開啟DepartmentService.cs類，在Service類後面添加下列類： 

public class DepartmentSimple
{
    public short DepartmentId
    {
        get;
        set;
    }
}

 7）在BDC Method Details面板中為AddDepartment方法建立一個方向為"Return"的參數，命名為“returnParameter”

8)開啟BDC Explorer視窗，導航到AddDepartment方法的returnParameter參數，修改其type descriptor的屬性。

Name:DepartmentSimple

TypeName:BdcModelProject1.BdcModel1.DepartmentSimple,BdcModel1

9)右擊該DepartmentSimple類型描述器並選擇“Add Type Descriptor” 。設定屬性為：

Name:DepartmentId

TypeName:System.Int16

Identifier:DepartmentId

10) 參數和類型描述器定義好後如所示： 

11）接下來，我們需要為AddDepartment方法建立一個方法執行個體。在BDC Method Details面板中，點擊AddDepartment方法下的建立方法執行個體操作。按照所示設定其屬性： 

12）開啟DepartmentService.cs檔案，你會看到已經為你產生了一個AddDepartment方法。 用下列代碼替換該方法的代碼：

public static DepartmentSimple AddDepartment(string Name, string GroupName, short DepartmentId)
{
    DepartmentDataContext db = new DepartmentDataContext("server=localhost;database=adventureworks;uid=***;pwd=***");
    BdcModelProject1.Department createdEntity = new BdcModelProject1.Department
    {
        DepartmentID = DepartmentId,
        Name = Name,
        GroupName = GroupName,
        ModifiedDate = DateTime.Now
    };
    db.Departments.InsertOnSubmit(createdEntity);
    db.SubmitChanges();
    DepartmentSimple IdentifiersStruct = new DepartmentSimple
    {
        DepartmentId = DepartmentId,
    };
    return IdentifiersStruct;
}

13）重新編譯該項目並按“Ctrl+F5”鍵重新部署它。開啟你的SharePoint網站並建立一個基於該BCS外部內容類型的外部清單。選擇頂部的“項目”功能區，你會發現“建立項目”按鈕現在變為可用狀態。這樣，就說明我們上面定義的Creator方法沒問題，否則它是不可用狀態。 

14）點擊“建立項目”，將會彈出一個表單供我們插入資料。在第5步我們定義了輸入參數並且只在Name和GroupName上設定CreatorField=true，因此在該表單中我們僅看到Name和GroupName兩個欄位。如果你需要添加新的欄位，那麼你不但需要將其定義為輸入參數，還要設定Creator Field 為true。對於Department表，DepartmentId是自增的主鍵，因此我們沒有將其設定為Creator欄位，但如果你的主鍵不是自增的，那麼你也需要將其定義為一個Creator欄位。

 

單擊該表單中的儲存按鈕。 

15) 結果如下。

 

現在，讓我們來為我們的Department實體建立BCS Updater方法。 

 

16）右擊該Department實體的Methods一節，並選擇“Add new Method”。

17）為新方法起一個名字“UpdateDepartment”。 

我們需要為Updater方法建立輸入參數。

 

18）在BDC Method Details面板中，點擊UpdateDepartment方法下的添加參數操作，添加一個方向為“In”的參數。 

19）在BDC Explorer視窗中，展開樹狀檢視導航到該參數。選中該參數的type descriptor並修改其屬性如下：

Name:Departmet

TypeName:BdcModelProject1.BdcModel1.Department,BdcModel1

 

20)右擊Department類型描述器，為其添加兩個類型描述器並如下設定屬性：

DepartmentID:

Name:DepartmentId

TypeName:System.Int16

Identifier:DepartmentId

UpdaterField:True

 

GroupName:

Name:GroupName

TypeName:System.String

UpdaterField:True 

Name:

Name:Name

TypeName:System.String

UpdaterField:True  

 

注意：在本文中我們使用的Department表，其主鍵為自增的。為了保證updater方法正確執行，我們需要將上一篇中談到的Specific Finder方法的傳回值中的DepartmentId定義為唯讀。如所示：

21）至此，參數和類型描述器應如所示。如果你想要更新更多的欄位，先將其添加為類型描述器，再設定其UpdaterField=true即可。

22）我們需要為UpdateDepartment方法建立一個方法執行個體。在BDC Method Details面板中，點擊UpdateDepartment方法下的添加方法執行個體操作，添加一個方法執行個體並設定其方法執行個體類型為Updater。 

23）開啟Departmentservice.cs，找到自動產生的UpdateDepartment方法，用下面的代碼替換其代碼： 

public static void UpdateDepartment(Department parameter)
{
    DepartmentDataContext db = new DepartmentDataContext("server=localhost;database=adventureworks2000;uid=***;pwd=***");
    BdcModelProject1.Department updatedEntity = (from entity in db.Departments
                                 where entity.DepartmentID == parameter.DepartmentId
                                 select entity).FirstOrDefault<BdcModelProject1.Department>();
    updatedEntity.Name = parameter.Name;
    updatedEntity.GroupName = parameter.GroupName;
    db.SubmitChanges();
}

24）重新編譯該項目，按“Ctrl+F5”鍵重新部署。開啟你的SharePoint網站，由於我們在Department實體中添加了新的方法，因此需要刪除前面建立的外部清單，並重新建立。 建立好後，隨便選中一條記錄，你會看到“編輯項目”按鈕變為可用狀態。由於我們為BCS模型正確的配置了updater方法，現在我們可以編輯記錄了。 

25）點擊“編輯項目”，在彈出的表單中你將看到Name和GroupName兩個欄位，可供我們進行更新。修改一下名稱，並點擊儲存。

26）更新後的結果。

 

希望本文對你有用。在接下來的文章中我們將一起探討如何用Visual Studio 2010在兩個外部內容類型之間建立BCS關聯。

 

參考資料

bcs creator and updater methods for dot net assembly 

How to: Add a Creator Method

Designing a Business Data Connectivity Model