报表表单调用接口- 与应用程序的结合-交互增强
目录

报表表单调用接口

报表表单调用接口封装在/mis2/vrsr/js/gez_form.js文件中。

弹出层打开报表表单gezDialogForm

所有的html标签都支持在弹出层中打开报表表单页面,调用方式为$(html标签).gezDialogForm(settings)。

settings参数格式:
{
 "secInfo":"安全机制信息",//安全机制信息串,必传参数
 "resID":"32366",//报表资源ID
 "raq":"/mis2/vrsr/gezForm/gezFormDemo.raq",//报表文件路径。raq和resID选择其一进行
 "toolbarLocation":"no", //表单报表的工具栏位置,可选值有top,bottom,no。默认值为no。
 "autoHideEditor":"false",//表单编辑风格控件是否隐藏,可选值有true,false。默认值为false。
 "buttons":["submit", "ok", "cancel"],//弹出层展现时,底层工具条显示按钮。不配置则不显示按钮。submit提交按钮,ok确定按钮,cancel取消按钮
 "onsubmit":function(data){
  //提交按钮回调函数,即报表提交后的回调函数
 },
 "onok":function(data){
  //确定按钮回调函数
 },
 "oncancel":function(data){
  //取消按钮回调函数
 }
}

 

IFRAME或DIV标签打开报表表单gezForm

该方法只支持div或iframe标签的调用,调用方式为$("div/iframe").gezForm(settings)。其中iframe标签必须配置name属性。

settings参数格式:
{
    "secInfo": "安全机制信息", //安全机制信息串,必传参数
    "resID":"32366",//报表资源ID
    "raq":"/mis2/vrsr/gezForm/gezFormDemo.raq",//报表文件路径。raq和resID选择其一进行
    "toolbarLocation":"no", //表单报表的工具栏位置,可选值有top,bottom,no。默认值为no。
    "autoHideEditor":"false",//表单编辑风格控件是否隐藏,可选值有true,false。默认值为false。
}

表单数据提交gezSubmit

该方法只适用于使用gezForm打开表单报表的div或iframe标签,调用方式为$("div/iframe").gezSubmit(callback)。其中callback为匿名函数,在表单数据提交完成后进行回调。

$("div/iframe").gezSubmit(function(){
    //数据提交完成后回调。可在该匿名函数中配置提交完成后的一系列操作。
})

获取格式化表单数据gezGetFormData

该方法只适用于使用gezForm打开表单报表的div或iframe标签,调用方式为$("div/iframe").gezGetFormData(format),返回同格式的数据。其中format为json格式的字符串或对象,可为多层嵌套的json格式数据。

format参数格式:
{
    "userName": "@name", //其中@后内容表单控件的name属性
    "sex": "@sex", //返回的数据会以name='sex'表单控件的真实值进行替换@sex
    "info": {
        "birthday": "@birthday",
        "introduction": "个人简述"
    }
}

获取某一表单控件的真实值gezGetFieldValue

该方法只适用于使用gezForm打开表单报表的div或iframe标签,调用方式为$("div/frame").gezGetFieldValue(fieldName)。其中fieldName为表单控件的name属性值。

设置表单数据gezSetFormData

该方法只适用于使用gezForm打开表单报表的div或iframe标签,调用方式为$("div/frame").gezSetFormData(data)。其中data为一层的json格式数据。配置格式为表单name属性:表单真实值。

{"userName":"test","birthday":"1990-01-01"}
以上数据设置结果为:name="userName"的表单控件真实值为test;name="birthday"的表单控件真实值为1990-01-01。在配置真实值的过程中,该方法也会自动修改显示值。

设置某一个表单控件的真实值gezSetFieldValue

该方法只适用于使用gezForm打开表单报表的div或iframe标签,调用方式为$("div/iframe").gezSetFieldValue(fieldName, fieldValue)。其中fieldName为表单中某个控件的name属性,fieldValue为该控件的真实值。