使用VS.NET手動創建一個MOSS的BDC實體
MOSS技朮 2007-12-21 17:12:00 阅读15 评论0 字号：大中小
業務資料目錄--BDC（Business Data Catalog）是MOSS中新加的一個功能。它可以將LOB(Line-of-Business)資料組合到SharePoint的其他基本功能中。比如我們可以利用BDC組合業務資料到清單或企業搜索中。為此，我們必須先構建一個XML檔，用於標識資料存儲的位置（MS SQL Server資料庫或Web服務）以及資料是什麼樣子的（比如，資料類型是什麼，主鍵是哪個）。
本文將通過創建一個BDC中繼資料檔定義一個簡單的LOB資料實體。在此之前，需要具備下列的環境：
- 安裝Microsoft SQL Server 2005並部署了AdventureWorks資料庫
- 拷貝BDC架構檔, Bdcmetadata.xsd和Bdcmetadataresource.xsd, 到Visual Studio 2005的Schema庫中。將上面的兩個文件從program files\Microsoft Office Servers\12.0\Bin\ 拷到 program files\Microsoft Visual Studio 8\Xml\Schemas\。
下面開始構建BDC中繼資料檔來定義一個簡單的LOB資料實體：
1. 首先，創建一個空的XML檔
打開Visual Studio 2005，創建一個 XML檔。右擊文檔，選屬性。在架構(Schemas)屬性框上，點省略號，把Bdcmetadata.xsd 架構檔附加到該文檔上。
2.定義一個 LobSystem
添加下面的XML來定義最上層的LobSystem及其參數：
<LobSystem
Type="Database"
Version="1.0.0.01"
Name="CRM"
xmlns="http://schemas.microsoft.com/office/2006/03/BusinessDataCatalog">
</LobSystem>
3.定義最上層的安全性相關參數
注意：這是可選的，我們也可以在BDC的管理頁面中進行操作。
添加下面的XML到LobSystem元素的末尾（在結束標記</LobSystem>之前）。注意，我們必須更新Principal屬性值，以使其指向正確的功能變數名稱和用戶或組名。
<AccessControlList>
<AccessControlEntry Principal="your domain\you">
<Right BdcRight="Execute"/>
<Right BdcRight="Edit"/>
<Right BdcRight="SetPermissions"/>
<Right BdcRight="SelectableInClients"/>
</AccessControlEntry>
<AccessControlEntry Principal="your domain\your BDC users">
<Right BdcRight="Execute"/>
<Right BdcRight="SelectableInClients"/>
</AccessControlEntry>
</AccessControlList>
4.定義一個LOB系統的實例
對於資料庫來說，一個系統實例定義了BDC中使用的資料庫的連接參數。添加下面的XML，作為LobSystem元素的一個子節點（在AccessControlList元素後）。注意，我們必須用正確的伺服器名替換server_name。
<LobSystemInstances>
<LobSystemInstance Name="CRMDB">
<Properties>
<Property Name="AuthenticationMode" Type="System.String">
PassThrough</Property>
<Property Name="DatabaseAccessProvider" Type="System.String">
SqlServer</Property>
<Property Name="RdbConnection Data Source" Type="System.String">
your_server_name</Property>
<Property Name="RdbConnection Initial Catalog" Type="System.String">
AdventureWorks</Property>
<Property Name="RdbConnection Integrated Security" Type=
"System.String">SSPI</Property>
</Properties>
</LobSystemInstance>
</LobSystemInstances>
使用pass-through方式作驗證的缺點是作業系統只暴露用戶名和密碼。因此，如果一個公司使用雙因素驗證（即使用者需要提供用戶名，密碼以外的其它特定的私有資訊），我們就不能使用pass-through方式了。
如果不用考慮上面這些缺點，那麼pass-through方式是我們在測試環境下的一個不錯的選擇。如果您的公司使用雙因數驗證，並且您還需要連BDC到一個SQL Server資料庫，那麼您可以使用SSO(Single Sign Sn)，對此，這裡就不做更深的介紹了。
5.定義一個實體---Customer
一個實體包括一個標題(定義在元素屬性中)，一個唯一標識（等同於主鍵），和一些方法（用於定義實體中的欄位，並告訴BDC如何將實體資料從LOB系統中取出來）。下面的步驟定義了一個名為Customer的實體。
- 在 LobSystemInstances 元素後面為該實體添加XML核心代碼。這裡包括我們用來定義實體標題的預留位置元素，統一標識和一個返回所有Customer的方法。
注意：一個方法包含一個Properties元素用於定義資料庫查詢（或Web服務方法），一個Properties 元素定義從查詢返回的資料，和一個MethodInstances 元素，標識MOSS中的特定功能。
<Entities>
<Entity Name="Customer">
<Properties>
<!--Properties go here-->
</Properties>
<Identifiers>
<!--Identifiers go here-->
</Identifiers>
<Methods>
<Method Name ="GetCustomers">
<Properties>
<!--Method Properties go here-->
</Properties>
<Parameters>
<!--Method Parameters go here-->
</Parameters>
<MethodInstances>
<!--Method Instances go here-->
</MethodInstances>
</Method>
</Methods>
</Entity>
</Entities> - 定義GetCustomers方法中的屬性。對於資料庫，我們的實體屬性告訴BDC查詢的內容和如何進行查詢。為GetCustomers 方法添加下面的XML到Properties 元素內。注意，在我們的T-SQL語句中有一個WHERE子句，包含了參數minCustomerID 和maxCustomerID 的引用，我們必須提前定義出來。同時，還要注意避免出現大於和小於號。
這裡我們不要按順序寫。先把注意力放到方法屬性上，不要管更高一層的實體屬性。因為這是我們定義查詢的地方，它直接決定了實體其他部分的內容。
<Property Name="RdbCommandText" Type="System.String">
SELECT
customerID,
LastName + ', ' + FirstName as Name,
Phone,
EmailAddress
FROM
Sales.vIndividualCustomer
WHERE
(customerID > @minCustomerID and
customerID < @maxCustomerID)
</Property>
<Property Name="RdbCommandType" Type="System.String">Text</Property> - 回到實體層次，定義屬性和標識。用下麵的XML替換Properties和Identifiers預留位置元素。
<Properties>
<Property Name="Title" Type="System.String">Name</Property>
</Properties>
<Identifiers>
<Identifier Name="CustomerID" TypeName="System.Int32"/>
</Identifiers> - 定義方法參數。添加下面的XML到GetCustomers 方法的Parameters 元素中。這裡定義了3個參數。頭兩個是輸入參數，通過CustomerID過濾了列表。第三個參數定義了由SQL查詢返回的資料。
所有這3個參數都包括了一個到前面我們創建的標識的引用。這個標識是實體的非常重要的一個部分。MOSS用它來查詢一個特定的元素（因此標識被定義在輸入參數中）。它同時還用於輸出實體的各種附加功能中（比如應用於Business Data Action中）。沒有標識，實體就會嚴重癱瘓。
返回參數通常比較複雜。它被定義為一個資料的記錄集。這樣就告訴了MOSS，將會有多個實體被返回。
<Parameter Direction="In" Name="@minCustomerID">
<TypeDescriptor TypeName="System.Int32" Name="customerID" IdentifierName="CustomerID">
<DefaultValues>
<DefaultValue MethodInstanceName="CustomerFinderInstance" Type="System.Int32">
0</DefaultValue>
<DefaultValue MethodInstanceName=
"CustomerSpecificFinderInstance" Type="System.Int32">
0</DefaultValue>
</DefaultValues>
</TypeDescriptor>
</Parameter>
<Parameter Direction="In" Name="@maxCustomerID">
<TypeDescriptor TypeName="System.Int32" Name="customerID" IdentifierName="CustomerID">
<DefaultValues>
<DefaultValue MethodInstanceName="CustomerFinderInstance" Type=
"System.Int32">9999999</DefaultValue>
<DefaultValue MethodInstanceName=
"CustomerSpecificFinderInstance" Type="System.Int32">
9999999</DefaultValue>
</DefaultValues>
</TypeDescriptor>
</Parameter>
<Parameter Direction="Return" Name="Customers">
<TypeDescriptor TypeName="System.Data.IDataReader, System.Data, Version=2.0.3600.0,
Culture=neutral, PublicKeyToken=b77a5c561934e089" IsCollection="true"
Name="CustomerDataReader">
<TypeDescriptors>
<TypeDescriptor TypeName="System.Data.IDataRecord, System.Data,
Version=2.0.3600.0, Culture=neutral, PublicKeyToken=
b77a5c561934e089" Name="CustomerDataRecord">
<TypeDescriptors>
<TypeDescriptor TypeName="System.Int32" IdentifierName=
"CustomerID" Name="customerID" />
<TypeDescriptor TypeName="System.String" Name="Name" />
<TypeDescriptor TypeName="System.String" Name="Phone" />
<TypeDescriptor TypeName="System.String" Name="EmailAddress" >
<LocalizedDisplayNames>
<LocalizedDisplayName LCID="1033">Email Address
</LocalizedDisplayName>
</LocalizedDisplayNames>
</TypeDescriptor>
</TypeDescriptors>
</TypeDescriptor>
</TypeDescriptors>
</TypeDescriptor>
</Parameter> - 定義方法的實例。添加下麵的XML到MethodInstances 元素中。MOSS通過Finder 方法獲取所有實體的已知實例。而且，MOSS通過finder方法來支持Business Data List WebPart。MOSS通過特定的Finder方法來獲取查詢特定方法實例的類型。搜索，業務資料操作，篩選，幾乎所有其他的BDC功能都會用到該方法。
一個方法通常只支持0或1個方法的實例。在本例中，我們只有一個方法，可以返回所有的customers或單個customer。當您定義您的實體時，您會發現或許使用兩個方法會更容易些，一個GetCustomers 方法和一個GetSingleCustomer 方法。我們在這裡只是為了簡化XML，所以寫的比較簡練。
<MethodInstance
Name="CustomerFinderInstance"
Type="Finder"
ReturnParameterName="Customers"
ReturnTypeDescriptorName="CustomerDataReader" />
<MethodInstance
Name="CustomerSpecificFinderInstance"
Type="SpecificFinder"
ReturnParameterName="Customers"
ReturnTypeDescriptorName="CustomerDataReader"/> - 保存檔。
6.將完成的中繼資料檔上傳到SSP(Shared Service Provider)
打開管理中心，點左側巡覽列中的共用服務（通常名為SharedServices1）。在BDC一節中，點導入應用程式定義。點流覽，找到剛剛創建的中繼資料文件，按兩下。其他的應用程式定義項都用預設值就好，點導入。
7. 使用業務資料清單部件來顯示Customer資料
在一個我們創建好的網站裡，在頁面中添加一個業務資料清單部件。 打開屬性面板，在"類型"中輸入Customer然後回車。MOSS會分析該屬性，並得到Customer(CRMDB) 實體。 點確定，該實體就會顯示在WebPart中了。
MOSS中的BDC功能允許我們將處於門戶以外的LOB資料包括進來，用於清單和企業搜索。BDC需要一個XML中繼資料檔用於定義到外部資料來源的連接參數、各種查詢（或Web服務方法調用），以及用於查詢或方法調用的所有的輸入輸出參數。定義一個中繼資料檔，關鍵是理解其結構。理解BDC的關鍵就是理解實體。實體包括：
屬性，允許BDC開發人員在實體層次定義特定的中繼資料，比如預設的顯示元素（Title）。
標識，LOB欄位的集合,唯一標識該實體。
方法， 包括T-SQL或Web服務方法，用於獲取實體資料。實體可以包括多個方法,可以隨意包含參數和篩選，可供BDC用戶篩選結果。
(這篇是轉來的,有空再自己寫一篇個人認為詳細的
源文档 <http://blog.163.com/szmax_limin/blog/static/58182861200711215120980/>