5. カスタマイズ

<%-- APAGENT_n_IS 変数名 --%>というコメントを出力用HTML(JSP)ファイルに記述することにより、フェーズに割り当てるメソッドに対応するAPAgentオブジェクトの変数名を自由に設定することができます。

<%-- APAGENT_n_IS 変数名 --%>

   n      : フェーズに割り当てるメソッドの順番に対応する1からの連番
   変数名 : n番目のメソッドに対応するAPAgentオブジェクトの変数名
           （変数名はJavaの命名規則に従います。
             ただし、WebAP JSPの予約語は使用しないでください。）

JSP開発ツールでJSP生成した場合には、メソッドに対応するAPAgentオブジェクトの変数名は、jspAgent_メソッド名となりますが、事前カスタマイズでAPAgentオブジェクトから値を取得する処理を記述する場合には、メソッド名を特定しなければならない変数名を使用するのは不便です。 そのため、フェーズに設定するメソッドの順番に合わせて変数名を自由に設定できるようにしました。

<%-- APAGENT_1_IS agent --%>
	        :
<INPUT NAME="Text1" TYPE="text" VALUE="">  <- ここはJSP開発ツールでマッピング
<INPUT NAME="Text2" TYPE="text" VALUE="<%= agent.param1%>">  <- ここは事前カスタマイズ

<%-- APAGENT_1_IS agent --%>
	        :
<% proj.tran.classes.stub.ifname_Method1_APAgentSub jspAgent_Method1
    = (proj.tran.classes.stub.ifname_Method1_APAgentSub)param.getAPAgent("Method1"); %>
<% proj.tran.classes.stub.ifname_Method1_APAgentSub agent = jspAgent_Method1; %>
	        :
<INPUT NAME="Text1" TYPE="text" VALUE="<%= jspAgent_Method1.param1%>">
<INPUT NAME="Text2" TYPE="text" VALUE="<%= agent.param1%>">
	        :

注意

• このコメントのみで一行が構成されていなければなりません。
• このコメントはHTML(JSP)ファイルのどこに記述してもかまいません。

サーバAPのメソッドの出力引数または戻り値を、列マッピングしたテーブルに、修飾したテキスト文字で表示したい場合は、TDタグの中に修飾用のHTMLタグを記述してください。

<TD>〜</TD>の間にマッピング可能なHTMLタグの記述がない場合、列マッピングしたデータは、<TD>〜</TD>の間に出てくる最初の終端タグの前に出力されます。

下記の記述例の場合は、「引数設定」ダイアログで 名前を出力引数または戻り値に列マッピングすることにより、実行時に出力引数または戻り値の値が </i>タグの前にテキスト文字として出力されます。このため緑色の斜体文字として表示されます。
同様に、住所を列マッピングした場合は、</b>タグの前に出力されるので、太字で表示されます。

<table border="1">
<tr>
<th>名前</th>
<th>住所</th>
</tr>
<tr>
<td><font color=green><i></i></font></td>
<td><b></b></td>
</tr>
</table>

サーバAPのメソッドの出力引数または戻り値を、テーブルの見出し行に表示したい場合は、NAME属性値のない見出し行だけのテーブルを用意し、THタグの中にOTXJSPKEYタグを記述してください。

下記の記述例の場合は、「引数設定」ダイアログで JSPKEY1を出力引数または戻り値にマッピングすることにより、実行時に出力引数または戻り値の値が OTXJSPKEYタグの後ろにテキスト文字として出力されます。このためテーブルの見出しとして表示されます。
また、VAL_Aを出力引数または戻り値にマッピングすることにより、JSPKEY1にマッピングした見出しに対応するデータを表示することができます。

<form>
<table border="1">
<tr><td>
  <table border="1" width="100%">
  <tr>
    <th width="50%"><OTXJSPKEY name="JSPKEY1"></th>
    <th width="50%"><OTXJSPKEY name="JSPKEY2"></th>
  </tr>
  </table>
</td></tr>
<tr><td>
  <table border="1" width="100%">
  <tr>
    <td width="50%"><input type="text" name="VAL_A" size="20"></td>
    <td width="50%"><input type="text" name="VAL_B" size="20"></td>
  </tr>
  </table>
</td></tr>
</table>
</form>

サーバAPのメソッドの出力引数または戻り値を INPUTタグではなくテキスト文字として表示したい場合は、OTXJSPKEYタグを使用してください。

OTXJSPKEYタグは、WebAP JSP 独自のタグであるため、Webブラウザで表示する場合には OTXJSPKEYタグそのものは無視されます。環境設定での指定により OTXJSPKEYタグを生成JSPに出力しないようにすることもできます。

下記の記述例の場合は、「引数設定」ダイアログで ADDRESS を出力引数または戻り値に マッピングすることにより、実行時に出力引数または戻り値の値が OTXJSPKEYタグの後にテキスト文字として出力されます。

HTML（JSP）ファイルをカスタマイズして、ハイパーリンクやJavaScriptでフェーズのURLを指定することにより、次のフェーズを実行することが可能です。

JSPファイル名とは、当該HTML(JSP)ファイルを元にJSP開発ツールで作成するJSPファイルの名前です。命名規則は以下のようになります。
HTML（JSP）ファイル中にフォームが複数あり、２番目以降のフォームから実行する場合は、以下の後に":フェーズを実行するフォームの番号(記述順に1から数えた番号)"を追加してください。

JSP開発ツールで作成したJSPファイル中に、フォームごとに"JSPNAME"というNAME属性値のhidden属性のINPUTタグの記述が追加されます。JSPファイル名が、そのINPUTタグのVALUE属性値と同じ値になっていることを確認してください。

注意：JSPNAME、JSPCOUNTを指定しない場合、フェーズの遷移チェックが正しく行われないことがあります。
また、JSPNAMEを指定しない場合、サーバAPの入力パラメータに正しい値を設定できないことがあります。

下記はJavaScriptに記述する場合の例です。
2番目のフォームのボタンをクリックするとフェーズp2を実行し、新しいウィンドウにフェーズ実行結果を表示します。

<SCRIPT Language="JavaScript">
function open_window(){
	alert('送信します')
	window.open('/OTXJSP/RUN?JSPPRO=Proj1&JSPTR=Tran1&JSPPHASE=p2&JSPNAME=p1_p1.jsp:2&JSPCOUNT=<%= param.count %>','window2');
}
</SCRIPT>

<FORM >
<INPUT TYPE="text" NAME="Frm1_text_1" SIZE=20>
</FORM>

<FORM >
<INPUT TYPE="text" NAME="Frm2_text_1" SIZE=20>
<INPUT NAME="Frm2_button" TYPE="button"VALUE="送信button" onClick="open_window()">
</FORM>

<TABLE NOTBLMAP>
  <TR>
    <TD BGCOLOR="<OTXJSPKEY NAME=P1_M>"><INPUT TYPE="TEXT"  NAME="P1" SIZE="20">
    </TD>
  </TR>
</TABLE>

注意：

• 上記のように「タグの属性="OTXJSPKEYタグ"」と記述する場合、JSP開発ツールの「環境設定」ダイアログの「JSP」タブで、OTXJSPKEYタグをJSPファイルに出力しないように設定してください。
• 上記のようにタグ内にタグを記述した場合、HTMLエディタによっては内側のタグの"<"と">"を"&キーワード（ltまたはgt）;"のように書き換えられる場合があります。その場合は、テキストエディタ等で元のように書き換えてください。
• すでにマッピング済のフェーズについて、フェーズの出力用HTML(JSP)ファイルを修正してTABLEタグにNOTBLMAP属性を付加または削除すると、既存のマッピング情報が消える場合があります。NOTBLMAP属性を付加または削除したら、必ず「引数設定」ダイアログで再設定を行ってください。

HTML(JSP)ファイルを作成するときには、次の点に注意してください。

• 「HTMLタグの開始（<）から終了（>）までの間で改行する場合、NAMEやVALUEなどの属性の途中で改行しないでください。たとえば、「NAME=（改行）ABC」のように記述しないでください。「NAME=ABC(改行)VALUE=123」のように属性ごとに改行することは可能です。」

• HTMLタグのNAME属性値に不適切な文字（以下の枠内参照）を使用した場合、HTMLタグの種類によって、以下の制限があります。

  ASCIIコード0x21から0x7e（通常の半角文字）の文字以外 "(0x22) (*注1) ,(0x2c) <(0x3c) =(0x3d) >(0x3e) {(0x7b) }(0x7d) (*注1) NAME="ABC"のように値の両端のみに "(0x22)を記述している場合は問題ありません。

  • INPUTタグ、TEXTAREAタグ、SELECTタグの場合

    不適切な文字を含むNAME属性値がある場合、JSP開発ツールでHTML（JSP）ファイルを読み込んで使用可能ですが、不適切な文字を含むHTMLタグはサーバAPの引数にマッピングできません。
    
    「"」(0x22)、「>」(0x3e)については、JSP開発ツールでHTML（JSP）ファイルを読み込むことは可能ですが、Webブラウザの表示が不正になる場合があるので、NAME属性値内に使用しないでください。
    
    「>」(0x3e)の場合でも、NAME="ABC<% =I %>"のようにJSP構文の終端としての%>の記述であれば、HTML（JSP）ファイルを使用可能です。
    
    

  • TABLEタグ、OTXJSPKEYタグの場合

    不適切な文字を含むNAME属性値がある場合、JSP開発ツールでHTML（JSP）ファイルを読み込んで使用することはできません。
    
    「"」(0x22)、「>」(0x3e)については、JSP開発ツールでHTML（JSP）ファイルを読み込むことは可能ですが、Webブラウザの表示が不正になる場合があるので、NAME属性値内に使用しないでください。
    
    

以下に、NAME属性値の記述によるWebAP JSPでの扱い方の違いを示します。

NAME属性値の記述例	WebAP JSPでの扱い方
< INPUT TYPE=”TEXT” NAME=”ABC”>	HTML(JSP)ファイル使用可能、マッピング可能
< INPUT TYPE=”TEXT” NAME=”ABC<% =I %>”>	HTML(JSP)ファイル使用可能、マッピング不可
<TABLE NAME=”ABC<% =I %>”>	HTML(JSP)ファイル使用不可
< INPUT TYPE=”TEXT” NAME=”ABC<% =”I” %>”>	HTML(JSP)ファイル使用可能、マッピング可能、Webブラウザの表示不正

• HTMLタグのNAME以外の属性値（VALUEなど。NAME属性値の制限は上記参照。）の値として""や<>を含む文字列を使用しないでください。このようなHTMLファイルをJSP開発ツールで読み込んだとき、正常にHTMLタグや属性値を検出できない場合があります。
  
• HTMLタグを中に含んだコメントを記述しないでください。コメントとして扱われない場合があります。

  例：	<!---- <input type="text" name="abcd"> <input type="text" name="efgh"> --->

• <Form>タグの中に<Form>タグを記述しないでください。「引数設定」ダイアログでマッピングできません。

• 同じname属性値を設定する場合の注意点
  • 同じname属性値を同一フォーム内で設定する場合は、以下の条件をすべて満たす必要があります。
    • 同じ種類のHTMLタグであること。
    • 同じテーブル内で、かつ、同じ列内のHTMLタグであること。またはテーブルに含まれないHTMLタグ同士であること。
  • 同じname属性値をどちらもフォーム外で設定する場合は、以下の条件をすべて満たす必要があります。
    • 拡張マッピングタグ（OTXJSPKEY）であること。
    • 同じテーブル内で、かつ、同じ列内のHTMLタグであること。またはテーブルに含まれないHTMLタグ同士であること。
  • 同じname属性値がフォーム内とフォーム外にある場合、または別々のフォーム内にある場合はHTMLタグの種類やテーブルに含まれるかどうかに関わらず、設定可能です。

• HTMLタグのname属性値中に"."は記述しないことを推奨します。
  パラメータ名と自動マッピングを行う場合は、"."を"_"に替えてもマッピング可能です。
  JavaScriptを使用している場合は、必ずHTMLタグのname属性値中の"."を"_"に替えてください。

• バージョン2.122 以前の WebAP JSP 構文で HTML にカスタマイズを加えている場合は、最新版のWebAP JSP Developer でビルドメニューを利用する前に修正する必要があります。
  詳細は、「WebOTX WebAP JSP 運用ガイド 互換性について」を参照してください。

• MFDL移行した画面をカスタマイズする場合に注意する点については、「移行画面のカスタマイズの注意点」を参照してください。

• JSP構文の終端（%>）以外では、HTMLの終端タグ(>)の直前に%を記述しないでください。
  例えば、TABEL、TDタグ等のWIDTH属性値を%表記で指定する場合は、指定値をダブルクォーテーションで囲むなどして、HTMLの終端タグの直前が%にならないようにしてください。
  

  例：	<table width="80%">

フェーズ処理を行うJavaソースファイルは、JSP開発ツールで自動的に作成します。作成したソースファイルは、以下の場所にあります。

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

JSP開発ツールからソース生成を行ったときにフェーズJavaソースファイルに上書きすると、カスタマイズした情報は削除されます。
カスタマイズした情報をフェーズJavaソースファイル更新後にも使用したい場合には、カスタマイズした内容を別ファイルに保存するなどの対応が必要です。

フェーズJavaソースファイル中でカスタマイズが不可能な部分は以下のように
「// ------- fixed area start -------」
「// ------- fixed area end ------- 」
で区分けしています。

// ------- fixed area start -------
//出力データ管理オブジェクト作成
OTXJSPResultRel1  jspresult = preOTXJSPResult;
if(jspresult == null){
	jspresult = new OTXJSPResultRel1();
}
// ------- fixed area end -------

この範囲に含まれていないソースについてカスタマイズを行ってください。範囲内に含まれるソースを修正する必要がある場合には、修正による影響を十分考慮のうえ行ってください。

作成後のJavaソースファイルを、入力データおよび出力データについてユーザが直接カスタマイズすることができます。カスタマイズできるのは、ソースファイル中の以下のメソッド内の特定の記述のみです。その他のソースコードは変更しないでください。

public WebOTXJSPBean execute(
  Object com,
  HttpServletRequest req,
  HttpServletResponse res,
  String host,
  OTXJSPResultRel1 preOTXJSPResult,
  PhaseExecInfo pInfo
) throws JServletException

private void setInputParam_jspAgent_
カウンタ_メソッド名_出力JSPファイル名（
  APAgentのクラス名 jspAgent_メソッド名,
  HttpServletRequest req,
  String jspCode
)throws JServletException

JSP開発ツール起動時のJavaVMのオプションで、-Dwebapjsp.phasestate=1を指定しているときは、executeメソッドの形式は以下のようになります。JavaVMのオプションについては、「WebAP JSP Developer 固有のJavaVMのオプション」を参照してください。

public WebOTXJSPBean execute(
  Object com,
  HttpServletRequest req,
  HttpServletResponse res,
  String host,
  OTXJSPResultRel1 preOTXJSPResult
) throws JServletException

タイムアウトフェーズのカスタマイズについては、「カスタマイズ例３（タイムアウトフェーズのカスタマイズ）」を参照してください。

WebAP JSPでは、サーバAPのメソッドの入力引数に値を設定する場合、APAgentクラスのメンバ変数に値を設定します。WebAP JSPでは自動生成したフェーズソースのexecuteメソッドでAPAgentクラスのインスタンスを生成しています。APAgentクラスのインスタンスはjspAgent_メソッド名の変数に設定しています。
INPUTタグのNAME属性値ADDRESSから取得した文字列をサーバAPのメソッドの入力引数(string型)に指定する場合の例を示します。

ADDRESSの値を JavaServlet API である getParameter メソッドにより取得し、入力引数に設定するには、APAgentクラスのメンバ変数に値を設定します。メンバ変数の名前はIDLで定義したメソッドのパラメータ名となります。以下のようにカスタマイズします。

jspAgent_メソッド名.入力引数名 = CodeConv.changeCode(req.getParameter("ADDRESS"), jspCode);

INPUTタグのNAME属性値VINTAGEから取得した文字列をサーバAPのメソッドの入力引数(long型)に指定する場合の例を示します。

jspAgent_メソッド名.入力引数名 = DataConv.changeStrToInt("VINTAGE",req.getParameter("VINTAGE"));

入力引数に値を設定する処理をカスタマイズする場合は、以下のことに注意してください。

自動生成されたフェーズJavaソース内の入力引数に値を設定する処理を削除すると、不正な値が送信されたり、メソッドの実行に失敗する場合があります。

フェーズJavaソース中のデバッグトレースに情報を出力したい箇所で、以下のいずれかの形式でカスタマイズコードを追加してください。

  Trace.println(Trace.TRACE_LEVEL_1,"デバッグメッセージ");
  

  if(Trace.getLevel() >= Trace.TRACE_LEVEL_1){ 
     Trace.println("デバッグメッセージ");
  }
  

WebAP JSPでトレースを取得するように設定している場合、カスタマイズしたフェーズが実行されると、トレースログに「デバッグメッセージ」で指定した内容を出力します。

タイムアウトフェーズが実行される契機は、セッション解放契機と同じです。タイムアウト時だけでなく、別のトランザクションに切り替わる場合も、タイムアウトフェーズが実行されます。
タイムアウトフェーズ中で業務の終了処理を行いたいが、トランザクション切り替わり時には終了処理を行いたくないといった場合には、タイムアウトフェーズの実行契機を判断して処理を切り分けてください。
タイムアウトフェーズの実行契機は、executeメソッドのreqパラメータ、resパラメータの値により判断できます。詳細はexecuteメソッドを参照してください。

また、トランザクション切り変わり時に、次に実行するトランザクションを判断して特定の処理を行うようにカスタマイズすることもできます。
以下にカスタマイズの例を示します。

public WebOTXJSPBean execute(Object  com, HttpServletRequest  req, HttpServletResponse res,
String host, OTXJSPResultRel1 preOTXJSPResult, PhaseExecInfo pInfo) 
throws  JServletException{
	--------------

	//トランザクション切り替わり時以外のときに終了処理を行う
	if((req == null) && (res == null)){
	    //終了処理を記述
	}
	--------------

	//次のトランザクションがプロジェクトProj1、トランザクションTran1のとき特定処理を行う
	if(req != null){
	    String nextproj = req.getParameter("JSPPRO");
	    String nexttran = req.getParameter("JSPTR");
	    if((nextproj.equals("Proj1")) && (nexttran.equals("Tran1"))){
	        //特定処理を記述
	    }
	}
	--------------
}		

フェーズ処理を実行した結果を出力するJSPファイルは、JSP開発ツールで自動的に作成します。作成したJSPファイルは、以下の場所にあります。

JSP開発ディレクトリ/jsp/プロジェクト名/トランザクション名/*.jsp

JSP開発ツールからJSP生成を行ったときにJSPファイルに上書きすると、カスタマイズした情報は削除されます。
カスタマイズした情報をJSPファイル更新後にも使用したい場合には、カスタマイズした内容を別ファイルに保存するなどの対応が必要です。

JSPファイル中でカスタマイズが不可能な部分は以下の行記述で囲んでいます。
<%--- WebOTX WebAP JSP script1 Rel1 ----%>
<%--- WebOTX WebAP JSP script2 Rel1 ----%>
<%--- WebOTX WebAP JSP script3 Rel1 ----%>

<%--- WebOTX WebAP JSP script1 Rel1 ----%>
<%--- This JSP File can be used for JSP 1.0 ---%>
<%@ page import="jp.co.nec.webapjsp.run.*" %>
<%@ page import="jp.co.nec.webapjsp.common.util.*" %>
<%@ page contentType="text/html; charset=Shift_JIS" %>
<%--- WebOTX WebAP JSP script1 Rel1 ----%>

この範囲に含まれていないソースについてカスタマイズを行ってください。範囲内に含まれるソースを修正する必要がある場合には、修正による影響を十分考慮のうえ行ってください。

自動生成したJSPファイル内で使用できるJSP1.0構文は以下の通りです。

また以下のオブジェクトが自動生成したJSPファイル中から参照可能です。

WebAP JSPでは、サーバAPのメソッドの出力引数、戻り値を取り出す場合、APAgentクラスを使用します。

APAgentクラスは、OTXJSPResultRel1クラスの getAPAgentメソッドにより取得します。APAgentクラスを取得するコードについては、JSPファイルに自動生成しています。

以下に自動生成したコード例を示します。

テキストとして表示したい箇所に、値を取得するコードを追記することにより、サーバAPの出力引数、戻り値を表示することができます。
出力引数を表示する場合、以下のようにコードを記述します。

戻り値を表示する場合以下のようにコードを記述します。
（サーバAPのメソッドが void型の場合は、このような記述はしないでください。）

次のIDL定義、HTMLの場合を想定して、説明します。

interface ARRAYTEST{
  typedef string ARRAY_NAME[6]; 
  typedef wstring ARRAY_ADDR[6];

  string methodB(in ARRAY_NAME iNAME, in ARRAY_ADDR iADDR,
    out ARRAY_NAME oNAME, out ARRAY_ADDR oADDR);
};

<table name="tblA" border="1" >
<tr>
<th>名前</th>
<th>住所</th>
</tr>
</table>

JSP開発ツールを使って自動生成したJSPのテーブル出力部分をカスタマイズして、「名前」列に出力するデータが空文字列のとき、以降の行を出力しないようにします。
<%--　--%>は、コメントです。

<TABLE NAME="tblA" border= "1"> 
<TR > 
<TH>名前</TH> 
<TH>住所</TH> 
</TR> 
 
<%   {  %> 
<%   int jsp_rowcount = 0;    %> 
<%   for(int jsp_i = 0 ; ; jsp_i++){    %> 
<%       boolean jsp_flag = false; %> 
<%       String jsp_column1_value = ""; 
         try{ 
             jsp_column1_value = jspAgent_methodB.oName[jsp_i]; 
             jsp_flag = true; 
         }catch(ArrayIndexOutOfBoundsException e){ 
         }%> 
<%       String jsp_column2_value = ""; 
         try{ 
             jsp_column2_value = jspAgent_methodB.oADDR[jsp_i]; 
             jsp_flag = true; 
         }catch(ArrayIndexOutOfBoundsException e){ 
         }%> 
<%       if(jsp_flag == false){ 
             break; 
         }%> 
<TR > 
    <TD><%= jsp_column1_value %></TD> 
    <TD><%= jsp_column2_value %></TD> 
</TR> 
<%    }    %> 
	 
<INPUT NAME="tblA__jsp_maxcount" TYPE="HIDDEN" VALUE="<%= jsp_rowcount %>" > 
<%    }    %> 
 
</TABLE> 

<TABLE NAME="tblA" border= "1"> 
<TR > 
<TH>名前</TH> 
<TH>住所</TH> 
</TR> 

<%    {    %> 
<%    int jsp_rowcount = 0;    %> 
<%    for(int jsp_i = 0 ; ; jsp_i++){    %> 
<%        boolean jsp_flag = false; %> 
<%        String jsp_column1_value = ""; 
          try{ 
              jsp_column1_value = jspAgent_methodB.oName[jsp_i]; 
              if(jsp_column1_value.length() == 0){ 
                break; 
            } 
              jsp_flag = true; 
          }catch(ArrayIndexOutOfBoundsException e){ 
          }%> 
<%        String jsp_column2_value = ""; 
          try{ 
              jsp_column2_value = jspAgent_methodB.oADDR[jsp_i]; 
              jsp_flag = true; 
          }catch(ArrayIndexOutOfBoundsException e){ 
          }%> 
<%        if(jsp_flag == false){ 
              break; 
          }%> 
<TR > 
    <TD><%= jsp_column1_value %></TD> 
    <TD><%= jsp_column2_value %></TD> 
</TR> 
<%    }    %> 

<INPUT NAME="tblA__jsp_maxcount" TYPE="HIDDEN" VALUE="<%= jsp_rowcount %>" > 
<%    }    %> 

</TABLE>

上記例の場合、インクルードするファイルは以下のようになります。

フェーズ処理を実行中にエラーを検出した場合に表示されるエラー表示画面は、以下の場所にあります。

runerr.jspは、SJISコードで記述しています。

エラー表示画面を変更して別のファイル名で格納した場合は、「環境設定」ページの「エラー発生時に表示するJSP名」を変更してください。

エラー表示画面を変更した場合、デフォルトと同じファイル名(runerr.jsp)のままにしておくと、WebAP JSPのバージョンアップインストールで、デフォルトのエラー表示画面に上書きされます。

エラー表示画面用JSPファイルにおけるエラー情報の参照方法について説明します。

＜エラー概要＞

    int errNo = jservletException.getErrno();
    int errcd = JServletError.getErrNo(errNo);

    String errMsg = jservletException.getMsg();

＜エラー詳細(CORBAシステム例外の場合)＞

   Exception e = jservletException.getException(); 
   if(e instanceof org.omg.CORBA.SystemException){ 
        org.omg.CORBA.SystemException e2 =  (org.omg.CORBA.SystemException)e; 
   }

    String  minor = String.valueOf(e2.minor);

    String emsg = e2.toString();

＜エラー詳細(CORBAユーザ例外の場合)＞

    Exception e = jservletException.getException();
    if(e instanceof org.omg.CORBA.UserException){
        org.omg.CORBA.UserException e2 =  (org.omg.CORBA.UserException)e;
    }

    String emsg = e2.toString();

＜エラー詳細(WebOTX VIS Connectorから通知されたユーザ例外の場合)＞

    Exception e = jservletException.getException();
    if(e instanceof jp.co.nec.webapjsp.run.common.VISConUserException){
        jp.co.nec.webapjsp.run.common.VISConUserException __jsp_vexception = 
             (jp.co.nec.webapjsp.run.common.VISConUserException)e;
        if(e instanceof jp.co.nec.webapjsp.run.common.VCAConUserException){
	    //VCAConUserExceptionの場合に行いたい処理を記述
        }
    }

    if(__jsp_vexception instanceof jp.co.nec.webapjsp.run.common.VCAConUserException){
	//VCAConUserExceptionの場合に詳細情報を取得
	String	detail  = ((jp.co.nec.webapjsp.run.common.VCAConUserException)__jsp_vexception).errdetail;
    }
    int __jsp_viscon_langtype = __jsp_vexception.errinfo & 0x00ff;   // WebOTX VIS Connectorの言語種別取得
			 
    if((__jsp_vexception.errinfo & 0x0100) != 0){   //  WebOTX VIS Connectorのコネクト状態チェック
        __jsp_viscon_is_connect = true;
    }
			 
    errinfo = Integer.toHexString(__jsp_vexception.errinfo);
 
    String [][]__jsp_msgdim = null;
    String visconerrPath = WebOTXJSPBase.getInstPath() + 
                  java.io.File.separator + "conf" + 
                  java.io.File.separator + "data" + 
                  java.io.File.separator + "visconerr.dat";
    try{
        setVisConErrMsg(visconerrPath); //  WebOTX VIS ConnectorUserException定義ファイルを読み込む
        if(__jsp_viscon_langtype == 0x00){ //  WebOTX VIS Connector C++版
            __jsp_msgdim = __jsp_VISConUserExceptionMsg_C; 
        }else if(__jsp_viscon_langtype == 0x01){ //  WebOTX VIS Connector JAVA版 
            __jsp_msgdim = __jsp_VISConUserExceptionMsg_Java; 
        }
    }catch(IOException e2){
    }
 
    if(__jsp_msgdim != null){
    // エラーコードに対応するメッセージを取得する
        int __vexception_errcode = (__jsp_vexception.errcode & (~0x10000000));
        for(int i = 0; i < __jsp_msgdim.length ; i++){
            String []__jsp_se =  __jsp_msgdim[i];
            try{
                if(__vexception_errcode == (Integer.valueOf(__jsp_se[0],16)).intValue()){
                    minor   = __jsp_se[0];	// 番号
                    cause   = __jsp_se[1];	// 原因
                    explain = __jsp_se[2];	// 詳細
                    tackle  = __jsp_se[3];	// 対処方法
                    break;
                }
            }catch(NumberFormatException e3){
            }
        }
    }

補足
WebOTX Connector Developer(VISコネクタ)で生成したサーバAPをカスタマイズして、独自エラーコードのVCAConUserExceptionを通知するようにした場合には、 WebOTX VIS ConnectorのUserException定義ファイル(visconerr.dat)に対応するエラーメッセージを追加してください。

WebOTX VIS ConnectorがC++版の場合は、visconerr.datの「// C 」のコメント行の下に、 WebOTX VIS ConnectorがJAVA版の場合は、visconerr.datの「// Java 」のコメント行の下に、エラーコード、原因、エラー内容、対処方法を、「,」で区切って１行に記述してください。エラーコードは16進で記述してください。

WebOTX VIS ConnectorのUserException定義ファイルは、以下の場所にあります。

visconerr.datは、SJISコードで記述しています。

• JSP構文が記述されていないため、HTMLエディタで編集可能です。
• JSPファイルのカスタマイズはMFDL移行処理を再度実行時に消えてしまいますが、HTMLファイルをカスタマイズした場合は、カスタマイズをすべて生かしたまま再度MFDL移行処理を実行することができます。

1. 移行定義ファイル作成Excelファイルの「基本設定」シートの「生成対象」に「HTML」を指定して、移行定義ファイルを作成してください。
2. JSP開発ツールまたはコマンドラインから、1.の移行定義ファイルを指定してMFDL移行処理を実行してください。HTMLファイルが生成されます。
3. HTMLファイルをカスタマイズしてください。
4. 移行定義ファイル作成Excelファイルの「基本設定」シートの「生成対象」に「JSP」を指定、「HTMLの反映」に「する」を指定して、移行定義ファイルを作成してください。
5. JSP開発ツールまたはコマンドラインから、4.の移行定義ファイルを指定してMFDL移行処理を実行してください。JSPファイルが生成されます。

HTMLを作成した後で、WebOTX Connector Developer(VISコネクタ)でMFDL定義ファイルから移行し直すなどしてコネクタ連携ファイルを変更した場合は、以下のことに注意してください。

• HTMLファイルをコネクタ連携ファイルにあわせて作り直すために再度MFDL移行処理を実行する場合は、既存のHTMLファイルを削除してください。既存のHTMLファイルがある場合、そのHTMLファイルの再作成を行いません。
• 「HTMLを反映する」を指定してJSPファイルを生成する場合、コネクタ連携ファイル中に存在するフィールドに対応したタグがHTMLファイルに存在しなければ、MFDL移行中に警告メッセージを表示します。また、生成するJSPファイル中に警告メッセージをコメントとして記述します。
• 「HTMLを反映する」を指定してJSPファイルを生成する場合、コネクタ連携ファイルに対応するHTMLファイル自身が存在しなければ、MFDL移行中に警告メッセージを表示し、コネクタ連携ファイルのフィールド情報を元にJSPファイルを作成します。また、生成するJSPファイル中に警告メッセージをコメントとして記述します。

• 編集に使用するHTMLエディタによっては、MFDLから移行した画面と項目の位置が変わってしまう場合があるのでご注意ください。WebAP JSP開発部門では、FrontPage98でこの現象が発生することを確認しています。

• <HEAD>、</HEAD>、<BODY>、</BODY>、<FORM>、</FORM>タグを削除しないでください。

• <BODY>タグのonLoadイベントに処理を記述する場合には、必ず処理を ' で囲んでください。

  例： onLoad='initFunc()'

• 以下の名前のINPUTタグのonClickイベントに処理を記述する場合には、必ず処理を ' で囲んでください。
  

  "exec"、"PF01"、"PF02"、"PF03"、"PF04"、"PF05"、"PF06"、 "PF07"、"PF08"、"PF09"、"PF10"、"PF11"、"PF12"、"PF13"、 "PF14"、"PF15"、"EK01"、"EK02"、"EK03"

  例： onClick='checkFunc()'

• JSP構文を追加しないでください。

• タグのNAME属性値やタグの種類を変更しないでください。

• HTMLファイルをカスタマイズ時のその他の注意点については、「HTML作成の注意点」を参照してください。