ここでは、CData BizTalk Adapter for JSON を使用し、静的な要請応答送信ポートを作成、構成、テストする手順を説明します。静的な要請応答送信ポートを使用してコマンドを実行し、BizTalk の結果にアクセスすることができます。送信ポートを使用することで、アップデートグラムコマンド、SQL コマンド、ストアドプロシージャ操作を実行できます。
送信ポートを作成し構成する
静的な要請応答送信ポートを作成し、アダプタをトランスポートタイプとして使用するように構成します。
- 未実行の場合、BizTalk 管理コンソールで BizTalk アプリケーションを開きます。
- BizTalk アプリのノードで、［Send Ports］を右クリックし、［New］->［Static Solicit-Response Send Port］を選択すると、送信ポートプロパティのダイアログが表示されます。
- 送信ポートのプロパティで、受信ポートの名前を入力します。
- ［Transport Type］メニューで、CData.JSON を選択します。
- ［Send Pipeline］メニューで、デフォルトオプションの［PassThruTransmit］を選択します。
- ［Receive Pipeline］メニューで、デフォルトオプションの［PassThruReceive］を選択します。
アダプタを構成する
［Transport Properties］ダイアログで、アダプタが実行するコマンドを定義します。
- 送信ポートのプロパティで、［Configure］ボタンをクリックします。アダプタのトランスポートプロパティダイアログが表示されます。
- ［CommandType］プロパティで、実行したいコマンドタイプを選択します。
- SQL コマンドを実行したい場合は、［SQL Command］のボックスにコマンドを入力してください。
プロパティとその機能についての説明は、ヘルプドキュメントの［Adapter Configuration］を参照してください。
JSON への接続を構成する
［Connection String Options］ダイアログで、JSON への接続に必要な資格情報とその他のプロパティを設定します。
- 送信ポートのプロパティで、［Configure］をクリックします。アダプタのプロパティダイアログが表示されます。
- ［Connection String］プロパティのボタンをクリックします。［Connection String Options］ダイアログが表示されます。
- 接続プロパティを入力します。下は一般的な接続文字列です。
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 データのモデリング」を参照してください。また、以下の例で使用されているサンプルデータも確認できます。データには人や所有する車、それらの車に行われたさまざまなメンテナンスサービスのエントリが含まれています。
- ［Test Connection］をクリックして値を確認し、接続を確認します。
プロパティとその機能の説明については、ヘルプドキュメントの［Connection String Options］チャプターを参照してください。
［
アダプタfor JSON のアップデートグラムチュートリアル］では、要請応答送信ポートを使用して、JSON にアップデートグラムを挿入するシンプルなアプリケーションを作成する手順を説明します。