创建 Siebel 系统连接 URI

  • 项目

适用于 Siebel eBusiness 应用程序的 Microsoft BizTalk 适配器连接 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 中的用户信息

默认情况下，在连接 URI 中指定 Siebel 系统凭据时，Siebel 适配器将引发异常。 这是因为这些凭据以纯文本形式表示，这会带来固有的安全风险。 可以设置 AcceptCredentialsInUri 绑定属性来控制连接 URI 是否可以包含凭据。 如果 AcceptCredentialsInUri 属性为 false，则连接 URI 包含凭据时，Siebel 适配器将引发异常;如果 属性为 true，则不引发异常。

重要

由于将字符串中的凭据作为纯文本传递会带来固有的安全风险，因此最好不要在连接 URI 中指定 Siebel 系统凭据。

可通过多种方式提供 Siebel 系统凭据，而无需在连接 URI 中指定凭据。

  • 在代码中，可以在相应的 对象上设置 ClientCredentials 属性。

  • 使用“添加适配器服务引用”插件或使用适配器服务加载项时，可以通过选择“配置适配器”对话框的“安全性”选项卡来输入凭据。

  • 在BizTalk Server解决方案中指定发送端口或接收位置绑定时，可以通过选择相应对话框的“安全”选项卡来输入凭据。

    Siebel 连接 URI 中 (userinfoparams) 的用户信息表示为用户身份验证所需的参数的名称值集合。 下表介绍了这些参数。

属性 说明
用户名 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) 查询信息用于指定其他连接属性。

属性 说明
SiebelObjectManager 企业服务器上的 Siebel 对象管理器的名称。 此参数是必需的。
SiebelEnterpriseServer Siebel Enterprise Server 的名称。 此参数是必需的。
语言 对象管理器的语言。 此参数是可选的。 如果未指定，Siebel 适配器将提供默认值 (enu) 。
传输 传输;仅支持 tcpip。 此参数是可选的。 如果未指定，Siebel 系统将提供默认值 (tcpip) 。
Encryption 要在 Siebel 适配器和 Siebel 系统之间使用的加密类型。 支持的值为 none、mscrypto 或 rsa。 此参数是可选的。 如果未指定，Siebel 系统将提供默认值 (无) 。
压缩 要在 Siebel 适配器和 Siebel 系统之间使用的压缩算法。 支持的值为 none 或 zlib。 此参数是可选的。 如果未指定，则 Siebel 系统 (zlib) 提供默认值。
SiebelServer Siebel 服务器。 对于所有 Siebel 7.5.5 服务器连接 (7.5.2、7.5.3 等 ) 是必需的;否则，请勿设置此参数。
SiebelRepository Siebel 存储库。 如果服务器上存在多个存储库，则为必需;否则为可选。 注意： 如果服务器上存在多个存储库，则必须在 SiebelRepository 参数中指定目标存储库。

有关查询信息中设置的 Siebel 参数的详细信息，请参阅 Siebel 文档。

在连接 URI 中使用保留字符

Siebel 适配器不支持为任何参数值指定具有特殊字符的连接 URI。 如果连接参数值包含特殊字符，请确保执行下列操作之一：

  • 如果要使用“添加适配器服务引用插件”或“使用适配器服务加载项”在 Visual Studio 中指定 URI，则必须在“ 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 应用程序