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