共用方式為

建立 Siebel 系統連線 URI

  • 發行項

Microsoft BizTalk Adapter for Siebel eBusiness Applications 連線 URI 包含配接器用來建立 Siebel 系統連線的屬性。

本主題提供 Siebel 連線 URI 的相關資訊，也提供其他主題的連結，說明如何在不同的程式設計案例中指定連線 URI。

Siebel 配接器的連線 URI

典型的 WCF 端點位址 URI 會以下列方式表示：

scheme://userinfoparams@hostinfoparams?query_string

端點位址 URI 包含下列元件：

  • scheme 是配置名稱。

  • userinfoparams 是端點進行使用者驗證所需的參數名稱值集合。

  • hostinfoparams 是建立與主機連線所需的資訊;例如，路徑。

  • query_string是以問號 (？) 分隔之參數的選擇性名稱/值集合。

    Siebel 連線 URI 遵循此一般格式，並實作如下：

siebel://Username=[USER_NAME];Password=[PASSWORD]@[SERVER]:[PORT]?SiebelObjectManager=[SIEBEL_OBJECT_MANAGER_NAME]&SiebelEnterpriseServer=[SERVER_NAME]&Language=[LANGUAGE]&Transport=[TRANSPORT]&Encryption=[ENCRYPTION]&Compression=[COMPRESSION]&SiebelServer=[SIEBEL_SERVER_NAME]&SiebelRepository=[SIEBEL_REPOSITORY_NAME]

下列各節說明針對 Siebel 連線 URI 的每個元件所實作的屬性。

Siebel 連線 URI 的配置

Siebel 連線 URI 的配置為 「siebel」。

Siebel 連線 URI 中的使用者資訊

根據預設，Siebel 配接器會在連線 URI 中指定 Siebel 系統認證時擲回例外狀況。 這是因為這些認證會以純文字表示，這會造成固有的安全性風險。 您可以設定 AcceptCredentialsInUri 系結屬性，以控制連線 URI 是否可以包含認證。 如果 AcceptCredentialsInUri 屬性為 false，則如果連線 URI 包含認證，Siebel 配接器會擲回例外狀況;如果屬性為 true，則不會擲回任何例外狀況。

重要

由於將認證以純文字形式傳遞字串所造成的固有安全性風險，最好不要在連線 URI 中指定 Siebel 系統認證。

有數種方式可以提供 Siebel 系統認證，而不需在連線 URI 中指定認證。

  • 在程式碼中，您可以在適當的物件上設定 ClientCredentials 屬性。

  • 當您使用 [新增配接器服務參考外掛程式] 或 [取用配接器服務增益集] 時，您可以選取 [設定配接器] 對話方塊的 [安全性] 索引標籤來輸入認證。

  • 當您在BizTalk Server解決方案中指定傳送埠或接收位置系結時，您可以選取適當對話方塊的 [安全性] 索引標籤來輸入認證。

    Siebel 連線 URI 中 userinfoparams) 的使用者 (資訊會表示為使用者驗證所需的參數名稱/值集合。 下列表格描述這些參數。

屬性 Description
使用者名稱 Siebel 系統上的使用者名稱;此值區分大小寫。 您必須將 AcceptCredentialsInUri 系結屬性設定為 true ，才能在連線 URI 中指定使用者名稱和密碼。 注意： Siebel 配接器會保留您在 Siebel 系統上開啟連線時為使用者名稱輸入的值大小寫。
密碼 Siebel 系統上使用者的密碼;此值區分大小寫。 您必須將 AcceptCredentialsInUri 系結屬性設定為 true ，才能在連線 URI 中指定使用者名稱和密碼。 注意： Siebel 配接器會保留您在 Siebel 系統上開啟連線時為密碼輸入的值大小寫。

Siebel 連線 URI 中的主機資訊

Siebel 主機資訊 (hostinfoparams) 以下列格式指定 Siebel 系統的位址：[SERVER]：[PORT]。 根據 Siebel 伺服器版本，Siebel 主機資訊會採用不同的值：

  • 針對 Siebel 7.5 版和更早版本，主機資訊參數會採用安裝 Siebel 閘道伺服器的電腦名稱稱，以及 Siebel 閘道埠號碼。

  • 針對 Siebel 7.7 版和更新版本，主機資訊參數會採用安裝 Siebel 伺服器的電腦名稱稱，以及 Siebel 連線代理人埠號碼。

    重要

    當您使用新增配接器服務參考 Visual Studio 外掛程式或取用配接器服務 BizTalk 專案增益集來連線到 Siebel 系統時，必須針對 「SiebelGateway」 連接屬性提供主機資訊。

Siebel 連線 URI 中的查詢資訊

Siebel 連線 URI 中的查詢資訊 (query_string) 用來指定其他連線屬性。

屬性 Description
SiebelObjectManager 企業伺服器上的 Siebel 物件管理員名稱。 此為必要參數。
SiebelEnterpriseServer Siebel Enterprise Server 的名稱。 此為必要參數。
語言 物件管理員的語言。 這是選擇性參數。 如果未指定，Siebel 配接器會提供預設值 (enu) 。
傳輸 傳輸;僅支援 tcpip。 這是選擇性參數。 如果未指定，Siebel 系統會提供預設值 (tcpip) 。
加密 要在 Siebel 介面卡與 Siebel 系統之間使用的加密類型。 支援的值為 none、mscrypto 或 rsa。 這是選擇性參數。 如果未指定，Siebel 系統會提供預設值 (無) 。
壓縮 要在 Siebel 介面卡與 Siebel 系統之間使用的壓縮演算法。 支援的值為 none 或 zlib。 這是選擇性參數。 如果未指定，Siebel 系統會提供預設值 (zlib) 。
SiebelServer Siebel 伺服器。 (7.5.2、7.5.3 等 ) 的所有 Siebel 7.5 伺服器連線都需要;否則，請勿設定此參數。
SiebelRepository Siebel 存放庫。 如果伺服器上存在多個存放庫，則為必要項;否則為選擇性。 注意： 如果伺服器上存在多個存放庫，您必須在 SiebelRepository 參數中指定目標存放庫。

如需查詢資訊中所設定之 Siebel 參數的詳細資訊，請參閱您的 Siebel 檔。

在連線 URI 中使用保留字元

Siebel 配接器不支援針對任何參數值指定具有特殊字元的連接 URI。 如果連接參數值包含特殊字元，請確定您執行下列其中一項：

  • 如果您使用 [新增配接器服務參考外掛程式] 或 [取用配接器服務增益集] 在 Visual Studio 中指定 URI，則必須在 [ URI 屬性 ] 索引標籤中指定它們原狀，也就是不使用任何逸出字元。 如果您直接在 [ 設定 URI ] 欄位中指定 URI，且連接參數包含保留字元，則必須使用適當的逸出字元來指定連接參數。

  • 如果您在 BizTalk Server 管理主控台中建立傳送或接收埠時指定 URI，且連線參數包含保留字元，則必須使用適當的逸出字元來指定連接參數。

使用連線 URI 連線至 Siebel 系統

以下是範例 Siebel 連線 URI。

siebel://Username=YourUserName;Password=YourPassword@Siebel_server:1234?SiebelObjectManager=obj_mgr&SiebelEnterpriseServer=entserver&Language=enu

注意

此範例 URI 包含 Siebel 系統認證;您必須將 AcceptCredentialsInUri 系結屬性設定為 true ，才能使用包含認證的連線 URI。

如需如何建立 Siebel 系統連線的相關資訊， (包括設定連線屬性) 時：

另請參閱

建立與 Siebel 系統的連線
開發您的 Siebel 應用程式
使用 WCF 通道模型開發 Siebel 應用程式3
使用 WCF 服務模型開發 SQL 應用程式