搭配 SharePoint 使用 Oracle 資料庫配接器

發行項
10/14/2023

Visual Studio 的 WCF 配接器服務開發精靈可讓 Microsoft BizTalk Adapter for Oracle Database 和 Microsoft BizTalk Adapter for Oracle E-Business Suite 直接取用為 Microsoft SharePoint 中的外部資料源。支援此功能的 [新增服務開發精靈] 會使用 WCF 配 接器服務範本啟動，以在 Visual Studio 中建立新的 Visual C# 網站。範本隨附于 BizTalk 配接器套件中。您也必須安裝 Microsoft Windows Communication Foundation (WCF) 企業營運 (LOB) 配接器 SDK。

SharePoint 作業支援

配接器服務開發精靈會針對與 Microsoft SharePoint 相容的 Oracle 配接器產生特殊服務合約。精靈會產生服務合約，其中包含下列作業以整合配接器與 Microsoft SharePoint：

創建： CreateItem_作業支援。
讀： ReadItem_作業支援。
更新： UpdateItem_作業支援。
刪除： DeleteItem_作業支援。
查詢： ReadList 作業支援。
副： Associate_作業支援。

下列服務合約是針對 Microsoft BizTalk Adapter for Oracle Database 產生的，例如。配接器已設定為提供 EMP 資料表的存取權

    [System.ServiceModel.ServiceContractAttribute()]  
    public interface ISCOTT_EMP {  
  
    [System.ServiceModel.OperationContractAttribute()]  
    SCOTT_EMP_Record[] ReadList(System.Nullable<int> Limit);  
  
    [System.ServiceModel.OperationContractAttribute()]  
    void CreateItem(SCOTT_EMP_Record Input);  
  
    [System.ServiceModel.OperationContractAttribute()]  
    SCOTT_EMP_Record[] ReadItem_EMPNO(System.Nullable<decimal> EMPNO);  
  
    [System.ServiceModel.OperationContractAttribute()]  
    void UpdateItem_EMPNO(SCOTT_EMP_Record Input);  
  
    [System.ServiceModel.OperationContractAttribute()]  
    void DeleteItem_EMPNO(System.Nullable<decimal> EMPNO);  
  
    [System.ServiceModel.OperationContractAttribute()]  
    SCOTT_EMP_Record[] Associate_DEPTNO(System.Nullable<decimal> DEPTNO);  
}

在 IIS 中建立新網站以裝載 Oracle 資料庫

這些步驟提供使用 WCF 配接器服務開發精靈的範例，以建立裝載 Microsoft BizTalk Adapter for Oracle Database 的新 WCF Web 服務。服務合約將包含與 Sharepoint 直接相容的作業。因此，它可以直接取用為外部資料源。配接器已設定為使用 SCOTT 帳戶向 Oracle 資料庫進行驗證。如果 SCOTT 帳戶已鎖定，您可以藉由以 SYSDBA 身分登入 SQL Plus 來解除鎖定帳戶。

<Oracle Installation Bin Directory>\Sqlplus.exe SYS AS SYSDBA

然後，執行下列命令。

SQL> ALTER USER scott ACCOUNT UNLOCK;

建立新的網站專案

開啟 Visual Studio。
在 Visual Studio 的 [ 檔案 ] 功能表上，選取 [ 新增 ]，然後按一下 [ 專案]。
在 [ 新增專案] 對話方塊中，展開 [ 其他語言 ]，然後按一下 [ Visual C#]。在範本清單中尋找 WCF 配接器服務 ，然後按一下它以選取它。

注意

如果未安裝 BizTalk 配接器套件 2013， 則無法使用 WCF 配接器服務 範本。在 x64 系統上，安裝 BizTalk 配接器套件 2013 的 x86 和 x64 版本。
針對名稱指定 ScottEMP ，然後按一下 [ 確定]。 WCF 配接器服務開發精靈隨即啟動。
在 [簡介] 頁面上，按一下 [下一步] 。
在 [ 選擇作業] 頁面上，指定 oracleDBBinding 系結。
按一下 [設定] 按鈕。 [ 設定配接器 ] 對話方塊隨即顯示。
在 [安全性] 索引標籤上，選取 [用戶端認證類型] 下拉式清單中的 [使用者名稱]。
針對 [使用者名稱] 輸入 SCOTT ，然後輸入 SCOTT 帳戶的正確密碼。 SCOTT 帳戶的預設密碼為 tiger。
按一下 [ URI 屬性] 索引 標籤，在 [ ServerAddress ] 方塊中輸入 Oracle 伺服器的 IP 位址或主機名稱。
在 [ ServiceName ] 方塊中輸入正確的 Oracle 資料庫服務實例名稱。您可以從 Oracle Enterprise Manager 複製實例名稱資訊。
按下 [設定配接器] 對話方塊上的 [確定] 按鈕
在精靈的 [ 選擇作業] 頁面上，按一下 [ 連接 ] 按鈕，等候一些時間讓 Oracle 資料庫建置類別。
在 [ 選取類別 ] 清單中新增類別之後，請向下捲動至 SCOTT 並加以展開。然後展開 [資料表 ]，然後按一下 EMP 資料表專案。
在 [可用的類別和作業 ] 清單中，選取清單中的所有作業，然後按一下 [ 新增 ] 按鈕。所有作業都會新增至 [ 新增的類別和作業 ] 清單。
在 [ 選擇作業] 頁面上，按一下 [ 下一步] 按鈕。
在此範例的 [ 設定服務和端點行為] 頁面上，將 UseServiceCertificate 服務行為設定為 false 。然後按一下 [ 下一步] 按鈕。
在 [ 設定服務端點系結和位址 ] 頁面上，按一下 [ 套用 ] 按鈕。然後按一下 [ 下一步] 按鈕。
在 [ 摘要] 頁面上，按一下 [ 完成] 按鈕。
按一下 [ 建置 ] 功能表選項，然後按一下 [ 建置方案]。確認專案建置成功，且沒有任何錯誤。

將新服務發佈至 IIS

在此範例中，您會將介面卡主機服務發佈至本機 IIS 網頁伺服器。

在 visual Studio 方案總管中，以滑鼠右鍵按一下ScottEmp專案，然後按一下 [屬性]。 [專案Designer] 索引標籤隨即顯示。
按一下 [Web] 索引標籤，然後按一下 [使用本機 IIS Web 服務器] 選項。
按一下 [建立虛擬目錄] 按鈕。
將網頁瀏覽器開啟至服務位址 http://localhost/ScottEmp/ISCOTT_EMP.svc 。您應該會收到一則訊息，指出介面卡裝載于 IIS 中，指出「您已建立服務」。

使用 SharePoint 將外部資料源新增至 SharePoint 網站Designer

本節說明如何使用 SharePoint Designer，將 WCF 服務新增為外部資料源。

開啟 SharePoint Designer並建立新的網站。
在 SharePoint Designer中，展開 [流覽]，然後按一下 [網站物件] 清單中的[外部內容類型]。
按一下 [ 外部內容類型 ] 功能表按鈕，以建立新的外部內容類型。
按一下 [名稱 ] 旁的文字，編輯新外部內容類型的名稱。輸入 OracleEMP 以取得名稱。
按一下 [外部系統] 旁的文字連結，指出按一下這裡以探索外部資料源和作業。 這會開啟 OracleEMP 外部內容類型的 Operation Designer。
按一下探索畫面上的 [ 新增連線 ] 按鈕。
在 [外部資料源類型選取] 對話方塊中，選擇 [WCF 服務 ]，然後按一下 [ 確定 ] 按鈕。
在 [WCF 連線] 對話方塊的 [ 服務中繼資料 URL] 方塊中，輸入 https://localhost/ScottEmp/ISCOTT_EMP.svc?wsdl
在 [ 服務端點 URL] 方塊中，輸入 https://localhost/ScottEmp/ISCOTT_EMP.svc
按一下 [ 確定 ] 按鈕以關閉 [WCF 連線] 對話方塊。
填入資料來源資訊之後，請展開 https://localhost/ScottEmp/ISCOTT_EMP.svc 資料來源，然後展開 [Web 方法]。
以滑鼠右鍵按一下 ReadList Web 方法，然後按一下 [ 新增讀取清單作業]。 [讀取清單] 組態對話方塊隨即啟動。
在 [讀取清單] 對話方塊中，按一下 [ 傳回參數 ]，然後按一下 [資料來源元素] 中的 [EMPNO ]。按一下 [ 對應至識別碼]。
按一下 [讀取清單] 對話方塊中的 [ 完成 ]。
輸入 Ctrl+s以儲存新的外部資料源。

測試外部資料源連線

在新的網站中，按一下 [ 建立清單和表單 ] 按鈕。 [建立 OracleEMP 的清單和表單] 對話方塊隨即出現。
針對 [ 清單名稱] 輸入OracleEMP_List，然後按一下 [ 確定 ] 按鈕。
建立清單之後，按一下功能表上的 [ 摘要檢視 ] 按鈕。
按一下 [外部清單] 底下的 [OracleEMP_List ]。
按一下功能表上的 [ 瀏覽器預覽] 按鈕，以測試介面卡的 ReadList 作業。

疑難排解

在 64 位電腦上，您必須確定也已安裝 32 位 Oracle 用戶端元件。這是因為 Visual Studio 及其精靈會以需要存取 32 位元件的 32 位進程來執行。

共用方式為