使用VS.NET手動創建一個MOSS的BDC實體

来源：互联网发布：linux内核调试ida 编辑：程序博客网时间：2024/06/16 19:25

使用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屬性值，以使其指向正確的功能變數名稱和用戶或組名。

</AccessControlEntry>

</AccessControlEntry>

</AccessControlList>

4.定義一個LOB系統的實例

對於資料庫來說，一個系統實例定義了BDC中使用的資料庫的連接參數。添加下面的XML，作為LobSystem元素的一個子節點（在AccessControlList元素後）。注意，我們必須用正確的伺服器名替換server_name。

PassThrough</Property>

SqlServer</Property>

your_server_name</Property>

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>
      <Identifiers>
         
      </Identifiers>
      <Methods>
         <Method Name ="GetCustomers">
            <Properties>
               
            </Properties>
            <Parameters>
               
            </Parameters>
            <MethodInstances>
               
            </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/>

0 0