設計商務資料連線模型

您可以將實體和方法新增至模型檔案，以開發商務資料連線 (BDC) 服務的模型。 實體可描述資料欄位的集合。 例如，實體可代表資料庫中的資料表。 方法會執行工作，例如新增、刪除或更新實體所代表的資料。 如需詳細資訊，請參閱將商務資料整合至 SharePoint。

新增實體

您可以將 [實體] 從 Visual Studio [工具箱] 拖曳或複製到 BDC 設計工具，即可新增實體。 如需詳細資訊，請參閱如何：將實體新增至模型。

定義類別中實體的欄位。 例如，您可以將名為 Address 的欄位新增至 Customer 類別。 您可以將新類別新增至專案，或使用其他工具建立的現有類別，例如物件關聯式設計工具 (O/R 設計工具)。 實體的名稱和表示實體的類別名稱不一定相符。 當您在模型中定義方法時，您會將類別關聯至實體。

新增方法

當使用者檢視、新增、更新或刪除以模型為基礎的清單或 Web 組件中的資訊時，BDC 服務會呼叫模型中的方法。 您必須為使用者可以執行的每個工作，將方法新增至模型。 從 [BDC 方法詳細資料] 視窗中選取五種基本方法類型中的任何一種，以建立方法。 下表描述 BDC 模型的五種基本方法。

方法	描述
搜尋工具	傳回實體執行個體的集合。 當使用者開啟清單或 Web 組件時呼叫。 如需詳細資訊，請參閱如何：新增搜尋工具方法。
特定搜尋	傳回特定實體執行個體。 當使用者檢視清單中特定項目的詳細資料時呼叫。 如需詳細資訊，請參閱如何：新增特定搜尋工具方法。
建立者	將新資料新增至實體的資料來源。 當使用者選擇以模型為基礎的清單功能區上的 [新增項目] 按鈕時呼叫。 如需詳細資訊，請參閱如何：新增建立者方法。
更新者	修改清單中的資料。 當使用者更新清單中的資訊時呼叫。 如需詳細資訊，請參閱如何：新增更新者方法。
刪除者	移除資料。 當使用者從清單中刪除項目時呼叫。 如需詳細資訊，請參閱如何：新增刪除者方法。

定義方法參數

當您建立方法時，Visual Studio 會新增適用於方法類型的輸入和輸出參數。 這些參數只是預留位置。 在大部分情況下，您必須修改參數，使其傳入或傳回正確的資料類型。 例如，根據預設，搜尋工具方法會傳回字串。 在大部分情況下，您想要修改搜尋工具方法的傳回參數，使其傳回實體的集合。 您可以藉由修改參數的類型描述元來完成此作業。 類型描述元是描述參數資料類型的屬性集合。 如需詳細資訊，請參閱如何：定義參數的類型描述元。

Visual Studio 可讓您在模型中的參數之間複製類型描述元。 例如，您可以為 GetCustomer 方法的傳回參數定義名為 CustomerTD 的類型描述元。 您可以在 [BDC 總管] 中複製 CustomerTD 類型描述元，然後將該類型描述元貼到 CreateCustomer 方法的輸入參數。 這可防止您多次定義相同的類型描述元。

方法執行個體

當您建立方法時，Visual Studio 會新增預設方法執行個體。 方法執行個體是方法的參考，加上參數的預設值。 單一方法可以有多個方法執行個體。 每個執行個體都是方法簽章和一組預設值的組合。 如需詳細資訊，請參閱如何：定義參數的類型描述元。

當您執行專案時，方法執行個體會出現在 SharePoint 清單上方的下拉式清單中。 使用者可以選擇方法執行個體來檢視資料。

若要將預設值新增至方法執行個體，您必須直接修改模型的 XML。 如需詳細資訊，請參閱 DefaultValue。

新增篩選描述元

模型的取用者可能想要擷取符合某些準則之實體的執行個體。 若要啟用這項功能，您可以將篩選描述元新增至方法。 篩選描述元可讓模型取用者在執行之前，先將值傳遞至方法，以篩選方法結果集。 如需詳細資訊，請參閱如何：將篩選參數新增至作業，以限制外部系統執行個體。

SharePoint 提供數個功能，可讓使用者提供篩選值。 例如，商務資料 Web 組件會提供篩選文字方塊。 使用者可以在文字方塊中輸入值來限制清單中的資料。 如需如何將篩選描述元新增至方法的詳細資訊，請參閱如何：將篩選描述元新增至搜尋工具方法。

篩選描述元屬性

您必須設定篩選描述元的 [相關聯的類型描述元]、[名稱] 和 [類型] 屬性的值。 所有其他屬性是選擇性的。

[相關聯的類型描述元] 屬性會讓篩選描述元與輸入參數相關。 當使用者提供篩選值時，BDC 服務會使用輸入參數將該值傳遞至方法。

[類型] 屬性描述您想要使用的篩選模式。 在 SharePoint 中，您選取的篩選模式會影響出現在使用者介面 (UI) 中的文字。 例如，對於比較子篩選模式，文字等於顯示為商務資料 Web 組件上方的控制項。 如需每個篩選模式的詳細資訊，請參閱 BDC 支援的篩選類型 (英文)。

如需篩選描述元屬性的詳細資訊，請參閱 FilterDescriptor。

提供預設值

在某些情況下，使用者可能不會提供篩選值。 您可以將預設值新增至方法執行個體，或在方法的程式碼中設定預設值，來提供預設值。 如需如何將預設值新增至方法執行個體的詳細資訊，請參閱 MethodInstance。 如需如何在方法程式碼中設定輸入參數預設值的範例，請參閱如何：將篩選描述元新增至搜尋工具方法。

驗證模型

您可以在開發期間驗證模型。 Visual Studio 會識別可能導致模型無法如預期般運作的問題。 這些問題會顯示在 Visual Studio 的 [錯誤清單] 中。

您可以開啟 BDC 設計工具的捷徑功能表，然後選擇 [驗證] 來驗證模型。 如果模型包含任何錯誤，會出現在 [錯誤清單] 中。 您可以按兩下清單中的錯誤，快速將游標移至包含錯誤的程式碼。 或者，您可以重複地選擇 F8 或 Shift+F8 鍵，向前或向後檢視清單中的錯誤。

違反模型規則時，可能會發生驗證錯誤。 例如，如果類型描述元的 IsCollection 屬性設定為 true，但是沒有子系類型描述元存在，則會出現驗證錯誤。 您可能必須參考 BDC 模型的規則，以了解 Visual Studio [錯誤清單] 中出現的一些錯誤。 如需 BDC 模型規則的詳細資訊，請參閱 BDCMetadata 結構描述。

針對包含模型的解決方案進行偵錯

您可以針對程式碼進行偵錯，就像在 Visual Studio 中針對任何程式碼進行偵錯一樣。 若要針對程式碼進行偵錯，請在程式碼中的任何位置設定中斷點，然後啟動偵錯工具。 Visual Studio 會開啟 SharePoint 網站。 在 SharePoint 中，建立使用商務資料的清單或 Web 組件。 然後您可以逐步執行程式碼。 如需對 SharePoint 專案進行偵錯的詳細資訊，請參閱針對 SharePoint 解決方案進行疑難排解。

您也可以在新增至專案的自訂組件中針對程式碼進行偵錯。 不過，若要對自訂群組件中的程式碼進行偵錯，您必須將組件新增至解決方案套件中。 如需詳細資訊，請參閱如何：新增和移除其他組件。

如需將自訂組件新增至專案的詳細資訊，請參閱如何：在 BDC 功能中包含自訂組件。

設定 BDC 安全性

您可能必須先修改 SharePoint 中的安全性設定，才能對解決方案進行偵錯。 若要修改這些設定，請在 SharePoint 2010 管理中心網站中開啟商務資料連線服務應用程式。 在 [設定中繼資料存放區權限] 對話方塊中，新增使用者帳戶，然後選取下列任一選項：

Task	選項
將模型部署至 BDC 服務。	編輯
在模型中使用外部內容類型 (實體) 來建立清單和 Web 組件。	用戶端中可選取
建立、讀取、更新和刪除實體資料。	執行

如需這些設定的詳細資訊，請參閱商務資料連線服務管理。

您也可以設定個別模型或外部內容類型的安全性權限。 如需如何設定模型安全性權限的詳細資訊，請參閱 BDC 模型管理。 如需如何設定外部內容類型安全性權限的詳細資訊，請參閱外部內容類型管理。

注意

使用這些設定針對本機 SharePoint Server 上的解決方案進行偵錯。 如需如何在生產 SharePoint 伺服器上設定 BDC 相關安全性設定的詳細資訊，請參閱商務資料連線服務安全性概觀。

撤銷損毀的模型

第一次啟動偵錯工具時，Visual Studio 會將整個模型部署到 SharePoint。 之後的每一次，Visual Studio 都會使用您在部署之間所做的任何變更來更新 SharePoint 中的模型。

在某些情況下，您可能想要 Visual Studio 從 SharePoint 完全撤銷模型。 例如，模型可能損毀。 若要將模型重新部署至 SharePoint，請將模型的 [累加式更新] 屬性設定為 False，然後啟動偵錯工具。 當您選取 [BDC 總管] 中代表模型的節點時，[累加式更新] 屬性會出現在 [屬性] 視窗中。 根據預設，模型的名稱是 BdcModel1。

變更模型中實體的識別碼名稱

如果您在部署模型之後變更識別碼的名稱，您可能會收到部署錯誤。 您無法藉由將模型的 [累加式更新] 屬性設定為 False 來解決此錯誤。 您必須手動撤銷模型，然後再次部署解決方案。 如需詳細資訊，請參閱針對 SharePoint 解決方案進行疑難排解。 在一開始部署模型之前，您可以將 [累加式更新] 屬性設定為 False，以避免此錯誤。

尋找 BDC 模型元素的文件

Visual Studio 會針對您所建立的每個實體、方法或其他項目，將 XML 元素新增至模型。 元素屬性會顯示為 [屬性] 視窗中的屬性。 如需 Visual Studio 在您設計模型時所產生元素和屬性的詳細資訊，請參閱 BDCMetadata 結構描述。

相關主題

標題	描述
BDC 模型設計工具概觀	描述可用來以視覺化方式設計 BDC 模型的工具。
如何：將實體新增至模型	示範如何將外部內容類型或實體新增至模型。
如何：新增 Finder 方法	示範如何新增方法，讓使用者能夠檢視清單或 Web 組件中的實體清單。
如何：新增特定 Finder 方法	示範如何新增方法，讓使用者能夠檢視特定實體的詳細資料。
如何：新增 Creator 方法	示範如何新增方法，讓使用者能夠直接從清單或 Web 組件將記錄新增至資料來源。
如何：新增 Deleter 方法	示範如何新增方法，讓使用者能夠使用清單或 Web 組件之使用者介面 (UI) 中的選項，從資料來源移除資料。
如何：新增 Updater 方法	示範如何新增方法，讓使用者能夠直接從清單或 Web 組件變更資料來源中的資料記錄。
如何：將參數新增至方法	示範如何使用 Visual Studio 中的 [方法詳細資料] 視窗，將輸入和傳回參數新增至方法。
作法：定義參數的類型描述元	示範如何在模型中定義參數資料類型。
如何：定義方法執行個體	示範如何建立 BDC 執行之方法的執行個體。
如何：將篩選描述元新增至搜尋工具方法	示範如何讓使用者限制搜尋工具方法所傳回的執行個體數目。
建立實體之間的關聯	描述如何在模型中定義實體之間的關聯性。 商務資料 Web 組件、外部清單和自訂應用程式可以在使用者介面 (UI) 中顯示這些資料關聯性。
如何: 建立實體之間的關聯	示範如何在模型中定義實體之間的關聯性。
逐步解說：使用商務資料在 SharePoint 中建立外部清單	提供逐步指示，說明如何建立及測試在 SharePoint 外部清單中顯示連絡人的模型。
將商務資料整合至 SharePoint	提供為 BDC 服務建立和設計模型的概觀。