CData BizTalk Adapter for Dropbox で SQL コマンドスキーマを生成する方法

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
CData BizTalk Adapter は、データを XML として返すことで BizTalk でのDropbox のデータの処理を容易にします。BizTalk でアクセスしたいテーブルの XML スキーマファイルを作成することで、BizTalk オーケストレーションでこのデータを利用できます。

この記事では、CData BizTalk Adapter を使用して取得したDropbox のデータを処理するためのスキーマ生成方法を説明します。SELECT コマンド用のスキーマを生成します。

このガイドでは、CData BizTalk Adapter for Dropbox を使用して Dropbox への SQL コマンドを実行する方法を解説します。

Dropbox 用アダプターをプロジェクトに追加する

以下の手順で、BizTalk Server プロジェクトにアダプターを追加します。

  1. まだ行っていない場合は、Visual Studio で新しい BizTalk Server プロジェクトを作成します。
  2. Solution Explorer でプロジェクトを右クリックし、Add -> Add Generated Items をクリックします。
  3. 表示されるダイアログボックスで Add Adapter Metadata を選択します。
  4. 表示される Add Adapter ウィザードで、リストからアダプターを選択します。
  5. Port メニューでは、選択を空白のままにします。または、トランスポートタイプとしてアダプターが設定されている Receive Location か Send Port を選択することもできます。

SQL コマンド用のスキーマを生成する

Add Adapter ウィザードでアダプターを選択すると、Schema ウィザードが表示されます。以下の手順で接続プロパティを構成し、コマンドの結果のメタデータを取得します。

  1. Connection String ページで、認証情報やその他の接続プロパティを入力します(BizTalk アプリケーションで既に構成済みのアダプターを選択していない場合)。

    OAuth では認証するユーザーにブラウザでDropbox との通信を要求します。CData 製品は、以下のようにさまざまな方法でこれを容易にします。 ユーザー資格情報の接続プロパティを設定せずに接続できます。 接続すると、CData 製品はデフォルトブラウザでOAuth エンドポイントを開きます。ログインして、CData 製品にアクセス許可を与えます。CData 製品がOAuth プロセスを完了します。

    他のOAuth 認証フローについては、ヘルプドキュメントの「OAuth 認証の使用」を参照してください。

    なお、Dropbox Driver はDropbox のファイルの一覧表示やユーザー管理情報の取得用です。Dropbox に保管されているExcel、CSV、JSON などのファイル内のデータを読み込みたい場合には、Excel DriverCSV DriverJSON Driver をご利用ください。

  2. 次のページ(Schema Information)の General Options セクションで、アダプターの構成に応じて Send Port または Receive Location を選択します。
  3. 結果セット全体のスキーマを生成する場合は、Message Mode メニューで Single Message オプションを選択します。結果セットの各行ごとにスキーマを生成する場合は、Message Per Row オプションを選択し、メッセージのルート要素が 'row' であることを確認します。
  4. Command Type メニューで、SQL Command を選択します。
  5. Statement Information ページの SQL Command Text ボックスに、SQL コマンドを入力します(Receive Location または Send Port を構成済みの場合は、構成した SQL コマンドがボックスに入力されています)。この例では以下のクエリを使用します:

    SELECT Id, Name FROM Files
    
  6. ウィザードに表示されるサマリーで設定を確認し、Finish をクリックして schema.xsd ファイルを生成します。

スキーマの処理

シンプルな BizTalk アプリケーションでスキーマを使用する方法については、チュートリアルを参照してください。

はじめる準備はできましたか?

詳細:

Dropbox 連携ソリューション