CData BizTalk Adapter for JSON の要請応答送信ポートを構成

アダプタ for JSON を要請応答送信ポートと共に使用して、BizTalk でアップデートグラムとデータ操作 SQL を実行します。

ここでは、CData BizTalk Adapter for JSON を使用し、静的な要請応答送信ポートを作成、構成、テストする手順を説明します。静的な要請応答送信ポートを使用してコマンドを実行し、BizTalk の結果にアクセスすることができます。送信ポートを使用することで、アップデートグラムコマンド、SQL コマンド、ストアドプロシージャ操作を実行できます。

送信ポートを作成し構成する

静的な要請応答送信ポートを作成し、アダプタをトランスポートタイプとして使用するように構成します。

  1. 未実行の場合、BizTalk 管理コンソールで BizTalk アプリケーションを開きます。
  2. BizTalk アプリのノードで、[Send Ports]を右クリックし、[New]->[Static Solicit-Response Send Port]を選択すると、送信ポートプロパティのダイアログが表示されます。
  3. 送信ポートのプロパティで、受信ポートの名前を入力します。
  4. [Transport Type]メニューで、CData.JSON を選択します。
  5. [Send Pipeline]メニューで、デフォルトオプションの[PassThruTransmit]を選択します。
  6. [Receive Pipeline]メニューで、デフォルトオプションの[PassThruReceive]を選択します。

アダプタを構成する

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

  1. 送信ポートのプロパティで、[Configure]ボタンをクリックします。アダプタのトランスポートプロパティダイアログが表示されます。
  2. [CommandType]プロパティで、実行したいコマンドタイプを選択します。
  3. SQL コマンドを実行したい場合は、[SQL Command]のボックスにコマンドを入力してください。
プロパティとその機能についての説明は、ヘルプドキュメントの[Adapter Configuration]を参照してください。

JSON への接続を構成する

[Connection String Options]ダイアログで、JSON への接続に必要な資格情報とその他のプロパティを設定します。

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

    URI=C:\people.json;DataModel=Relational;

    データソースへの認証については、ヘルプドキュメントの「はじめに」を参照してください。本製品は、JSON API を双方向データベーステーブルとして、JSON ファイルを読み取り専用ビュー(ローカル ファイル、一般的なクラウドサービスに保存されているファイル、FTP サーバー)としてモデル化します。HTTP Basic、Digest、NTLM、OAuth、FTP などの主要な認証スキームがサポートされています。詳細はヘルプドキュメントの「はじめに」を参照してください。

    URI を設定して認証値を入力したら、DataModel を設定してデータ表現とデータ構造をより厳密に一致させます。

    DataModel プロパティは、データをどのようにテーブルに表現するかを制御するプロパティで、次の基本設定を切り替えます。

    • Document(デフォルト):JSON データのトップレベルのドキュメントビューをモデル化します。本製品 は、ネストされたオブジェクト配列を集約されたJSON オブジェクトとして返します。
    • FlattenedDocuments:ネストされた配列オブジェクトと親オブジェクトを、単一テーブルに暗黙的に結合します。
    • Relational:階層データから個々の関連テーブルを返します。テーブルには、親ドキュメントにリンクする主キーと外部キーが含まれています。

    リレーショナル表現の設定についての詳細は、ヘルプドキュメントの「JSON データのモデリング」を参照してください。また、以下の例で使用されているサンプルデータも確認できます。データには人や所有する車、それらの車に行われたさまざまなメンテナンスサービスのエントリが含まれています。

  4. [Test Connection]をクリックして値を確認し、接続を確認します。
プロパティとその機能の説明については、ヘルプドキュメントの[Connection String Options]チャプターを参照してください。
アダプタfor JSON のアップデートグラムチュートリアル]では、要請応答送信ポートを使用して、JSON にアップデートグラムを挿入するシンプルなアプリケーションを作成する手順を説明します。
 
 
ダウンロード