001/* 002 * Copyright (c) 2009 The openGion Project. 003 * 004 * Licensed under the Apache License, Version 2.0 (the "License"); 005 * you may not use this file except in compliance with the License. 006 * You may obtain a copy of the License at 007 * 008 * http://www.apache.org/licenses/LICENSE-2.0 009 * 010 * Unless required by applicable law or agreed to in writing, software 011 * distributed under the License is distributed on an "AS IS" BASIS, 012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, 013 * either express or implied. See the License for the specific language 014 * governing permissions and limitations under the License. 015 */ 016package org.opengion.hayabusa.taglib; 017 018import org.opengion.hayabusa.common.HybsSystem; 019import org.opengion.hayabusa.common.HybsSystemException; 020import org.opengion.hayabusa.db.DBColumn; 021import org.opengion.hayabusa.db.DBColumnConfig; 022import org.opengion.hayabusa.resource.CodeData; 023import org.opengion.hayabusa.resource.RoleMode; 024import org.opengion.fukurou.util.Attributes; 025import org.opengion.fukurou.util.XHTMLTag; 026import org.opengion.fukurou.util.StringUtil; 027import org.opengion.fukurou.util.ToString; // 6.1.1.0 (2015/01/17) 028import org.opengion.fukurou.util.ArraySet; // 6.4.3.4 (2016/03/11) 029import static org.opengion.fukurou.util.StringUtil.nval; 030 031import java.util.Set; // 6.4.3.4 (2016/03/11) 032 033/** 034 * カラムリソースに基づいた、入力フィールドなどを作成するHTML拡張タグです。 035 * 036 * name 属性に カラムリソースのキーを与えることにより、指定した表示形式にて画面に表示します。 037 * column タグは、リソースの設定が反映されるため、アプリケーションを修正せずに、 038 * 機能拡張することが可能です。たとえば、テキストフィールド入力に設定していたカラムを、 039 * プルダウンメニューに即座に変更可能です。 040 * カラム定義でロールが指定されている場合、ログインユーザーでアクセス許可がない場合は 041 * カラムは表示されません。 042 * カラムリソースに存在しない場合や特殊用途に使用する場合は、inputタグを使用してください。 043 * 044 * @og.formSample 045 * ●形式:<og:column name=… value=… /> 046 * ●body:あり(EVAL_BODY_BUFFERED:BODYを評価し、{@XXXX} を解析します) 047 * 048 * ●Tag定義: 049 * <og:column 050 * name ○【TAG】カラムの名前を指定します(必須)。 051 * value 【TAG】設定値を指定します 052 * defaultVal 【TAG】value属性に値がセットされていないときに、初期値をセットします 053 * td 【TAG】テーブル形式の <td> タグを使用するかどうか[yes/no/false]を指定します (初期値:yes) 054 * addNoValue 【TAG】セレクトメニューの場合、値なしのOptionを含めるかどうか[true/false]を指定します (初期値:true) 055 * addKeyLabel 【TAG】セレクトメニューの場合、キー:ラベル形式で表示するかどうか[true/false/null]を指定します (初期値:null) 056 * lbl 【TAG】ラベルリソースのラベルIDを指定します 057 * must 【TAG】必須入力を表す色に変えるかどうか[true/false]を指定します (初期値:false) 058 * mustAny 【TAG】選択必須入力(どれかひとつ必須)を表す色[true/mustAny/その他]を指定します (初期値:無指定) 059 * useMustHidden 【TAG】必須の自動チェック用Hiddenを出力するかどうか[true/false]を指定します (初期値:true) 060 * aimai 【TAG】曖昧検索可能フィールドとして、曖昧検索方法を指定します (初期値:null) 061 * writable 【TAG】書き込みタイプかどうか[true/false]を指定します (初期値:true) 062 * colspan 【HTML】フィールド部分の colspan を指定します 063 * rowspan 【HTML】ラベル、フィールド共に rowspan を指定します 064 * id 【HTML】要素に対して固有の名前(id)をつける場合に設定します 065 * size 【HTML】カラムの入力枠サイズ(横幅)を文字数でセットします(入力文字制限ではありません) 066 * viewSize 【TAG】カラムの表示サイズ(横幅)を文字数でセットします。 067 * maxlength 【HTML】最大入力文字数を指定します(入力可能文字数で、バイト数ではありません) 068 * renderer 【TAG】カラムの表示用レンデラー({@og.doc03Link renderer Renderer_****})をセットします 069 * editor 【TAG】カラムの編集用エディター({@og.doc03Link editor Editor_****})をセットします 070 * dbType 【TAG】DBタイプ({@og.doc03Link dbType DBType_****})をセットします 071 * optionAttributes 【TAG】JavaScript などの HTML基本タグ以外の属性を、そのままタグとして使用します 072 * // useDefaultPropertieVal 【廃止】カラムリソースの初期値を使うかどうか[true/false]を指定します (初期値:false) 8.4.3.0 (2023/03/31) Delete 073 * nextForm 【TAG】入力カーソルを、指定されたname属性のフィールドへ自動的に移動させます 074 * useRequestValue 【TAG】value が null の場合に、name 属性から Request情報 を適用するかどうかを指定します (初期値:true) 075 * codeName 【TAG】コードセレクトのユニークキー(コード名称)をセットします 076 * codeList 【TAG】コードセレクトのサブセットとなるコードをCSV形式で指定します 077 * codeGroup 【TAG】コードセレクトのサブセットとなるグループを指定します 078 * codeKeyVal 【TAG】新しいコードセレクトを作成する為の「キー:ラベル キー:ラベル」の文字列を指定します 079 * useLblBody 【TAG】BODYに記述した内容で、ラベルを作成します 7.4.2.0 (2021/04/30) 080 * clazz 【HTML】要素に対して class 属性を設定します 081 * caseKey 【TAG】このタグ自体を利用するかどうかの条件キーを指定します (初期値:null) 082 * caseVal 【TAG】このタグ自体を利用するかどうかの条件値を指定します (初期値:null) 083 * caseNN 【TAG】指定の値が、null/ゼロ文字列 でない場合(Not Null=NN)は、このタグは使用されます (初期値:判定しない) 084 * caseNull 【TAG】指定の値が、null/ゼロ文字列 の場合は、このタグは使用されます (初期値:判定しない) 085 * caseIf 【TAG】指定の値が、true/TRUE文字列の場合は、このタグは使用されます (初期値:判定しない) 086 * lang 【HTML】要素の内容と他の属性値の言語(lang,xml:lang)を指定します 087 * dir 【HTML】文字表記の方向(dir)を指定します 088 * title 【HTML】要素に対する補足的情報(title)を設定します 089 * style 【HTML】この要素に対して適用させるスタイルシート(style)を設定します 090 * readonly 【HTML】その部品に対して変更が出来ないように(readonly)指定します(サーバーに送信される) 091 * disabled 【HTML】その部品に対して、選択や変更が出来ないように(disabled)指定します(サーバーに送信されない) 092 * tabindex 【HTML】タブの移動順(tabindex)を指定します(0 ~ 32767) 093 * accesskey 【HTML】アクセスキー(alt+キーで直接指定)を割り当てます 094 * language 【HTML】タグ内部で使用する言語コード[ja/en/zh/…]を指定します 095 * onClick 【HTML】JavaScriptのイベント onClick を設定します(例:onClick="renew('query.jsp','QUERY');") 096 * onChange 【HTML】JavaScriptのイベント onChange を設定します(例:onChange="renew('query.jsp','QUERY');") 097 * onBlur 【HTML】JavaScriptのイベント onBlur を設定します(例:onBlur="this.value=value.toUpperCase();") 098 * onFocus 【HTML】JavaScriptのイベント onFocus を設定します 099 * ondblClick 【HTML】JavaScriptのイベント ondblClick を設定します 100 * onMouseDown 【HTML】JavaScriptのイベント onMouseDown を設定します 101 * onMouseUp 【HTML】JavaScriptのイベント onMouseUp を設定します 102 * onMouseMove 【HTML】JavaScriptのイベント onMouseMove を設定します 103 * onMouseOut 【HTML】JavaScriptのイベント onMouseOut を設定します 104 * onMouseOver 【HTML】JavaScriptのイベント onMouseOver を設定します 105 * onSelect 【HTML】JavaScriptのイベント onSelect を設定します 106 * onKeydown 【HTML】JavaScriptのイベント onKeydown を設定します 107 * onKeypress 【HTML】JavaScriptのイベント onKeypress を設定します 108 * onKeyup 【HTML】JavaScriptのイベント onKeyup を設定します 109 * autocomplete 【HTML5】入力候補を提示して入力内容を自動補完する[on/off] (初期値はon) 110 * autofocus 【HTML5】指定した入力欄にカーソルが当たって自動的にフォーカスされます 111 * pattern 【HTML5】正規表現で入力値のパターンを指定します 112 * placeholder 【HTML5】入力欄に初期表示する内容を指定します 113 * required 【HTML5】入力必須を指定します 114 * list 【HTML5】ユーザーに入力候補として提案するデータリストの要素のid属性の値を指定します 115 * min 【HTML5】入力欄で入力できる最小値を指定します 116 * max 【HTML5】入力欄で入力できる最大値を指定します 117 * step 【HTML5】入力欄で刻むステップ値を指定する 118 * type 【HTML5】HTML5追加分[text/search/tel/url/email/datetime/date/month/week/time/datetime-local/number/range/color] 119 * roles 【TAG】ロールをセットします 120 * eventColumn 【TAG】イベントカラム(親カラム)セット 121 * eventValue 【TAG】イベントValueのSQL分 122 * eventURL 【TAG】イベントURLのセット 123 * eventCallback 【TAG】eventColumn実行後のcallbak関数指定 124 * param 【TAG】パラメータをセットします(eventColumn でDBMENUの場合は、select文を記述します) 125 * dbid 【TAG】(通常は使いません)データベースへ接続する場合のID (初期値:null) 126 * xssCheck 【TAG】リクエスト情報の HTMLTag開始/終了文字(><) 存在チェックを実施するかどうか[true/false]を設定します (初期値:USE_XSS_CHECK[=true]) 127 * useSLabel 【TAG】MENU,DBMENUでSLABELを利用するかどうか[auto/true/false]を指定します (初期値:auto) 128 * help 【TAG】このカラムに対するヘルプファイルを指定します (初期値:null) 129 * useRealTimeCheck 【TAG】(通常は使いません)リアルタイムチェックを行うかどうか (初期値:true:行う) 5.9.32.2 (2018/05/18) 130 * useDateFeed 【TAG】日付送り戻し機能を有効にするかどうか[true:有効/false:無効]指定します (初期値:true) 8.1.2.3 (2022/05/20) 131 * useHidden 【TAG】隠しフィールドを作成するかどうか[true/false]指定します (初期値:false) 8.3.1.0 (2022/10/14) 132 * debug 【TAG】デバッグ情報を出力するかどうか[true/false]を指定します (初期値:false) 133 * > ... Body ... 134 * </og:column> 135 * 136 * ●使用例 137 * <og:column name="PN" /> 編集種別がTextの場合は、テキストフィールドが表示されます。 138 * 通常はNAME属性を指定するだけです。 139 * <og:column name="CDC" /> 編集種別がMenuの場合は、メニューが表示されます。 140 * <og:column name="PN" value="syokichi" /> 初期値をセットするときはvalue属性を使います。 141 * <og:column name="PN" lbl="PNL" /> ラベルを変更するときはlbl属性を使います。 142 * <og:column name="CDC" /> カラムリソースからセレクトメニューも自動作成されます。 143 * <og:column name="CDC" addNoValue="false" /> NULL値を消すときはaddNoValue属性を使います。 144 * <og:column name="CDC" addNoValue="false" must="true" /> 属性は、複数組み合わせて使えます。 145 * <og:column name="PN" must="true" /> 色を変更するときはmust属性を使います。 146 * <og:column name="PN" td="false" /> 自動作成されるtdタグやラベルを外すときはtd属性を使います。 147 * <og:column name="PN" td="no" /> 自動作成されるtdタグを外し、ラベルとフィールドは残します。 148 * <og:column name="PN" writable="false" /> 非入力にするときはwritable属性を使います。 149 * <og:column name="PN" size="20" /> 強制的にSIZEの変更をするときはsize属性を使います。 150 * <og:column name="A" nextForm="B" /> 最大桁数入力後、フォーム B にフォーカスが移動します。 151 * <og:column name="B" /> 152 * 153 * BODY 部分に記述した値は、カラムフィールドの直後にセットされます。 154 * <og:column name="PN" > 155 * <button type="button" onclick="popup(・・・);return false;"> 156 * <og:message lbl="POPUP" comment="▼" /> 157 * </button> 158 * </og:column> 159 * 160 * eventColumnを利用すると、親カラムの変更に従って子カラムの内容を変える事が可能です。 161 * ・親子関係のプルダウンを作成する場合 162 * <og:column name="OYA" /> 163 * <og:column name="KO" eventColumn="OYA" param="SELECT ... WHERE COL = '{@OYA}'" /> 164 * 165 * ・親子関係の入力欄(親のデータで子をDBから検索)を作成する場合 166 * <og:column name="OYA" /> 167 * <og:column name="KO" eventColumn="OYA" param="SELECT A AS VALUE WHERE COL = {@OYA}" /> 168 * 169 * ・親子関係の要素をカスタム化されたJSPを利用して作成する場合 170 * 変更するカラムはJSPで記述されており、指定する事が可能です。 171 * <og:column name="OYA" /> 172 * <og:column name="KO" eventColumn="OYA" param="{@OYA}" eventURL="custom_makeColumn.jsp" /> 173 * 174 * @og.group 画面部品 175 * 176 * @version 4.0 177 * @author Kazuhiko Hasegawa 178 * @since JDK5.0, 179 */ 180public class ColumnTag extends HTMLTagSupport { 181 /** このプログラムのVERSION文字列を設定します。 {@value} */ 182 private static final String VERSION = "8.4.3.0 (2023/03/31)" ; 183 private static final long serialVersionUID = 843020230331L ; 184 185 // 6.4.3.4 (2016/03/11) String配列 から、Setに置き換えます。 186 private static final Set<String> TYPE_SET = new ArraySet<>( "text","search","tel","url","email","datetime","date","month","week","time","datetime-local","number","range","color" ); 187 private static final Set<String> TD_SET = new ArraySet<>( "yes" , "no" , "false" ); 188 189 // 8.4.3.0 (2023/03/31) システム定数 初期値を 使う:true / 使わない:false 190 private static final boolean USE_DEFVAL = HybsSystem.sysBool( "USE_DEFAULT_PROPERTIE_VALUE" ); 191 192 // 4.0.0 (2005/01/31) HTML_LABEL_SEPARATOR を boolean 変数として取得します。 193 private final String CLM = HybsSystem.sysBool( "HTML_LABEL_SEPARATOR" ) ? ":" : "" ; 194 195 /** yes:<td> タグを使用 / false:フィールドのみ / no:ラベルとフィールド */ 196 private String tdFlag = "yes"; 197 /** 値なしのOptionをSelectに含めるかどうか */ 198 private boolean addNoValue = true; 199 /** キー:ラベル形式で表示するかどうか */ 200 private String addKeyLabel ; // 6.0.4.0 (2014/11/28) 201 private String name ; 202 private String value ; 203 /** 書き込み/ラベルを指定する */ 204 private boolean writable = true; // true で書き込み 205 /** value がセットされていないときの初期値 */ 206 private String defaultVal = ""; 207 // 2.1.0.0 (2002/10/11) useDefaultPropertieVal 属性を追加。 208 // 5.2.3.0 (2010/12/01) useDefaultPropertieVal 属性の初期値をシステム定数で定義 209 // properties ファイルの初期値を 使う:true / 使わない:false 210// private boolean useDefVal = HybsSystem.sysBool( "USE_DEFAULT_PROPERTIE_VALUE" ); // 8.4.3.0 (2023/03/31) Delete 211 212 /** colspan 属性 */ 213 private String colspan = ""; // 3.0.0.0 (2002/12/25) 214 /** rowspan 属性 */ 215 private String rowspan = ""; // 6.2.0.0 (2015/02/27) 216 /** nextForm 属性 */ 217 private String nextForm ; // 3.5.4.2 (2003/12/15) 218 219 // 3.5.4.9 (2004/02/25) value が null の場合に、リクエスト情報を設定します。 220 private boolean useRequestValue = true; // 初期値:true 221 222 // 3.5.6.0 (2004/06/18) Attributes 経由でなく、直接 DBColumnConfig に設定します。 223 private String fieldSize ; // 6.2.0.0 (2015/02/27) 224 private String viewSize ; // 6.2.0.0 (2015/02/27) 225 private String maxlength ; 226 227 // 3.8.0.4 (2005/08/08) BODY 部分に記述した値は、カラムフィールドの直後にセットされます。 228 private String body ; 229 private String codeName ; // 3.8.0.6 (2005/09/12) 230 /** Codeリソースのサブセット */ 231 private String codeList ; // 5.1.9.0 (2010/08/01) 232 /** Codeリソースのサブセットとなるグループ */ 233 private String codeGroup ; // 5.1.9.0 (2010/08/01) 234 /** 新しいコードセレクトを作成する為の KEY:VAL 文字列 */ 235 private String codeKeyVal ; // 5.6.6.0 (2013/07/05) 236 /** BODYに記述した内容で、ラベルを作成します */ 237 private boolean useLblBody ; // 7.4.2.0 (2021/04/30) 238 239 // 4.0.0 (2007/05/30) カラム状態を動的に変更します。 240 private String renderer ; 241 private String editor ; 242 private String dbType ; 243 244 /** 親カラムの指定 */ 245 private String eventColumn ; // 4.3.6.0 (2009/04/01) 246 private String eventValue ; // 6.3.3.0 (2015/07/25) 247 /** eventColumnで飛ばすURL */ 248 private String eventURL ; // 4.3.6.0 (2009/04/01) 249 /** パラメータを変更可能にする */ 250 private String param ; // 4.3.6.0 (2009/04/01) 251 private String dbid ; // 5.7.6.2 (2014/05/16) 252 private String help ; // 6.3.2.0 (2015/07/10) 253 254 /** XSS対策 */ 255 private boolean xssCheck = HybsSystem.sysBool( "USE_XSS_CHECK" ); // 5.1.7.0 (2010/06/01) 256 257 private String useSLabel = "auto"; // 5.5.1.0 (2012/04/03) 258 /** 日付送り戻し機能の有効/無効 */ 259 private boolean useDateFeed = true; // 8.1.2.3 (2022/05/20) 260 /** 隠しフィールドの作成有無 */ 261 private boolean useHidden ; // 8.3.1.0 (2022/10/14) 262 263 /** 264 * デフォルトコンストラクター 265 * 266 * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor. 267 */ 268 public ColumnTag() { super(); } // これも、自動的に呼ばれるが、空のメソッドを作成すると警告されるので、明示的にしておきます。 269 270 /** 271 * Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。 272 * 273 * @og.rev 3.8.0.4 (2005/08/08) 新規追加(BODY部の評価) 274 * @og.rev 5.1.7.0 (2010/06/01) command=RENEWの場合はdefaultValを無視する。 275 * @og.rev 5.2.2.0 (2010/11/01) caseKey 、caseVal 属性対応 276 * @og.rev 6.3.3.0 (2015/07/25) eventValue 追加。 277 * @og.rev 6.3.4.0 (2015/08/01) eventValue のSQL処理は、jsp/common/eventColumnMaker.jsp で行う。 278 * @og.rev 6.4.8.1 (2016/07/02) xssCheckを、doStartTag に移動 279 * 280 * @return 後続処理の指示( EVAL_BODY_BUFFERED ) 281 */ 282 @Override 283 public int doStartTag() { 284 // 5.2.2.0 (2010/11/01) caseKey 、caseVal 属性対応 285 if( useTag() ) { 286 // 5.9.10.0 (2016/07/01) doAfterBodyから移動 287 useXssCheck( xssCheck ); 288 289 // makeTag() より移動 290 if( value == null && useRequestValue ) { // 3.5.4.9 (2004/02/25) 291 // 5.1.7.0 (2010/06/01) command=RENEWの場合はdefaultValを無視する。 292 final String cmd = pageContext.getRequest().getParameter( "command" ); 293 if( "RENEW".equals( cmd ) ) { 294 value = getRequestValue( name ); 295 } 296 else { 297 value = nval( getRequestValue( name ),defaultVal ); 298 } 299 } 300 301 return EVAL_BODY_BUFFERED ; // Body を評価する。( extends BodyTagSupport 時) 302 } 303 return SKIP_BODY ; // Body を評価しない 304 } 305 306 /** 307 * Taglibのタグ本体を処理する doAfterBody() を オーバーライドします。 308 * 309 * @og.rev 3.8.0.4 (2005/08/08) 新規追加(BODY部の評価) 310 * @og.rev 5.1.7.0 (2010/06/01) XSS解除対応 311 * @og.rev 6.4.8.1 (2016/07/02) xssCheckを、doStartTag に移動 312 * 313 * @return 後続処理の指示(SKIP_BODY) 314 */ 315 @Override 316 public int doAfterBody() { 317 318 body = getBodyString(); 319 return SKIP_BODY ; 320 } 321 322 /** 323 * タグリブオブジェクトをリリースします。 324 * キャッシュされて再利用されるので、フィールドの初期設定を行います。 325 * 326 * @og.rev 2.0.0.4 (2002/09/27) カスタムタグの release() メソッドを、追加 327 * @og.rev 2.0.0.8 (2002/10/09) yes/no/false で指定するように変更 328 * @og.rev 3.0.0.0 (2002/12/25) colspan 属性を追加。 329 * @og.rev 3.0.1.4 (2003/03/17) colspan 属性の制御方法を変更 330 * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。 331 * @og.rev 3.5.4.2 (2003/12/15) nextForm 属性を追加。 332 * @og.rev 3.5.4.9 (2004/02/25) useRequestValue 属性を追加。 333 * @og.rev 3.5.6.0 (2004/06/18) Attributes 経由でなく、直接 DBColumnConfig に設定します。 334 * @og.rev 3.8.0.4 (2005/08/08) body , useBody 属性を追加。 335 * @og.rev 3.8.0.6 (2005/09/12) codeName 属性を追加。 336 * @og.rev 4.1.2.1 (2008/03/13) must , mustAny 属性を自動化します。 337 * @og.rev 5.1.7.0 (2010/06/01) XSS解除対応 338 * @og.rev 5.1.9.0 (2010/08/01) codeList , codeGroup属性を追加。(Codeリソースのサブセットとなるグループ) 339 * @og.rev 5.2.1.0 (2010/10/01) must , mustAny 属性の処理を、HTMLTagSupport に移します 340 * @og.rev 5.2.3.0 (2010/12/01) useDefaultPropertieVal 属性の初期値をシステム定数で定義 341 * @og.rev 5.6.6.0 (2013/07/05) codeKeyVal 属性を追加 342 * @og.rev 5.7.6.2 (2014/05/16) dbid 属性を追加 343 * @og.rev 6.0.4.0 (2014/11/28) addKeyLabel 属性を追加 344 * @og.rev 6.2.0.0 (2015/02/27) rowspan 属性を追加 345 * @og.rev 6.2.0.0 (2015/02/27) viewSize 属性の追加 346 * @og.rev 6.3.2.0 (2015/07/10) help 属性の追加 347 * @og.rev 6.3.3.0 (2015/07/25) eventValue 追加 348 * @og.rev 7.4.2.0 (2021/04/30) useLblBodyをtrueにすると、BODYに記述した内容で、ラベルを作成します 349 * @og.rev 8.1.2.3 (2022/05/20) 日付送り戻し不具合対応(useDateFeed 属性追加) 350 * @og.rev 8.3.1.0 (2022/10/14) 隠しフィールドの作成対応(useHidden 属性追加) 351 * @og.rev 8.4.3.0 (2023/03/31) useDefaultPropertieVal 属性廃止 352 */ 353 @Override 354 protected void release2() { 355 super.release2(); 356 tdFlag = "yes"; // table形式の <td> タグを使用するかどうか 357 addNoValue = true; // 値なしのOptionをSelectに含めるかどうか 358 addKeyLabel = null; // 6.0.4.0 (2014/11/28) キー:ラベル形式で表示するかどうか 359 name = null; 360 value = null; 361 writable = true; // 書き込み/ラベルを指定する。(true で書き込み) 362 defaultVal = ""; // value がセットされていないときの初期値 363// useDefVal = HybsSystem.sysBool( "USE_DEFAULT_PROPERTIE_VALUE" ); // 5.2.3.0 (2010/12/01) 8.4.3.0 (2023/03/31) Delete 364 colspan = ""; 365 rowspan = ""; // 6.2.0.0 (2015/02/27) rowspan 属性を追加 366 nextForm = null; // 3.5.4.2 (2003/12/15) 367 useRequestValue = true; // 3.5.4.9 (2004/02/25) 368 fieldSize = null; // 6.2.0.0 (2015/02/27) 369 viewSize = null; // 6.2.0.0 (2015/02/27) 370 maxlength = null; // 3.5.6.0 (2004/06/18) 371 body = null; // 3.8.0.4 (2005/08/08) 372 codeName = null; // 3.8.0.6 (2005/09/12) 373 codeList = null; // 5.1.9.0 (2010/08/01) 新規追加(Codeリソースのサブセット) 374 codeGroup = null; // 5.1.9.0 (2010/08/01) 新規追加(Codeリソースのサブセットとなるグループ) 375 codeKeyVal = null; // 5.6.6.0 (2013/07/05) 新規追加(新しいコードセレクトを作成する為の KEY:VAL 文字列) 376 useLblBody = false; // 7.4.2.0 (2021/04/30) BODYに記述した内容で、ラベルを作成します 377 renderer = null; 378 editor = null; 379 dbType = null; 380 eventColumn = null; // 4.3.6.0 (2009/04/01) 381 eventValue = null; // 6.3.3.0 (2015/07/25) 382 eventURL = null; // 4.3.6.0 (2009/04/01) 383 param = null; // 4.3.6.0 (2009/04/01) 384 dbid = null; // 5.7.6.2 (2014/05/16) 385 help = null; // 6.3.2.0 (2015/07/10) 386 xssCheck = HybsSystem.sysBool( "USE_XSS_CHECK" ); // 5.1.7.0 (2010/06/01) XSS解除対応 387 useSLabel = "auto"; // 5.5.1.0 (2012/04/03) 388 useDateFeed = true; // 8.1.2.3 (2022/05/20) 389 useHidden = false; // 8.3.1.0 (2022/10/14) 390 } 391 392 /** 393 * 検索条件の入力用のテキストフィールドを作成します。 394 * 395 * テーブルタグによりフィールドは分割されます。 396 * 使用時は、テーブルタグを前後に使用して下さい。 397 * 398 * @og.rev 2.0.0.8 (2002/10/09) yes/no/false で指定するように変更 399 * @og.rev 2.0.1.0 (2002/10/10) ラベルとフィールドのセパレーターとして、コロン(:)を使用するかどうかを指定できる 400 * @og.rev 3.0.0.0 (2002/12/25) colspan 属性を追加。 401 * @og.rev 3.0.1.4 (2003/03/17) colspan 属性の制御方法を変更 402 * @og.rev 3.5.4.9 (2004/02/25) value が null の時の 値の設定方法 403 * @og.rev 3.8.0.4 (2005/08/08) body 属性を追加。 404 * @og.rev 3.8.7.0 (2006/12/15) カラムリソースで指定したカラムラベルを反映させる。 405 * @og.rev 4.0.0.0 (2005/11/30) カラムロールを考慮 406 * @og.rev 4.1.2.1 (2008/03/13) must , mustAny 属性を自動化します。 407 * @og.rev 4.3.7.1 (2009/06/08) id=labelのclass化 408 * @og.rev 5.2.1.0 (2010/10/01) must , mustAny 属性の処理を、HTMLTagSupport に移します。 409 * @og.rev 5.6.2.2 (2013/03/15) 自動must処理の出力位置を変更 410 * @og.rev 6.2.0.0 (2015/02/27) rowspan 属性を追加 411 * @og.rev 6.2.0.0 (2015/02/27) aimai 属性を追加。 412 * @og.rev 6.2.4.0 (2015/05/15) aimai 属性は、BODYのincludeより前に追加。 413 * @og.rev 6.3.2.0 (2015/07/10) help 属性の追加 414 * @og.rev 7.4.2.0 (2021/04/30) useLblBodyをtrueにすると、BODYに記述した内容で、ラベルを作成します 415 * @og.rev 8.3.1.0 (2022/10/14) 隠しフィールドの作成対応(useHidden 属性追加) 416 * @og.rev 8.4.3.0 (2023/03/31) defaultVal の設定値の取り扱い(変更あり) 417 * 418 * @return 入力用のテキストフィールドタグ 419 * @og.rtnNotNull 420 */ 421 @Override 422 protected String makeTag() { 423 // 3.8.7.0 (2006/12/15) カラムリソースで指定したカラムラベルを反映させる。 424 final DBColumn dbColumn = getDBColumn( name ); 425 String label = getLongLabel() ; 426 if( label == null ) { label = dbColumn.getLongLabel() ; } 427 428 final String tag = getInsertTag( dbColumn,value ); 429 430 // 4.0.0 (2005/11/30) カラムロールを考慮 431 // アクセス不可の場合は、ゼロ文字列を返す。 432 if( tag == null ) { return ""; } 433 434 // 3.8.0.4 (2005/08/08) BODY を使用する場合は、カラムフィールドの直後に挿入する。 435 // 6.2.4.0 (2015/05/15) aimai 属性は、BODYのincludeより前に追加。 436 if( body == null ) { body = ""; } 437 // 7.4.2.0 (2021/04/30) useLblBodyをtrueにすると、BODYに記述した内容で、ラベルを作成します 438 else if( useLblBody ) { label = body; body = ""; } 439 440 final StringBuilder rtn = new StringBuilder( BUFFER_MIDDLE ); 441 if( "yes".equals( tdFlag ) ) { 442 // 4.3.7.1 (2009/06/08) id=labelのclass化 443 // rtn.append( "<td id=\"label\">" ); 444 rtn.append( "<td class=\"label\"" ) // 6.2.0.0 (2015/02/27) 445 .append( rowspan ).append( '>' ) // 6.2.0.0 (2015/02/27) 446 .append( label ) 447 .append( CLM ) 448 .append( "</td><td" ) 449 .append( colspan ) 450 .append( rowspan ) // 6.2.0.0 (2015/02/27) 451 .append( '>' ) // 6.0.2.5 (2014/10/31) char を append する。 452 .append( tag ) 453 .append( makeHelpLink( help ) ) // 6.3.2.0 (2015/07/10) help 属性を追加 454 .append( makeAimaiPicker( name ) ) // 6.2.0.0 (2015/02/27) aimai 属性を追加 455 .append( makeMustHidden( name ) ) // 6.2.0.0 (2015/02/27) , 5.6.2.2 (2013/03/15) 456 .append( body ) // 6.2.4.0 (2015/05/15) 457 .append( "</td>" ); 458 } 459 else if( "no".equals( tdFlag ) ) { 460 // 4.3.7.1 (2009/06/08) id=labelのclass化 461 rtn.append( "<span class=\"label\">" ) 462 .append( label ) 463 .append( CLM ) 464 .append( "</span>" ) 465 .append( tag ) 466 .append( makeHelpLink( help ) ) // 6.3.2.0 (2015/07/10) help 属性を追加 467 .append( makeAimaiPicker( name ) ) // 6.2.0.0 (2015/02/27) aimai 属性を追加 468 .append( makeMustHidden( name ) ) // 6.2.0.0 (2015/02/27) , 5.6.2.2 (2013/03/15) 469 .append( body ); // 6.2.4.0 (2015/05/15) 470 } 471 // "false".equals( tdFlag ) の条件 472 else { 473 rtn.append( tag ) 474 .append( makeHelpLink( help ) ) // 6.3.2.0 (2015/07/10) help 属性を追加 475 .append( makeAimaiPicker( name ) ) // 6.2.0.0 (2015/02/27) aimai 属性を追加 476 .append( makeMustHidden( name ) ) // 6.2.0.0 (2015/02/27) , 5.6.2.2 (2013/03/15) 477 .append( body ); // 6.2.4.0 (2015/05/15) 478 } 479 480 // 8.3.1.0 (2022/10/14) 隠しフィールドの作成対応 481 if( useHidden ) { 482 final String disabled = get( "disabled" ); 483 if( !writable || "disabled".equalsIgnoreCase( disabled ) ) { 484 // 8.4.3.0 (2023/03/31) カラムリソースの初期値を使わない時に、"null"を設定すると、ゼロ文字列と置き換えます。(暫定対応) 485 if( "null".equalsIgnoreCase( value ) ) { value = ""; } 486 rtn.append( XHTMLTag.hidden( name,value ) ); 487 } 488 else { 489 final String errMsg = "useHidden は、writableが false 又は、disabledが disabled のときしか使えません。" + CR 490 + "\t name=[" + name + "] , writable=[" + writable + "] , disabled=[" + disabled + "]"; 491 throw new HybsSystemException( errMsg ); 492 } 493 } 494 495 return rtn.toString() ; 496 } 497 498 /** 499 * カラムがselectタグの場合に、値なしのオプション文字列を挿入します。 500 * 501 * addNoValue 値が True の場合のみ、挿入します。 502 * 503 * @og.rev 2.1.0.0 (2002/10/11) useDefaultPropertieVal 属性を追加。 504 * @og.rev 3.5.4.2 (2003/12/15) 入力カーソルを自動的に次のフィールドへ移動する機能を追加する。 505 * @og.rev 3.5.5.5 (2004/04/23) DBColumn の size と maxlength の 意味を変更 506 * @og.rev 3.5.5.7 (2004/05/10) DBColumn.getOption( String ) 廃止 507 * @og.rev 3.5.6.0 (2004/06/18) Attributes 経由でなく、直接 DBColumnConfig に設定します。 508 * @og.rev 3.8.0.6 (2005/09/12) codeName 属性を追加。 509 * @og.rev 3.8.7.0 (2006/12/15) カラムリソースで指定したカラムラベルを反映させる。 510 * @og.rev 4.0.0.0 (2005/01/31) getFieldSize メソッドを XHTMLTag から DBColumn へ移動 511 * @og.rev 4.0.0.0 (2005/11/30) カラムロールを考慮。アクセス不可の場合は、null を返す。 512 * @og.rev 4.3.0.0 (2008/07/04) ロールモードマルチ対応 513 * @og.rev 4.3.7.2 (2009/06/15) 不要なIDが出力されるバグを修正 514 * @og.rev 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し 515 * @og.rev 5.1.7.0 (2010/06/01) DBColumnの{@XXXX}変数対応 516 * @og.rev 5.1.9.0 (2010/08/01) codeList ,codeGroup 属性を追加(Codeリソースのサブセットとなるグループ) 517 * @og.rev 5.5.4.0 (2012/07/02) eventColumnの{@USER.XXXX}対応 518 * @og.rev 5.6.6.0 (2013/07/05) codeKeyVal 属性を追加 519 * @og.rev 5.7.6.2 (2014/05/16) dbid 属性を追加、IEのHTML5機能が無効の場合の処理 520 * @og.rev 5.7.6.2 (2014/05/16) IEのHTML5機能が無効の場合、list 属性は削除します。 521 * @og.rev 5.7.7.1 (2014/06/13) codeName 設定時に、renderer,editor が null の場合のみ、MENUに設定 522 * @og.rev 6.0.4.0 (2014/11/28) addKeyLabel 属性を追加 523 * @og.rev 6.2.0.0 (2015/02/27) viewSize 属性の追加 524 * @og.rev 6.2.3.0 (2015/05/01) maxlength 変数は、0 の場合は、無制限になります。 525 * @og.rev 6.3.1.0 (2015/06/28) 個人リソースのUSE_ADD_KEY_LABELで初期値設定 526 * @og.rev 6.3.3.0 (2015/07/25) eventValue 追加 527 * @og.rev 5.9.18.1 (2017/03/24) editorにDATALIST_Rの追加対応 528 * @og.rev 6.7.7.2 (2017/04/14) (注意点3)現時点では、INMENU,INDBMENUについては、イベントカラムが正常に動作しません。 529 * @og.rev 8.4.3.0 (2023/03/31) useDefaultPropertieVal 属性廃止 530 * @og.rev 8.4.3.0 (2023/03/31) defaultVal の設定値の取り扱い(変更あり) 531 * 532 * @param clm DBColumnカラムオブジェクト 533 * @param value 設定値 534 * 535 * @return 入力用のカラムタグ 536 */ 537 private String getInsertTag( final DBColumn clm, final String value ) { 538 539 // 4.3.0.0 (2008/07/04) ロールモードマルチ対応 540 final String roles = get( "roles" ); 541 // 6.4.1.1 (2016/01/16) PMD refactoring. Avoid if (x != y) ..; else ..; 542 final RoleMode roleMode = roles == null 543 ? clm.getRoleMode() : RoleMode.newInstance( roles ); 544 545 final byte byteMode = getUser().getAccessBitMode( roleMode ) ; 546 547 if( !RoleMode.isAccess( byteMode ) ) { return null; } // アクセス不可(rw不可) 548 549 // 書き込み権限のチェック 550 // writable = writable && RoleMode.isWrite( byteMode ); 551 552 // 3.5.4.2 (2003/12/15) 入力カーソルを自動的に次のフィールドへ移動する機能 553 if( nextForm != null ) { 554 // 6.2.3.0 (2015/05/01) maxlength 変数は使用しません。 555 final String onKeyup = "nextForm(this,'" + nextForm + "'," + clm.getTotalSize() + ");" ; 556 set( "onKeyup",onKeyup ); 557 } 558 559 // 3.5.6.0 (2004/06/18) 直接 DBColumnConfig に設定します。 560 if( fieldSize == null && maxlength != null ) { 561 // 4.0.0 (2005/01/31) getFieldSize メソッドを XHTMLTag から DBColumn へ移動 562 final int fsize = clm.getFieldSize( Integer.parseInt( maxlength ) ); 563 fieldSize = String.valueOf( fsize ); 564 } 565 566 final DBColumnConfig config = clm.getConfig(); 567 568 // 5.7.6.2 (2014/05/16) IEのHTML5機能が無効の場合の処理 569 final String ieHTML5 = (String)getSessionAttribute( HybsSystem.IE_HTML5_KEY ); 570 if( "FALSE".equalsIgnoreCase( ieHTML5 ) ) { 571 if( "DATALIST".equalsIgnoreCase( editor ) || 572 "DATALIST".equalsIgnoreCase( config.getEditor() ) ) { 573 editor = "INDBMENU"; 574 // 5.7.6.2 (2014/05/16) list 属性は削除します。 575 set( "list",null ); 576 } 577 // 5.9.18.1 (2017/03/24) IEのHTML5機能が無効の場合の処理(DATALIST_R用) 578 if( "DATALIST_R".equalsIgnoreCase( editor ) || 579 "DATALIST_R".equalsIgnoreCase( config.getEditor() )){ 580 editor = "INMENU"; 581 set( "list",null ); 582 } 583 } 584 585 if( maxlength != null ) { config.setMaxlength( maxlength ); } 586 if( fieldSize != null ) { config.setFieldSize( fieldSize ); } // 6.2.0.0 (2015/02/27) メソッド名変更 587 if( viewSize != null ) { config.setViewLength(viewSize ); } // 6.2.0.0 (2015/02/27) 新規追加 588 if( renderer != null ) { config.setRenderer( renderer ); } 589 if( editor != null ) { config.setEditor( editor ); } 590 if( dbType != null ) { config.setDbType( dbType ); } 591 if( eventColumn != null ) { config.setEventColumn( eventColumn ); } // 4.3.6.0 (2009/04/01) 592 if( eventValue != null ) { config.setEventValue( eventValue ); } // 6.3.3.0 (2015/07/25) 593 594 // 6.4.1.1 (2016/01/16) PMD refactoring. Avoid if (x != y) ..; else ..; 595 if( param == null ) { 596 if( clm.isNeedsParamParse() ){ 597 config.setRendererParam( getRequestParameter( config.getRendererParam() ) ); 598 config.setEditorParam( getRequestParameter( config.getEditorParam() ) ); 599 } 600 } 601 else { 602 config.setParameter( getRequestParameter( param ) ); // ここで{@XXXX}変換 603 config.setRawParameter( getReservedParameter(param ) ); // 5.5.4.0 (2012/07/02) 予約語対応 604 } 605 606 if( dbid != null ) { config.setDbid( dbid ); } // 5.7.6.2 (2014/05/16) 607 if( eventURL != null ) { config.setEventURL( eventURL ); } // 4.3.6.0 (2009/04/01) 608 if( useSLabel != null ) { config.setUseSLabel( useSLabel ); } // 5.5.1.0 (2012/04/03) 609 if( !useDateFeed ) { config.setUseDateFeed( useDateFeed ); } // 8.1.2.3 (2022/05/20) 610 611 // 6.3.1.0 (2015/06/28) 個人リソースのUSE_ADD_KEY_LABELで初期値設定 612 if( addKeyLabel == null ) { addKeyLabel = nval( sys( "USE_ADD_KEY_LABEL" ) , null ); } // 4:個人設定可 613 if( addKeyLabel != null ) { config.setAddKeyLabel( addKeyLabel ); } // 6.0.4.0 (2014/11/28) 614 615 // 4.0.0 (2005/01/31) 616 if( codeName != null ) { 617 final CodeData codeData = getResource().getCodeData( codeName ) ; 618 config.setCodeData( codeData ); 619 // 5.7.7.1 (2014/06/13) codeName 設定時に、renderer,editor が null の場合のみ、MENUに設定。 620 if( renderer == null ) { config.setRenderer( "MENU" ); } 621 if( editor == null ) { config.setEditor( "MENU" ); } 622 } 623 624 // 5.6.6.0 (2013/07/05) CodeData オブジェクトの取得を表に移動 625 // codeName で指定のリソースでも、サブセットが作成できます。 626 final CodeData codeData = config.getCodeData() ; 627 if( codeData != null ) { 628 // 5.1.9.0 (2010/08/01) codeList 属性を追加(Codeリソースのサブセット) 629 if( codeList != null ) { 630 config.setCodeData( codeData.subsetList( codeList ) ); 631 } 632 633 // 5.1.9.0 (2010/08/01) codeGroup 属性を追加(Codeリソースのサブセットとなるグループ) 634 if( codeGroup != null ) { 635 config.setCodeData( codeData.subsetGroup( codeGroup ) ); 636 } 637 638 // 5.1.9.0 (2010/08/01) RoleMode 制御を追加(Codeリソースのサブセット) 639 if( codeData.useRoleMode() ) { 640 config.setCodeData( codeData.subsetRole( getUser().getRoleMode() ) ); 641 } 642 } 643 644 // 5.6.6.0 (2013/07/05) codeKeyVal 新しいコードセレクトを作成する。 645 // 6.0.4.0 (2014/11/28) KVMENUエディター で構築する。 646 if( codeKeyVal != null ) { 647 config.setParameter( codeKeyVal ); 648 config.setRenderer( "KVMENU" ); 649 config.setEditor( "KVMENU" ); 650 } 651 652 final Attributes attri = getAttributes(); 653 config.setEditorAttributes( attri ); 654 final DBColumn column = new DBColumn( config ); 655 656 // 6.1.0.0 (2014/12/26) refactoring 657// final String val = useDefVal && ( value == null || value.isEmpty() ) ? column.getDefault() : value ; 658 // 8.4.3.0 (2023/03/31) カラムリソースの初期値を使わない時に、"null"を設定すると、ゼロ文字列と置き換えます。(暫定対応) 659 String val = USE_DEFVAL && ( value == null || value.isEmpty() ) ? column.getDefault() : value ; 660 if( "null".equalsIgnoreCase( val ) ) { val = ""; } 661 662 String rtn = null; 663 if( writable ) { 664 final String editTag = column.getEditorValue( val ); 665 final StringBuilder tag = new StringBuilder( BUFFER_MIDDLE ) 666 .append( editTag ); 667 if( addNoValue && editTag.startsWith( "<select" ) ) { 668 final int offset = editTag.indexOf( '>' ); 669 tag.insert( offset+1,"<option value=\"\" ></option>" ); 670 } 671 rtn = tag.toString(); 672 } 673 else { 674 if( attri == null || attri.size() == 0 ) { 675 rtn = column.getRendererValue( val ); 676 } 677 else { 678 attri.set( "body" , column.getRendererValue( val ) ); 679 rtn = XHTMLTag.span( attri ); 680 } 681 } 682 683 // 4.3.6.0 (2009/04/01) eventColumn対応 生SQL文のセッション保存 684 // 5.1.7.0 (2010/06/01) 動的プルダウン実装見直し 685 final String evCol = column.getEventColumn(); 686 if( evCol != null && evCol.length() > 0 ){ 687 // 6.7.7.2 (2017/04/14) (注意点3)現時点では、INMENU,INDBMENUについては、イベントカラムが正常に動作しません。 688 if( "INMENU".equals( config.getEditor() ) || "INDBMENU".equals( config.getEditor() ) ) { 689 final String errMsg = "(注意点3)現時点では、INMENU,INDBMENUについては、イベントカラムが正常に動作しません。" + CR 690 + "\t name=[" + name + "] , eventColumn=[" + evCol + "] , editor=[" + config.getEditor() + "]"; 691 throw new HybsSystemException( errMsg ); 692 } 693 addEventColumn( column ); 694 rtn = column.getEventColumnTag( rtn, val, writable ); 695 } 696 697 return rtn; 698 } 699 700 /** 701 * 【TAG】カラムの名前を返します。 702 * 703 * @og.tag 704 * <og:column name="PN" /> 705 * 706 * @og.rev 4.2.4.0 (2008/07/01) 707 * 708 * @return カラムの名前 709 */ 710 protected String getName() { 711 return name; 712 } 713 714 /** 715 * 【TAG】カラムの名前を指定します。 716 * 717 * @og.tag 718 * <og:column name="PN" /> 719 * 720 * @og.rev 3.8.0.9 (2005/10/17) RequestParameter変数({@XXXX})が使用できるように修正 721 * 722 * @param name 名前 723 */ 724 public void setName( final String name ) { 725 this.name = nval( getRequestParameter( name ),this.name ); 726 } 727 728 /** 729 * 【TAG】設定値を指定します。 730 * 731 * @og.tag 732 * <og:column name="PN" value="syokichi" /> 733 * 734 * @param val 設定値 735 */ 736 public void setValue( final String val ) { 737 value = nval( getRequestParameter( val ),value ); 738 } 739 740 /** 741 * 【TAG】value属性に値がセットされていないとき使用する、初期値を指定します。 742 * 743 * @og.tag 744 * value属性に値がセットされていないときに、この初期値を使用します。 745 * 746 * なお、commandがRENEWの場合は、このdefaultValは適用されません。 747 * これは、defaultValの値が埋め込まれた項目が存在する画面に戻った際に、 748 * defaultValの項目の値がnullとなっていた場合に、defaultValの値が復元されると、 749 * 検索結果との不一致が発生するためです。 750 * 751 * 8.4.3.0 (2023/03/31) defaultVal の設定値の取り扱い(変更あり) 752 * {@XXXX} は、リクエスト変数 ⇒ valueタグセット値 を確認 753 * 値がなければ、""(空文字列) となる。 754 * 通常の固定値は、そのまま使用される(""(空文字列)も有効 755 * defaultVal属性を使用しない場合は、""(空文字列) となる。 756 * 757 * システム定数 USE_DEFAULT_PROPERTIE_VALUE が true の場合は、カラムリソースの初期値が 758 * 使用されます。カラムリソースの初期値より、defaultVal が優先されます。 759 * カラムリソースの初期値を使わない時に、"null"を設定すると、ゼロ文字列と置き換えます。 760 * 761 * @param dv 初期値 762 */ 763 public void setDefaultVal( final String dv ) { 764 defaultVal = nval( getRequestParameter( dv ),defaultVal ); 765 } 766 767// /** 768// * 【廃止】カラムリソースの初期値を使うかどうか[true/false]を指定します(初期値:false)。 769// * 770// * @og.tag 771// * 初期値がセットされていないときに指定します。 772// * 使う場合はtrue、使わない場合は falseをセットします。 773// * この初期値を、システム定数の USE_DEFAULT_PROPERTIE_VALUE で設定可能とします。 774// * 775// * @og.rev 2.1.0.0 (2002/10/11) useDefaultPropertieVal 属性を追加。 776// * @og.rev 5.2.3.0 (2010/12/01) 初期値をシステム定数で定義(USE_DEFAULT_PROPERTIE_VALUE) 777// * @og.rev 8.4.3.0 (2023/03/31) useDefaultPropertieVal 属性廃止 778// * 779// * @param dv ファイルの初期値 [true:使う/false:使わない] 780// */ 781// public void setUseDefaultPropertieVal( final String dv ) { 782// useDefVal = nval( getRequestParameter( dv ),useDefVal ); 783// } 784 785 /** 786 * 【TAG】テーブル形式の <td> タグを使用するかどうか[yes/no/false]を指定します(初期値:yes)。 787 * 788 * @og.tag 789 * yes(初期値) とすると、ラベルとフィールドをテーブルのtdタグでそれぞれ記述します。 790 * no とすると、tdタグを使用せず、ラベルとフィールドを表示します。 791 * false は、ラベルを出さずに、フィールドのみを表示します。 792 * 793 * <td><og:column name="PN" td="no" /> </td> 794 * 795 * @og.rev 2.0.0.8 (2002/10/09) yes/no/false で指定するように変更 796 * @og.rev 2.1.2.3 (2002/12/02) errMsg の文字列の修正漏れを訂正 797 * @og.rev 6.3.4.0 (2015/08/01) Arrays.toString から String.join に置き換え。 798 * @og.rev 6.4.3.4 (2016/03/11) String配列 から、Setに置き換えます。 799 * 800 * @param flag TDタグ使用 [yes:タグを使用/no:ラベルとフィールド/false:フィールドのみ] 801 */ 802 public void setTd( final String flag ) { 803 final String td = nval( getRequestParameter( flag ),tdFlag ); 804 805 if( check( td , TD_SET ) ) { 806 tdFlag = td; 807 } 808 else { 809 final String errMsg = "Error in SelectTag [td]: " 810 + td + " in [" + String.join( ", " , TD_SET ) + "] only used."; 811 throw new HybsSystemException( errMsg ); 812 } 813 } 814 815 /** 816 * 【TAG】セレクトメニューの場合、値なしのOptionを含めるかどうか[true/false]を指定します(初期値:true)。 817 * 818 * @og.tag 819 * カラムがプルダウンメニュー形式の場合、選択肢には通常データベース登録できる候補が 820 * 並びます。しかし、検索時には、候補を絞りたくない(指定しない)場合があり、 821 * その様な場合には、値なしのOptionを含める(true)ことで、対応可能です。 822 * 初期値:true(値なしのOptionを含める)なので、検索画面に利用する場合は、そのまま使用できます。 823 * 824 * <og:column name="CDC" addNoValue="false" /> 825 * 826 * @param flag 値なしのOptionの有無 [true:含める/それ以外:含めない] 827 */ 828 public void setAddNoValue( final String flag ) { 829 addNoValue = nval( getRequestParameter( flag ),addNoValue ); 830 } 831 832 /** 833 * 【TAG】セレクトメニューの場合、キー:ラベル形式で表示するかどうか[true/false/null]を指定します(初期値:null)。 834 * 835 * @og.tag 836 * カラムがプルダウンメニュー形式の場合、キー:ラベル形式で表示するか、ラベルだけで表示するかを 837 * 選択できます。 838 * true を指定すると、「強制的に」キー:ラベル形式で表示します。 839 * false の場合は、「強制的に」ラベルのみで表示されます。 840 * 初期値の null の場合、コードリソースや、SQL文に準拠した指定通りの形式で表示します。 841 * 842 * <og:column name="CDC" addKeyLabel="true" /> 843 * 844 * @og.rev 6.0.4.0 (2014/11/28) キー:ラベル形式で表示するかどうか。新規追加 845 * 846 * @param flag キー:ラベル形式表示 [true:キー:ラベル形式/false:ラベルのみ/null:指定通り] 847 */ 848 public void setAddKeyLabel( final String flag ) { 849 addKeyLabel = nval( getRequestParameter( flag ),addKeyLabel ); 850 } 851 852 /** 853 * 【TAG】書き込みタイプかどうか[true/false]を指定します(初期値:true)。 854 * 855 * @og.tag 856 * 初期値は、書き込みタイプ("true") です。 857 * <og:column name="PN" writable="false" /> 858 * 859 * @param flag 書き込み許可 [true:許可/false:不可] 860 */ 861 public void setWritable( final String flag ) { 862 writable = nval( getRequestParameter( flag ),writable ); 863 } 864 865 /** 866 * 【HTML】最大入力文字数を指定します(入力可能文字数で、バイト数ではありません)。 867 * 868 * @og.tag 869 * 指定しない場合は、カラム定義に準拠します。 870 * また、値を 0 に設定した場合、無制限になります。 871 * <og:column name="PN" maxlength="20" /> 872 * 873 * @og.rev 3.5.4.2 (2003/12/15) 最大入力制限数に応じたサイズ自動生成を入れます。 874 * @og.rev 3.5.4.5 (2004/01/23) CSSで処理する場合のクラス属性は、maxlength が 5 以下の場合とする。 875 * @og.rev 3.5.6.0 (2004/06/18) Attributes 経由でなく、直接 DBColumnConfig に設定します。 876 * @og.rev 6.2.0.0 (2015/02/27) 小さなカラムのサイズ指定は、すでに廃止 ("S0" + 桁数(1~5)) 877 * @og.rev 6.2.3.0 (2015/05/01) maxlength 変数は、0 の場合は、無制限になります。 878 * 879 * @param maxlen 最大入力文字数 880 */ 881 public void setMaxlength( final String maxlen ) { 882 maxlength = nval( getRequestParameter( maxlen ),null ); 883 884 // 6.2.3.0 (2015/05/01) maxlength 変数は、0 の場合は、無制限になります。 885 if( "0".equals( maxlength ) ) { set( "NO_MAXLEN", "true" ); } 886 } 887 888 /** 889 * 【TAG】カラムの入力枠サイズ(横幅)を文字数でセットします(入力文字制限ではありません)。 890 * 891 * @og.tag 892 * <og:column name="PN" size="20" /> 893 * 894 * @og.rev 3.5.6.0 (2004/06/18) Attributes 経由でなく、直接 DBColumnConfig に設定します。 895 * 896 * @param size 入力枠サイズ(横幅) 897 */ 898 public void setSize( final String size ) { 899 fieldSize = nval( getRequestParameter( size ),null ); 900 } 901 902 /** 903 * 【TAG】カラムの表示サイズ(横幅)を文字数でセットします。 904 * 905 * @og.tag 906 * 入力枠ではなく、表示する時の文字数制限に使われます。 907 * maxLength は、DB上の桁数(バイト数)ですが、viewSize は、文字数です。 908 * SLABEL の簡易バイト数計算(全角2Byte)でもなく、文字数計算になります。 909 * 910 * @og.rev 6.2.0.0 (2015/02/27) viewSize 属性の追加 911 * 912 * @param len 表示サイズ(横幅) 913 */ 914 public void setViewSize( final String len ) { 915 viewSize = nval( getRequestParameter( len ),null ); 916 } 917 918 /** 919 * 【TAG】フィールド部分の colspan を指定します。 920 * 921 * @og.tag 922 * 通常は、ラベルとフィールドが、別のtdで囲われます。しかし、場合によっては、 923 * フィールド部の長いカラムがある場合、上下のカラムとの位置関係がおかしくなり、 924 * ラベルとフィールドが離れて表示されるケースがあります。 925 * この場合、長いフィールド部を持つカラムに、colspan 属性を指定すると、 926 * その分のカラムを割り当てることにより、上下のカラムとの位置関係を 927 * 調節することが可能になります。 928 * 通常は 3 を指定して、tdが、フィールド、ラベル、フィールドの 929 * 組み合わせ部分に、長いフィールドが適用されるように使用します。 930 * 931 * <og:column name="PN" colspan="3" /> 932 * 933 * @og.rev 3.0.0.0 (2002/12/25) colspan 属性を追加。 934 * @og.rev 3.0.1.4 (2003/03/17) colspan 属性の制御方法を変更 935 * 936 * @param sp フィールド部分のcolspan 937 */ 938 public void setColspan( final String sp ) { 939 colspan = nval( getRequestParameter( sp ),colspan ); 940 if( colspan.length() > 0 ) { 941 colspan = " colspan=\"" + colspan + "\" "; 942 } 943 } 944 945 /** 946 * 【TAG】ラベル、フィールド共に rowspan を指定します。 947 * 948 * @og.tag 949 * 通常は、ラベルとフィールドが、別のtdで囲われます。rowspan は、 950 * そのどちらの TDフィールドにも、設定します。 951 * 初期値は、rowspan を付けないです。 952 * 953 * <og:column name="PN" rowspan="3" /> 954 * 955 * @og.rev 6.2.0.0 (2015/02/27) rowspan 属性を追加 956 * 957 * @param sp ラベル、フィールド部分のrowspan 958 */ 959 public void setRowspan( final String sp ) { 960 rowspan = nval( getRequestParameter( sp ),rowspan ); 961 if( rowspan.length() > 0 ) { 962 rowspan = " rowspan=\"" + rowspan + "\" "; 963 } 964 } 965 966 /** 967 * 【TAG】入力カーソルを、指定されたname属性のフィールドへ自動的に移動させます。 968 * 969 * @og.tag 970 * JavaScript の onKeyup イベントを利用して、最大桁数まで入力すると、 971 * 次のフィールドに、自動的にカーソルが飛ぶように設定します。 972 * 引数は、次に飛ばすフィールドの name 属性です。 973 * 実行するには、JavaScript の nextForm 関数が必要です。(default.js で指定) 974 * 975 * @og.rev 3.5.4.2 (2003/12/15) 新規追加 976 * 977 * @param name 次にフォーカスを移すタグのname属性 978 */ 979 public void setNextForm( final String name ) { 980 nextForm = nval( getRequestParameter( name ),nextForm ); 981 } 982 983 /** 984 * 【TAG】value が null の場合に、name 属性から Request情報 を適用するかどうかを指定します(初期値:true)。 985 * 986 * @og.tag 987 * name 属性に一致するリクエスト情報がある場合、value が null の場合や、 988 * 引数を設定していない場合は、この設定値に応じて、リクエスト情報の値を 989 * 設定します(初期値:true なので、通常はこの動きです) 990 * ごくまれに、ENTRY 系の削除を行う場合、リクエスト情報が残り、削除されずに 991 * 再表示(DB的には削除済み)されるケースでは、使用しない(false)設定が可能です。 992 * 993 * useRequestValue | true(初期値) | false 994 * ------------------+------------------------+------------ 995 * value |A A A A _ _ _ _ |_ _ _ _ 996 * name(Request情報) |B B _ _ B B _ _ |B B _ _ 997 * defaultVal |C _ C _ C _ C _ |C _ C _ 998 * ==================+========================+============ 999 * 設定値 |A A A A B B C _ |C _ C _ 1000 * 1001 * @og.rev 3.5.4.9 (2004/02/25) 新規追加 1002 * 1003 * @param flag Request情報適用 [true:する/false:しない] 1004 */ 1005 public void setUseRequestValue( final String flag ) { 1006 useRequestValue = nval( getRequestParameter( flag ),useRequestValue ); 1007 } 1008 1009 /** 1010 * 【TAG】コードセレクトのユニークキー(コード名称)をセットします。 1011 * 1012 * @og.tag 1013 * このキーを元に、CodeData オブジェクトを構築します。 1014 * 1015 * @og.rev 3.8.0.6 (2005/09/12) 新規作成 1016 * 1017 * @param name メニューのユニークキー 1018 */ 1019 public void setCodeName( final String name ) { 1020 codeName = nval( getRequestParameter( name ),codeName ); 1021 } 1022 1023 /** 1024 * 【TAG】コードセレクトのサブセットとなるコード(キー)をCSV形式で指定します。 1025 * 1026 * @og.tag 1027 * この値に限定された、コードリソースを、既存の、CodeData の 1028 * サブセットとして作成します。 1029 * codeName で指定されたリソースでも、サブセットを作成する事ができます。 1030 * ここで指定するのは、コード(キー)だけです。 1031 * 1032 * @og.rev 5.1.9.0 (2010/08/01) 新規作成 1033 * 1034 * @param list コードセレクトのサブセットとなるコード(キー) 1035 */ 1036 public void setCodeList( final String list ) { 1037 codeList = nval( getRequestParameter( list ),codeList ); 1038 } 1039 1040 /** 1041 * 【TAG】コードセレクトのサブセットとなるグループを指定します。 1042 * 1043 * @og.tag 1044 * この値に限定された、コードリソースを、既存の、CodeData の 1045 * サブセットとして作成します。 1046 * codeName で指定されたリソースでも、サブセットを作成する事ができます。 1047 * グループとは、optiongroup の事ではなく、コードリソースに関連付けられた 1048 * グループを指定する事で、簡易的にサブセットを作成します。 1049 * 1050 * @og.rev 5.1.9.0 (2010/08/01) 新規作成 1051 * 1052 * @param group コードセレクトのサブセットとなるグループ 1053 */ 1054 public void setCodeGroup( final String group ) { 1055 codeGroup = nval( getRequestParameter( group ),codeGroup ); 1056 } 1057 1058 /** 1059 * 【TAG】新しいコードセレクトを作成する為の「キー:ラベル キー:ラベル」の文字列を指定します。 1060 * 1061 * @og.tag 1062 * 既存の、CodeData には存在しない、新しいコードリソースを作成する為の、文字列を指定します。 1063 * 文字列は、「キー:ラベル キー:ラベル」形式で、スペースで分解後、":" でキーとラベルに分離します。 1064 * スペース分解後の文字列に、":" が含まれていない場合は、キーをラベルとして扱います。 1065 * また、ラベル部分は、ラベルリソースを使用して、変換を行います。 1066 * 内部的には、CodeData を作成しません。DBColumnオブジェクト内で、直接、Selection_KEYVAL を生成します。 1067 * codeName 、codeList、codeGroup などが指定された場合は、そちらが優先されます。 1068 * 「キー:ラベル キー:ラベル」で、ラベル にスペースを含ませる場合は、ダブルクォーテーションで囲ってください。 1069 * 「"キー:ラベル" "キー:ラベル"」という感じです。 1070 * 1071 * ※ 6.0.4.0 (2014/11/28) editor,renderer を、"KVMENU" にして、param に、「キー:ラベル キー:ラベル」 1072 * の文字列を指定してください。近い将来、この属性は、廃止します。 1073 * ※ 6.2.6.0 (2015/06/19) 廃止を取りやめます。上記、KVMENU設定と、param でもできますが、それの 1074 * 簡易版として、残します。(若干の仕様強化を図ります) 1075 * 1076 * @og.rev 5.6.6.0 (2013/07/05) 新規作成 1077 * @og.rev 6.0.4.0 (2014/11/28) editor,renderer を、"KVMENU" にして、param を使用してください。 1078 * @og.rev 6.2.6.0 (2015/06/19) 廃止の取りやめ。なんとなく便利なので残します。 1079 * 1080 * @param keyval KEY:VAL文字列 1081 */ 1082 public void setCodeKeyVal( final String keyval ) { 1083 codeKeyVal = nval( getRequestParameter( keyval ),codeKeyVal ); 1084 } 1085 1086 /** 1087 * 【TAG】BODYに記述した内容で、ラベルを作成します。 1088 * 1089 * @og.tag 1090 * 通常のラベルの代わりに、BODY部に記述した内容を、ラベルとして使用します。 1091 * BODY が 未指定の場合は、useLblBody="true" でも、元のラベルを使います。 1092 * 1093 * @og.rev 7.4.2.0 (2021/04/30) useLblBodyをtrueにすると、BODYに記述した内容で、ラベルを作成します 1094 * 1095 * @param flag KEY:VAL文字列 1096 */ 1097 public void setUseLblBody( final String flag ) { 1098 useLblBody = nval( getRequestParameter( flag ),useLblBody ); 1099 } 1100 1101 /** 1102 * 【TAG】カラムの表示用レンデラー({@og.doc03Link renderer Renderer_****})をセットします。 1103 * 1104 * @og.tag 1105 * これは、plugin.column 以下の Renderer_**** クラスの **** を 1106 * 与えます。これらは、CellRenderer インターフェースを継承したサブクラスです。 1107 * 属性クラス定義の {@link org.opengion.hayabusa.db.CellRenderer Renderer} を参照願います。 1108 * {@og.doc03Link renderer Renderer_**** クラス} 1109 * 1110 * @param rdr 表示用レンデラー (Renderer_**** の ****) 1111 * @see org.opengion.hayabusa.db.CellRenderer 1112 */ 1113 public void setRenderer ( final String rdr ) { 1114 renderer = nval( getRequestParameter( rdr ),renderer ); 1115 } 1116 1117 /** 1118 * 【TAG】カラムの編集用エディター({@og.doc03Link editor Editor_****})をセットします。 1119 * 1120 * @og.tag 1121 * これは、plugin.column 以下の Editor_**** クラスの **** を 1122 * 与えます。これらは、CellEditor インターフェースを継承したサブクラスです。 1123 * 属性クラス定義の {@link org.opengion.hayabusa.db.CellEditor Editor} を参照願います。 1124 * {@og.doc03Link editor Editor_**** クラス} 1125 * 1126 * @param ed 編集用エディター (Editor_**** の ****) 1127 * @see org.opengion.hayabusa.db.CellEditor 1128 */ 1129 public void setEditor ( final String ed ) { 1130 editor = nval( getRequestParameter( ed ),editor ); 1131 } 1132 1133 /** 1134 * 【TAG】DBタイプ({@og.doc03Link dbType DBType_****})をセットします。 1135 * 1136 * @og.tag 1137 * これは、org.opengion.hayabusa.db.column 以下の DBType_**** クラスの **** を 1138 * 与えます。これらは、DBType インターフェースを継承したサブクラスです。 1139 * 属性クラス定義の {@link org.opengion.hayabusa.db.DBType DBType} を参照願います。 1140 * {@og.doc03Link dbType DBType_**** クラス} 1141 * 1142 * @param dt パラメータ 1143 * @see org.opengion.hayabusa.db.DBType DBType_**** の **** 1144 */ 1145 public void setDbType( final String dt ) { 1146 dbType = nval( getRequestParameter( dt ),dbType ); 1147 } 1148 1149 /** 1150 * 【TAG】イベントカラム(親カラム)を設定します。 1151 * 1152 * @og.tag 1153 * 親子関係を持った項目の動的な入れ替えを行う場合に利用します。 1154 * このカラムを変化させるトリガとなるカラムの名前をセットします。 1155 * 1156 * この属性がセットされた場合、親カラムが変更都度子カラム(自身のカラム)が 1157 * 再表示されます。 1158 * 標準で再表示時に受け継がれる属性は以下の通りです。 1159 * (1)editor・renderer 1160 * (2)writable 1161 * (3)addNoValue 1162 * (4)class(must・mustAnyや、DBTypeを含みます) 1163 * (5)style(optionAttributes等でセットしたもの) 1164 * (6)size 1165 * (7)maxlength 1166 * これら以外に特殊な設定を行ったカラムに関しては、eventURL属性でカスタムの 1167 * 置き換え用JSPを作成し、個別に対応して下さい。 1168 * 1169 * また、置き換えの定義は、param属性で定義します。 1170 * param属性に定義されたSQL文の結果により、各種エディター、レンデラーによって、以下の 1171 * ように置き換えが行われます。 1172 * 1173 * (1)DBMENUの場合 1174 * paramに指定されたSQL文により動的にプルダウンを置き変えます。 1175 * SQL文の{@XXXX}の記述により、その時点での親カラムの値を参照することができます。 1176 * 1177 * 例) SELECT A.CODE,B.LNAME FROM GEA04 A,GEA08 B 1178 * WHERE A.CLM||'.'||A.CODE = B.CLM 1179 * AND A.SYSTEM_ID = B.SYSTEM_ID 1180 * AND A.CLM like 'KBSAKU%' 1181 * AND B.LANG like '{@LANG}' ← name=LANGを持つ項目のその時点での値に変換される 1182 * AND B.SYSTEM_ID = '**' 1183 * 1184 * (2)DBMENU以外の場合 1185 * paramに指定されたSQL文により値(value値)を置き換えたカラムを作成し、置き換えます。 1186 * DBMENUの場合と同様、SQL文の{@XXXX}の記述により、その時点での親カラムの値を参照することができます。 1187 * 1188 * 例) SELECT LABEL_NAME FROM GF41 1189 * WHERE SYSTEM_ID='{@SYS.SYSTEM_ID}' AND CLM='{@CLM}' AND LANG='{@LANG}' 1190 * 1191 * なお、いずれの場合も、{@XXXX}の部分については、$1,$2...$9の形式でも記述することができます。 1192 * この場合、$1は1番目のeventColumnのカラム、$2は2番目のeventColumnのカラムと指します。 1193 * 1194 * (注意点1)イベントカラムによるイベントは、画面表示時に1度実行されます。 1195 * 但し、eventColumn属性で、カラム名の先頭に'_'をつけた場合、 1196 * または親カラムの値がNULLの場合は実行されません。 1197 * 1198 * (注意点2)SQL文などのパラメーター中に記述された{@XXXX}の値の変換はJavaScriptにより行われるため、 1199 * 値が取得できる項目は、"画面に書き込み可能状態で表示されているカラム"に限ります。 1200 * テーブルモデル内の変数や表示のみの値については、ここでは利用することはできません。 1201 * {@USER.XXXX}等の予約語に関しては、5.5.4.0以降では処理されます。 1202 * 1203 * (注意点3)現時点では、INMENU,INDBMENUについては、入れ替え後のJavaScriptが正常に動作しないため、 1204 * イベントカラムが正常に動作しません。 1205 * 1206 * (注意点4) 6.8.2.4 (2017/11/20) イベントカラムの、変数($1,$2...$9)は、先頭から9つまでしか使えません。 1207 * 10個目以降の変数は無視されますので、必要であれば、9個までの位置に、カラムを記述してください。 1208 * 1209 * (注意点5) 7.3.0.0 (2021/01/06) イベントカラムを定義すると、子カラムの onChange イベントが発火されます。 1210 * これは、(注意点1)のカラム名の先頭に'_'をつけた場合でも同様です。 1211 * 子カラムにonChangeを記述する場合は、ご注意ください。 1212 * 1213 * @og.rev 4.3.6.0 (2009/04/01) 1214 * @og.rev 5.1.7.0 (2010/06/01) コメント大幅修正 1215 * @param col 親カラム 1216 */ 1217 public void setEventColumn( final String col ) { 1218 eventColumn = nval( getRequestParameter( col ), eventColumn ); 1219 } 1220 1221 /** 1222 * 【TAG】eventColumn使用時の値を、SQL文から求めるためのqueryをセットします。 1223 * 1224 * @og.tag 1225 * eventColumn利用時は{@XXXX}はリクエストパラメータではなく 1226 * xxxカラムの実際の値が利用されます。 1227 * 1228 * @og.rev 6.3.3.0 (2015/07/25) eventValue 追加 1229 * @param val パラメータ 1230 */ 1231 public void setEventValue( final String val ) { 1232 eventValue = nval( getReservedParameter( val ), eventValue ); // ここでは{@XXXX}変換をしない 1233 } 1234 1235 /** 1236 * 【TAG】イベントカラム指定時に呼び出すURLを指定します。 1237 * 1238 * @og.tag 1239 * 初期値はシステム定数のEVENT_COLUMN_URLです。 1240 * イベントカラム指定時に部品を作成するJSPを指定します。 1241 * (設定例:eventURL="makeColumn_custom.jsp") 1242 * 1243 * 置き換え対象のカラムに特殊な設定がされており、標準のカラム置き換えでは対応できない場合に、 1244 * このURLを指定することで、個別に置き換え方法を定義する必要があります。 1245 * 1246 * なお、個別に置き換え方法を定義したJSPを作成する場合は、標準(jsp/common/eventColumnMaker.jsp)を 1247 * 参考にして作成して下さい。 1248 * 1249 * eventColumnから利用するJSPで利用可能なリクエスト変数 1250 * {@EC_CNAME} 子カラム名(一覧表示の場合でも行番号__nは付加されません) 1251 * {@EC_RENDERER} 子カラムのレンデラー 1252 * {@EC_EDITOR} 子カラムのエディター 1253 * {@EC_SQL} 子カラムのプルダウン、または値を出力するためのSQL文({@XXXX}をカラムのvalue値で置き換えたもの) 1254 * {@EC_VALSQL} 子カラムの値を出力するためのSQL文({@XXXX}をカラムのvalue値で置き換えたもの) 1255 * {@EC_WRITABLE} 子カラムが編集可能などうか 1256 * {@EC_CVALUE} 子カラムの現在の値 1257 * {@EC_NOVALUE} 子カラムの最上部Option値が空ならtrue。その他false(addNoValue属性値と同じです) 1258 * {@EC_CLASS} 子カラムのCLASS属性 1259 * {@EC_SIZE} 子カラムのSIZE属性 1260 * {@EC_MAXLENGTH} 子カラムのMAXLENGTH属性 1261 * {@EC_OPTATTRS} 子カラムのその他OPTION属性 1262 * {@EC_PNAMEE} 親カラム名(一覧表示の場合でも行番号__nは付加されません) 1263 * {@EC_PVALUE} 親カラムの現在の値 1264 * 1265 * @og.rev 4.3.6.0 (2009/04/01) 1266 * @og.rev 5.1.7.0 (2010/06/01) コメント大幅修正 1267 * @param url イベントURL 1268 */ 1269 public void setEventURL( final String url ) { 1270 eventURL = nval( getRequestParameter( url ), eventURL ); 1271 } 1272 1273 /** 1274 * 【TAG】パラメータをセットします。 1275 * 1276 * @og.tag 1277 * EditorParam等のパラメータを一括でセットします。 1278 * eventColumn利用時は{@XXXX}はリクエストパラメータではなく 1279 * xxxカラムの実際の値が利用されます。 1280 * 1281 * @og.rev 4.3.6.0 (2009/04/01) 1282 * @param prm パラメータ 1283 */ 1284 public void setParam( final String prm ) { 1285 param = nval( prm, param ); // ここでは{@XXXX}変換をしない 1286 } 1287 1288 /** 1289 * 【TAG】データベースへ接続する場合のID(初期値:null)。 1290 * 1291 * @og.tag 1292 * データベース接続を使用するエディター、レンデラーを使用する場合に使用する接続先IDを指定します。 1293 * カラムオブジェクトは、query処理ではなく、view処理時に適用されるため、データベース 1294 * 接続先を指定する必要があります。 1295 * 初期値は、null(DEFAULT 接続) です。 1296 * 1297 * @og.rev 5.7.6.2 (2014/05/16) 新規追加 1298 * 1299 * @param id 接続先ID 1300 */ 1301 public void setDbid( final String id ) { 1302 dbid = nval( getRequestParameter( id ),dbid ); 1303 } 1304 1305 /** 1306 * 【TAG】リクエスト情報の HTMLTag開始/終了文字(><) 存在チェックを実施するかどうか[true/false]を設定します 1307 * (初期値:USE_XSS_CHECK[={@og.value SystemData#USE_XSS_CHECK}])。 1308 * 1309 * @og.tag 1310 * クロスサイトスクリプティング(XSS)対策の一環としてless/greater than signについてのチェックを行います。 1311 * (><) が含まれていたエラーにする(true)/かノーチェックか(false)を指定します。 1312 * (初期値:システム定数のUSE_XSS_CHECK[={@og.value SystemData#USE_XSS_CHECK}])。 1313 * 1314 * @og.rev 5.1.7.0 (2010/06/01) 新規追加 1315 * 1316 * @param flag XSSチェック [true:する/false:しない] 1317 * @see org.opengion.hayabusa.common.SystemData#USE_XSS_CHECK 1318 */ 1319 public void setXssCheck( final String flag ) { 1320 xssCheck = nval( getRequestParameter( flag ),xssCheck ); 1321 } 1322 1323 /** 1324 * 【TAG】MENU,DBMENUでSLABELを利用するかどうか[auto/true/false]を指定します(初期値:auto)。 1325 * 1326 * @og.tag 1327 * 通常はセレクトメニューは一覧とそれ以外で短縮ラベルの利用が自動で切り替わります。 1328 * 強制的にSLABELを利用させたい場合にこの属性をtrueにセットして下さい。 1329 * 標準はauto(自動)です。 1330 * auto/true/false以外を指定した場合はfalse扱いとします。 1331 * 1332 * @og.rev 5.5.1.0 (2012/04/03) 1333 * 1334 * @param prm SLABEL利用 [auto:自動/true:利用する/false:利用しない] 1335 */ 1336 public void setUseSLabel( final String prm ) { 1337 useSLabel = nval( getRequestParameter( prm ),useSLabel ); 1338 } 1339 1340 /** 1341 * 【TAG】eventColumn実行後のcallbak関数を指定します。 1342 * 1343 * @og.tag 1344 * eventColumnの動作終了後に実行するCallback関数の指定を行います。 1345 * 関数名のみを指定して下さい。 1346 * ex) sampleCallback()を実行する場合はeventCallback="sampleCallback" 1347 * 実行する関数の第一引数には自動的に次の要素が入った配列が渡されます 1348 * [0] 変更された子カラムのID属性値 1349 * [1] evnetColumn実行後の子カラムの値 1350 * [2] eventColumn実行前の子カラムの値 1351 * 1352 * この属性は、optionAttributesへの設定と同様の動作を行います。 1353 * 1354 * @og.rev 5.5.4.0 (2012/07/02) 新規追加 1355 * @og.rev 6.9.8.0 (2018/05/28) パラメータ引数が、未設定の場合の考慮不足 1356 * 1357 * @param callback callbak関数 1358 */ 1359 public void setEventCallback( final String callback ) { 1360 // optionAttributes扱いで登録します。 1361 final String clbk = getRequestParameter( callback ); 1362 if( StringUtil.isNotNull( clbk ) ){ 1363 add( "optionAttributes", "eventCallback='" + clbk + "'" ); 1364 } 1365 1366// // optionAttributes扱いで登録します。 1367// if( callback != null && callback.length() > 0 ){ 1368// add( "optionAttributes", "eventCallback='"+getRequestParameter( callback )+"'" ); 1369// } 1370 } 1371 1372 /** 1373 * 【HTML5】表示形式を指定します(初期値:text)。 1374 * 1375 * @og.tag 1376 * ColumnTagは、カラムリソースで作成される為、タイプは固定です。 1377 * しかし、HTML5 で追加された形式には、有用なタイプも存在する為、 1378 * それらへの書き換えをできるようにします。 1379 * よって、ここでは、従来型のタイプへの書き換えはできません。 1380 * (textだけは例外で戻せるようにします)。 1381 * 1382 * [search/tel/url/email/datetime/date/month/week/time/datetime-local/number/range/color] 1383 * が、設定できます。 1384 * 1385 * HTML5 の機能を有効にするには、ネイティブモードで動作させる必要があります。 1386// * ① USE_IE7_HEADER = "false" に設定する。 6.9.5.0 (2018/04/23) 廃止(false固定) 1387// * ② USE_HTML5_HEADER = "true" に設定する。 6.9.5.0 (2018/04/23) 廃止(true固定) 1388 * ③ IEのツール⇒互換表示設定で、互換表示に追加したWebサイトから削除する。 1389 * ④ 同上の設定で、イントラサイトを互換表示で表示するのチェックを外す。 1390 * 必要があります。 1391 * 1392 * <og:input type="text" /> テキストボックスを表示 1393 * 1394 * HTML5 で追加されたタイプ 1395 * <og:input type="search" /> 検索テキストの入力欄を作成する 1396 * <og:input type="tel" /> 電話番号の入力欄を作成する 1397 * <og:input type="url" /> URLの入力欄を作成する 1398 * <og:input type="email" /> メールアドレスの入力欄を作成する 1399 * <og:input type="datetime" /> UTC(協定世界時)による日時の入力欄を作成する 1400 * <og:input type="date" /> 日付の入力欄を作成する 1401 * <og:input type="month" /> 月の入力欄を作成する 1402 * <og:input type="week" /> 週の入力欄を作成する 1403 * <og:input type="time" /> 時間の入力欄を作成する 1404 * <og:input type="datetime-local" /> UTC(協定世界時)によらないローカル日時の入力欄を作成する 1405 * <og:input type="number" /> 数値の入力欄を作成する 1406 * <og:input type="range" /> レンジの入力欄を作成する 1407 * <og:input type="color" /> 色の入力欄を作成する 1408 * 1409 * @og.rev 5.7.1.0 (2013/12/06) HTML5 対応(新規追加) 1410 * @og.rev 6.3.4.0 (2015/08/01) Arrays.toString から String.join に置き換え。 1411 * @og.rev 6.4.3.4 (2016/03/11) String配列 から、Setに置き換えます。 1412 * 1413 * @param type HTML5用 [text/search/tel/url/email/datetime/date/month/week/time/datetime-local/number/range/color] 1414 */ 1415 public void setType( final String type ) { 1416 final String tp = getRequestParameter( type ); 1417 1418 if( check( tp , TYPE_SET ) ) { 1419 set( "type",tp ); 1420 } 1421 else { 1422 final String errMsg = "type 属性は、下記の中から選択してください。type=[" 1423 + tp + "] in [" + String.join( ", " , TYPE_SET ) + "]"; 1424 throw new HybsSystemException( errMsg ); 1425 } 1426 } 1427 1428 /** 1429 * 【TAG】このカラムに対するヘルプファイルを指定します(初期値:null)。 1430 * 1431 * @og.tag 1432 * 引数の url は、通常 そのカラムに関する詳細な説明を行っているファイルになります。 1433 * 簡易的な説明なら、カラムリソースの概要説明に入れれば、自動的に 1434 * title属性に入り、マウスオーバーでチルト表示されますが、それより少し 1435 * 複雑な説明を、html ファイルや、PDFファイルで行う事を想定しています。 1436 * デフォルトアイコンは、DEFAULT_CLMHELP_ICON です。 1437 * "http" や "/" , "../" などで始まる場合は、そのままのURLを使用します。 1438 * (初期値:DEFAULT_CLMHELP_ICON[={@og.value SystemData#DEFAULT_CLMHELP_ICON}])。 1439 * 1440 * @og.rev 6.3.2.0 (2015/07/10) help 属性の追加 1441 * 1442 * @param url helpファイルのURL(通常は、helpフォルダ以下のファイル名) 1443 */ 1444 public void setHelp( final String url ) { 1445 help = nval( getRequestParameter( url ),help ); 1446 } 1447 1448 /** 1449 * 【TAG】リアルタイムチェックを行うかどうかを指定します(初期値:true)。 1450 * 1451 * @og.tag 1452 * カラム単位でリアルタイムチェックを行うかどうかを設定をします。 1453 * タグに独自属性としてrealTimeCheck="true/false"を追記します。 1454 * falseを設定した場合にチェックが行われなくなります。 1455 * 初期値はリアルタイムチェックを行う(true)です。 1456 * 1457 * この属性は、optionAttributesへの設定と同様の動作を行います。 1458 * 引数の文字列の、true/false 判定を行っていません。そのままの文字列が設定されます。 1459 * JavaScript 側では、false 判定のみ行っているので、不正な文字列の場合は、 1460 * 初期値(true:リアルタイムチェックを行う)が適用されます。 1461 * これは、Ver5 とロジックを合わせておくための処置です。 1462 * 1463 * @og.rev 5.9.32.2 (2018/05/18) 新規追加 1464 * @og.rev 6.9.8.0 (2018/05/28) Ver5 とロジックを合わせます。 1465 * 1466 * @param flag リアルタイムチェックを行うかどうか [true:行う/false:行わない] 1467 */ 1468 public void setUseRealTimeCheck( final String flag ) { 1469 // optionAttributes扱いで登録します。 1470 final String rtcf = getRequestParameter( flag ); 1471 1472 if( StringUtil.isNotNull( rtcf ) ){ 1473 add( "optionAttributes", "realTimeChk=\"" + rtcf + "\"" ); // 連結時のスペースは、Attributes クラスで処理 1474 } 1475 1476// // optionAttributes扱いで登録します。 1477// final boolean useRtc = nval( getRequestParameter( flag ) , true ); 1478// 1479// if( !useRtc ) { // true 以外の場合のみ、optionAttributes に属性を追加します。 1480// add( "optionAttributes", "realTimeChk=\"false\"" ); // 連結時のスペースは、Attributes クラスで処理 1481// } 1482 } 1483 1484 /** 1485 * 【TAG】日付送り戻し機能を有効にするかどうか[true:有効/false:無効]指定します(初期値:true)。 1486 * 1487 * @og.tag 1488 * 編集種別が年月(YM)、年月日(YMD)、年月日(YMD2)のとき、日付送り戻し機能の 1489 * 有効(true)/無効(false)を指定します。 1490 * イベントカラム(親カラム)を設定し、param属性に定義したSQL文を実行させたい場合には、 1491 * false を指定します。 1492 * 1493 * @og.rev 8.1.2.3 (2022/05/20) 日付送り戻し不具合対応(useDateFeed 属性追加) 1494 * 1495 * @param flag 日付送り戻し機能有無 [true:有効/false:無効] 1496 */ 1497 public void setUseDateFeed( final String flag ) { 1498 useDateFeed = nval( getRequestParameter( flag ),useDateFeed ); 1499 } 1500 1501 /** 1502 * 【TAG】隠しフィールドを作成するかどうか[true/false]指定します (初期値:false)。 1503 * 1504 * @og.tag 1505 * 書き込み不可(writable="false" 又は、disabled)のとき、リクエスト変数を使用したい場合に 1506 * true を指定します。 1507 * 初期値は、false です。 1508 * 1509 * @og.rev 8.3.1.0 (2022/10/14) 隠しフィールドの作成対応(useHidden 属性追加) 1510 * 1511 * @param flag 隠しフィールドを作成 [true:する/false:しない] 1512 */ 1513 public void setUseHidden( final String flag ) { 1514 useHidden = nval( getRequestParameter( flag ),useHidden ); 1515 } 1516 1517 /** 1518 * ヘルプファイル へのリンクを生成します。 1519 * 1520 * @og.rev 6.3.2.0 (2015/07/10) help 属性の追加。 1521 * @og.rev 6.4.2.0 (2016/01/29) alt属性にtitle属性を追記。 1522 * @og.rev 7.0.1.0 (2018/10/15) XHTML → HTML5 対応(空要素の、"/>" 止めを、">" に変更します)。 1523 * @og.rev 7.3.2.3 (2021/04/09) システム定数のICON_DIRを使用します。 1524 * 1525 * @param url helpファイルのURL(通常は、helpフォルダ以下のファイル名) 1526 * 1527 * @return helpファイルのための aタグ 1528 * @see #setHelp( String ) 1529 * @og.rtnNotNull 1530 */ 1531 private String makeHelpLink( final String url ) { 1532 if( url != null ) { 1533 // 7.3.2.3 (2021/04/09) システム定数のICON_DIRを使用します。 1534// final String JSP = HybsSystem.sys( "JSP" ); 1535 final String icon = HybsSystem.sys( "JSP_ICON" ) + "/" + HybsSystem.sys( "DEFAULT_CLMHELP_ICON" ); 1536 1537// final String img = "<img src=\"" + JSP + icon + "\" alt=\"Help\" title=\"Help\" />"; // 6.4.2.0 (2016/01/29) 1538 final String img = "<img src=\"" + icon + "\" alt=\"Help\" title=\"Help\" >"; // 7.3.2.3 (2021/04/09) 1539 1540 return XHTMLTag.link( 1541 new Attributes() 1542 .set( "href" , makeUrl( url ) ) 1543 .set( "body" , img ) 1544 .set( "target" , "_blank" ) 1545 .set( "class" , "clmHelplink" ) 1546 ); 1547 } 1548 return "" ; 1549 } 1550 1551 /** 1552 * このオブジェクトの文字列表現を返します。 1553 * 基本的にデバッグ目的に使用します。 1554 * 1555 * @return このクラスの文字列表現 1556 * @og.rtnNotNull 1557 */ 1558 @Override 1559 public String toString() { 1560 return ToString.title( this.getClass().getName() ) 1561 .println( "VERSION" ,VERSION ) 1562 .println( "tdFlag" ,tdFlag ) 1563 .println( "addNoValue" ,addNoValue ) 1564 .println( "name" ,name ) 1565 .println( "value" ,value ) 1566 .println( "writable" ,writable ) 1567 .println( "defaultVal" ,defaultVal ) 1568// .println( "useDefVal" ,useDefVal ) // 8.4.3.0 (2023/03/31) Delete 1569 .println( "colspan" ,colspan ) 1570 .println( "rowspan" ,rowspan ) 1571 .println( "nextForm" ,nextForm ) 1572 .println( "useRequestValue" ,useRequestValue) 1573 .println( "viewSize" ,viewSize ) 1574 .println( "fieldSize" ,fieldSize ) // 6.2.0.0 (2015/02/27) 1575 .println( "maxlength" ,maxlength ) 1576 .println( "codeName" ,codeName ) 1577 .println( "param" ,param ) // 8.2.1.0 (2022/07/15) 1578 .println( "body" ,StringUtil.htmlFilter( body ) ) 1579 .println( "Other..." ,getAttributes().getAttribute() ) 1580 .fixForm().toString() ; 1581 } 1582}