LobSystemInstance

LobSystemInstance オブジェクトの主な目的は、ビジネス データ カタログのインフラストラクチャのコンポーネントに認証と接続文字列の情報を提供することです。インフラストラクチャのコンポーネントは、ビジネス データ カタログのクライアントのために、実行時の接続管理を行います。LobSystemInstance オブジェクトには一意の名前が必要です。

クライアントへの影響

Microsoft Office SharePoint Server 2007 のエンティティ選択ウィンドウには、ユーザーが権限を持っているビジネス データ カタログで使用できる LobSystemInstance オブジェクトが一覧表示され、Web パーツやビジネス データの列を追加するときにエンティティを選択できます。

Remarks

LobSystemInstance オブジェクトを使用すると、接続パラメータと認証設定などの 2 セットのインスタンス固有のデータを、1 つは Web クライアント用、もう 1 つは検索専用として、単一のシステム定義と関連付けることができます。これは、セキュリティ資格情報のセットが、Web クライアントを使用してデータにアクセスするときと検索のクロールを行うときで異なっている場合に、非常に役立ちます。

例

説明

以下の例は、LobSystemInstance オブジェクトのメタデータを表す XML を示しています。このオブジェクトが取るプロパティのセットは、データベースの場合と Web サービスの場合で異なります。コード例に続く最初の 2 つの表には、LobSystemInstance オブジェクトで使用できるプロパティが一覧表示されます。

コード

パス スルー認証を使用するデータベース

  <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	いいえ	なし		Username フィルタおよび Password フィルタで使用される資格情報を格納する SSO 企業アプリケーション定義の ID。

以下に、LobSystemInstance オブジェクトで Web サービス システムのために使用できるプロパティを示します。

プロパティ	型	必須	既定値	制限/使用する値	コメント
WebServiceAuthenticationMode	System.String	いいえ	RevertToSelf	PassThrough RevertToSelf Credentials WindowsCredentials	Web サービス メソッドの呼び出しに使用される認証モード。
SsoProviderImplementation	System.String	WsdlFetchAuthenticationMode が Credentials または WindowsCredentials の場合は必須	なし	Microsoft シングル サインオン プロバイダ	Web サービスの呼び出しに使用される資格情報を格納する ISsoProvider 実装の完全修飾の種類名。
WebServiceSsoApplicationId	System.String	WsdlFetchAuthenticationMode が Credentials または WindowsCredentials の場合は必須	なし		Web サービスの呼び出しに使用される資格情報を格納する SSO 企業アプリケーション定義の ID。
WebProxyServerConfiguration	System.String	いいえ	なし		プロキシ サーバー URL。WSDL の取得要求や Web サービスのメソッドの呼び出し要求は、このプロキシ サーバー経由でルーティングされます。
NumberOfConnections	System.Int32	いいえ	-1	-1 または正の数	システムに対して許可される同時接続の最大数。値が -1 の場合、最大数はありません。
SecondarySsoApplicationId	System.String	いいえ	なし		Username フィルタや Password フィルタ、および HTTP ヘッダーや SOAP ヘッダーで使用されるユーザー名とパスワードを格納する SSO 企業アプリケーション定義の ID。
WebServiceUrlOverride	System.String	いいえ	なし		Web サービスへのアクセスに使用される URL を上書きします。既定の動作では、WSDL ファイルで定義されている Web サービス URL を使用します。

See Also

タスク

AdventureWorks SQL Server 2000 のサンプル

[方法] ランタイム オブジェクト モデルの使用を開始する

[方法] 管理オブジェクト モデルの使用を開始する

概念

ビジネス データ カタログの認証

FAQ : ビジネス データ カタログ

ビジネス データ カタログ : 用語集