2. 開発環境の運用

ここでは、WebOTX上で動作するサーバAPと接続するアプリケーションを開発する場合の開発手順、およびJSP開発ツールの各画面などを説明します。

2.1. 概要

WebAP JSP Developer は、以下の機能を提供しています。

2.2. 運用

2.2.1. JSP開発ツールの起動

JSP開発ツールの起動方法は、以下のとおりです。

■準備

JDKをインストールしてください。

■起動

Windowsのスタートメニューで［WebOTX］−［WebAP JSP Developer ］−［JSP開発ツール］をクリックしてください。

初回起動時のみ、JSP開発ツールの起動に必要な環境設定を行う「WebOTX WebAP JSP 環境設定」ダイアログを表示します。 環境設定後にJSP開発ツールを起動する場合は、「WebOTX WebAP JSP 環境設定」ダイアログは表示しません。

2.2.2. Object Brokerバージョン選択

WebAP JSPは以前のバージョンのWebOTXやObject Brokerにも対応しています。
WebAP JSP Developer は、使用するObject Brokerのバージョンに対応したWebアプリケーションを生成するために、Object Brokerのバージョンを認識する必要があります。

プロジェクトが１つも定義されていない状態でJSP開発ツールを起動したとき、「Object Brokerバージョン選択」ダイアログを表示します。

使用するObject Brokerのバージョンを選択後、「OK」ボタンをクリックしてください。メインウィンドウを表示します。
「キャンセル」ボタンをクリックすると、JSP開発ツールを終了します。

WebAP JSP Developer と同じCD-ROMからObject Brokerをインストールした場合は、「5.1以上」を選択してください。
Object Brokerのバージョンとして「4.5」を選択する必要があるのは、次の場合です。

• WebOTX バージョン2.xのCD-ROMに含まれるObjectSpinner バージョン4.xを使用する場合
• WebOTX バージョン3.x以上のCD-ROMに含まれるObjectSpinner互換ライブラリ（ObjectSpinnerバージョン4.xとの互換用ライブラリ）を使用する場合

WebAP JSP が使用可能なObject Brokerのバージョンについては、「サポートするObject Brokerのバージョンの組み合わせ」を参照してください。

プロジェクトが定義されている状態でJSP開発ツールを起動したときは、すでにObject Brokerのバージョンを選択済みとみなして、「Object Brokerバージョン選択」ダイアログを表示せずに、メインウィンドウを表示します。

定義されているプロジェクトがWebAP JSP Developer バージョン3.102以前または3.105で作成されたものであれば、Object Brokerのバージョンは「4.5」であると認識します。
Object Brokerのバージョンを「5.1以上」に変更したい場合は、JSP開発ツールを終了させて、「Object Brokerバージョン移行」コマンドを実行してください。

注意：

• 「Object Brokerバージョン選択」ダイアログで「5.1以上」を選択後、１つでもプロジェクトを作成した後は、Object Brokerのバージョンを「4.5」に変更することはできません。
  
  
• プロジェクト管理サーバを使用している場合、プロジェクトが１つも定義されていない状態でJSP開発ツールを起動できるのはプロジェクト管理者（PM）のみです。
  
  
• プロジェクト管理サーバを使用している場合、プロジェクト管理者がJSP開発ツールを起動して「Object Brokerバージョン選択」ダイアログを表示している時に、別のプロジェクト管理者がJSP開発ツールを起動することはできません。

2.2.3. メインウィンドウ

JSP開発ツールを起動すると、メインウィンドウを表示します。
メインウィンドウは、メニューバーと3つのパネルで構成しています。

＜メニューバー＞

メニューの構成を以下に示します。

＊「情報の最新化」は、プロジェクト管理サーバを使用しているときにのみ表示します。

「ファイル」、「ヘルプ」以外のメニューを実行する場合は、プロジェクトパネルで選択している項目（プロジェクト、トランザクション、フェーズ）が処理対象となります。処理対象によっては、選択できないメニューもあります。

(注1) 最上位の"WebOTX WebAP JSP"

＜プロジェクトパネル＞

プロジェクトパネルは、プロジェクト、トランザクション、フェーズの一覧をツリー形式で表示します。
メニューから実行する処理の対象となるプロジェクト、トランザクション、フェーズを、プロジェクトパネルで選択します。
プロジェクトパネルには、以下の階層のノードがあります。

＜メインパネル＞

メインパネルは、プロジェクト、トランザクション、フェーズに関する情報を表示します。

プロジェクトパネルで、製品名ノード（最上位の「WebOTX WebAP JSP」）が選択されているとき、以下の情報をメインパネルに表示します。

プロジェクトパネルで、プロジェクトノードが選択されているとき、以下の情報をメインパネルに表示します。

プロジェクトパネルで、トランザクションノードが選択されているとき、以下の情報をメインパネルに表示します。

プロジェクトパネルで、フェーズノードが選択されているとき、以下の情報をメインパネルに表示します。

ビルドパネルは、Javaソースファイルの作成、JSPファイルの作成、コンパイル時、MFDL移行時に、作成結果、エラーメッセージ等の情報を表示します。

2.2.4. 定義情報の印刷

JSP開発ツールで定義した内容を「構成情報印刷機能」により印刷することができます。

メインウィンドウのメニューバーから「ファイル」−「印刷」メニューをクリックすると、「構成情報印刷機能」ダイアログを表示します。構成情報印刷機能では、JSP開発ツールで定義しているすべてのプロジェクト情報、およびJSP開発ツールの環境定義情報を出力できます。
「構成情報印刷機能」の使用方法については「構成情報印刷機能」を参照してください。

印刷イメージを、以下に示します。

2.2.5. プロジェクト管理

プロジェクトの作成／削除／名前の変更について説明します。
プロジェクト名は、プロジェクトに関連するファイルを格納するディレクトリ（以下プロジェクト関連ディレクトリ）の名称としても使用します。

＜新規プロジェクトの作成＞

新規プロジェクトの作成は、プロジェクトパネルの製品名ノード（最上位の"WebOTX WebAP JSP"）を選択後、メインウィンドウのメニューバーから「プロジェクト」−「作成...」メニューをクリックし、「プロジェクト作成」ダイアログを表示して行ってください。

＜プロジェクトの削除＞

プロジェクトの削除は、プロジェクトパネルの削除対象プロジェクト名ノードを選択後、メインウィンドウのメニューバーから「プロジェクト」−「削除...」メニューをクリックし、「プロジェクト削除」ダイアログを表示して行ってください。

＜プロジェクト名の変更＞

プロジェクト名の変更は、プロジェクトパネルの変更対象プロジェクト名ノードを選択後、メインウィンドウのメニューバーから「プロジェクト」−「名前の変更...」メニューをクリックし、「プロジェクト名変更」ダイアログを表示して行ってください。

「プロジェクト作成」ダイアログ

設定項目の説明を以下に示します。

「OK」ボタンをクリックすると、プロジェクトを新規作成し、JSP開発ディレクトリ配下にプロジェクト関連ディレクトリを作成します。

「プロジェクト削除」ダイアログ

「OK」ボタンをクリックすると、プロジェクトを削除し、JSP開発ディレクトリ配下のプロジェクト関連ディレクトリを削除します。

JSPファイルをユーザがこの後も使用することができるように、出力JSPファイル格納ディレクトリは削除しません。不要の場合は手動で削除してください。

「プロジェクト名変更」ダイアログ

「プロジェクト名変更」ダイアログには、現在のプロジェクト名が表示されます。任意のプロジェクト名に変更した後、OKボタンをクリックしてください。
　プロジェクト名を変更した場合は、必ずビルドメニューでソース作成／JSP作成を実行してください。

設定項目の説明を以下に示します。

「OK」ボタンをクリックすると、プロジェクト名を変更し、プロジェクト関連ファイル格納ディレクトリのディレクトリ名を変更します。

2.2.6. トランザクション管理

新規トランザクションの作成、トランザクション名の変更、トランザクションの削除、MFDL移行、フェーズの設定を行います。
トランザクション名は、トランザクションに関連するファイルを格納するディレクトリ（以下トランザクション関連ディレクトリ）の名称としても使用します。

＜新規トランザクションの作成＞

新規トランザクションの作成は、プロジェクトパネルのプロジェクト名ノードを選択後、メインウィンドウのメニューバーから「トランザクション」−「作成...」メニューをクリックし、「トランザクション作成」ダイアログを表示して行ってください。

＜トランザクションの削除＞

トランザクションの削除は、プロジェクトパネルの削除対象トランザクション名ノードを選択後、メインウィンドウのメニューバーから「トランザクション」−「削除...」メニューをクリックし、「トランザクション削除」ダイアログを表示して行ってください。

＜トランザクション名の変更＞

トランザクション名の変更は、プロジェクトパネルの変更対象トランザクション名ノードを選択後、メインウィンドウのメニューバーから「トランザクション」−「名前の変更...」メニューをクリックし、「トランザクション名変更」ダイアログを表示して行ってください。

＜MFDL移行＞

MFDL移行は、プロジェクトパネルの移行対象トランザクション名ノードを選択後、メインウィンドウのメニューバーから「トランザクション」−「MFDL...」メニューをクリックし、「MFDL移行」ダイアログを表示して行ってください。MFDL移行の詳細については、「MFDL移行」を参照してください。

＜フェーズ設定＞

フェーズ設定は、プロジェクトパネルのフェーズ設定対象トランザクション名ノードを選択後、メインウィンドウのメニューバーから「トランザクション」−「フェーズ設定...」メニューをクリックし、「フェーズ設定」ダイアログを表示して行ってください。

「トランザクション作成」ダイアログ

設定項目の説明を以下に示します。

「OK」ボタンをクリックすると、トランザクションを新規作成し、JSP開発ディレクトリ配下にトランザクション関連ディレクトリを作成します。

「トランザクション削除」ダイアログ

「OK」ボタンをクリックすると、トランザクションを削除し、JSP開発ディレクトリ配下のトランザクション関連ディレクトリを削除します。

JSPファイルをユーザがこの後も使用することができるように、出力JSPファイル格納ディレクトリは削除しません。不要の場合は手動で削除してください。

「トランザクション名変更」ダイアログ

「トランザクション名変更」ダイアログには、現在のトランザクション名が表示されます。任意のトランザクション名に変更した後、OKボタンをクリックしてください。
　トランザクション名を変更した場合は、必ずビルドメニューでソース作成／JSP作成を実行してください。

　設定項目の説明を以下に示します。

「OK」ボタンをクリックすると、トランザクション名を変更し、トランザクション関連ファイル格納ディレクトリのディレクトリ名を変更します。

2.2.6.1. MFDL移行

MFDL移行を行うために必要な設定を行い、MFDLの定義にもとづいたフェーズ、フェーズJavaソースファイル、JSPファイルを作成します。

WebAP JSPで移行可能なMFDL機能の範囲については、「MFDLサポート機能一覧」を参照してください。
MFDL移行して作成したWebアプリケーションの機能については、「MFDL移行して作成したWebアプリケーションの機能」を参照してください。

MFDL移行の手順は以下のとおりです。
以下の方法以外に、コマンドラインから実行する方法もあります。

1. MFDL移行時に必要な情報を記述した移行定義ファイルを作成してください。移行定義ファイルの作成方法については、「移行定義ファイルの作成方法」を参照してください。
2. メインウィンドウのメニューバーから「トランザクション」−「MFDL...」メニューをクリックしてください。
   「MFDL」ダイアログ を表示します。
3. 「MFDL」ダイアログで「移行定義ファイル名」を設定後、「OK」ボタンをクリックすると、フェーズ、フェーズJavaソースファイル、JSPファイルを自動生成します。
   

以下に、「MFDL」ダイアログの説明を行います。

「MFDL」ダイアログ

設定項目の説明を以下に示します。

項目を設定後、「OK」ボタンをクリックするとMFDL移行処理を開始します。

MFDL移行中に画面の重ねあわせに関してエラーを検出した場合は、次のダイアログを表示します。

「はい」を選択すると、MFDL移行処理を続行します。
「すべてはい」を選択すると、これ以降に重ねあわせのエラーを検出してもエラーダイアログを表示せず、MFDL移行処理を続行します。
「いいえ」を選択すると、MFDL移行処理を中断します。
検出したエラーの詳細は、ビルドパネルに表示します。
重ねあわせ以外のエラーを検出した場合には、エラーダイアログは表示せず、MFDL移行処理を中断します。

2.2.6.2. フェーズ設定

フェーズ実行結果の出力先JSPファイルの指定、フェーズ遷移の設定、フェーズで実行するサーバAPのメソッドの設定を行います。また、サーバAPのメソッドと、フェーズの入力および出力画面となるJSPファイルのフィールドとの関連付けを行います。

フェーズ設定の手順は以下のとおりです。

1. メインウィンドウのメニューバーから「トランザクション」−「フェーズ設定...」メニューをクリックしてください。「フェーズ設定」ダイアログを表示します。「フェーズ設定」ダイアログには、HTML(JSP)タブとメソッドタブがあります。
2. 「フェーズ設定」ダイアログ（HTML(JSP)タブ）で、フェーズ実行結果の出力用HTML(JSP)ファイルの指定、フェーズ遷移の設定を行ってください。
3. 「フェーズ設定」ダイアログ（メソッドタブ）で、フェーズで実行するサーバAPのメソッドの設定を行ってください。
4. 「フェーズ設定」ダイアログ（メソッドタブ）内で、メソッド名を選択して「引数マッピング」ボタンをクリックしてください。「引数設定」ダイアログを表示します。「引数設定」ダイアログには、入力引数タブと出力引数・戻り値タブがあります。
5. 「引数設定」ダイアログで、メソッドの引数とJSPファイルのフィールドとの関連付けを行った後、「終了」ボタンをクリックしてください。「フェーズ設定」ダイアログに戻ります。
6. 「フェーズ設定」ダイアログの「OK」ボタンをクリックしてください。

2.2.6.3. TABLEタグのマッピング

JSP開発ツールで、TABLEタグをサーバAPのメソッドのパラメータとマッピングするには、以下の３パターンの方法があります。

• TABLEタグ全体のマッピング
• 列単位のマッピング
• セル単位のマッピング

各マッピングモードとHTMLのテーブルの関係を下図に示します。

入力パラメータ／出力パラメータ／戻り値とTABLEタグのマッピング可能な組み合わせを下表に示します。

ここでは、テーブル全体とサーバAPのメソッドのパラメータをマッピングする方法を説明します。
この方式は、構造体の固定長配列及び構造体の可変長配列の出力パラメータ、戻り値に対して使用できます。入力パラメータに対しては使用できません。
この方式を使用すると、HTML中に<tr><td>タグを記述しておかなくても、構造体の要素をテーブル形式で表示することができます。

以下に示す、HTMLの書式とメソッドのパラメータの書式の組み合わせにおいて使用可能です。

<table name="TBL1">
	<tr>
		<th>見出し１</th>
		<th>見出し２</th>
		<th>見出し３</th>
	</tr>
</table>

＜注意点＞

• テーブルまたはテーブル中の列をマッピングする場合、TABLEタグにNAME属性値が必要です。マッピング対象となりうるテーブルについては、NAME属性値を自動的に付加します。NAME属性値の自動付加については、「NAME属性値の自動付加」を参照してください。
• テーブルが入れ子になっている場合には最も内側のテーブルがマッピング対象になります。マッピング対象外のテーブルにはNAME属性値は記述しないでください。
• 見出し行は省略可能です。
• 見出し行以外の記述があった場合、削除されます。
• 見出し行が存在して、かつ見出し数と構造体要素数が一致していない場合、JSP開発ツールで不足分を補います。その場合の見出しは構造体の要素名になります。
• 表示行数は、固定長配列の場合は定義要素数、可変長配列の場合はサーバAPから受信した要素数になります。
• 表示列数は、構造体の要素数になります。

struct ST1{
	string    VAL_A;
	string    VAL_B;
	short     VAL_C;
};

typedef ST1 STArray[3];

struct ST1{
	string    VAL_A;
	string    VAL_B;
	short     VAL_C;
};

typedef sequence< ST1 > STSequence;
typedef sequence< ST1,3 > STSequence3;

引数設定ダイアログの設定例

構造体の固定長配列とマッピング時の、引数設定ダイアログ（出力引数・戻り値）の画面例を以下に示します。

NAME属性値の自動付加

• NAME属性値がないマッピング可能なテーブルに、NAME属性値を自動的に付加します。既にNAME属性値があるテーブルのNAME属性値は変更しません。
• テーブルが入れ子になっている場合は、最も内側のテーブルにNAME属性値を付加します。
• テーブルの形式が不正な場合には、NAME属性値は付加しません。
• TABLEタグとTRタグの間にWebAP JSPで認識するHTMLタグが記述されている場合
• TRタグがないTABLEタグとTABLE終端タグの間にWebAP JSPで認識するHTMLタグが記述されている場合
• TRタグとTR終端タグの間のTDタグとTD終端タグの間以外にWebAP JSPで認識するHTMLタグが記述されている場合
• テーブル内にSELECTタグがある場合、NAME属性値は付加しません。SELECTタグを含むテーブルと列単位でマッピングしたい場合は、TABLEタグにNAME属性値をあらかじめ記述しておいてください。
• テーブルにNOTBLMAP属性が指定されている場合、NAME属性値は付加しません。
• NAME属性値は、"JSP_TABLE" + 連番（1から始まるHTMLファイル中のテーブルの記述順）となります。JSPファイルは、NAME属性値を付加した状態で生成します。

WebAP JSPで認識するHTMLタグ

• <INPUT>
• <SELECT>
• <TEXTAREA>
• <FORM>,</FORM>
• <HEAD>
• <BODY>
• <TABLE>,</TABLE>
• <TR>,</TR>
• <TH>,</TH>
• <TD>,</TD>
• <OTXJSPKEY>
• <!>

ここでは、テーブル内の各列単位にサーバAPのメソッドのパラメータをマッピングする方法を説明します。
この方式は、配列型のパラメータに対して使用できます。
この方式を使用すると、列単位にセルの属性を定義できます。
以下に示す、HTMLの書式とメソッドのパラメータの書式の組み合わせにおいて使用可能です。

<table name="TBL1">
  <tr>
    <th>見出し１</th>
    <th>見出し２</th>
    <th>見出し３</th>
  </tr>
  <tr>
    <td><input type="text" name="VAL_A" size="20"></td>
    <td><input type="text" name="VAL_B" size="20"></td>
    <td><input type="text" name="VAL_C" size="20"></td>
  </tr>
  <tr>
    <td><input type="text" name="VAL_A" size="20"></td>
    <td><input type="text" name="VAL_B" size="20"></td>
    <td><input type="text" name="VAL_C" size="20"></td>
  </tr>
  <tr>
    <td><input type="text" name="VAL_A" size="20"></td>
    <td><input type="text" name="VAL_B" size="20"></td>
    <td><input type="text" name="VAL_C" size="20"></td>
  </tr>
  
  <tr>から</tr>までを表示する行数分繰り返す

</table>

＜注意点＞

• テーブルまたはテーブル中の列をマッピングする場合、TABLEタグにNAME属性値が必要です。マッピング対象となりうるテーブルについては、NAME属性値を自動的に付加します。NAME属性値の自動付加については、「NAME属性値の自動付加」を参照してください。
• テーブルが入れ子になっている場合には最も内側のテーブルの列がマッピング対象になります。マッピング対象外のテーブルにはNAME属性値は記述しないでください。
• 見出し行は省略可能です。
• テーブル内のセルの属性は、1行目にあたる部分(見出し行以降最初に現れる<tr>と</tr>に囲まれた部分)の記述を採用します。
• テーブルの各セルには、メソッドのパラメータとマッピング可能なHTMLタグを記述してください。マッピング可能なHTMLタグの種類は、INPUTタグ、SELECTタグ、TEXTAREAタグ、OTXJSPKEYタグです。ただし、SELECTタグはMULTIPLE属性なしで使用してください。また、SELECTタグを含むテーブルにはNAME属性値は自動的に付加されませんので、あらかじめTABLEタグにNAME属性値を記述しておいてください。
• マッピング可能なHTMLタグのNAME属性値が列名になります。
• マッピング可能なHTMLタグ中のNAME属性値は必須です。
• <tr>〜</tr>は表示したい行数分繰り返してください。JSP開発ツールではHTMLに記述されている<tr>〜</tr>の数を行数と判断します。

<table name="TBL1">
  <tr>
    <th>見出し１</th>
    <th>見出し２</th>
    <th>見出し３</th>
  </tr>
  <tr>
    <td><input type="text" name="VAL_A" size="20"></td>
    <td><input type="text" name="VAL_B" size="20"></td>
    <td><input type="text" name="VAL_C" size="20"></td>
  </tr>
</table>

<table name="TBL1">
  <tr>
    <th>見出し１</th>
    <th>見出し２</th>
    <th>見出し３</th>
  </tr>
</table>

<table name="TBL1">
  <tr>
    <td></td>
    <td></td>
    <td></td>
  </tr>
</table>

＜注意点＞

• テーブルまたはテーブル中の列をマッピングする場合、TABLEタグにNAME属性値が必要です。マッピング対象となりうるテーブルについては、NAME属性値を自動的に付加します。NAME属性値の自動付加については、「NAME属性値の自動付加」を参照してください。
• テーブルが入れ子になっている場合には最も内側のテーブルの列がマッピング対象になります。マッピング対象外のテーブルにはNAME属性値は記述しないでください。
• 見出し行は省略可能です。
• メソッドのパラメータとマッピング可能なHTMLタグの種類は、INPUTタグ、SELECTタグ、TEXTAREAタグ、OTXJSPKEYタグの４つです。ただし、SELECTタグはMULTIPLE属性なしで使用してください。また、SELECTタグを含むテーブルにはNAME属性値は自動的に付加されませんので、あらかじめTABLEタグにNAME属性値を記述しておいてください。
• RADIOボタン（INPUTタグのTYPE属性がRADIO）は、セル単位でマッピングした場合と列単位でマッピングした場合で、受信したデータの出力方法が次のように異なります。
  セル単位マッピングの場合は、出力引数の値が、RADIOボタンのVALUE属性値と同じであれば、RADIOボタンにCHECKED属性が付きます。
  列単位マッピングの場合は、出力引数の値が、それぞれのRADIOボタンのVALUE属性値に設定されます。
• JSP開発ツールは、以下の法則で列名を認識します。
1. 見出し行があり、かつ空文字、空白でない場合、見出しが列名になります。ただし、次の行にマッピング可能なHTMLタグがある場合、HTMLタグのNAME属性値が列名になります。
2. 見出し行がなくて、マッピング可能なHTMLタグがある場合、HTMLタグのNAME属性値が列名になります。
3. マッピング可能なHTMLタグも見出しもない場合、JSP開発ツールが付与した連番が列名になります。
• マッピング可能なHTMLタグがある場合は、NAME属性値は必須です。
• マッピング可能なHTMLタグがない場合は、各セルをラベルとして表示します。
• テーブル内のセルの属性は、1行目にあたる部分(見出し行以降最初に現れる<tr>と</tr>に囲まれた部分)の記述を採用します。
• ２行目以降の行は、受信したデータを表示する属性（VALUE、CHECKEDなど）の値以外は、１行目の記述（<td>と</td>で囲まれた部分）と同じになります。
• ２行目以降の行を記述している場合は、上書きされます。
• 表示行数は、固定長配列の場合は定義要素数、可変長配列の場合はサーバAPから受信した要素数になります。

typedef string    VAL_A[3];
typedef short     VAL_B[3];
typedef long      VAL_C[3];

struct ST1{
	string    VAL_A;
	string    VAL_B;
	short     VAL_C;
};

typedef ST1 STArray[3];

typedef sequence <string>    VAL_A;
typedef sequence <short>     VAL_B;
typedef sequence <long>      VAL_C;

struct ST1{
	string    VAL_A;
	string    VAL_B;
	short     VAL_C;
};

typedef sequence< ST1 > STSequence;
typedef sequence< ST1,3 > STSequence3;

引数設定ダイアログの設定例

構造体の固定長配列とマッピング時の、引数設定ダイアログ（入力引数、出力引数・戻り値）の画面例を以下に示します。

CHECKBOXに対する入力、出力マッピングについて

CHECKBOX(INPUTタグのTYPE=CHECKBOX）を列単位でマッピングする場合には注意が必要です。これは、CHECKBOXで指定された値(VALUE属性）は、チェックボックスが選択されているときにしか、WebブラウザからWebサーバに送られてこないためです。そのため、WebAP JSPでは、次の二つの情報を用いて、CHECKBOXの選択状態を判断します。

1. CHECKBOXのNAME属性値に行番号を付加することにより、どの行のCHECKBOXから受信したデータであるかを認識する。
2. INPUTタグ(HIDDEN属性)を付加し、そのタグのVALUE属性が行数を示すようにする。

それぞれの情報について、HTML作成時の注意点を説明します。

1. 入力となるテーブルを開発者が手作業で作成したものである場合、CHECKBOXのNAME属性値は以下のフォーマットに従ってください。



フォーマット　　　　　（注：行番号は1から）

NAME="独自の名前"__jsp_行番号

例

NAME=abcdefg__jsp_2

入力となるテーブル中のCHECKBOXが、あるフェーズのサーバAPの実行結果を示すもの である場合、JSPファイル生成時にHTMLファイル中のCHECKBOXのNAME属性値に __jsp_行番号 が自動的に付加されます。

ただし、テーブルの他の列には出力引数がマッピングされているが、CHECKBOX自体に サーバAPの出力引数がマッピングされていない場合、CHECKBOXのNAME属性値は、もともとHTMLファイルに記述されていたものとなります。

2. この行数は、前画面にテーブルがあり、そのテーブル中のCHECKBOXの選択状態をサーバAPの入力引数に設定する場合に関係します。

固定長配列の入力引数に、CHECKBOXがマッピングされた場合、配列数分の行数が前画面に含まれていると、フェーズは判断します。
　可変長配列の入力引数に、マッピングされた場合、前画面のテーブルの終端タグ（</table>）の直前に、次の形式のINPUTタグを記述しておく必要があります。

<INPUT NAME="テーブル名__jsp_maxcount" TYPE="HIDDEN" VALUE="行数">

テーブル名はテーブルのNAME属性値ですので、テーブルのNAME属性値も記述しておく必要があります。

このINPUTタグのVALUE値をフェーズは取得し、行数を判断します。

入力となるテーブルがサーバAPの実行結果を示すものである場合、このINPUTタグはWebAP JSPが自動的に付加します。

ここでは、テーブル内の各セル単位にサーバAPのメソッドのパラメータをマッピングする方法を説明します。
この方式は、固定長配列型、または基本型のパラメータで使用できます。可変長配列型のパラメータでは使用できません。
この方式を使用すると、テーブル内の各セルに別々の属性を定義できます。例えば、行ごとあるいは列ごとに表示色を変更したり、1行目だけセンタリングすることができます。
また、表示順序とパラメータの配列の順序を一致させる必要がありません。例えば、パラメータの配列の一部をテーブル形式で表示したり、配列の要素順とは異なる順序でテーブルを表示することができます。
OTXJSPKEYタグを使用することにより、受信用テーブルのセル内に文字列をラベルとして表示することもできます。

以下に示す、HTMLの書式とメソッドのパラメータの書式の組み合わせにおいて使用可能です。

<table>
  <tr>
    <th>見出し１</th>
    <th>見出し２</th>
    <th>見出し３</th>
  </tr>
  <tr>
    <td><input type="text" name="VAL_A[0]" size="20"></td>
    <td><input type="text" name="VAL_B[0]" size="20"></td>
    <td><input type="text" name="VAL_C[0]" size="20"></td>
  </tr>
  <tr>
    <td><input type="text" name="VAL_A[1]" size="20"></td>
    <td><input type="text" name="VAL_B[1]" size="20"></td>
    <td><input type="text" name="VAL_C[1]" size="20"></td>
  </tr>
  <tr>
    <td><input type="text" name="VAL_A[2]" size="20"></td>
    <td><input type="text" name="VAL_B[2]" size="20"></td>
    <td><input type="text" name="VAL_C[2]" size="20"></td>
  </tr>

  <tr>から</tr>までを表示する行数分繰り返す

</table>

＜注意点＞

• TABLEタグのNAME属性値は省略可能です。テーブルが入れ子になっている場合も、すべてのテーブル内のマッピング可能なHTMLタグとマッピングできます。
• テーブルのTRタグとTR終端タグの間にないHTMLタグはマッピングできない場合があります。テーブル中でマッピング対象としたいタグは、必ず<TR></TR>タグに囲まれる箇所に記述してください。
• 見出し行は省略可能です。
• テーブル内の各セルに記述してマッピングできるHTMLタグの種類は、「IDLデータ型とHTMLタグの対応表」の、「入力引数とHTMLタグの対応」表、「出力引数および戻り値とHTMLタグの対応」表を参照してください。
• RADIOボタン（INPUTタグのTYPE属性がRADIO）は、セル単位でマッピングした場合と列単位でマッピングした場合で、受信したデータの出力方法が次のように異なります。
  セル単位マッピングの場合は、出力引数の値が、RADIOボタンのVALUE属性値と同じであれば、RADIOボタンにCHECKED属性が付きます。
  列単位マッピングの場合は、出力引数の値が、それぞれのRADIOボタンのVALUE属性値に設定されます。
• 各セルのHTMLタグ中のNAME属性値は必須です。

typedef string VAL_A[3];
typedef short VAL_B[3];
typedef long VAL_C[3];

struct ST1{
  string VAL_A;
  string VAL_B;
  short VAL_C;
};
typedef ST1 STArray[3];

引数設定ダイアログの設定例

構造体の固定長配列とマッピング時の、引数設定ダイアログ（入力引数、出力引数・戻り値）の画面例を以下に示します。

2.2.6.4. プロパティ設定

トランザクションごとのプロパティの設定を行います。

プロジェクトパネルのトランザクション名ノードを選択後、メインウィンドウのメニューバーから「トランザクション」−「プロパティ...」メニューをクリックすると、「プロパティ設定」ダイアログを表示します。

「プロパティ設定」ダイアログ

JSP開発ツールで作成し、WebAP JSPに転送するJSPファイルの文字コードを選択してください。選択できる文字コードの種類と、JSPファイル中に記述されるコンテンツタイプは以下のとおりです。

文字コードの初期値は、「Windows-31J」になります。(V6.3からWebAP JSP Developer （32bit版）も「SJIS」から「Windows-31J」に初期値を変更しました。)

注意：WebAP JSPでJDK 1.5以上を使用する場合に、「SJIS」、「MS932」を指定すると、外字やＩＢＭ拡張文字などの機種依存文字が表示できません。「Windows-31J」を指定してください。

2.2.6.5. タイムアウトフェーズ

WebAP JSPでは、タイムアウトフェーズ（セッション解放時に実行するフェーズ）を指定できます。

セッション解放時にタイムアウトフェーズを実行するためには、以下の手順でWebアプリケーションの作成、実行を行ってください。

1. タイムアウトフェーズの名前をWebAP JSP Developer の「環境設定」画面の「その他」タブの「タイムアウト用フェーズ名」に設定してください。
2. トランザクションにタイムアウトフェーズを追加し、「フェーズ設定」ダイアログでフェーズの設定を行います。
   タイムアウトフェーズを設定する際の注意点については、「タイムアウトフェーズ設定の注意点」を参照してください。
3. トランザクションをビルドしてWebアプリケーションを作成し、WebAP JSPにファイル転送します。
4. WebAP JSPの「環境設定」ページの「起動時オプション」の「タイムアウト時のフェーズ実行」を「行う」に指定してください。
5. トランザクションのセッションが解放される契機に、タイムアウトフェーズが実行されます。セッション解放契機については、「セッション」を参照してください。

タイムアウトフェーズ設定の注意点

「フェーズ設定」ダイアログでタイムアウトフェーズを設定する場合、以下の制限があります。違反していると、「フェーズ設定」ダイアログの「OK」ボタンクリック時にエラーになります。
また、「環境設定」ダイアログで「タイムアウト用フェーズ名」を変更した結果が以下の制限に違反すると、ソース生成時にエラーになります。

• タイムアウトフェーズに、出力用HTML(JSP)ファイルを指定しないでください。
• 「次に実行するフェーズ」としてタイムアウトフェーズを指定しないでください。
• タイムアウトフェーズに登録したメソッドの引数マッピングを行わないでください。
• タイムアウトフェーズは先頭フェーズとして指定（フェーズ名の左の「先頭設定」列のチェックボックスをクリックして「先頭」を表示）してください。
• タイムアウトフェーズの遷移情報は「保存しない」を指定してください。

2.2.7. フェーズ管理

フェーズに関する編集機能には、以下のものがあります。

＜新規フェーズの作成＞

フェーズを新規に作成するには、プロジェクトパネルのトランザクション名ノードを選択後、メインウィンドウのメニューバーから「フェーズ」−「作成...」メニューをクリックし、「フェーズ作成」ダイアログを表示してください。

＜フェーズの削除＞

フェーズを削除するには、プロジェクトパネルの削除対象フェーズ名ノードを選択後、メインウィンドウのメニューバーから「フェーズ」−「削除...」メニューをクリックし、「フェーズ削除」ダイアログを表示してください。

＜フェーズ名の変更＞

フェーズ名を変更するには、プロジェクトパネルの変更対象フェーズ名ノードを選択後、メインウィンドウのメニューバーから「フェーズ」−「名前の変更...」メニューをクリックし、「フェーズ名変更」ダイアログを表示してください。

「フェーズ作成」ダイアログ

設定項目の説明を以下に示します。

「OK」ボタンをクリックすると、フェーズを新規作成し、フェーズに関連する以下のファイルをJSP開発ディレクトリ配下に作成します。

・フェーズプロパティファイル

/JSP開発ディレクトリ/project/プロジェクト名/トランザクション名/work/新規フェーズ名

「フェーズ削除」ダイアログ

「OK」ボタンをクリックすると、フェーズを削除し、フェーズに関連する以下のファイルを削除します。

・フェーズプロパティファイル

/JSP開発ディレクトリ/project/プロジェクト名/トランザクション名/work/該当フェーズ名

＜注意＞
関連するフェーズ（直前に実行するフェーズ、次に実行するフェーズ）のフェーズプロパティファイルから、削除したフェーズについての情報が消えます。フェーズ設定画面でフェーズ情報を確認してください。

「フェーズ名変更」ダイアログ

「フェーズ名変更」ダイアログには、現在のフェーズ名が表示されます。任意のフェーズ名に変更した後、OKボタンをクリックしてください。

設定項目の説明を以下に示します。

「OK」ボタンをクリックすると、フェーズ名を変更し、フェーズに関連する以下のファイル名を変更します。

・フェーズプロパティファイル

/JSP開発ディレクトリ/project/プロジェクト名/トランザクション名/work/該当フェーズ名

＜注意＞
関連するフェーズ（直前に実行するフェーズ、次に実行するフェーズ）のフェーズプロパティファイルの、名称変更したフェーズについての情報も変わります。フェーズ設定画面でフェーズ情報を確認後、ソース作成、JSPファイル作成、コンパイルを再度行ってください。

2.2.8. APの生成と登録

トランザクションの定義が終了したら、アプリケーションの生成とWebAP JSPへの登録を行ってください。
生成したアプリケーションをWebAP JSPへ登録すると、Webブラウザからトランザクションを実行することが可能になります。（WebOTX でトランザクションを実行するサーバAPが起動されている必要があります。）

以下では、アプリケーションの生成とWebAP JSPへの登録手順を説明します。
以下の方法以外に、コマンドラインから実行する方法もあります。

アプリケーションを作成するには、ソース作成、JSP作成、コンパイル（リコンパイル）を順番に実行する方法と、ソース作成からリコンパイルまでを一括して実行する方法があります。

■ソース作成、JSP作成、コンパイル（リコンパイル）を順番に実行する手順

■ソース作成からリコンパイルまでを一括して実行する手順

フェーズ設定の修正後またはJSPやソースファイルのカスタマイズ後に、APを再生成する場合は、上記の手順の全部または一部を行う必要があります。

Webアプリケーションの修正を行った場合に、メニューバーの「ビルド」メニューのうち、どの処理を選択してAPの再作成を行えばよいかを以下の表にまとめました。
数字は、処理を実行する順番を表します。
「ビルド」が「○」の場合は、順番に処理を実行する代りに「ビルド」−「ビルド」メニューでソース生成からリコンパイルまでを一括して行うこともできます。ただし、「ビルド」−「ビルド」メニューを使用すると、同じトランザクション内のすべてのファイルについて処理を行うため、時間がかかる場合があります。

2.2.9. プロジェクト管理サーバ

大規模なソフトウェアを開発する場合は、複数の開発担当者が共同で開発を行うことになります。

従来のJSP開発ツールでは、一人が一つのプロジェクトの更新を行うことを前提にしていましたが、大規模なソフトウェアを開発する場合は、複数の開発担当者が一つのプロジェクトの更新を行う必要があります。

プロジェクト管理サーバは、各JSP開発ツールに対してプロジェクト内の各定義情報の排他制御機能を提供します。
本機能により、複数の開発担当者が一つのプロジェクトを共同で開発することが可能になります。

プロジェクト管理サーバを起動するには、起動用ファイルとユーザ定義ファイルの設定を行った後、起動用ファイルを実行してください。

■起動用ファイルの設定

以下の場所に「プロジェクト管理サーバ起動用ファイル」の雛形があります。

これらのファイルに記述されている以下のパラメータをご使用の環境に合わせて書き換えてください。

■ユーザ定義ファイルの設定

プロジェクト管理サーバは、JSP開発ツールを使用するユーザにレベルを設定し、適応するレベル以外の利用者が権限を越えた操作を行うことができないように排他制御を行います。

JSP開発ツールを使用するユーザの識別は、JSP開発ツールの起動時オプションで指定するユーザ名により行います。同じユーザ名で複数のJSP開発ツールが同時にプロジェクト管理サーバに接続することはできません。

ユーザの識別情報は、ユーザ定義ファイル（JSP開発ツールのインストールディレクトリ配下のprojServer/conf/user.conf ）に記述します。

ユーザ定義ファイルのフォーマットを以下に示します。

レベルに記述する識別子を以下に示します。

ユーザ定義ファイルの記述例を以下に示します。

ユーザ定義ファイルを記述する際の注意事項を以下に示します。

• 行頭が半角＃であった場合、その行はコメント行として扱います。
• 行頭からレベル識別子までには、スペースや非印字可能文字があった場合はエラーとします。
• ユーザ名として記述可能な文字は、半角の英数字およびアンダースコア（"_"）です。
• レベル識別子の後に半角スペース（0x20）,タブコード（0x09）、#（0x23）,改行コードのいずれかを記述することができます。レベル識別子のあとに#（0x23）があった場合には、#（0x23）以降をコメントとして扱います。
• 最後の行の終端には、改行が必要です。

プロジェクト管理サーバ使用時の競合操作一覧

プロジェクト管理サーバを使用しているときに、他のクライアントの使用状況により、メニュー選択、コマンド実行などの操作を行えるかどうかの一覧を以下に示します。

＜プロジェクト管理者による操作＞

(*1)「印刷処理中」とは、メニューを選択してから「構成情報印刷機能」の画面を閉じるまでの間を指します。

＊一覧に記述している以外の操作は、他のクライアントの使用状況にかかわらず使用可能です。
＊△のパターンでは、他のクライアントの現在の使用状況に関わらず、関連するプロジェクト／トランザクションが変更されていれば、「情報の最新化」を行う必要があります。

＜トランザクション管理者による操作＞

(*1)「印刷処理中」とは、メニューを選択してから「構成情報印刷機能」の画面を閉じるまでの間を指します。

＊一覧に記述している以外の操作は、他のクライアントの使用状況にかかわらず使用可能です。
＊△のパターンでは、他のクライアントの現在の使用状況に関わらず、関連するプロジェクト／トランザクションが変更されていれば、「情報の最新化」を行う必要があります。

＜担当者による操作＞

(*1)「印刷処理中」とは、メニューを選択してから「構成情報印刷機能」の画面を閉じるまでの間を指します。

＊一覧に記述している以外の操作は、他のクライアントの使用状況にかかわらず使用可能です。
＊△のパターンでは、他のクライアントの現在の使用状況に関わらず、関連するプロジェクト／トランザクションが変更されていれば、「情報の最新化」を行う必要があります。

2.3. 設定

2.3.1. JSP開発ツール起動用の環境設定

＜WebAP JSP Developer 固有のJavaVMのオプション＞

WebAP JSP Developer 固有のJavaVMのオプションについては、以下の表を参照してください。

2.3.2. 環境設定

WebAP JSP Developer を使用する前に環境設定を行う必要があります。
環境設定を行うには、メインウィンドウのメニューバーで「ファイル」−「環境設定」メニューをクリックして「環境設定」ダイアログを表示してください。

コンフィグレーションファイルの内容を直接エディタで編集することにより、ログファイル関連情報等のその他のコンフィグレーション情報を変更することもできます。

「環境設定」ダイアログ

「環境設定」ダイアログは、次の６つのタブから構成されます。

「環境設定」ダイアログの各項目の説明を以下に示します。項目を設定後、「OK」ボタンをクリックしてください。

＜ブラウザ タブ＞

「ブラウザ」タブの各項目の説明を以下に示します。

以下に、各項目の初期値と定義例を示します。

＜コンパイラ タブ＞

「コンパイラ」タブの各項目の説明を以下に示します。

以下に、各項目の初期値と定義例を示します。
定義例は、Object Brokerバージョン9.xを使用する場合で、「IDLコンパイラ−継承元ディレクトリ」を指定する場合です。

＜MFDL(表示) タブ＞

「MFDL(表示)」タブの各項目の説明を以下に示します。

以下に、各項目の初期値と定義例を示します。

＜MFDL(制御) タブ＞

「MFDL(制御)」タブの各項目の説明を以下に示します。

以下に、各項目の初期値を示します。

＜JSP タブ＞

「JSP」タブの各項目の説明を以下に示します。

以下に、各項目の初期値と定義例を示します。

＜その他 タブ＞

「その他」タブの各項目の説明を以下に示します。

以下に、各項目の初期値と定義例を示します。

＜参考＞ HTML保存ルートディレクトリ、IF保存ルートディレクトリを設定して、ファイルの保管場所を移行する手順

例：絶対パスで設定していたC:\WEBAPJSP配下のHTML(JSP)、IDL（IF）ファイル群をD:\WEBAPJSP2配下に移行する場合

1. 「環境設定」ダイアログのHTML保存ルートディレクトリ、IF保存ルートディレクトリに"C:\WEBAPJSP"を設定します。
2. フェーズに関連づけられているHTML(JSP)ファイル、IDL（IF）ファイルが、フェーズプロパティファイルより新しくなるように、HTML(JSP)ファイル、IDL（IF）ファイルの更新日付を変更します。
3. すべてのトランザクションの「フェーズ設定」ダイアログを表示して「OK」ボタンをクリックします。（フェーズプロパティファイルの記述が相対パスになります。）
4. C:\WEBAPJSP配下のファイル群をD:\WEBAPJSP2配下に移動します。
5. 「環境設定」ダイアログのHTML保存ルートディレクトリ、IF保存ルートディレクトリに"D:\WEBAPJSP2"を設定します。

その他のコンフィグレーション情報の変更

WebAP JSP Developer のコンフィグレーションファイルには、「環境設定」ダイアログで設定できる情報以外に、ログファイル関連等の情報を記述しています。
デフォルトの設定を変更する場合は、ファイルに記述されている設定値を書き換えてください。
コンフィグレーションファイルは以下の場所にあります。

JSP開発ディレクトリ\conf\env\dev.conf

コンフィグレーションファイル中の変更可能なパラメータと設定値について、ファイルに記述されている順に以下に示します。下記以外のパラメータの設定値は、変更しないでください。

2.4. コマンドによる運用

2.4.1. APの生成と登録

JSP開発ツールのメニューバーから行っていた「プロジェクト作成」、「トランザクション作成」、「ソース作成」、「JSP作成」、「MFDL移行」、「リコンパイル」、「ファイル転送」の処理を、コマンドラインから直接実行することができます。

また、「リコンパイル」処理の一部である、「JSPコンパイル」処理（JSPファイルをJavaファイルに変換する処理）、「ZIPファイル作成」処理をコマンド指定して、それぞれ単独で実行することが可能です。
WebAP JSP Developer の「リコンパイル」処理を行うより、JDKのjavacコマンドで直接コンパイルした方が速度が速いため、「リコンパイル」処理を行う代りに以下の手順を実行することにより、処理時間を短縮できます。

コマンドラインの指定方法は以下のとおりです。

コマンド名には以下のものが指定可能です。
コマンド引数指定なしで実行された場合は、USAGEだけを表示します。
注意：MFDL移行したトランザクションに対しては、-srcmake、-jspmakeコマンドは実行できません。

コマンド名は複数指定が可能です。コマンド名を記述する順番は任意ですが、実際に処理する順番は以下のとおりになります。

• MFDL移行以外の場合
  

  1：プロジェクト作成 2：トランザクション作成 3：ソース作成 4：JSP作成 5：JSPコンパイル 6：リコンパイル 7：ZIPファイル作成 8：ファイル転送

• MFDL移行の場合
  

  1：プロジェクト作成 2：トランザクション作成 3：MFDL移行 4：JSPコンパイル 5：リコンパイル 6：ZIPファイル作成 7：ファイル転送

  
  

すでに作成済のファイルがある場合、すべて上書きします。
コマンド終了時、「正常終了しました」もしくは「異常終了しました」というメッセージを標準出力に出力します。
プロセスの終了ステータスは、異常終了が1、正常終了が0です。

プロジェクト生成で、すでに当該のプロジェクト名が存在する場合は、「指定されたプロジェクトはすでに存在しています。」のメッセージを標準出力し、以降の処理は継続します。
トランザクション生成で、すでに当該のトランザクション名が存在する場合は、「指定されたトランザクションはすでに存在しています。」のメッセージを標準出力し、以降の処理は継続します。

コマンド処理中にエラーが発生した場合は、標準出力にエラーメッセージを出力し、以降の処理を打ち切ります。
エラーメッセージの内容は、メニューバーから実行したときにerror.logに出力する情報と同じですが、時刻表示は行いません。また、JavaVMが生成したExceptionの場合は、エラー原因のスタックトレースを出力します。

WebAP JSP Developer のコンフィグレーションファイルにトレースレベル３以上が指定されている場合、trace_cmd.logファイルにトレースを出力します。トレースの内容はメニューバーから実行したときにtrace.logファイルに出力する情報と同じです。trace_cmd.logファイルはtrace.logファイルと同じく、以下の場所に作成します。

/JSP開発ディレクトリ/logs配下

＜注意＞
コマンドの実行時に必要な情報（Javaコンパイラのパス等）は、WebAP JSP Developer の環境設定で指定した情報を使用します。そのため、WebAP JSP Developer の環境設定が正常に行われていない環境では、コマンドは動作しない可能性があります。

プロジェクト管理サーバを使用する場合、コマンド実行できるのは、プロジェクト管理者（PM）と、トランザクション管理者(TM)だけです。担当者(NU)はコマンド実行できません。

Javaソースファイルをjavacコマンドでコンパイルする方法

1. Javaソースファイル格納ディレクトリをカレントディレクトリにしてください。Javaソースファイル格納ディレクトリの場所は以下のとおりです。

   プロジェクトJSPディレクトリ(project,jspディレクトリのある所）\project\プロジェクト名\トランザクション名\sources

2. Javaソースファイルをjavacコマンドでコンパイルしてください。

コマンドラインの指定方法は、以下のとおりです。

以下に、JDK 1.3.1、ObjectSpinnerバージョン4.xを使用し、MFDL移行したWebアプリケーションを作成する場合のコマンドラインの例を示します。

2.4.2. Object Brokerバージョン移行

ObjectSpinner4.x用のトランザクションをObject Brokerバージョン6.x以上またはObjectSpinnerバージョン5.x用のトランザクションに移行する方法について以下に説明します。

Object Brokerバージョン移行は、移行用コマンドにより、全プロジェクトに対して行います。

■移行手順

移行手順は以下のとおりです。

1. プロジェクト管理サーバを使用している場合は、プロジェクト管理サーバを停止してください。

2. JSP開発ツールを起動して、「環境設定」ダイアログの「コンパイラ」タブで、必要な環境設定を行ってください。
   特に以下の設定を確認してください。
   

   • 「IDLコンパイラ−コマンド名」を設定していること。
   • Object BrokerのjarファイルへのパスとJavaのクラスライブラリへのパスを、「Javaコンパイラ−オプション」に設定していること。
   • Object Brokerのjarファイル名がospiorb.jarではなく、ospiorb50.jarであること。

3. 既存のトランザクションが使用しているIFファイルに対応するIDLファイルを、IFファイルと同じディレクトリに格納してください。MFDL移行のトランザクションの場合はIFファイルを使用していないため、この作業は必要ありません。

4. 「コマンドラインの指定方法」を参照して、Object Brokerバージョン移行用コマンドを記述したバッチファイルを作成してください。以下の場所にある移行用バッチファイル（ospiconv.bat）の記述を、ご使用の環境に合わせて修正してください。クラスパス、WebAP JSP Developer インストールディレクトリ、プロジェクトJSPディレクトリ、JSP開発ディレクトリの設定が修正対象です。

   WebAP JSP Developer インストールディレクトリ/ospiconv.bat

5. JSP開発ツールを終了してください。

6. Object Brokerバージョン移行用パッチファイルを実行してください。

7. 移行が正常に行われたかどうかは、標準出力のメッセージを確認するとともに、JSP開発ツールを起動して以下の点を確認してください。

   • 「プロジェクトパネル」で製品名ノード（最上位の「WebOTX WebAP JSP」）を選択したときに、「メインパネル」に表示される「Object Brokerバージョン」が「5.1以上」になっていること。
   • 「プロジェクトパネル」のトランザクションノードのアイコンがエラー表示になっていないこと。
     
     エラー表示の例

8. 移行に失敗したトランザクションについては、JSP開発ツール上ではトランザクションの削除以外の処理は行えなくなります。正しいIDLファイルに置き換えるなどの対処を行った後、Object Brokerバージョン移行用パッチファイルを再度実行してください。

移行完了したトランザクションをWebAP JSP上で動作させるためには、この後、トランザクションのリビルド（MFDL移行したトランザクションの場合はリコンパイル）を行う必要があります。

• 通常のトランザクションの場合（MFDL移行以外の場合）
  以下のいずれかの方法でリビルドを行ってください。その際、ソースファイルやJSPファイルへのカスタマイズが失われないように注意してください。
  

  • JSP開発ツールの「ビルド」メニューの、「ソース作成」、「JSP作成」、「リコンパイル」を順に実行
  • JSP開発ツールの「ビルド」メニューの、「ビルド」を実行
  • 上記と同等の処理を行う「APの生成と登録」コマンドを実行

• MFDL移行したトランザクションの場合
  以下のいずれかの方法でリコンパイルを行ってください。
  

  • JSP開発ツールの「ビルド」メニューの、「リコンパイル」を実行
  • 上記と同等の処理を行う「APの生成と登録」コマンドを実行
  
  

■コマンドラインの指定方法

コマンドラインの指定方法は以下のとおりです。

コマンド終了時、「正常終了しました」もしくは「異常終了しました」というメッセージを標準出力に出力します。
プロセスの終了ステータスは、異常終了が1、正常終了が0です。

コマンドを実行すると、MFDL移行して作成したトランザクション以外のトランザクションについて、トランザクション単位にIDLコンパイルを行います。IDLコンパイルの結果は、標準出力に出力します。

以下のエラーの場合は、標準出力にエラーメッセージを出力し、次のIDLファイルをコンパイルします。

• IDLコンパイルに失敗した場合
• IDLコンパイルの結果作成されたIFファイル中に、既存のトランザクションで定義しているメソッドが存在しない場合

コマンド処理中に上記以外のエラー（IDLファイルが存在しないなど）が発生した場合は、標準出力にエラーメッセージを出力し、以降の処理を打ち切ります。
また、JavaVMが生成したExceptionの場合は、エラー原因のスタックトレースを出力します。

WebAP JSP Developer のコンフィグレーションファイルにトレースレベル３以上が指定されている場合、trace_cmd.logファイルにトレースを出力します。trace_cmd.logファイルは、以下の場所に作成します。

/JSP開発ディレクトリ/logs配下

＜注意＞
コマンドの実行時に必要な情報（IDLコンパイラのパス等）は、JSP開発ツールの環境設定で指定した情報を使用します。そのため、JSP開発ツールの環境設定が正常に行われていない環境では、コマンドは動作しない可能性があります。

2.4.3. MFDL移行

MFDL移行処理を、コマンドラインから直接実行する方法について説明します。

■移行手順

移行手順は以下のとおりです。

1. JSP開発ツールを起動して、「環境設定」ダイアログで必要な環境設定を行ってください。

2. JSP開発ツールで、必要なプロジェクトとトランザクションを追加してください。

3. JSP開発ツールを終了してください。

4. トランザクションごとに移行定義ファイルを作成してください。移行定義ファイルの作成方法については、「移行定義ファイルの作成方法」を参照してください。

5. WebAP JSP Developer のコマンド機能で、MFDL移行、コンパイル、ファイル転送を行ってください。コマンドラインの指定方法については、「APの生成と登録」を参照してください。

＜注意＞
移行定義ファイルが存在しない場合、移行定義ファイルの記述形式が不正な場合は、エラーとなり、MFDL移行処理を中断します。