ノーコードでクラウド上のデータとの連携を実現。
詳細はこちら →こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
CData BizTalk Adapter for SugarCRM は、BizTalk のSugar CRM でSQL コマンド、アップデートグラム、ストアドプロシージャを実行することを可能にします。ここでは、アップデートグラムを使用して、Sugar CRM を挿入するアプリケーションのウォークスルーについて説明します。
以下のセクションでは、サンプルアプリケーションの作成について説明します。
Visual Studio のウィザードを使用することで、スキーマとアップデートグラムインスタンスを生成することができます。
[Add Adapter]ウィザードを使用して、プロジェクトにアダプタを追加します。アダプタを使用して、挿入したいテーブルに関する[Accounts]などのSugar CRM メタデータをクエリします。
Sugar CRM データを挿入するアップデートグラムを作成するためのテンプレートとしてスキーマを使用します。スキーマは、XMLリクエストと応答を定義する.xsd ファイルです。例として、挿入アップデートグラムを生成する方法を説明します。以下の手順に従って、update とdelete のアップデートグラムを生成できます。
[Insert]オプションを選択し、挿入したいテーブルとカラムを選択します。このチュートリアルは、Name とAnnualRevenue を使用しています。
Noteアップデートグラムを作成する際、挿入はスキーマに含ませたカラムに限定されます。
このステップでは、後のステップでアダプタに送られるXML メッセージを作成します。[Solution Explorer]にある.xsd ファイルを右クリックし、[Generate Instance]をクリックしてアップデートグラムを作成します。アップデートグラムが保存される場所は、[Output]タブに表示されます。
アップデートグラムは、Sugar CRM から求められる応答を定義するよう構成されています。アップデートグラムの例や詳細については、アダプタのヘルプドキュメントをご覧ください。
アプリケーションに受信場所を追加するには、まず受信ポートを追加する必要があります。受信ポートは複数の受信場所からのデータを受け取ることができます。
静的な一方向のファイル受信場所は、アップデートグラムを含むBizTalk メッセージを作成します。
コンフィギュレーションは、以下のステップで構成されています。
要請応答送信ポートを使用して、 アップデートグラムコマンドの結果を取得します。このチュートリアルでは、新しく挿入されたレコードのId がBizTalkで返されます。
[Adapter Transport Properties]ダイアログで、アダプタが実行するコマンドを定義します。
Sugar CRM への接続に必要な資格情報とその他のプロパティを設定します。
接続プロパティを入力してください。
下は一般的な接続文字列です。
User=MyUser;Password=MyPassword;URL=MySugarCRMAccountURL;CacheMetadata=True;
CData 製品をSugarCRM に認証するには、以下を有効なSugarCRM ユーザー資格情報に設定する必要があります。User:SugarCRM アカウントのユーザー。Password:SugarCRM アカウントのパスワード。
OAuth consumer key とconsumer secret は、Admin -> OAuth Keys で生成することができます。OAuthClientId にOAuth consumer key を、OAuthClientSecret にconsumer secret を設定します。
さらに、SugarCRM への接続を確立するには以下を指定します。URL:'http://{sugar crm instance}.com' の形式で、SugarCRM アカウントに紐付いているURL に設定。Platform:認証中にログインの競合が発生した場合は、SugarCRM UI で作成したプラットフォームのいずれかに設定。
SugarCRM メタデータの取得は高負荷になる可能性があることに注意してください。メタデータのキャッシュ で説明しているように、メタデータをローカルに格納することをお勧めします。
ファイル送信ポートは、インサートから返されるId をファイルに書き込みます。以下のステップに従って一方向送信ポートを構成し、受信メッセージをファイルに書きこみます。
以下のステップに従って、アプリケーションで次の関連を定義するフィルタルールを作成します。
要請応答送信ポートのプロパティで、[Filters]をクリックし、以下の値を設定します。
一方向送信ポートのプロパティで、[Filters]をクリックし、以下の値を設定します。
BizTalk アプリケーションを起動するときに以下の手順に従い、アップデートグラムが受信場所によって確実に取得されるようにします。
受信場所用に構成したフォルダに、アップデートグラムを複製することができます。
一方向送信ポート用に構成したフォルダを開きます。このフォルダは、XML file の新しいId を含みます。メッセージは次の例のようになります。
<table xmlns="http://www.cdata.com/SugarCRMProvider" AffectedRows="1">
<row>
<Id>0014000001XERBUAA5</Id>
</row>
</table>
アプリケーションログでエラーメッセージを表示することで、アプリケーションが正常に初期化されたことを素早く確認できます。ログを開くには、[Administration Console]のナビゲーションツリーで[Event Viewer (Local)]ノードを展開します。Windows ログを展開し、[Applications]を選択します。
発生したエラーのリストはここから入手可能です。ここには、システム上のすべてのアプリケーションのエラ-メッセージが含まれるため、エラーメッセージのソースを確認することが必要です。受信場所では、ソースが[CData BizTalk SugarCRM Receive Adapter]である必要があります。エラーメッセージの詳細から、エラーの理由を知ることができます。
エラー解消のガイダンスについては、support@cdata.com/jp にお問い合わせください。