Microsoft BizTalk Adapter for Oracle E-Business Suite 連線 URI 包含配接器用來建立連線到 Oracle E-Business Suite 的屬性，實際上連結到基礎的 Oracle 資料庫。 Oracle E-Business 配接器支援兩種方式來聯機到基礎 Oracle 資料庫：一種是使用 tnsnames.ora，另一種是不使用 tnsnames.ora。 根據連線方法的類型，連線 URI 的格式也不同。 本主題提供 Oracle 連線 URI 的相關信息，並提供其他主題的連結，說明如何在不同的程式設計案例中指定 URI。
Oracle E-Business Suite 是一種應用層，可與基礎 Oracle 資料庫介面，並根據組織內的不同需求分類為不同的應用程式，例如財務和 HR。 這些應用程式各提供各種「表單」，讓用戶能夠將數據輸入基礎 Oracle 資料庫。 這些表單的存取受限於將使用者與應用程式內容產生關聯，其中包含使用者所屬的組織標識碼、與使用者相關聯的「責任」，以及使用者想要叫用的 Oracle E-Business Suite 應用程式名稱。 即使配接器會直接連線到基礎資料庫，而且不會使用表單來與 Oracle E-Business Suite 介面，但在 Oracle E-Business Suite 成品上執行作業時，設定應用程式內容是必要的。 因此，若要連線到 Oracle E-Business 套件，以及基礎 Oracle 資料庫，請使用 Oracle E-Business 配接器，您必須：
指定連線 URI 以連線到 Oracle E-Business Suite 和基礎 Oracle 資料庫。 建立連線時，您可以選擇指定 Oracle E-Business Suite 或基礎 Oracle 資料庫的認證。
設定使用者的應用程式內容。 Oracle E-Business 配接器會公開接受認證和責任的特定系結屬性。 如需這些系結屬性的詳細資訊，請參閱 關於 BizTalk Adapter for Oracle E-Business Suite 系結屬性。 如需設定應用程式內容的詳細資訊，請參閱 設定應用程式內容。
本節說明如何指定連接 URI，以使用 tnsnames.ora 或不使用 tnsnames.ora 的方式連接到基礎資料庫。 它也提供使用連線 URI 連線到 Oracle E-Business Suite 的相關信息。
使用 tnsnames.ora 連線
這很重要
- 針對此方法，您必須在已安裝配接器用戶端的計算機上，於 tnsnames.ora 檔案中新增 net 服務名稱項目。 如需關於網路服務名稱項目的資訊，請參閱 設定 E-Business Suite 配接器的 Oracle 用戶端。
- 由於 Oracle 用戶端的限制，如果您在交易中執行作業，連線 URI 中的 DataSourceName 參數 （net service name） 不能包含超過 39 個字元。 因此，如果您要在交易中執行作業，請確定針對 DataSourceName 參數指定的值小於或等於 39 個字元。
連線 URI 可以包含 Oracle net 服務名稱，用來識別您想要連線的 Oracle E-Business Suite 服務。 Oracle 用戶端會依據您設定的 Oracle 命名方法階層，將您在連線 URI 中提供的 Oracle net 服務名稱解析為 Oracle E-Business Suite 服務的連線資訊。 一個常見的命名方法稱為在地命名。 在本機命名中，Oracle 用戶端會使用名為 tnsnames.ora 的檔案來解析 Oracle net 服務名稱。
WCF 中的一般端點位址 URI 表示為： ，其中： scheme://userauthparams@hostinfoparams
scheme 是方案名稱。
userauthparams 是端點進行用戶驗證所需的參數名稱值集合。
hostinfoparams 是建立與主機連線所需的資訊;例如，net 服務名稱。
Oracle E-Business 配接器連線 URI 遵守此基本格式，並實作如下：
oracleebs://User=[USER_NAME];Password=[PASSWORD]@[NET_SERVICE_NAME]
下表說明連線 URI 中包含的屬性。
| 連接 URI 屬性 | 類別 | 說明 |
|---|---|---|
| [USER_NAME] | 用戶驗證參數 | 要用於驗證的用戶名稱。 Oracle E-Business 配接器會公開 ClientCredentialType 系結屬性，這個屬性會指定用戶端指定用來建立連線的 Oracle 用戶端認證類型。 ClientCredentialType 系結屬性的可能值為 Database 和 EBusiness。 根據這個系結屬性的值，您必須指定相關的認證。 如需詳細資訊，請參閱 Oracle 認證和連線 URI。 注意： 您必須將 AcceptCredentialsInUri 系結屬性設定為 true ，才能在連線 URI 中指定使用者名稱和密碼。 注意： Oracle E-Business 配接器不會維持您在連接到 Oracle E-Business Suite 時針對使用者名稱輸入的值的大小寫。 用戶名稱會使用 SQL*Plus 的標準規則傳遞至 Oracle E-Business Suite。 不過，如果您想要保留使用者名稱的案例，或如果您想要輸入包含特殊字元的用戶名稱，則必須在雙引號內指定值。 |
| [PASSWORD] | 用戶驗證參數 | 要用於驗證的密碼。 Oracle E-Business 配接器會公開 ClientCredentialType 系結屬性，這個屬性會指定用戶端指定用來建立連線的 Oracle 用戶端認證類型。 如果 ClientCredentialType 屬性設定為 Database，客戶端必須指定 Oracle 資料庫使用者的密碼。 如果 ClientCredentialType 屬性設定為 EBusiness，客戶端必須指定 Oracle E-Business Suite 使用者的密碼。 注意： Oracle E-Business 配接器在連接至 Oracle E-Business Suite 時，不會保留您針對密碼輸入的值的大小寫。 用戶名稱會使用 SQL*Plus 的標準規則傳遞至 Oracle E-Business Suite。 不過，如果您想要保留密碼大小寫，或想要輸入包含特殊字元的密碼，則必須在雙引號內指定值。 |
| [NET_SERVICE_NAME] | hostinfoparams | 安裝 Oracle E-Business 配接器之電腦上的 tnsnames.ora 檔案中指定的 net 服務名稱。 如需 net 服務名稱和 tnsnames.ora 的相關信息，請參閱 設定 E-Business Suite 配接器的 Oracle 用戶端。 |
不使用 tnsnames.ora 連線
這很重要
- 您不需要在 tnsnames.ora 中加入網路服務名稱來使用此方法。 此外，您甚至不需要在已安裝配接器用戶端的計算機上擁有 tnsnames.ora 檔案。
- 如果您在交易中執行作業，則不支援這種連線模式。 這是因為 Oracle 用戶端的限制。
WCF 中的一般端點位址 URI 表示為： ，其中： scheme://userauthparams@hostinfoparams
scheme 是方案名稱。
userauthparams 是端點進行用戶驗證所需的參數名稱值集合。
hostinfoparams 是建立與主機連線所需的資訊;例如，伺服器名稱、埠號碼等。
Oracle E-Business 配接器連線 URI 遵守此基本格式，並實作如下：
oracleebs://User=[USER_NAME];Password=[PASSWORD]@[SERVER_NAME]:[PORT_NUMBER]/[SERVICE_NAME]/[SERVICE_TYPE]
下表說明連線 URI 中包含的屬性。
| 連接 URI 屬性 | 類別 | 說明 |
|---|---|---|
| [USER_NAME] | 使用者認證參數 | 要用於驗證的用戶名稱。 Oracle E-Business 配接器會公開 ClientCredentialType 系結屬性，這個屬性會指定用戶端指定用來建立連線的 Oracle 用戶端認證類型。 ClientCredentialType 系結屬性的可能值為 Database 和 EBusiness。 根據這個系結屬性的值，您必須指定相關的認證。 如需詳細資訊，請參閱 Oracle 認證和連線 URI。 注意： 您必須將 AcceptCredentialsInUri 系結屬性設定為 true ，才能在連線 URI 中指定使用者名稱和密碼。 注意： Oracle E-Business 配接器不會維持您在連接到 Oracle E-Business Suite 時針對使用者名稱輸入的值的大小寫。 用戶名稱會使用 SQL*Plus 的標準規則傳遞至 Oracle E-Business Suite。 不過，如果您想要保留使用者名稱的案例，或如果您想要輸入包含特殊字元的用戶名稱，則必須在雙引號內指定值。 |
| [PASSWORD] | 用戶驗證參數 | 要用於驗證的密碼。 Oracle E-Business 配接器會公開 ClientCredentialType 系結屬性，這個屬性會指定用戶端指定用來建立連線的 Oracle 用戶端認證類型。 如果 ClientCredentialType 屬性設定為 Database，客戶端必須指定 Oracle 資料庫使用者的密碼。 如果 ClientCredentialType 屬性設定為 EBusiness，客戶端必須指定 Oracle E-Business Suite 使用者的密碼。 注意： Oracle E-Business 配接器在連線到 Oracle E-Business Suite 時，不區分您為密碼輸入的值的大小寫。 用戶名稱會使用 SQL*Plus 的標準規則傳遞至 Oracle E-Business Suite。 不過，如果您想要保留密碼大小寫，或想要輸入包含特殊字元的密碼，則必須在雙引號內指定值。 |
| [SERVER_NAME] | hostinfoparams | 執行 Oracle E-Business Suite 的伺服器名稱。 這是必要項目。 |
| [PORT_NUMBER] | 主機資訊參數 | Oracle Net Listener 埠。 預設值 1521。 |
| [SERVICE_NAME] | 主機資訊參數 | Oracle 資料庫服務名稱。 這是必要項目。 |
| [SERVICE_TYPE] | hostinfoparams | Oracle 服務的型別。 可能的值為 Dedicated 或 Shared。 專用服務會使用專用的伺服器進程來只提供一個用戶進程。 共用服務會使用可服務多個用戶進程的共享伺服器進程。 預設值為 Dedicated。 |
Oracle 認證和連線 URI
根據預設，Oracle E-Business 配接器會在連線 URI 中指定 Oracle 認證時擲回例外狀況。 這是因為這些認證在連線 URI 中以純文本表示，這會造成安全性風險。 您可以設定 AcceptCredentialsInUri 系結屬性，以控制連線 URI 是否可以包含 Oracle 資料庫的認證。 如果 AcceptCredentialsInUri 屬性為 false，這是預設值，則如果連線 URI 包含 Oracle 認證，Oracle E-Business 配接器會擲回例外狀況;如果屬性為 true，則不會擲回例外狀況。
這很重要
由於將認證以純文本形式傳遞字串所造成的安全性風險，您應該避免在連線 URI 中指定 Oracle 資料庫連線認證。 如需如何更安全地提供 Oracle 資料庫認證的詳細資訊，請參閱 保護您的 Oracle EBS 應用程式。
您也可以選擇指定資料庫認證或 Oracle E-Business Suite 認證，以建立 Oracle E-Business Suite 的連線。 配接器會公開三個系結屬性來啟用此行為： ClientCredentialType、 OracleUserName、 OraclePassword。
ClientCredentialType 系結屬性的可能值為 Database 和 EBusiness。
如果 ClientCredentialType 屬性設定為 Database，客戶端必須指定資料庫認證。
如果 ClientCredentialType 屬性設定為 EBusiness，客戶端必須指定 Oracle E-Business Suite 認證。 在此情況下，配接器客戶端也必須指定 OracleUserName 和 OraclePassword 系結屬性的資料庫認證。
這很重要
在配接器用戶端將 ClientCredentialType 系結屬性設定為 Database 來指定連線至 Oracle E-Business Suite 的資料庫認證，但叫用 Oracle E-Business Suite 成品時，會使用為 OracleUserName 和 OraclePassword 系結屬性指定的值來設定應用程式內容。 在 Oracle E-Business Suite 中叫用工件時，必須設定應用程式內容。 如需設定應用程式內容的詳細資訊，請參閱 設定應用程式內容。
在連線 URI 中使用保留字元
Oracle E-Business 配接器不支援指定任何參數值具有特殊字元的連接 URI。 如果連接參數值包含特殊字元，請確定您執行下列其中一項：
如果您使用 [新增配接器服務參考外掛程式] 或 [取用配接器服務載入巨集] 在 Visual Studio 中指定 URI，則必須在 [URI 屬性 ] 索引標籤中指定它們 as-is，也就是不使用任何逸出字元。 如果您直接在 [ 設定 URI ] 字段中指定 URI，而連接參數包含保留字元，則必須使用適當的逸出字元來指定連接參數。
如果您在 BizTalk Server 管理控制台中建立傳送或接收埠時指定 URI，而且連接參數包含保留字元，您必須使用適當的逸出字元來指定連接參數。
使用連線 URI 連線至 Oracle E-Business Suite
以下是使用 tnsnames.ora 的 Oracle E-Business 配接器連線 URI 範例。
oracleebs://ADAPTER
在此範例中，ADAPTER是 NET 服務名稱，與 tnsnames.ora 中目標 Oracle 資料庫的 SERVICE NAME 和連線資訊相關聯。
以下是 Oracle E-Business 配接器不使用 tnsnames.ora 的連線 URI 範例。
oracleebs://yourOracleServer:1521/yourOracleDatabaseServiceName/Dedicated
在此範例中，伺服器名稱為 「yourOracleServer」，而服務名稱為 「yourOracleDatabaseServiceName」。。
如需了解如何在下列情況下建立 Oracle E-Business Suite 連線的相關資訊：
使用 BizTalk 專案附加元件之取用配接器服務或 Visual Studio 外掛程式之新增配接器服務參考，請參閱 在 Visual Studio 中連線到 Oracle E-Business Suite。
在 BizTalk Server 解決方案中設定傳送埠或接收埠（位置），請參閱手動設定 實體埠系結至 Oracle E-Business 配接器。
另請參閱
設定 E-Business Suite 配接器的 Oracle 用戶端
使用 Windows 驗證連線到 Oracle E-Business Suite
建立 Oracle E-Business Suite 的連線