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

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

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

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

以下の手順で、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 アプリケーションで既に構成済みのアダプターを選択していない場合）。一般的な接続文字列は以下のとおりです：

   AccountsServer=AccountsServer;
   

   Zoho Creator 接続プロパティの取得・設定方法

   Zoho Creator に接続するには、Region をサーバーURL のトップレベルドメイン（TLD）に設定します。

   Zoho Creator への認証

   Zoho Creator は、データに接続する2つの方法を提供します。

   • デスクトップ経由で自分のローカルデータに接続する場合（非ブラウザ接続）は、CData が提供する組み込みOAuth アプリケーションを使用します。
   • ネットワーク経由で共有データに接続する場合（ブラウザ接続）は、カスタムOAuth アプリケーションを使用します。
   すべてのOAuth フロー（埋め込みまたはカスタム）で、この認証を有効にするにはAuthScheme をOAuth に設定する必要があります。 ヘルプドキュメントでは、次の3つの一般的な認証フローでのZoho Creator への認証について詳しく説明します。
   • デスクトップ：ユーザーのローカルマシン上でのサーバーへの接続で、テストやプロトタイピングによく使用されます。埋め込みOAuth またはカスタムOAuth で認証されます。
   • Web：共有ウェブサイト経由でデータにアクセスします。カスタムOAuth でのみ認証されます。
   • ヘッドレスサーバー：他のコンピュータやそのユーザーにサービスを提供する専用コンピュータで、モニタやキーボードなしで動作するように構成されています。埋め込みOAuth またはカスタムOAuth で認証されます。
   認証方法の詳細は、ヘルプドキュメントを参照してください。
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, Leave_Type FROM Leave_Types WHERE Leave_Type = 'Sick'
   

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

スキーマの処理

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