5.3.3 サービスアダプタ(MDB(WS-R))を定義する
(1) キュー情報およびメッセージ種別の取得
サービス部品がMDB(WS-R)の場合,サービス部品のキュー情報およびメッセージ種別を開発者から取得する必要があります。取得した情報は,サービスアダプタを定義するときに使用します。
取得する情報は次のとおりです。
- キュー名称
- 宛先のアドレス(アダプタとサービス部品との間でネットワーク通信をする場合)
- ベーシック認証のためのユーザ名およびパスワード(アダプタとサービス部品との間でネットワーク通信をし,かつベーシック認証を使用する場合)
- メッセージ種別
(2) サービス部品の電文フォーマット
(3) データ変換
サービスリクエスタの電文の形式と,サービスアダプタが呼び出すサービス部品の電文の形式が異なる場合,データ変換が必要です。
データ変換を行う場合,サービスアダプタ定義画面で標準電文にサービスリクエスタから入力される電文を設定し,データ変換定義画面でデータ変換(マッピング)を定義します。
データ変換の詳細については,「7. データ変換の定義」を参照してください。
(4) 呼出しの設定
利用するサービス部品の呼出し方法を設定できます。リモート呼出しまたはローカル呼出しを選択できます。リモート呼出しを選択した場合,最大メッセージ数を設定します。また必要に応じて,ベーシック認証を設定します。
(5) 最大メッセージ数の設定
サービス部品の呼出し方法としてリモート呼出しを設定した場合,一度に処理できる電文の数を初期値から変更した数に設定できます。設定できる値は1~65535です。
(6) ベーシック認証の設定
サービス部品の呼出し方法としてリモート呼出しを設定した場合で,MDB(WS-R)のメッセージ転送でユーザ認証を必要とするときは,ベーシック認証(ユーザ名およびパスワード)の設定が必要になります。
(7) サービスアダプタ定義画面での操作
MDB(WS-R)に対するアダプタを定義する場合の手順を次に示します。
- サービスアダプタ定義画面を表示します。
サービスアダプタ定義画面の表示方法については,「5.3.1(5) サービスアダプタ定義画面の表示」を参照してください。
- サービス部品制御情報の[サービス名],[サービスID],および[最大インスタンス数]を必要に応じて編集します。
- サービス部品制御情報の[アドレス]を指定します。
[アドレス]には,「5.3.3(1) キュー情報およびメッセージ種別の取得」で取得したキュー名称を入力します。
- オペレーション情報に表示されている内容を確認します。
- 要求電文について次に示す操作をします。
- 標準電文のフォーマットを指定する場合
- 手順6.~9.を実施して,手順10.に進みます。
- 標準電文のフォーマットを指定しない場合
- 手順10.に進みます。
- 標準電文の[使う]チェックボックスをチェックします。
- 標準電文の[フォーマットID]を指定します。
- 標準電文の[...]ボタンをクリックして,[電文フォーマット]に標準電文のフォーマットを指定します。
なお,外部のXMLスキーマを参照している電文フォーマットを設定する場合,必ずルートスキーマに当たるファイルを設定してください。ルートスキーマから参照される外部のXMLスキーマファイルは,自動的に取り込まれます。
指定できる電文フォーマットの形式については,「2.5.5 XMLスキーマの適用範囲」を参照してください。
- 標準電文の[表示]ボタンをクリックします。
標準電文のフォーマットが表示されます。必要に応じて指定した標準電文のフォーマットを確認してください。
- サービス部品電文の[フォーマットID]を指定します。
- サービス部品電文の[...]ボタンをクリックして,[電文フォーマット]にサービス部品電文のフォーマットを指定します。
- サービス部品電文の[表示]ボタンをクリックします。
サービス部品電文のフォーマットが表示されます。必要に応じて指定したサービス部品電文のフォーマットを確認してください。
- サービスアダプタ定義(詳細)タブをクリックします。
- [JMSメッセージ種別]のドロップダウンリストから,JMSメッセージ種別を選択します。
- [呼出し設定]でサービス部品の呼出方法を選択します。
- [リモート呼出し]ラジオボタンを選択した場合
- 手順16.に進みます。
- [ローカル呼出し]ラジオボタンを選択した場合
- 手順24.に進みます。
- [最大メッセージ数]に,サービス部品が送信できる電文の数を指定します。
- [宛先URL]に「5.3.3(1) キュー情報およびメッセージ種別の取得」で取得した,宛先のアドレスを入力します。
- サービス部品がユーザ認証を必要とするかどうかで,次に示す操作をします。
- ユーザ認証が必要な場合
- 手順19.~21.を実施して,手順22.に進みます。
- ユーザ認証が不要な場合
- 手順22.に進みます。
- ベーシック認証の[使う]チェックボックスをチェックします。
- ユーザ名およびパスワードの欄に,ベーシック認証のために必要なユーザ名およびパスワードを入力します。
- パスワード(確認)欄に,パスワードの欄で入力したパスワードと同じパスワードを入力します。
- 転送キュー作成先RDエリア名を必要に応じて入力します。
- [順序保証]チェックボックスを必要に応じてチェックします。
- 定義内容を確認して,Eclipseのメニューから[ファイル]-[保管]を選択し,定義内容を保存します。