1. 必须遵循的命名规则编辑
1)不能以数字、$ 符号开头。
2)变量名只能是字母 (a-z A-Z)、数字 (0-9)、下划线(_)、(@) 或中文的组合,并且之间不能包含空格。
3)变量名中不能含有 ? * . - +/等字符和空格。
4)变量名建议不要使用编程语言的保留字,比如 true、false 等保留字。
5)变量名建议不要使用系统参数名称,否则会因为优先级调用系统参数,而非用户定义的参数,另外还可能存在引发系统参数紊乱的风险。系统参数内容可查看:系统参数
2. 经典命名规则编辑
1)匈牙利命名法
该命名法是在每个变量名的前面加上若干表示数据类型的字符。基本原则是:变量名=属性+类型+对象描述。如i表示 int,所有i开头的变量命都表示 int 类型。s 表示 String,所有变量名以s开头的都表示 String 类型变量。
2)骆驼命名法
正如它的名称所表示的那样,是指混合使用大小写字母来构成变量和函数的名字。驼峰命名法跟帕斯卡命名法相似,只是首字母为小写,如 userName。因为看上去像驼峰,因此而得名。
3)帕斯卡命名法,即 pascal 命名法
做法是首字母大写,如 UserName。
3. 同名参数优先级编辑
FineReport 有多种类型的参数,分别有不同的使用场景,详情可查看 :参数的种类与区别
用户在命名时,不同类型的参数不要使用同一名称。当模板中有重名参数时,将会按优先级顺序加载调用。参数加载的优先级顺序如下:
url参数>平台挂载参数>参数面板控件>模板参数>全局参数>表单 body 控件默认值
注:11.0.2 之前版本数据集参数也参与计算,优先级顺序为:url 中参数>平台挂载参数>参数面板控件>模板参数>全局参数>数据集参数>表单 body 中控件
比如使用第一张报表,给参数面板上地区控件赋默认值「华东」,如下图所示:
再将其挂载到决策报表平台上,挂载时给地区参数赋默认值「华北」,如下图所示:
最终平台上预览时,将根据参数优先级,优先加载挂载参数,所以预览时地区参数最终的默认值为「华北」,如下图所示:
4. 注意事项编辑
1)参数值的引用格式为参数前面加 $ 符号,如$adce。