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

使用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資料實體。在此之前，需要具備下列的環境：

1. 安裝Microsoft SQL Server 2005並部署了AdventureWorks資料庫
2. 拷貝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的實體。

1. 在 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>
2. 定義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 &gt; @minCustomerID and
          customerID &lt; @maxCustomerID)
   </Property>
   <Property Name="RdbCommandType" Type="System.String">Text</Property> 
3. 回到實體層次，定義屬性和標識。用下麵的XML替換Properties和Identifiers預留位置元素。
   <Properties>
      <Property Name="Title" Type="System.String">Name</Property>
   </Properties>
   <Identifiers>
      <Identifier Name="CustomerID" TypeName="System.Int32"/>
   </Identifiers>
4. 定義方法參數。添加下面的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>
5. 定義方法的實例。添加下麵的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. 保存檔。

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/>