フェーズ設定ダイアログは、次の要素から構成されます。

「フェーズ設定」ダイアログの各項目を次に説明します。項目を設定後、「OK」ボタンをクリックしてください。フェーズプロパティファイルにフェーズ設定を反映します。

＜フェーズ名リスト＞

当該のトランザクションに属するフェーズ名のリストを表示します。
フェーズ名リストでフェーズを選択し、HTML(JSP)タブ、メソッドタブの項目を設定してください。

フェーズ名の左の「先頭設定」列のチェックボックスをクリックすると「先頭」と表示されます。「先頭」の表示があるフェーズは、トランザクションの最初に実行できます。
「先頭」の表示が無いフェーズは、トランザクションの最初には実行できません。

＜HTML(JSP)タブ＞

新しい定義を追加するには、以下の手順で操作してください。

1. フェーズ名リストで、新しい定義を追加するフェーズを選択してください。
2. 「参照ボタン」をクリックして、フェーズの出力画面のベースにするHTMLファイルまたはJSPファイルを選択してください。
3. 「追加」ボタンをクリックして、定義一覧に追加してください。

既存の定義を更新するには、以下の手順で操作してください。

1. フェーズ名リストで、新しい定義を追加するフェーズを選択してください。
2. 定義一覧で更新する定義を選択してください。
3. 各項目を更新した後、各項目に対応する設定ボタンをクリックすると、定義一覧の情報が更新できます。
   遷移情報、サーバAPの項目に関しては、「すべてのフェーズに設定」をチェックした状態で対応する設定ボタンをクリックすると、同一トランザクション内のすべてのフェーズを更新できます。

定義を削除する場合は、定義一覧で削除する定義を選択して「削除」ボタンをクリックしてください。

定義一覧に複数の定義が存在する場合は、「出力条件」ボタンをクリックすることにより「出力条件設定」ダイアログで出力条件を指定できます。

HTML(JSP)ファイル作成時の注意点については、「HTML作成の注意点」を参照してください。

各項目の説明を次に示します。

＜メソッド タブ＞

新しい定義を追加するには、以下の手順で操作してください。

1. フェーズ名リストで、新しい定義を追加するフェーズを選択してください。
2. 「参照...」ボタンをクリックして、フェーズで実行するメソッドを含むIDLファイル（Object Brokerバージョン6.x以上またはObjectSpinnerバージョン5.x使用時）、またはIFファイル（ObjectSpinnerバージョン4.x使用時）を選択してください。
3. フェーズで実行するメソッドを一意に識別するためにモジュール名／インタフェース名／メソッド名を選択してください。
4. 「追加」ボタンをクリックして、メソッド名一覧に追加してください。
5. 複数のメソッドを実行する場合は、実行する順番どおりに追加してください。
6. メソッド名一覧で定義を行うメソッドを選択して「引数マッピング」ボタンをクリックしてください。
7. 「引数設定」ダイアログでHTMLの項目とメソッドのパラメタとのマッピングを定義してください。

定義を削除する場合は、メソッド名一覧で削除するメソッドを選択して「削除」ボタンをクリックしてください。

各項目の説明を次に示します。

「フェーズ設定」ダイアログで、一つのフェーズに対して複数のHTMLファイル（またはJSPファイル）を定義した場合に、各ファイルを使用する条件を「出力条件設定」ダイアログで指定することができます。 サーバAPのメソッドを実行したときに、メソッドの出力引数または戻り値と、指定した判定値を比較して、出力条件に該当するJSPファイルを出力します。
各項目に設定を行った後「終了」ボタンをクリックしてください。ここで設定した値は、「フェーズ設定」ダイアログで「OK」ボタンをクリックしたときに保存されます。

新しい条件を定義するには、以下の手順で操作してください。

1. 出力条件として使用するメソッド名と出力引数名を選択してください。
   メソッド定義を行っていない場合は、一覧に何も表示されません。

2. 「メソッド・引数選択」ボタンをクリックして、メソッド名／出力引数名／出力引数の型を決定してください。

3. 演算子と判定値を設定して「判定値設定」ボタンをクリックして、条件式を決定してください。

設定をやり直す場合は、「クリア」ボタンをクリックするとメソッド名以下の項目がすべて消去されます。

「出力条件設定」ダイアログの各項目を次に説明します。

「引数設定」ダイアログ は、次の要素から構成されます。

必要なマッピングを行った後、「終了」ボタンをクリックしてください。ここで設定した情報は、「フェーズ設定」ダイアログで「OK」ボタンをクリックしたときに、保存されます。

いくつかのマッピング方法を「マッピングの参考」で紹介しています。

新しい定義を追加するには、以下の手順で操作してください。

1. パラメータ リストで、マッピング対象のパラメータを選択してください。
2. 前画面HTML(JSP)ファイル一覧で、マッピング対象のHTMLファイルを選択してください。
3. HTML(JSP)のフィールド名一覧で、マッピング対象のフィールドを選択してください。
4. 「設定」ボタンをクリックして、HTML(JSP)のフィールドとパラメータをマッピングしてください。

メソッドの入力引数に設定するHTTPパラメータとして 前画面HTML(JSP)ファイル中のHTMLタグ以外の任意のフィールド名を使用したい場合は、「マニュアル設定」を参照してください。

各項目の説明を次に示します。

新しい定義を追加するには、以下の手順で操作してください。

1. パラメータ リストで、マッピング対象のパラメータを選択してください。
2. HTML(JSP)のファイル一覧で、マッピング対象のファイルを選択してください。
3. HTML(JSP)のフィールド名一覧で、マッピング対象のフィールドを選択してください。
4. 「設定」ボタンをクリックして、HTML（JSP)のフィールドとパラメータをマッピングしてください。

各項目の説明を次に示します。

自動マッピングについての注意：

• 自動マッピングでは、array型の引数に対する配列単位でのマッピングはできません。配列要素ごとのマッピングは可能です。

  例： typedef string a[10]

  例のような書式の引数がある場合、a[]という配列自体をマッピングすることはできません。
  a[0]のように要素に対してはマッピング可能です。

• JavaScriptを使用している場合は、必ずHTMLタグのname属性値中の"."を"_"に替えてください。

■OPTIONタグのVALUE属性値と表示文字に別の値を設定

OPTIONタグのVALUE属性値と表示文字列を出力引数にマッピングするためには、以下のようにIDLを定義する必要があります。

(1) メンバ２個の構造体を定義し、構造体をsequenceまたはarrayに定義する。
(2) メソッドの出力パラメータに(1)で定義した型のパラメータを追加する。
(3) 「引数設定」ダイアログで、(2)のパラメータを構造体表示し、SELECTタグにマッピングする。

この場合のIDLの定義例を以下に示します。

interface optTest{
	struct optST {
		string		value;
		string		name;
	};
	typedef sequence < optST > seqOptST;
	void method1(out seqOptST opt);
};

上記のように定義することにより、OPTIONタグのVALUE属性値に value の値を設定し、表示文字列に name の値を設定することができます。なお、上記の例の value、name の型は boolean 以外の基本的な型であれば指定可能です。

■Webブラウザが持つCookie情報をサーバAPのパラメータにマッピング

　Webブラウザが持つCookie情報を、WebOTXサーバAPで使用するためのマッピング方法については、「Cookieパラメータ利用の手引き」を参照してください。

■マニュアル設定

メソッドの入力引数に設定するHTTPパラメータとして HTMLファイル中のHTMLタグだけでなく、任意のフィールド名を設定することが可能です。任意のフィールド名の設定は、「引数設定」ダイアログの「入力引数」タブで以下のように行ってください。

• 前画面HTML(JSP)ファイルが存在しない場合
  
  1. 入力引数名リストで、マッピング対象のパラメータを選択してください。構造体や配列については要素単位で設定してください。
  2. 前画面HTML(JSP)ファイル一覧で、「任意HTMLファイル」を選択してください。
  3. HTML(JSP)のフィールド名一覧で、「マニュアル設定」を選択してください。
  4. 「設定」ボタンをクリックするとフィールド名を指定する画面が表示されます。任意のフィールド名を指定してください。
• 前画面HTML(JSP)ファイルは存在するが、HTMLファイル中のHTMLタグ以外のフィールド名を設定したい場合
  
  1. 入力引数名リストで、マッピング対象のパラメータを選択してください。構造体や配列については要素単位で設定してください。
  2. 前画面HTML(JSP)ファイル一覧で、前画面HTML(JSP)ファイルを選択してください。
  3. HTML(JSP)のフィールド名一覧で、「マニュアル設定」を選択してください。
  4. 「設定」ボタンをクリックするとフィールド名を指定する画面が表示されます。任意のフィールド名を指定してください。前画面HTML(JSP)ファイル中のHTMLフィールド名と重複する名前は指定できません。

マニュアル設定したフィールド名から入力値を取得するには、フィールド名と入力値をURLに直接記述して実行してください。
以下に、第一フェーズ実行時、マニュアル設定したフィールド名から入力値を取得する場合のURLを示します。

http://Webサーバ名（ドメイン省略不可）:ポート番号/OTXJSP/RUN?JSPPRO=プロジェクト名&JSPTR=トランザクション名&JSPPHASE=最初に実行するフェーズ名&マニュアル設定したフィールド名=入力値

マニュアル設定時にフィールド名に設定できる文字は、１バイト文字でASCIIコード0x21から0x7e（通常の半角文字）のものです。

ただし、以下の文字はHTMLとして認識できないため、またはWebAP JSPが内部で使用しているため、設定できません。

WebアプリケーションのWebAP JSPへの転送は、プロジェクトパネルのトランザクション名を選択後、メニューバーから「ビルド」−「転送...」メニューをクリックし、「ファイル転送先選択」ダイアログを表示して行ってください。

「ファイル転送先選択」ダイアログの各項目を次に説明します。

項目を設定後、「転送」ボタンをクリックすると、WebAP JSPへのファイル転送を行います。プログレスバーの表示が消えると、転送完了です。

トランザクションの実行状況は、WebAP JSPの「運用状態表示」ページで確認できます。

「閉じる」ボタンをクリックすると、メインウィンドウに戻ります。