本節提供如何使用取用配接器服務 BizTalk 專案增益集、新增配接器中繼資料精靈和新增配接器服務參考 Visual Studio 外掛程式的相關資訊。 藉由使用這些 Visual Studio 元件,您可以:
流覽要擷取中繼資料的作業。
搜尋要擷取中繼資料的作業。
使用取用配接器服務增益集或新增配接器中繼資料精靈時,將所選作業和埠系結組態檔的訊息架構新增至 BizTalk 伺服器專案。
使用 [新增配接器服務參考外掛程式] 時,將 WCF 用戶端類別或 WCF 服務合約 (介面) ,並將組態檔 (app.config) 新增至非 BizTalk 程式設計專案。
您必須先連線到 Oracle 資料庫,才能流覽、搜尋或擷取目標作業的中繼資料。 如需在使用取用配接器服務增益集、新增配接器中繼資料精靈或新增配接器服務參考外掛程式時如何連線到 Oracle 資料庫的資訊,請參閱 在 Visual Studio 中連接到 Oracle 資料庫。
注意
- 當您流覽和搜尋作業時,[取用配接器服務 BizTalk 專案增益集]、[新增配接器中繼資料精靈] 和 [新增配接器服務參考 Visual Studio 外掛程式] 基本上會呈現相同的介面,因此這三個元件都會包含在相同的主題中。
- 您可以選取類別節點來傳回該類別子樹中的所有作業,例如整個資料表或架構 (,甚至是架構中的所有資料表) 。
流覽作業
使用取用配接器服務增益集流覽中繼資料時,[新增配接器中繼資料精靈] 或 [新增配接器服務參考外掛程式],Oracle 資料庫配接器會顯示:
可在資料表、檢視、預存程式、函數和封裝上執行的作業。
SQLEXECUTE 作業,可讓配接器用戶端在 Oracle 資料庫中執行任何一般資料操作語言 (DML) 或預存程式。
POLLINGSTMT 和通知作業,可讓配接器用戶端從 Oracle 資料庫取得輸入資料。 它也會公開個別架構下的預存程式、函式和套件清單,這些架構會公開為輪詢的作業。
注意
- 使用取用配接器服務增益集、新增配接器中繼資料精靈或新增配接器服務參考外掛程式,您可以使用 Windows 介面流覽類別和作業節點。
- SQLEXECUTE、POLLINGSTMT 和通知作業會直接顯示在類別樹狀目錄中的根節點底下。 您必須選取根節點,才能檢視這些輸出和輸入作業。
如需流覽中繼資料的詳細資訊,請參閱 在 Visual Studio 中取得 Oracle 資料庫作業的中繼資料
執行下列步驟,以使用 [新增配接器服務參考外掛程式] 或 [取用配接器服務增益集] 流覽 Oracle 資料庫中針對不同成品公開的作業。
流覽 Oracle 資料庫中的中繼資料
使用取用配接器服務增益集、新增配接器中繼資料精靈或新增配接器服務參考外掛程式連接到 Oracle 資料庫。 如需相關指示,請參閱 在 Visual Studio 中連線到 Oracle 資料庫 。
從 [ 選取合約類型 ] 下拉式清單中,根據您將使用配接器執行輸入或輸出作業,選取合約類型。
[ 選取類別] 方塊會列出 Oracle 資料庫中的架構。 按一下架構,即可在 [ 可用的類別和作業 ] 方塊中查看架構可存取的資料表、程式、函式、封裝和檢視。 或者,您可以展開架構節點來查看分類。
提示
您可以直接移至樹狀結構中的「立即」類別節點或子類別節點,方法是在 中輸入成品的名稱,而焦點位於 [ 選取類別 ] 方塊中的樹狀檢視上。 例如,若要跳至 SCOTT 節點,請將焦點保留在根節點上,然後輸入
SCOTT
。下圖顯示取用配接器服務增益集。 已選取 SCOTT 架構節點,且 SCOTT 節點下可用的一般類別節點會列在 [ 可用類別和作業 ] 方塊中。
按一下 [ 資料表] 節點,即可在 [ 可用的類別和作業 ] 方塊中查看 SCOTT 的資料表。 或者,您可以展開 [ 資料表 ] 節點來查看資料表清單。
按一下資料表名稱以查看資料表上支援的作業。
下圖顯示取用配接器服務增益集。 SCOTT 架構中可用的資料表會列在 [ 選取類別] 方塊中。 EMP 資料表可用的作業會列在 [ 可用的類別和作業 ] 方塊中。
按一下 [ 程式] 節點,即可在 [ 可用的類別和作業 ] 方塊中列出 SCHEMA SCOTT 可存取的程式。
下圖顯示取用配接器服務增益集。 SCOTT 架構中可用的一般類別節點會列在 [ 選取類別] 方塊中。 SCOTT 架構中可用的程式會列在 [ 可用的類別和作業 ] 方塊中。
按一下 [ 函式 ] 節點,即可在 [ 可用的類別和作業 ] 方塊中查看架構 SCOTT 的函式。
下圖顯示取用配接器服務增益集。 SCOTT 架構中可用的一般類別節點會列在 [ 選取類別] 方塊中。 SCOTT 架構中可用的函式會列在 [ 可用的類別和作業 ] 方塊中。
中的函式
按一下 [ 套件] 節點,即可在 [ 可用的類別和作業 ] 方塊中查看架構 SCOTT 的套件。 或者,您可以展開 [ 封裝 ] 節點來查看套件清單。
按一下套件名稱以查看套件上支援的作業。
下圖顯示 SCOTT 架構的取用配接器服務增益集,其中列出套件,以及特定套件支援的作業。
按一下 [ 檢視] 節點,即可在 [ 可用的類別和作業 ] 方塊中查看架構 SCOTT 的檢視。 或者,您可以展開 [ 檢 視] 節點來查看檢視清單。
按一下檢視名稱以查看檢視上支援的作業。
下圖顯示 SCOTT 架構的取用配接器服務增益集,其中列出檢視,以及特定檢視的支援作業。
注意
使用 WCF 通道和服務模型,配接器用戶端可以指定批次大小來執行中繼資料的批次擷取。
搜尋作業
使用 [取用配接器服務增益集]、[新增配接器中繼資料精靈] 或 [新增配接器服務參考外掛程式] 搜尋 Oracle 中繼資料時,Oracle 資料庫配接器:
支援搜尋運算式中的萬用字元和逸出字元。
在執行搜尋作業的節點下立即啟用搜尋。 例如,若要搜尋函式,您必須在 \[Schema]\Functions 下搜尋。 不支援多層級搜尋。
下表列出可用於搜尋的特殊字元,以及 Oracle 資料庫配接器用來解譯的特殊字元。
特殊字元 | 解譯 |
---|---|
_ (底線) | 完全符合一個字元 例如,A_符合 AB、AC、AD。 |
% (百分比) | 比對零個或多個字元。 例如,A% 符合 A、AB、ABC。 |
\ (逸出) | 逸出 % 和 _ 的特殊意義 例如,A\_B 符合A_B。 |
注意
逸出字元是在萬用字元之前放置的字元,表示萬用字元應該解譯為一般字元,而不是萬用字元。
如需詳細資訊,請參閱 在 Visual Studio 中取得 Oracle 資料庫作業的中繼資料
在 Oracle 資料庫中搜尋中繼資料
使用取用配接器服務增益集、新增配接器中繼資料精靈或新增配接器服務參考外掛程式連接到 Oracle 資料庫。 如需相關指示,請參閱 在 Visual Studio 中連線到 Oracle 資料庫 。
在 [取用配接器服務增益集] 的 [ 選取合約類型 ] 下拉式清單中,根據您將使用配接器搜尋輸入或輸出作業,選取合約類型。
在 [ 選取類別] 方塊中,按一下包含您要搜尋之資料表、程式、函式、封裝和檢視的架構。 如果您不確定要按一下哪一個架構,請按一下根節點。
在 [ 在類別中的搜尋] 文字方塊中,輸入搜尋運算式以搜尋特定架構。 例如,若要搜尋名稱中有 「SC」 的架構,請在文字方塊中輸入 %SC% 。
按一下具有向右箭號圖示的按鈕,即可開始搜尋。 搜尋完成之後, [可用的類別和作業 ] 方塊會列出符合搜尋準則的架構。
在 [ 選取類別] 方塊中,展開對應至架構的節點,然後按一下您要在其中搜尋的資料庫專案。 在 [ 類別搜尋] 文字方塊中,輸入搜尋運算式來搜尋特定資料庫專案。
例如,若要在其名稱中搜尋具有 「EMP」 的資料表,請選取 [資料表],在 [類別目錄搜尋] 文字方塊中輸入%EMP%,然後按一下具有向右箭頭圖示的按鈕。
下圖顯示取用配接器服務增益集,其中列出搜尋結果。
注意
使用 WCF 通道和服務模型,配接器用戶端可以指定批次大小來執行中繼資料的批次搜尋。
使用取用配接器服務增益集或新增配接器中繼資料精靈產生架構
您可以使用取用配接器服務增益集或 [新增配接器中繼資料精靈] 來產生所選 Oracle 資料庫成品的架構。 流覽並搜尋您想要叫用的成品之後,您就可以產生這些成品的架構,並將符合架構的訊息傳送至 Oracle 資料庫。 執行下列步驟,使用取用配接器服務增益集從 Oracle 資料庫擷取中繼資料。
注意
您可以選取類別節點以傳回該類別子樹狀結構中的所有作業,例如,您可以選取整個資料表 (來產生資料表中所有作業的架構) 或 (資料表上選取的特定作業,例如,插入和刪除) ,只針對資料表上的這些作業產生架構。 如需節點的詳細資訊,請參閱 中繼資料節點識別碼3。
從 Oracle 資料庫擷取中繼資料
使用取用配接器服務增益集或新增配接器中繼資料精靈連接到 Oracle 資料庫。 如需指示,請參閱 在 Visual Studio 中連線到 Oracle 資料庫 。
從 [ 選取合約類型 ] 下拉式清單中,根據您是否將使用配接器執行輸入或輸出作業,選取合約類型。
在 [ 選取類別] 方塊中,展開架構節點。
選取您要為其產生中繼資料的類別。 例如,如果您想要產生資料表的中繼資料,請選取 [ 資料表]。
展開該特定類別節點,然後選取您要產生中繼資料之該節點內的特定專案。
例如,若要產生特定資料表的中繼資料,請展開 [ 資料表 ] 節點,然後選取特定的資料表名稱。
注意
您也可以搜尋特定資料庫專案,如上一個程式所述。
在 [ 可用的類別和作業 ] 方塊中,選取與您在上一個步驟中選取之資料庫專案相關的作業,然後按一下 [ 新增]。 選取的作業會列在 [ 新增類別和作業 ] 方塊中。
下圖顯示取用配接器服務增益集,其中列出選取的作業。
如果您想要產生多個作業的架構,這些架構中可能會有一些重複的專案定義,可能會導致編譯 BizTalk 專案失敗。 例如,假設您產生作業 「Op1」 的架構。 「Op1」 的架構包含複雜資料類型 「CT1」 的參數。 產生 「Op1」 的架構之後,您會關閉取用配接器服務增益集,然後重新開啟它,以產生另一個作業 「Op2」 的架構。 假設 「Op2」 也包含複雜資料類型 「CT1」 的參數。 在您結束取用配接器服務增益集並編譯專案之後,您會收到編譯錯誤,因為複雜資料類型 「CT1」 會在不同的 XSD 檔案中定義兩次。 在這種情況下,我們建議使用下列專案:
在單一執行取用配接器服務增益集中產生所有作業的架構。 這可確保取用配接器服務增益集只會針對複雜資料類型 「CT1」 產生一個定義。
如果您想要針對使用配接器服務增益集的不同回合產生多個作業的架構,請務必選取 [ 產生唯一的架構類型 ] 核取方塊,讓產生的 XSD 檔案包含複雜資料類型 「CT1」 的唯一命名空間。
按一下 [確定]。 架構檔案會與 BizTalk 專案位於相同位置的 .xsd 副檔名儲存。
根據預設,系統會使用命名慣例 「OracleDBBindingSchema < n.xsd > 」 來建立檔案,其中 'n' 可以是 1、2 等等,視建立的架構檔案數目而定。 或者,您可以在 [ 檔案名前置 詞] 文字方塊中輸入名稱,以提供架構檔案的自訂名稱。 取用配接器服務增益集現在會建立具有命名慣例 < 檔案名前置 > 詞 Schema n.xsd > 的架構 < 檔案。
注意
取用配接器服務增益集也會建立系結檔案 (XML 檔案) 包含您在產生作業架構時所指定的系結屬性,以及叫用作業的 SOAP 動作。 您可以在 BizTalk Server 管理主控台中匯入此系結檔案,以使用連線 URI、系結屬性和 SOAP 動作集建立 WCF-Custom 埠。 如需詳細資訊,請參閱 使用埠系結檔案設定實體埠系結至 Oracle 資料庫。
重要
使用 [新增配接器中繼資料精靈] 不會產生系結檔案。
在 [檔案] 功能表上,按一下 [全部儲存]。
使用新增配接器服務參考外掛程式產生 WCF 用戶端或 WCF 服務合約
您可以使用 [新增配接器服務參考外掛程式] 來產生輸出作業的 WCF 用戶端程式代碼,或輸入作業的 WCF 服務程式代碼。
從 Oracle 資料庫擷取中繼資料
在 [新增配接器服務參考外掛程式] 的 [ 選取合約類型 ] 下拉式清單中,根據您要執行輸入 (POLLINGSTMT) 或輸出作業,選取合約的類型。
流覽或搜尋類別 (,例如 Oracle 資料庫資料表) 或您想要產生 WCF 用戶端 (或 WCF 服務合約) 的特定作業。
例如,若要流覽 SCOTT 中的作業。EMP 資料表,在 [ 選取類別 ] 方塊中:展開根節點 (/) ,以查看針對 Oracle 資料庫呈現的架構。
在根節點下,展開 SCOTT 節點,以查看針對 SCOTT 架構公開的類別。
在 SCOTT 節點下,展開 [ 資料表 ] 節點,以查看針對 SCOTT 架構呈現的資料表。
在 [ 資料表 ] 節點下,選取 EMP 節點。 EMP 資料表所呈現的作業會列在 [可用的類別和作業 ] 方塊中。
在 [ 可用的類別和作業 ] 方塊中,選取您要產生 WCF 用戶端 (或 WCF 服務合約) 的作業或類別,然後按一下 [ 新增]。 選取的作業會列在 [ 新增類別和作業 ] 方塊中。
下圖顯示使用 SCOTT 的插入和更新作業新增配接器服務參考外掛程式。已選取 EMP 資料表。
重要
根據您選取的輸出作業 (或類別) ,可能會產生多個 WCF 用戶端類別。 如需詳細資訊,請參閱 產生 Oracle 資料庫解決方案成品的 WCF 用戶端或 WCF 服務合約。
在大部分情況下,預設序列化選項就已足夠;不過,如有需要,您可以控制所產生程式碼的數個層面,以及所使用的序列化程式類型。 若要設定下列選項:
按一下 [ 進階選項 ] 以開啟 [ 進階選項 ] 方塊。
在 [ 進階選項 ] 方塊的 [ 選擇產生的 Proxy 選項] 底下,選取您想要的選項。 例如,您可以選取是否為 WCF 用戶端產生非同步方法,或停用組態檔的產生。
在 [序列化程式 ] 下,選取應該使用的序列化程式。
下圖顯示 [ 進階選項 ] 方塊,其中已針對序列化程式選取預設選取專案 (自動 ,而且未選取其他選項) 。
您可以在 [ 進階選項 ] 方塊中設定的選項相當於使用 ServiceModel 中繼資料公用程式工具 (svcutil.exe) 時可用的一些選項。 如需這些選項的詳細資訊,請參閱 ServiceModel 中繼資料公用程式工具 (Svcutil.exe) 。
按一下 [確定]。 [新增配接器服務參考外掛程式] 會將 WCF 用戶端類別儲存 (或 WCF 服務介面) ,以及您在專案目錄中選取之作業和類別的協助程式程式碼。 根據預設,也會儲存組態檔。 輸入和輸出作業會產生稍微不同的檔案;如需詳細資訊,請參閱 產生 WCF 用戶端或 Oracle 資料庫解決方案成品的 WCF 服務合約。
您可以選取 [ 可用類別和作業 ] 方塊中列出的任何節點。 如果您選取類別節點,則會選取該節點下可用的所有作業及其子節點。 例如,若要為 EMP 資料表呈現的所有作業產生 WCF 用戶端,您可以選取 EMP 節點;若要為 SCOTT 架構中的所有資料表產生 WCF 用戶端,您可以選取 [資料表] 節點;依此類故。