CData BizTalk Adapter for TaxJar で SQL コマンドスキーマを生成する方法
この記事では、CData BizTalk Adapter を使用して取得したTaxJar のデータを処理するためのスキーマ生成方法を説明します。SELECT コマンド用のスキーマを生成します。
このガイドでは、CData BizTalk Adapter for TaxJar を使用して TaxJar への SQL コマンドを実行する方法を解説します。
TaxJar 用アダプターをプロジェクトに追加する
以下の手順で、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 アプリケーションで既に構成済みのアダプターを選択していない場合）。一般的な接続文字列は以下のとおりです：
APIKey=3bb04218ef8t80efdf1739abf7257144;
TaxJar API への認証には、まず初めにTaxJar UI からAPI キーを取得する必要があります。
NOTE：API の利用は、Professional およびPremium TaxJar プランでのみ可能です。
すでにProfessional またはPremium プランをお持ちの方は、TaxJar UI にログインして、「アカウント」->「TaxJar API」に移動するとAPI キーを確認することができます。 API キーを取得したら、APIKey 接続プロパティに設定できます。
その他の注意事項
- デフォルトでは、エンティティが日付範囲フィルタをサポートしている場合、CData コネクタは過去3か月のデータを取得します。StartDate を設定して、取得するデータの最小作成日を指定することができます。
- API キーがサンドボックスAPI アカウント用に作成されている場合は、UseSandbox をtrue に設定してください。ただし、すべてのエンドポイントが期待どおりに機能するとは限りません。詳しくは、TaxJar 開発者用ドキュメントを参照してください。
- 次のページ（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 TransactionID, UserID FROM Orders WHERE TransactionID = '123'
- ウィザードに表示されるサマリーで設定を確認し、Finish をクリックして schema.xsd ファイルを生成します。
スキーマの処理
シンプルな BizTalk アプリケーションでスキーマを使用する方法については、チュートリアルを参照してください。