反馈已提交

网络繁忙

填报预览专有

  • 文档创建者:RosieY
  • 编辑次数:7次
  • 最近更新:RosieY 于 2022-05-17
  • 版本

    版本功能变动
    11.0

    和 10.0 区别:

    无变动,10.0 也支持

    getWidgetByName

    方法getWidgetByName(name)通过控件名称获取填报单元格中的控件
         参数name: string

    控件名称,字符串

    注:单元格中控件,默认无名称,可以在「控件名称」处为其添加。

       返回值object 

    控件对象,需要结合控件的属性/方法使用,当单元格扩展时,返回找到的控件数组中的第一个控件

         示例

    示例1:若获取到的报表对象定义为 report,获取单元格中的下拉框控件 comboBox0

    report.getWidgetByName("comboBox0");

    示例2:普通报表中,获取单元格中的下拉框控件 comboBox0 

    _g().getWidgetByName("comboBox0");
      应用示例

    填报时,成绩只允许输入一次,成绩控件输入值后将其设置为不可用:

    点击可下载模板:控件输入值后设置为不可用.cpt

    2021-09-07_10-46-26.gif

        移动端支持移动端

    getWidgetByCell

    方法getWidgetByCell(cell)通过单元格地址获取填报单元格中的控件
         参数cell:string单元格地址、字符串
       返回值object 控件对象,需要结合控件的属性/方法使用,当单元格扩展时,只返回一个控件,cell 对应的是扩展后单元格的编号
         示例

    示例1:若获取到的报表对象定义为 report ,获取报表 A1 单元格中的下拉框控件

    report.getWidgetByCell("A1");

    示例2:填报报表中,获取 A1 单元格中的下拉框控件

    _g().getWidgetByCell("A1");
      应用示例

    填报时,成绩只允许输入一次,获取 B4 单元格中的控件输入值后将其设置为不可用:

    点击可下载模板:控件输入值后设置为不可用(单元格地址方式获取).cpt

    2021-09-07_10-46-26.gif

       移动端支持移动端

    getWidgetsByName

    方法getWidgetsByName(name)

    通过控件名称获取填报单元格具有同一名字的控件

         参数name: string

    控件名称,字符串

    注:单元格中控件,默认无名称,可以在「控件名称」处为其添加。

       返回值[object ]

    控件对象数组,需要结合控件的属性/方法使用;当单元格扩展时,返回的是控件对象数组

         示例

    示例1:若获取到的报表定义为 report,获取单元格中名称为 comboBox0 的所有下拉框控件

    report.getWidgetsByName("comboBox0");

    示例2:普通报表中,获取单元格中名称为 comboBox0 的所有下拉框控件

    _g().getWidgetsByName("comboBox0");
      应用示例

    填报时,点击按钮,获取单选按钮组控件扩展的所有值:

    详细实现方法可参考:JS获取扩展控件的所有值

        移动端支持移动端

    appendReportRC

    方法appendReportRC(num,cell)在特定的位置插入行,指定的单元格需要设置扩展属性
         参数

    num:number

    cell:string

    num:插入的行数,数字

    cell:插入位置的单元格编号,如果无此参数,则插入位置为鼠标焦点所在行

       返回值void
         示例

    示例1:若获取到的报表对象定义为 report ,在报表 A1 单元格行后插入 3 行

    report.appendReportRC(3,"A1");

    示例2:填报报表中,在报表 A1 单元格行后插入 3 行

    _g().appendReportRC(3,"A1");
      应用示例

    填报时,点击按钮,插入自定义行数:

    点击可下载模板:在特定的位置插入行.cpt

    2021-09-09_11-40-46.gif


       移动端不支持移动端

    appendReportRow

    方法_g().appendReportRow(cell,sheetindex,num)

    插入行,需要配合「插入行按钮」实现

    注:使用 num 参数时,尽量将插入行按钮的行数调整为 0,负责会相互影响,出现混乱

         参数

    cell:string

    sheetindex:number

    num:number

    cell:「插入行按钮」所在单元格的编号,字符串

    sheetindex:sheet 编号,数字,从 0 开始

    num:插入的行数,数字

       返回值void
         示例

    示例1:若获取到的报表对象定义为 report ,插入行按钮在“sheet1”的“F1”单元格,插入 3 行

    report.appendReportRow("F1", 0,3);

    示例2:填报报表中,插入行按钮在“sheet1”的“F1”单元格,插入 3 行

    _g().appendReportRow("F1", 0,3);

    示例3:通过 this.options.location, this.options.reportIndex 获取插入行按钮、sheet 编号后,插入 3 行

    report.appendReportRow(this.options.location,this.options.reportIndex,3);

    示例4:填报报表中,通过 this.options.location, this.options.reportIndex 获取插入行按钮、sheet 编号后,插入 3 行

    _g().appendReportRow(this.options.location,this.options.reportIndex,3);
      应用示例

    填报时,点击按钮,插入自定义行数:

    详细实现方法可参考:JS实现插入自定义行数

    2021-09-09_11-40-46.gif


       移动端支持移动端

    deleteReportRC

    方法deleteReportRC(cell)删除行
         参数

    cell:string

    cell:删除位置的单元格编号。如果无此参数,则删除位置为鼠标焦点所在行

       返回值void
         示例

    示例1:若获取到的报表对象定义为 report ,删除 A1 单元格所在的行

    report.deleteReportRC("A1");

    示例2:填报报表中,删除 A1 单元格所在的行

    _g().deleteReportRC("A1");

    示例3:填报报表中,删除鼠标所在单元格位置的行

    _g().deleteReportRC();
      应用示例

    填报时,点击按钮,删除鼠标所在的单元格行:

    详细实现方法可参考:JS自定义插入和删除行按钮

    1606203534578928.gif

       移动端不支持移动端

    deleteRows

    方法deleteRows([cell])删除行
         参数

    cell:string

    cell:删除位置的单元格编号数组

       返回值void
         示例

    示例1:若获取到的报表对象定义为 report ,删除 A1、A2 单元格所在的行

    report.deleteRows(['A1','A2']);

    示例2:填报报表中,删除 A1 、A2 单元格所在的行

    _g().deleteRows(['A1','A2']);
      应用示例

    填报报表中,实现根据选项选批量删除:

    详细实现方法可参考:JS实现复选按钮控件全选和批量操作

    1619335206449834.gif

       移动端不支持移动端

    refreshAllSheets

    方法refreshAllSheets()重新查询,刷新所有 sheet,刷新后会停留在上次查看的 sheet
         参数

    -

    -

       返回值void
         示例

    示例1:若获取到的报表对象定义为 report ,刷新所有的 sheet

    report.refreshAllSheets();

    示例2:填报报表中,刷新所有的 sheet

    _g().refreshAllSheets();
      应用示例

    点击按钮刷新所有 sheet ,刷新后依旧停留在当前所在的 sheet3:

    点击可下载模板:刷新后停留在当前的sheet.cpt

    2021-09-09_16-53-00.gif

       移动端支持移动端

    loadSheetByIndex

    方法loadSheetByIndex(index)切换到指定 sheet,参数为 sheet 序号
         参数

    index:number

    index:sheet 序号( 从 0 开始 )

       返回值void
         示例

    示例1:若获取到的报表对象定义为 report ,切换到第 2 个 sheet

    report.loadSheetByIndex(1);

    示例2:填报报表中,切换到第 2 个 sheet

    _g().loadSheetByIndex(1);
      应用示例

    如果报表中有多个 sheet 页,预览时,默认展示第 2 个 sheet 页:

    点击可下载模板:默认展示特定sheet.cpt

    2021-09-09_19-13-55.gif

       移动端不支持移动端

    loadSheetByName

    方法loadSheetByName(name)切换到指定 sheet,参数为 sheet 名称
         参数

    name:string

    name:sheet 名称

       返回值void
         示例

    示例1:若获取到的报表对象定义为 report ,切换到名称为“商品”的 sheet

    report.loadSheetByName("商品");

    示例2:填报报表中,切换到名称为“商品”的 sheet

    _g().loadSheetByName("商品");
      应用示例

    如果报表中有多个 sheet 页,预览时,默认展示名称为“sheet2”的 sheet 页:

    点击可下载模板:默认展示特定sheet.cpt

    2021-09-09_19-13-55.gif

       移动端不支持移动端

    writeReport

    方法writeReport(sheetindex)强制提交,不校验
         参数

    sheetindex:number

    提交第几个 sheet,数字,从 0 开始,参数为空代表提交所有 sheet

       返回值void
         示例

    示例1:若获取到的报表对象定义为 report ,提交第 2 个 sheet

    report.writeReport(1);

    示例2:填报报表中,提交第 2 个 sheet

    _g().writeReport(1);
      应用示例

    自定义一个「提交」按钮,实现点击按钮时提交填报内容:

    点击可下载模板:强制提交不校验.cpt

    2021-09-09_19-57-04.gif

       移动端支持移动端

    verifyAndWriteReport

    方法verifyAndWriteReport(isallsheet)校验并提交报表
         参数

    isallsheet:boolean

    isallsheet:是否提交所有的 sheet

    • true:提交所有

    • false:提交当前 sheet

       返回值void
         示例

    示例1:若获取到的报表对象定义为 report ,提交所有 sheet

    report.verifyAndWriteReport(true);

    示例2:填报报表中,判断是否开启自动暂存

    _g().verifyAndWriteReport(true);
      应用示例

    自定义一个「提交」按钮,实现点击按钮时校验提交填报内容

    点击可下载模板:校验提交.cpt

    2021-09-09_19-57-04.gif

       移动端支持移动端

    verifyReport

    方法verifyReport()数据校验
         参数-

    -

       返回值void
         示例

    示例1:若获取到的报表对象定义为 report ,提交校验

    report.verifyReport();

    示例2:填报报表中,提交校验

    _g().verifyReport();
      应用示例

    自定义一个「校验」按钮,实现点击按钮时提交校验:

    点击可下载模板:自定义校验按钮.cpt

    2021-09-09_20-18-53.gif

       移动端支持移动端

    importExcel

    方法importExcel(importStyle)导入 Excel
         参数

    importStyle:

    导入方式,字符串,

    • 不写时为普通导入

    • "customize":自定义导入

       返回值void
         示例

    示例1:若获取到的报表对象定义为 report ,调出导入 Excel 的功能弹窗,以普通导入的方式导入 Excel

    report.verifyReport();

    示例2:填报报表中,调出导入 Excel 功能弹窗,以普通导入的方式导入 Excel

    _g().verifyReport();

    示例3:填报报表中,调出导入 Excel 功能弹窗,以自定义导入的方式导入 Excel

    _g().importExcel("customize");
      应用示例

    自定义一个 「导入Excel」按钮,点击实现导入 Excel:

    点击可下载模板:自定义导入的方式导入 Excel.cpt

    2021-09-09_20-36-00.gif

       移动端不支持移动端

    importExcel_Clean

    方法importExcel_Clean()「清空导入」的方式导入 Excel
         参数-

    -

       返回值void
         示例

    示例1:若获取到的报表对象定义为 report ,调出导入 Excel 功能弹窗,以「清空导入」的方式导入 Excel

    report.importExcel_Clean();

    示例2:填报报表中,调出导入 Excel 功能弹窗,以「清空导入」的方式导入 Excel 

    _g().importExcel_Clean();
      应用示例

    自定义一个 「导入Excel」 按钮,点击以「清空导入」的方式导入 Excel :

    点击可下载模板:清空导入的方式导入 Excel.cpt

    2021-09-09_20-36-00.gif

       移动端不支持移动端

    importExcel_Append

    方法importExcel_Append()增量导入」的方式导入 Excel
         参数-

    -

       返回值void
         示例

    示例1:若获取到的报表对象定义为 report ,调出导入 Excel 功能弹窗,以增量导入的方式导入 Excel

    report.importExcel_Append();

    示例2:填报报表中,调出导入 Excel 功能弹窗,以增量导入的方式导入 Excel 

    _g().importExcel_Append();
      应用示例

    自定义一个「导入Excel」按钮,点击以增量导入的方式导入 Excel:

    点击可下载模板:增量导入的方式导入 Excel.cpt

    2021-09-09_20-36-00.gif

       移动端不支持移动端

    importExcel_Cover


    方法importExcel_Cover()覆盖导入的方式导入 Excel:
         参数-

    -

       返回值void
         示例

    示例1:若获取到的报表对象定义为 report ,调出导入 Excel: 功能弹窗,以覆盖导入的方式导入 Excel

    report.importExcel_Cover();

    示例2:填报报表中,调出导入 Excel:功能弹窗,以覆盖导入的方式导入 Excel

    _g().importExcel_Cover();
      应用示例

    自定义一个「导入Excel」按钮,点击以覆盖导入的方式导入 Excel:

    点击可下载模板:覆盖导入的方式导入 Excel.cpt

    2021-09-09_20-36-00.gif

       移动端不支持移动端

    isDirtyPage

    方法isDirtyPage()判断页面是否被编辑过
         参数

    -

    -

       返回值boolean

    页面是否被编辑过,布尔型

    • true:编辑过

    • false:未编辑过

         示例

    示例1:若获取到的报表对象定义为 report ,判断页面是否被编辑过

    report.isDirtyPage();

    示例2:填报报表中,判断页面是否被编辑过

    _g().isDirtyPage();
      应用示例

    点击按钮,判断页面是否被编辑过:

    点击可下载模板:查看页面编辑状态.cpt

    2021-09-14_17-55-45.gif

       移动端不支持移动端

    isAutoStash

    方法isAutoStash()判断是否开启自动暂存,自动暂存可参考:填报暂存
         参数

    -

    -

       返回值boolean

    是否开启自动暂存,布尔型

    • true:开启

    • false:未开启

         示例

    示例1:若获取到的报表对象定义为 report ,判断是否开启自动暂存

    report.isAutoStash();

    示例2:填报报表中,判断是否开启自动暂存

    _g().isAutoStash();
      应用示例

    -

       移动端不支持移动端

    stash

    方法stash(undefined,true)暂存
         参数undefined,true

    固定格式,作用为弹出暂存成功的提示,如果不需要提示,直接不写即可

       返回值void
         示例

    示例1:若获取到的报表对象定义为 report ,暂存并弹出暂存成功的提示

    report.stash(undefined,true);

    示例2:填报报表中,暂存并弹出暂存成功的提示

    _g().stash(undefined,true);
    示例3:填报报表中,暂存但不弹出暂存成功的提示
    _g().stash();
      应用示例

    -

       移动端不支持移动端

    clear

    方法clear()清空暂存
         参数-

    无,如果不需要清空确认提醒以及清空成功的提示,则可以写 undefined,false

       返回值void
         示例

    示例1:若获取到的报表对象定义为 report ,清空暂存并弹出清空暂存成功的提示

    report.clear();

    示例2:填报报表中,清空暂存并弹出清空暂存成功的提示

    _g().clear();

    示例3:填报报表中,清空暂存但不弹出清空确认提醒以及清空成功的提示

    _g().clear(undefined,false);
      应用示例-
       移动端不支持移动端


    附件列表


    主题: 二次开发
    • 有帮助
    • 没帮助
    • 只是浏览

    售前咨询电话

    400-811-8890转1

    在线技术支持

    在线QQ:800049425

    热线电话:400-811-8890转2

    总裁办24H投诉

    热线电话:173-1278-1526

    文 档反 馈

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭