逐步解說：使用商務資料在 SharePoint 中建立外部清單

商務資料連接 (BDC) 服務可讓 SharePoint 顯示後端伺服器應用程式、Web 服務和資料庫中的商務資料。

本逐步解說將示範如何為傳回範例資料庫中聯絡人相關資料的 BDC 服務建立模型， 然後您將使用此模型在 SharePoint 中建立外部清單。

這個逐步解說將說明下列工作：

• 建立專案。

• 在模型中新增實體。

• 加入搜尋方法。

• 加入特定搜尋方法。

• 測試專案。

必要條件

您需要下列元件才能完成此逐步解說：

• 支援的 Microsoft Windows 和 SharePoint 版本。 如需詳細資訊，請參閱開發 SharePoint 方案的要求。

• Visual Studio 2010 Professional 或某個 Visual Studio Application Lifecycle Management (ALM) 版本。

• AdventureWorks 範例資料庫的存取權限。 如需如何安裝 AdventureWorks 資料庫的詳細資訊，請參閱 SQL Server 範例資料庫 (英文)。

建立專案

首先，請建立包含 BDC 模型的專案。

若要建立專案

1. 啟動 Visual Studio 2010。

2. 開啟 [新增專案] 對話方塊、在您要使用的語言下展開 [SharePoint] 節點，然後按一下 [2010]。

3. 在 [範本] 窗格中，選取 [商務資料連接模型]， 將專案命名為 AdventureWorksContacts，然後按一下 [確定]。

   [SharePoint 自訂精靈] 隨即出現。 這個精靈可讓您選取用來偵錯專案的網站以及方案的信任層級。

4. 按一下 [完成] 以接受預設的本機 SharePoint 網站，以及方案的預設信任層級。

在專案中加入資料存取類別

若要在專案中加入資料存取類別

1. 在 [工具] 功能表上，按一下 [連接至資料庫]。

   [加入連接] 對話方塊隨即開啟。

2. 加入 SQL Server AdventureWorks 範例資料庫的連接。 如需詳細資訊，請參閱 新增/修改連接 (Microsoft SQL Server)。

3. 在 [方案總管] 中，按一下專案節點。

4. 按一下 [專案] 功能表上的 [加入新項目]。

5. 在 [已安裝的範本] 窗格中選取 [資料] 節點。

6. 在 [範本] 窗格中選取 [LINQ to SQL 類別]。

7. 在 [名稱] 方塊中輸入 AdventureWorks，然後按一下 [加入]。

   專案中隨即加入一個 .dbml 檔，並開啟物件關聯式設計工具 (O/R 設計工具)。

8. 在 [檢視] 功能表上按一下 [伺服器總管]。

9. 在 [伺服器總管] 中展開表示 AdventureWorks 範例資料庫的節點，然後再展開 [資料表] 節點。

10. 將 [Contact (Person)] 資料表拖曳到 O/R 設計工具上。

    實體類別隨即建立並出現在設計介面上。 這個實體類別的屬性會對應至 [Contact (Person)] 資料表中的資料行。

從 BDC 模型中移除預設實體

[商務資料連線模型] 專案會將名為 Entity1 的預設實體新增至模型， 請移除這個實體。 稍後，您將加入新的實體。 在一開始就使用空模型，可減少完成逐步解說所需的步驟數目。

若要從模型中移除預設實體

1. 在 [方案總管] 中展開 [BdcModel1] 節點，然後按兩下 [BdcModel1.bdcm] 檔案。

2. 商務資料連接模型檔案隨即在 [BDC 設計工具] 中開啟。

3. 在設計工具中以滑鼠右鍵按一下 [Entity1]，然後按一下 [刪除]。

4. 在 [方案總管] 中以滑鼠右鍵按一下 Entity1.vb (使用 Visual Basic 時) 或 Entity1.cs (使用 C# 時)，然後按一下 [刪除]。

5. 以滑鼠右鍵按一下 Entity1Service.vb (使用 Visual Basic 時) 或 Entity1Service.cs (使用 C# 時)，然後按一下 [刪除]。

在模型中新增實體

將模型新增至實體。 您可以將實體從 Visual Studio [工具箱] 拖曳至 BDC 設計工具上。

若要在模型中新增實體

1. 在 [檢視] 功能表上，按一下 [工具箱]。

2. 從 [工具箱] 的 [BusinessDataConnectivity] 索引標籤中，把一個實體拖曳至 BDC 設計工具。

   新實體隨即出現在設計工具中。 Visual Studio 會將檔案加入至名為 EntityService.vb (使用 Visual Basic 時) 或 EntityService.cs (使用 C# 時) 的專案。

3. 在 [檢視] 功能表中，按一下 [屬性視窗]。

4. 在 [屬性視窗] 中，將 [名稱] 設定為 Contact。

5. 在設計工具中，以滑鼠右鍵按一下實體，再按一下 [加入]，然後按一下 [識別項]。

   新識別項隨即出現在實體上。

6. 在 [屬性視窗] 中，將識別項的名稱變更為 ContactID。

7. 在 [型別名稱] 下拉式清單中，選取 [System.Int32]。

加入特定搜尋方法

若要讓 BDC 服務顯示特定的連絡人，您必須加入「特定搜尋」方法。 當使用者在清單中選取項目，然後按一下 [功能區] 中的 [檢視項目] 按鈕時，BDC 服務便會呼叫特定搜尋方法。

請使用 [BDC 方法詳細資料] 視窗，在 Contact 實體中加入特定搜尋方法。 若要傳回特定實體，請在方法中加入程式碼。

若要加入特定搜尋方法

1. 在 BDC 設計工具上選取 [Contact] 實體。

2. 按一下 [檢視] 功能表上的 [其他視窗]，然後按一下 [BDC 方法詳細資料]。

3. 在 [BDC 方法詳細資料] 視窗的 [新增方法] 下拉式清單中，選取 [建立特定搜尋方法]。

   Visual Studio 會將下列項目加入至模型。 這些項目會顯示在 [BDC 方法詳細資料] 視窗中。

   • 名為 ReadItem 的方法。

   • 此方法的輸入參數。

   • 方法的傳回參數。

   • 各個參數的型別描述元。

   • 此方法的方法執行個體。

4. 在 [BDC 方法詳細資料] 視窗中，按一下針對 [Contact] 型別描述元而顯示的下拉式清單，然後按一下 [編輯]。

   [BDC 總管] 隨即開啟。 [BDC 總管] 可讓您以階層方式檢視模型。

5. 在 [屬性] 視窗中按一下出現在 [TypeName] 屬性旁邊的下拉式清單，按一下 [目前專案] 索引標籤，然後選取 [連絡人]。

6. 在 [BDC 總管] 中，以滑鼠右鍵按一下 [連絡人]，然後按一下 [加入型別描述元]。

   名為 [TypeDescriptor1] 的新型別描述元隨即在 [BDC 總管] 中顯示。

7. 在 [屬性視窗] 中，將 [名稱] 屬性設定為 ContactID。

8. 按一下 [TypeName] 屬性旁邊的下拉式清單，然後選取 [Int32]。

9. 按一下 [Identifier] 屬性旁邊的下拉式清單，然後選取 [ContactID]。

10. 重複步驟 6，為下列各個欄位建立型別描述元。

    名稱	型別名稱
    FirstName	System.String
    LastName	System.String
    Phone	System.String
    EmailAddress	System.String
    EmailPromotion	System.Int32
    NameStyle	System.Boolean
    PasswordHash	System.String
    PasswordSalt	System.String

11. 在 BDC 設計工具的 [Contact] 實體上，按兩下 [ReadItem] 方法。

    Contact 服務程式碼檔案隨即在 [程式碼編輯器] 中開啟。

12. 在 ContactService 類別中，使用下列程式碼取代 ReadItem 方法。 這個程式碼會執行下列工作：

    • 從 AdventureWorks 資料庫的 [連絡人] 資料表擷取記錄。

    • 將 Contact 實體傳回至 BDC 服務。

    注意事項
    將 ServerName 欄位的值替換成您的伺服器名稱。

    Public Shared Function ReadItem(ByVal contactID As Integer) As Contact
        Const ServerName As String = "MySQLServerName"
        Dim dataContext As AdventureWorksDataContext = _
            New AdventureWorksDataContext("Data Source=" & ServerName & _
                ";Initial Catalog=AdventureWorks;Integrated Security=True")
    
        Dim Contact As Contact = _
            (From TempContacts In dataContext.Contacts.AsEnumerable().Take(20) _
            Where TempContacts.ContactID = contactID _
            Select TempContacts).[Single]()
        Return Contact
    End Function
    

    public static Contact ReadItem(int contactID)
    {
        const string ServerName = "MySQLServerName";
        AdventureWorksDataContext dataContext = new AdventureWorksDataContext
              ("Data Source=" + ServerName + ";" +
               "Initial Catalog=AdventureWorks;Integrated Security=True");
    
        Contact Contact =
            (from contacts in dataContext.Contacts.AsEnumerable().Take(20)
             where contacts.ContactID == contactID
             select contacts).Single();
        return Contact;
    }
    

加入搜尋方法

若要讓 BDC 服務顯示清單中的連絡人，您必須加入搜尋方法。 請使用 [BDC 方法詳細資料] 視窗，在 Contact 實體中加入搜尋方法。 若要將實體集合傳回至 BDC 服務，請在方法中加入程式碼。

若要加入搜尋方法

1. 在 BDC 設計工具中選取 [Contact] 實體。

2. 在 [BDC 方法詳細資料] 視窗中，摺疊 [ReadList] 節點。

3. 從在 [ReadList] 方法下方顯示的 [加入方法] 下拉式清單中，選取 [建立搜尋方法]。

   Visual Studio 會加入方法、傳回參數以及型別描述元。

4. 在 BDC 設計工具中按一下 [Contact] 實體，然後按兩下 [ReadList] 方法。

   Contact 服務程式碼檔案隨即在 [程式碼編輯器] 中開啟。

5. 在 ContactService 類別中，使用下列程式碼取代 ReadList 方法。 這個程式碼會執行下列工作：

   • 從 AdventureWorks 資料庫的 [連絡人] 資料表擷取資料。

   • 將 Contact 實體清單傳回至 BDC 服務。

   注意事項
   將 ServerName 欄位的值替換成您的伺服器名稱。

   Public Shared Function ReadList() As IEnumerable(Of Contact)
       Const ServerName As String = "MySQLServerName"
       Dim dataContext As AdventureWorksDataContext = _
           New AdventureWorksDataContext("Data Source=" & ServerName & _
               ";Initial Catalog=AdventureWorks;Integrated Security=True")
   
       Dim Contacts As IEnumerable(Of Contact) = _
           From TempContacts In dataContext.Contacts.Take(20) _
                 Select TempContacts
       Return Contacts
   End Function
   

   public static IEnumerable<Contact> ReadList()
   {
       const string ServerName = "MySQLServerName";
       AdventureWorksDataContext dataContext = new AdventureWorksDataContext
             ("Data Source=" + ServerName + ";" +
              "Initial Catalog=AdventureWorks;Integrated Security=True");
   
       IEnumerable<Contact> Contacts =
           from contacts in dataContext.Contacts.Take(20)
           select contacts;
       return Contacts;
   
   }
   

測試專案

在您執行專案時，SharePoint 網站隨即開啟，而 Visual Studio 則會將您的模型加入至「商務資料連接」服務。 請在 SharePoint 中建立會參考 Contact 實體的外部清單。 AdventureWorks 資料庫中的連絡人資料會顯示在清單中。

注意事項
在可以對方案進行偵錯之前，您可能需要修改 SharePoint 中的安全性設定。 如需詳細資訊，請參閱設計商務資料連接模型。

若要測試專案

1. 請按 F5。

   SharePoint 網站隨即開啟。

2. 在 [網站動作] 功能表上，按一下 [更多選項]。

3. 按一下 [建立] 頁面中的 [外部清單]，然後按一下 [建立]。

4. 將自訂清單命名為 Contacts。

5. 按一下 [外部內容類型] 欄位旁的瀏覽按鈕。

6. 在 [外部內容類型選擇器] 對話方塊中，選取 [AdventureWorksContacts.BdcModel1.Contact]，然後按一下 [建立]。

7. 按一下 [建立] 建立連絡人清單。

   SharePoint 會建立外部清單， AdventureWorks 範例資料庫中的連絡人資料會在該清單中顯示。

8. 若要測試特定搜尋方法，請按一下清單中的連絡人。

9. 按一下 [功能區] 上的 [項目] 索引標籤。

10. 按一下 [項目] 索引標籤中的 [檢視項目]。

    您選取之聯絡人的詳細資料會顯示在表單上。

後續步驟

您可以透過下列主題，進一步了解如何在 SharePoint 中設計 BDC 服務的模型：

• HOW TO：加入建立者方法

• HOW TO：加入更新者方法

• HOW TO：加入刪除者方法

請參閱

概念

BDC 模型設計工具概觀

其他資源

設計商務資料連接模型

建立商務資料連接模型

將商業資料整合至 SharePoint