自定义合法性检查函数

功能用途说明：

在填报表的设计过程中，如需对用户所填数据进行合法性校验，润乾根据不同情况分为三种类型：

1.? 直接设置润乾报表设计器内置的数据校验类型属性，目前它支持对字符串、整数型、数值型、日期型、数字串、Email地址等六种通用的合法性校验。

2. 在填报属性的数据校验里写校验公式，如校验A2单元格中必须为”yyyy-MM-dd”格式的日期类型，那么校验公式可以这样写：A2.match(/^\d{4}-\d{2}-\d{2}$/)，校验公式必须是按合法的javascript语法写。

3.? ? 自定义合法性校验函数。

自定义合法性校验函数，实质上就是自定义javascript函数，并在自定义的javascript函数中封装校验数据的业务逻辑，然后在润乾填报属性的校验公式里直接调用自定义的函数名。

在润乾中使用自定义合法性校验函数基本流程如下：

第一步：在发布需要自定义合法性校验函数的填报表的JSP里直接定义并实现javascript函数，也可以写js文件，然后在JSP文件里引用这个js文件。如下定义一个简单的自定义函数：

<script language="javascript">function check(String cellName){alert( cellName );return true;}</script>

第二步：在填报属性的校验公式里写check(${B3}.toString())，既对B3单元格，及由B3扩展出来的单元格进行数据校验

第三步：在web服务器上发布这个报表。

实用代码举例：

用自定义函数对邮政编码格式的输入校验，首先将5.1.jsp里的报表名称改为5.2.2.raq，再添加定义校验的javascript函数，函数实现如下：

<script language="javascript">function zip( zipString ){return /^[1-9]\d{5}$/.test( zipString )}</script>

保存为5.2.2.jsp。

定义好javascript函数，第二步需要在报表的“填报属性”里设置“校验”，如下图所示，在F8单元格合法性校验编辑框中调用该js函数，并编辑校验出错提示信息：