LobSystemInstance

项目
06/15/2015

LobSystemInstance 对象的主要用途是，为业务数据目录的 Infrastructure 组件提供身份验证和连接字符串信息。该 Infrastructure 组件为业务数据目录客户端提供运行时连接管理。LobSystemInstance 对象必须具有唯一的名称。

客户端影响

Microsoft Office SharePoint Server 2007 中的实体选取器列出业务数据目录中可用的、您具有其权限的 LobSystemInstance 对象，并可让您在添加 Web 部件和业务数据列时选取实体。

Remarks

利用 LobSystemInstance 对象，可以将两组特定于实例的数据（例如连接参数和身份验证设置）与单个系统定义关联 - 一个用于 Web 客户端，另一个专用于搜索。这在以下情况下非常有用：您有多组不同的安全凭据，用于访问数据（使用 Web 客户端）和爬网搜索。

示例

说明

下面的示例演示 LobSystemInstance 对象的元数据 XML。此对象具有用于数据库和 Web 服务的多组不同的属性。代码示例后面的前两个表列出 LobSystemInstance 对象允许的属性。

代码

使用 PassThrough 身份验证的数据库

  <LobSystemInstances>
    <!-- An LobSystem can have only one LobSystemInstance. The LobSystemInstance defines the connection and authentication parameters. -->
    <LobSystemInstance Name="AdventureWorksSample">
      <Properties>
        <Property Name="AuthenticationMode" Type="System.String">PassThrough</Property>
        <!--AuthenticationMode can be set to PassThrough, RevertToSelf, RdbCredentials, or WindowsCredentials. -->
        <Property Name="DatabaseAccessProvider" Type="System.String">SqlServer</Property>
        <!-- Can be SQL Server, OlEDB, Oracle, or ODBC for database systems. -->
        <Property Name="RdbConnection Data Source" Type="System.String">YourAdventureWorks2000ServerNameHere</Property>
        <!-- The name of your server hosting the database or the name of the SQL Server instance in the format SQLServer\Instance. -->
        <Property Name="RdbConnection Initial Catalog" Type="System.String">AdventureWorks2000</Property>
        <!-- The name of the database.> -->
        <Property Name="RdbConnection Integrated Security" Type="System.String">SSPI</Property>
        <Property Name="RdbConnection Pooling" Type="System.String">false</Property>
       </Properties>
    </LobSystemInstance>
  </LobSystemInstances>

使用单一登录的数据库

<LobSystemInstances>
    <LobSystemInstance Name="AdventureWorksSampleSSO">
      <Properties>
        <Property Name="AuthenticationMode" Type="System.String">WindowsCredentials</Property>
        <Property Name="DatabaseAccessProvider" Type="System.String">SqlServer</Property>
        <Property Name="RdbConnection Data Source" Type="System.String">YourAdventureWorks2000ServerNameHere</Property>
        <Property Name="RdbConnection Initial Catalog" Type="System.String">AdventureWorks2000</Property>
        <Property Name="RdbConnection Integrated Security" Type="System.String">SSPI</Property>
        <Property Name="RdbConnection Pooling" Type="System.String">false</Property>
        <Property Name="SsoApplicationId" Type="System.String">AdventureWorks</Property>
        <Property Name="SsoProviderImplementation" 
            Type="System.String">Microsoft.SharePoint.Portal.
            SingleSignon.SpsSsoProvider, 
            Microsoft.SharePoint.Portal.SingleSignon, 
            Version=12.0.0.0, Culture=neutral, 
            PublicKeyToken=71e9bce111e9429c</Property>
      </Properties>
    </LobSystemInstance>
  </LobSystemInstances>

Web 服务

  <LobSystemInstances>
    <LobSystemInstance Name="AWSECommerceService">
      <Properties>
        <Property Name="WebServiceAuthenticationMode" Type="System.String">PassThrough</Property>
       </Properties>
    </LobSystemInstance>
  </LobSystemInstances>

属性

以下是 LobSystemInstance 对象对于数据库系统所能接受的属性。

属性	类型	必需	默认值	限制/接受的值	注释
AuthenticationMode	Microsoft.Office.Server.ApplicationRegistry.SystemSpecific.Db.DbAuthenticationMode	否	RevertToSelf	PassThrough RevertToSelf Credentials WindowsCredentials
DatabaseAccessProvider	Microsoft.Office.Server.ApplicationRegistry.SystemSpecific.Db.DbAccessProvider	否	SqlServer	SqlServer OleDb Oracle Odbc
SsoProviderImplementation	System.String	是，如果 AuthenticationMode 为 Credentials 或 WindowsCredentials	无	Microsoft 单一登录提供程序	ISsoProvider 实现（存储用于登录到数据库的凭据）的完全限定类型名称。
SsoApplicationId	System.String	否	无		SSO 企业应用程序定义（存储用于连接到数据库的凭据）的 ID。
RdbConnection Data Source RdbConnection Initial Catalog RdbConnection Integrated Security RdbConnection Pooling	System.String	否	无		带有 RdbConnection 前缀的属性成为数据库连接属性。例如，“RdbConnection Data Source”属性成为有关数据库连接的“Data Source”属性。
NumberOfConnections	System.Int32	否	-1	-1 或正数	允许同时连接到系统的最大连接数。如果值为 -1，则没有最大值。
SecondarySsoApplicationId	System.String	否	无		SSO 企业应用程序定义（存储由筛选器 Username 和 Password 所使用的凭据）的 ID。

以下是 LobSystemInstance 对象对于 Web 服务系统所能接受的属性。

属性	类型	必需	默认值	限制/接受的值	注释
WebServiceAuthenticationMode	System.String	否	RevertToSelf	PassThrough RevertToSelf Credentials WindowsCredentials	用于调用 Web 服务方法的身份验证模式。
SsoProviderImplementation	System.String	是，如果 WsdlFetchAuthenticationMode 为 Credentials 或 WindowsCredentials	无	Microsoft 单一登录提供程序	ISsoProvider 实现（存储用于调用 Web 服务的凭据）的完全限定类型名称。
WebServiceSsoApplicationId	System.String	是，如果 WsdlFetchAuthenticationMode 为 Credentials 或 WindowsCredentials	无		SSO 企业应用程序定义（存储用于调用 Web 服务的凭据）的 ID。
WebProxyServerConfiguration	System.String	否	无		代理服务器 URL。提取 WSDL 或调用 Web 服务方法的请求均会通过此代理服务器发送。
NumberOfConnections	System.Int32	否	-1	-1 或正数	允许同时连接到系统的最大连接数。如果值为 -1，则没有最大值。
SecondarySsoApplicationId	System.String	否	无		SSO 企业应用程序定义（存储 Username 和 Password 筛选器的用户名和密码以及 HTTP 和 SOAP 标头）的 ID。
WebServiceUrlOverride	System.String	否	无		替代用于访问 Web 服务的 URL。默认行为是使用 WSDL 文件中定义的 Web 服务 URL。

通过