CData BizTalk Adapter for Kintone で SQL コマンドスキーマを生成する方法
この記事では、CData BizTalk Adapter を使用して取得したKintone のデータを処理するためのスキーマ生成方法を説明します。SELECT コマンド用のスキーマを生成します。
このガイドでは、CData BizTalk Adapter for Kintone を使用して Kintone への SQL コマンドを実行する方法を解説します。
Kintone 用アダプターをプロジェクトに追加する
以下の手順で、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=myuseraccount;Password=mypassword;URL=http://subdomain.domain.com;
Kintone 接続プロパティの設定方法
それでは、Kintone に接続していきましょう。接続するには、以下の接続プロパティを設定します。
- URL：Kintone のアクセスURL（例：https://yoursitename.cybozu.com または https://yoursitename.kintone.com）
- User：アカウントのユーザー名
- Password：アカウントのパスワード
- AuthScheme：「Password」を指定
パスワード認証の代わりにAPI トークン認証をご利用になる場合は、ヘルプドキュメントの「接続の設定」セクションをご確認ください。
Basic 認証の設定
続いて、ご利用のKintone ドメインでBasic 認証を有効にしている場合は、接続プロパティの「詳細」設定で以下の項目を追加設定してください。
- BasicAuthUser：Basic 認証のユーザー名
- BasicAuthPassword：Basic 認証のパスワード
クライアント証明書認証の設定
Basic 認証の代わりにクライアント証明書による認証をご利用になる場合は、以下の項目を設定してください。
- SSLClientCert：クライアント証明書のパス
- SSLClientCertType：証明書の種類
- SSLClientCertSubject：証明書のサブジェクト
- SSLClientCertPassword：証明書のパスワード
- 次のページ（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 Name, Description FROM Apps
- ウィザードに表示されるサマリーで設定を確認し、Finish をクリックして schema.xsd ファイルを生成します。
スキーマの処理
シンプルな BizTalk アプリケーションでスキーマを使用する方法については、チュートリアルを参照してください。