1. 概述
在表单开发过程中，我们定义了一些实用的函数，在需要实现一些特定的功能时，我们可以使用这些函数。这些函数 我们定义在 FormFunctions.js。
2. 函数说明
2.1 CALC_DATE 日期计算
这个函数的作用是，给定义一个时间，可以在这个时间的基础上，增加(减去) 时间数，比如在当前的时间上，增加两个小时，两天
函数定义为:
CALC_DATE=function(date,time,unit,mode,formatStr)
| 参数 | 说明 |
|---|---|
| date | 日期字符串，2013-02-08 或者 2013-02-08 09:30 ，2013-02-08 09:30:22 |
| time | 时间数，比如 1,2 |
| unit | 单位 ‘Y(years)’、Q(quarters)’、’M(months)’、’w(weeks)’、’d(days)、’h(hours)’、’m(minutes)’、’s(seconds)’ |
| mode | + ，- 是加还是减 |
| formatStr | 格式化字符串，默认值为 YYYY-MM-DD HH:mm:ss，具体的格式可以 参考monent.js |
2.2 DATEDIF 计算日期差
计算两个时间差。比如 计算两个时间相差几个小时。
DATEDIF=function(date1,date2,unit,fixed,amend)
参数定义:
| 参数 | 说明 |
|---|---|
| date1 | 必填 时间字符串1 |
| date2 | 必填 时间字符串2 |
| unit | 必填 单位 单位的值 years、months、weeks、days、hours、minutes 和 seconds |
| fixed | 可空 精度，规定小数的位数 为 0-20 |
| amend | 可空 修正值 ，在计算的时间基础上 ，增加这个修正值 |
2.3 GETVALUE
这个函数用于取 json 的value 值
参数为字符串 ，参数格式 为 {value:””,text:””} ，这个函数就获取 这个value 的值。
2.4 NUM_ROUND
四舍五入函数
NUM_ROUND=function(numberRound,roundDigit)
参数
| 参数 | 说明 |
|---|---|
| numberRound | 需要四舍五入的数，这个是个数字 |
| roundDigit | 小数位数 |
2.5 异步调用脚本
这个函数的作用是异步调用“调用脚本”
invokeScript=function(alias, params, callback)
参数：
| 参数 | 说明 |
|---|---|
| alias | 脚本别名 |
| params | 脚本参数，参数这个是一个 JSON 格式数据 |
| callback | 回调函数 写法为 function(data){},data 是调用脚本返回的数据 |
2.6 同步调用脚本
invokeScriptPromise=function(alias,params)
这个函数的作用是同步步调用“调用脚本”
写法为：
var rtn=await this.invokeScriptPromise(alias,params);
参数：
| 参数 | 说明 |
|---|---|
| alias | 脚本别名 |
| params | 脚本参数，参数这个是一个 JSON 格式数据 |
2.7 异步调用自定义查询
这个用于异步调用自定义查询
invokeCustomQuery=function(alias,params,callback)
| 参数 | 说明 |
|---|---|
| alias | 自定义查询别名 |
| params | 参数，参数这个是一个 JSON 格式数据 |
| callback | 回调函数 写法为 function(data){},data 是调用脚本返回的数据 |
2.8 同步调用自定义查询
这个用于同步调用自定义查询。
var rtn=await this.invokeCustomQueryPromise=function(alias,params)
| 参数 | 说明 |
|---|---|
| alias | 脚本别名 |
| params | 脚本参数，参数这个是一个 JSON 格式数据 |
2.9 ajax函数调用
在表单中，有时我需要直接调用URL请求，进行数据访问。
2.9.1 get 方法
方法定义如下
function(url,params)
| 参数 | 说明 |
|---|---|
| url | 需要调用的URL |
| params | 可以留空， 参数使用 json 格式 {name:’ray’} |
2.9.2 postForm 方法
方法定义如下
function(url,params)
| 参数 | 说明 |
|---|---|
| url | 需要调用的URL |
| params | 可以传 JSON 对象 {name:”RAY”} 也可已传 传键值对 name=ray |
2.9.3 postJson 方法
方法定义如下
function(url,params)
| 参数 | 说明 |
|---|---|
| url | 需要调用的URL |
| params | 传递 JSON 对象 {name:”RAY”} |
2.10 防抖动函数使用
在输入时，有些情况下，我们需要根据输入，调用函数。
this.delay(function(){
},500);http://doc.redxun.cn/docs/jpaas/customWatch
2.11 使用Util.js
在表单中通过代码 this.getUtil() 获取。
this.getUtil().closeWindow(this,"ok");