一、            参数命名规则

       参数可以字母、数字、“-”,“_”组成,如EWA.ID, USER_NAME, C123A_B等,不能出现空格回车符等。

       参数是不区分大小写的。@id@ID@Id对系统来说是一个参数。

二、            参数特殊规则

1、           _SPLIT”后缀

用于分割参数。如:ID_SPLIT,表示获取ID_SPLIT参数,然后根据“,”分割为数组,用于执行SQL语句的参数分割,如DELETE FROM USERS WHERE ID IN (@ID_SPLIT),如果参数ID_SPLIT=1,3,12,则系统会自动合成为DELETE FROM USERS WHERE ID IN (‘1’, 3 ,12)语句执行。

2、           _OUT”后缀

ACTIONSQL执行中用于获取存储过程输出值。返回值为字符串或数字,不支持对象,如Oraclecursor

三、            参数优先级

EWA参数获取四种参数(按照优先级别,低级优先):

1、  系统参数,包括SYS_DATESYS_UNIDEWA.ID等,如果用户指定是无效的。

2、  Session参数

3、  Cookie参数

4、  Form参数(通过POST模式提交)

5、  Query参数(通过URL传递的参数)

参数是按照优先级别进行获取的,如果参数在FormQuery中同时出现,则获取Form,抛弃Query,避免出错的方式用不同的名称替换。

这种问题通常发生在列表下打开修改页面,同时在修改页面修改了主键,在更新过程中出现错误。

四、            参数调用

在配置文件中调用基本方式是:@参数名称,例如@ID, @USER_NAME, @ID_SPLIT等。可在配置文件中的ACTION,脚本,页面,css等方面运用。

如果指定参数为空值,在页面,脚本或css中则显示参数,在配置项中则为空字符,在ACTION中则为空值。

五、            用于页面传递的系统参数

参数

说明

备注

XMLNAME

配置文件

例如“|ewa|ewa_main.xml“|”表示目录分割符

ITEMNAME

配置项

 

EWA_LANG

指定语言

语言列表 zhcn(简体中文)enus(英语)

使用方式:

参数调用为最高优先级,默认为zhcn,如果参数指定,则保留在session中,下次从session中获取。

EWA_ACTION

指定要调用的ACTION

用于AJAX调用的功能,如删除记录,修改记录等,在配置文件中定义

EWA_NO_CONTENT

不显示内容

仅用于执行,不打印内容

EWA_P_BEHAVIOR

提交后执行的脚本

用于AJAX调用后再执行的脚本

EWA_AJAX

是否是AJAX调用

如果EWA_AJAX=XML,则输出XML字符串

EWA_POST

是否是POST提交

 

EWA_FRAMESET_NO

不显示frame框架

在配置项中定义了HtmlFrame后,首先显示框架,然后显示当前配置项。

EWA_FRAMESET_NO=1起作用

EWA_TREE_MORE

Tree加载分层数据

EWA_TREE_MORE=1起作用

EWA_TREE_STATUS

获取Tree当前状态

EWA_TREE_STATUS=1起作用

 

六、            系统内部参数,外部可调用

参数

说明

备注

SYS_CONTEXTPATH

当前web工程的地址

例如:/EmpScriptV2/

EWA.CP

当前web工程的地址

SYS_CONTEXTPATH

SYS_REMOTEIP

客户IP地址

 

SYS_REMOTE_URL

URL地址

 

SYS_REMOTE_REFERER

参考地址(referer

 

SYS_DATE

当前系统时间

 

SYS_UNID

当前GUNID

 

EWA.ID

当前GUNID

SYS_UNID

SYS_FRAME_UNID

当前配置项的编号

通过XMLNAMEITEMNAME组合的hashcode

EWA.GROUP.PATH

组件物理地址

EwaConfig.properties中定义,group_path

EWA.SCRIPT.PATH

配置文件物理地址

EwaConfig.properties中定义,script_path

EWA.CONFIG.PATH

系统配置物理地址

EwaConfig.properties中定义,config_path