CData BizTalk Adapter for Act CRM で SQL コマンドスキーマを生成する方法
この記事では、CData BizTalk Adapter を使用して取得したAct CRM のデータを処理するためのスキーマ生成方法を説明します。SELECT コマンド用のスキーマを生成します。
このガイドでは、CData BizTalk Adapter for Act CRM を使用して Act CRM への SQL コマンドを実行する方法を解説します。
Act CRM 用アダプターをプロジェクトに追加する
以下の手順で、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 アプリケーションで既に構成済みのアダプターを選択していない場合）。一般的な接続文字列は以下のとおりです：
URL=https://myActCRMserver.com;User=myUser;Password=myPassword;ActDatabase=MyDB;
Authentication セクションのUser とPassword プロパティに、有効なAct! ユーザー資格情報を設定する必要があります。認証値に加えて、以下も参照してください。
-
Act! Premium への接続
認証値に加えて、Act! へのURL も設定が必要です。例：https://eup1-iis-04.eu.hosted.act.com/。
さらに、接続するActDatabase を指定する必要があります。これは、ご自分のアカウントの「About Act! Premium」メニューのページ右上にある「?」で確認することができます。表示されたウィンドウの「Database Name」を使用します。
-
Act! Premium Cloud への接続
Act! Premium Cloud アカウントに接続するには、ActCloudName プロパティも指定する必要があります。このプロパティはCloud アカウントのURL アドレスで確認できます。例：https://eup1-iis-04.eu.hosted.act.com/ActCloudName/。
ActCRM メタデータの取得は高負荷になる可能性があることに注意してください。CacheMetadata プロパティを設定して、メタデータをローカルに格納することをお勧めします。
-
- 次のページ（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 ActivityDisplayName, Subject FROM Activities
- ウィザードに表示されるサマリーで設定を確認し、Finish をクリックして schema.xsd ファイルを生成します。
スキーマの処理
シンプルな BizTalk アプリケーションでスキーマを使用する方法については、チュートリアルを参照してください。