CData BizTalk Adapter for LDAP で SQL コマンドスキーマを生成する方法
この記事では、CData BizTalk Adapter を使用して取得したLDAP objectsを処理するためのスキーマ生成方法を説明します。SELECT コマンド用のスキーマを生成します。
このガイドでは、CData BizTalk Adapter for LDAP を使用して LDAP への SQL コマンドを実行する方法を解説します。
LDAP 用アダプターをプロジェクトに追加する
以下の手順で、BizTalk Server プロジェクトにアダプターを追加します。
- まだ行っていない場合は、Visual Studio で新しい BizTalk Server プロジェクトを作成します。
- Solution Explorer でプロジェクトを右クリックし、Add -> Add Generated Items をクリックします。
- 表示されるダイアログボックスで Add Adapter Metadata を選択します。
- 表示される Add Adapter ウィザードで、リストからアダプターを選択します。
- Port メニューでは、選択を空白のままにします。または、トランスポートタイプとしてアダプターが設定されている Receive Location か Send Port を選択することもできます。
SQL コマンド用のスキーマを生成する
Add Adapter ウィザードでアダプターを選択すると、Schema ウィザードが表示されます。以下の手順で接続プロパティを構成し、コマンドの結果のメタデータを取得します。
- Connection String ページで、認証情報やその他の接続プロパティを入力します（BizTalk アプリケーションで既に構成済みのアダプターを選択していない場合）。一般的な接続文字列は以下のとおりです：
User=Domain\BobF;Password=bob123456;Server=10.0.1.1;Port=389;
リクエストを認証するには、User およびPassword プロパティを有効なLDAP クレデンシャル（例えば、User を"Domain\BobF" または"cn=Bob F,ou=Employees,dc=Domain"）に設定します。 CData 製品は、デフォルトでプレーンテキスト認証を使用します。これは、CData 製品がサーバーとTLS/SSL のネゴシエーションを試みるためです。 AuthMechanism を使って別の認証方法を指定できます。 TLS/SSL コンフィギュレーションについて詳しくは、ヘルプドキュメントの「高度な設定」を参照してください。
- 基本接続には、Server およびPort を設定します。さらに、次のように接続を微調整できます。
- FollowReferrals：設定すると、CData 製品は参照サーバーのデータもビューとして表示します。参照サーバー上のデータを変更するには、このサーバーをServer およびPort で指定する必要があります。
- LDAPVersion：サーバーが実装するプロトコルのバージョンに設定します。デフォルトでは、CData 製品はversion 2 を使用します。
- BaseDN は、LDAP 検索の範囲を指定された識別名の高さに限定します。BaseDN の範囲を絞ることはパフォーマンスを劇的に向上させます。例えば、"cn=users,dc=domain" の値は、"cn=users" およびその子に含まれる結果のみを返します。
- Scope：このプロパティを使用すると、サブツリーから返されるデータをより細かく制御できます。
- 次のページ（Schema Information）の General Options セクションで、アダプターの構成に応じて Send Port または Receive Location を選択します。
- 結果セット全体のスキーマを生成する場合は、Message Mode メニューで Single Message オプションを選択します。結果セットの各行ごとにスキーマを生成する場合は、Message Per Row オプションを選択し、メッセージのルート要素が 'row' であることを確認します。
- Command Type メニューで、SQL Command を選択します。
Statement Information ページの SQL Command Text ボックスに、SQL コマンドを入力します（Receive Location または Send Port を構成済みの場合は、構成した SQL コマンドがボックスに入力されています）。この例では以下のクエリを使用します：
SELECT Id, LogonCount FROM User
- ウィザードに表示されるサマリーで設定を確認し、Finish をクリックして schema.xsd ファイルを生成します。
スキーマの処理
シンプルな BizTalk アプリケーションでスキーマを使用する方法については、チュートリアルを参照してください。