Receive Location for the CData BizTalk Adapter for X-Cart を構成

詳細情報をご希望ですか?

無償トライアル:

ダウンロードへ

製品の詳細情報へ:

X-Cart BizTalk Adapter

パワフルなBizTalk Adapter を使って標準オーケストレーションで、 X-Cart データをBizTalk Server に連携。

データ同期、ローカルバックアップ、ワークフロー自動化などに最適。



CData BizTalk Adapter for X-Cart を使用して、BizTalk のX-Cart をプルします。受信場所を使用して、X-CartでSQL コマンドを実行し、アクションを自動化します。

この記事の手順に従ってX-Cart に接続し、静的な一方向の受信場所を構成します。また、それを使用してX-Cart を取得し、XML ファイルに書き込むという簡単なテストを実行できます。

受信場所はSQL コマンドを実行し、その結果を含むBizTalk メッセージを作成することができます。アップデートグラムコマンドを実行したい場合は、送信ポートを使用してください。

受信ポートを作成する

アプリケーションに受信場所を追加するには、まず受信ポートを追加する必要があります。受信ポートは複数の受信場所からのデータを受け取ることができます。

  1. 未実行の場合、BizTalk Administration Console でアプリケーションを開きます。
  2. アプリケーションを開いたら、[Receive Ports]を右クリックし、[New] -> [Static One-Way Receive Port]と進みます。受信ポートプロパティのダイアログが表示されます。
  3. [Name]メニューで、受信ポートの名前を入力します。

受信場所を作成する

受信ポートの作成後、受信場所を作成し、トランスポートタイプとしてSalesforce アダプタを使用するように構成します。

  1. [Receive Locations]を右クリックし、[New] -> [One-Way Receive Location]と進みます。
  2. 新しい受信場所がメンバとなる適切な受信ポートを選択します。受信場所プロパティのダイアログが表示されます。
  3. [Name]メニューで、受信場所の名前を入力します。
  4. 受信場所のプロパティで、[Transport Type]メニューのCData.XCart を選択します。
  5. [Receive Pipeline]メニューで、デフォルトオプションの[PassThruReceive]を選択します。

アダプターを構成する

[Transport Properties]ダイアログで、アダプターが実行するコマンドを定義します。

  1. 受信場所のプロパティで、[Configure]をクリックします。アダプタの[Transport Properties]ダイアログが表示されます。
  2. [SQL Command]プロパティで、コマンドを入力します。この例では、SELECT * FROM PROFILESを使用します。
使用可能なアダプタ構成プロパティについては、[Adapter Configuration]のチャプターを参照してください。

接続文字列を構成する

Connection String Options ダイアログで、資格情報とその他の接続プロパティを設定します。

  1. 受信場所のプロパティで、[Configure]をクリックします。アダプターのプロパティダイアログが表示されます。
  2. [Connection String]プロパティのボタンをクリックします。
  3. [Connection String]プロパティのボックスをクリックします。[Connection String Options]ダイアログが表示されます。
  4. 接続プロパティを入力します。下は一般的な接続文字列です。

    Url=https://example.com/shop;ApiKey=MyApiKey;

    An API Key must be created for your XCart Installation. In order to obtain the API Key, you need to install and configure the REST API Module for your X-Cart installation.

    • Login to your X-Cart Installation. Click on My addons on the bottom of the left side-bar navigation panel.
    • Search for REST API Module. Install the Module.
    • After the module has been installed, you need to set it up.
      • Go to the Settings section for the REST API Module.
      • On the settings page specify the API Key (only read)
    • Set the ApiKey and Url to the connection property to connect to data.

  5. [Test Connection]をクリックして値を確認し、接続を確認します。

プロパティとその機能についての説明は、ヘルプドキュメントを参照してください。

送信ポートを使用し、XML ファイルにデータを書き込む

静的な一方向の受信場所を送信ポートとともに使うことができます。送信ポートは、受信場所で作成されるBizTalk メッセージと関連付けられていなければなりません。ファイルにデータを書き込むために、ファイル送信ポートを作成します。

  1. [BizTalk Administration]コンソールで右クリックし、[Send Ports] -> [New] -> [Static One-Way Send Port]と進みます。
  2. 構成ウィンドウの最初で送信ポートの名前を入力し、[Type]メニューから[FILE]を選択します。

  3. 宛先フォルダを構成します。これは、ディスク上にファイルが作成される場所になります。
  4. ファイル名にマクロを使用すれば、ファイルの作成日を簡単に識別できます。デフォルトでは、%MessageId%.xml が使用されます。これはランダムに生成されたBizTalk Id であり、ユーザーフレンドリーな命名ではありません。 PROFILES_yyyy-MM-dd.xml の形式でファイルを作成するには、PROFILES_%Date%.xml と入力します。

    Noteマクロの詳細については、ヘルプドキュメントの[BizTalk Configuration]のセクションを参照してください。

  5. [OK]をクリックします。URI フィールドに値が含まれるはずです。
  6. 送信ポートの、構成画面の左側にある[Filters]をクリックします。
  7. 次のプロパティを設定します。
    プロパティ:メニューから、[BTS.InboundTransportLocation]を選択します。
    オペレーター:メニューから、[==]を選択します。
    :受信場所のURI を入力します。受信場所のプロパティに、URI が表示されます。

送信ポートを使用して、受信場所から送信されたファイルを書き込むことができます。

ロケーションとポートをエンリストして有効にする

最後に、送信ポートをエンリストし、受信場所を有効にします。送信ポートを右クリックし、[Enlist]をクリックします。次に、受信場所を右クリックし、[Enable]をクリックします。

Note最後に受信場所を有効にすることで、送信ポートによって、ファイルが書き込み用として確実にピックアップされます。

トラブルシューティング

エラーが発生しているかどうかを確認するには、[Administration Console]のナビゲーションツリーで[Event Viewer (Local)]を展開します。Windows ログを展開し、[Applications]をクリックします。

ログにはシステム上のすべてのアプリケーションのエラ-メッセージが含まれるため、エラーメッセージのソースが[CData BizTalk X-Cart Receive Adapter]であることを確認することが必要です。エラーメッセージの詳細から、エラーの理由を知ることができます。エラー解消のガイダンスについては、support@cdata.com/jpにお問い合わせください。