平台开发手册

多组织设置

多组织概述

多组织是指从不同业务管控纬度划分的不同的组织类型，比如采购组织、库存组织、销售组织等，不同的组织类型代表不同的统计和汇报纬度，最终形成一个矩阵式多维管控体系，简单理解可以将一个业务模块理解为一个组织类型，比如集中采购，集团层面建立一个"集采中心"组织，各分子公司下面分别建有采购部，但是所有分子公司的采购部归属于“集采中心”直接管控，如下图：

主视图：

采购组织视图：

平台的组织机构搭建时，主视图通过行政纬度进行显示，但是并不是展示的所有组织都是行政组织，可以分别切换不同的业务组织纬度显示组织架构。

数据权限划分

数据权限的控制按照业务组织纬度管控，即平台提供按照业务组织进行数据隔离的控制，比如采购业务中的所有数据，只有采购组织中的人员才可以看到。

1、权限分配，在操作员维护中，可以指定所属组织及部门，同时可以设置可见范围，包括：当前组织、下级组织、当前部门、下级部门，凡是具有该组织或部门权限的人，都可以看到相应组织下的业务数据。

2、数据权限控制

a、数据模型：原则上来讲，所有业务单据，都有一个唯一所属的业务组织，在数据模型预置默认字段时，会默认增加 组织类型字段（注意需要指定默认组织编号，同时该字段应该是只读属性），在数据模型设计窗口选择“业务权限控制”选项，如果不勾选该选项，同时指定控制方式：按部门或按组织，则不进行数据权限控制，该设置在单据点上张、下张、前张、后张切换的时候有效。

b、数据列表：在数据列表定义中设定，需指定列表对应的组织编号字段、部门编号字段等属性

c、参照管理，在参照管理中设定，需指定列表对应的组织编号字段、部门编号字段等属性

d、自定义报表中使用方式

如果自己组织sql语句来查询形成一些个性化报表，可以直接通过联查权限表的方式进行控制，权限表说明如下：

bs_userauthm(权限主表)

bs_userauthc(权限子表)

组织权限重计算

重新计算所有人的组织权限,一般在组织机构发生调整后进行重计算

this.resetAuthData(function(res){
    
})

Form设计

Form窗体的数据存储位置

form窗体中，所有数据主要存储在如下几个变量中：

1、this.form.data：存储单据的表头、表体数据，数据列表数据

2、this.form.remotedata: 存储Ajax类型数据集、脚本类型数据集、自定义查询数据集

3、this.form.filterdata: 存储查询条件数据（控件属性中，选中“查询条件”项的控件数据）

4、this.form.formpara: 存储地址参数信息、传入的窗体变量信息以及其他窗体自动生成的临时数据

5、this.form.voucherinfo：单据的相关元数据信息

Form全局变量容器

​x
this.form.userdata //userdata为全局变量容器

this.form.userdata.price = 100;//定义一个名字为price的全局变量
let iprice = this.form.userdata.price; //从全局变量中取出price变量

全局变量适用于存储不同方法或事件中共享的数据

使用全局变量需要注意在form数据切换的时候状态恢复，如表单前张后张切换的时候，应该将全局变量清空或者重新初始化，放置发生计算混乱。

全局数据精度设定说明

数据精度定义位置： 控制面板 -- 系统设置 -- 精度定义，精度定义中可以自定义比如数量、单价、金额等相关数字类型的数据精度。

如何使用精度定义：

1、数据模型定义中，有“精度类型”列，如果字段为数字类型，从该列下拉项中可以选择已经定义好的数据精度，选择后“小数位数”列会自动带出对应的精度值

2、在窗体函数中，可以通过函数 this.form.getPrecision("精度符号") 获取到对应精度值，可通过 this.formatNumber(数值，精度) 实现四舍五入。

示例

xxxxxxxxxx
let inum = 232.5367
let iprecision = this.form.getPrecision("quan");//例如返回值2，代表保留2位小数
let inum1 = this.formatNumber(inum,iprecision) ;//结果为232.54 四舍五入，保留2位小数

注意点：

1、精度定义保存时，系统会自动更新“数据模型”中该精度对应所有字段的“小数位数”值

2、窗体中表头字段如果绑定的为数据模型中的数字类型字段，其精度会强制跟数据模型精度保持一致，前端设置无效

3、表格数据源如果为数据模型或者数据列表，其数字类型的精度也会强制跟数据模型保持一致，前端修改无效

打开新的Form弹窗

xxxxxxxxxx
 this.form.showDialog(
    {
        name:'FormID',
        fullscreen:false,
        appwindow:true,
        reload:false,
        title:"测试",
        width:'60%',
        height:'500px',
        id:"form1",
        src:"",
        closed:function(){},
        beforeClose:function(){
            return true //允许关闭
        },
        formpara:{
            para1:'a',
            para2:'b',
            filter:{
                表格名称(或列表编号):{
                    lock:''，
                    条件编号1:''//查询条件默认值
                }
            }
        }
    })

关闭的Form窗体弹窗

xxxxxxxxxx
this.form.close() //弹出窗口中点击按钮关闭
this.form.parent.closeDialog(id) //直接调用父窗体关闭方法

打开侧边滑动窗口

xxxxxxxxxx
 this.form.openDrawer(
    {
        name:"",//窗体ID
        direction: "rtl",//可选值:rtl / ltr / ttb / btt
        modal: true,//遮罩
        showclose: true,//显示关闭按钮
        size: "40%",//大小，百分比或者具体数值，如 300 或 30%
        title: "",
        autoclose: true,//点击空白自动关闭
        reload: true,//窗口内容每次打开自动刷新
        showheader: true,//显示标题
        beforeClose:function(id){
            //关闭前事件
            return true;
        }
    })

关闭侧边栏窗口

xxxxxxxxxx
this.form.closeDrawer()

打开/关闭浮动显示块

窗体中需具有显示块容器，并且显示块容器属性中 指定了“弹出方式”

xxxxxxxxxx
this.form.showPanel("显示块名称",true/false)

子窗体调用父窗体方法

子窗体是指通过弹窗打开的窗体，如果子窗体需要调用父窗体函数，使用 this.form.callParent(method,params)

注意：为了降低窗体间的耦合，建议使用此方法，这个方法在APP原生和H5中都可以使用，而不是直接使用this.form.parent.方法名 来调用

参数说明：

params详细说明：

1、直接写为数组，这是比较通用的做法，如果父窗体方法为多个参数，比如有两个参数：code,name ; 那么params可写为 ["001","张三"]或者 ["001",{name:"张三"}],具体数组中每一项需要用什么类型，根据父窗体方法类型来匹配

2、如果父窗体方法只有一个参数，可以直接用一个值代替，比如父窗体需要一个字符串参数code,那么params直接写“001”也可以

示例

xxxxxxxxxx
//父窗体方法,code name 均为字符串类型
function doTest(code,name){
    
}
//子窗体调用
this.form.callParent("doTest",["001","张三"])

//父窗体方法,name为字符串，data为对象
function setData(name,data){
    this.form.data.ccode = name;
    this.form.data.cmemto = data.memo
    this.form.data.cmaker = data.maker
}
//子窗体调用
this.form.callParent("setData",["001",{memo:"备注",maker:"张三"}])

//父窗体方法只有一个参数
function doTest(code){
    ...
}
//子窗体调用
this.form.callParent("doTest","001") //或者 this.form.callParent("doTest",["001"])

获取弹出/侧边栏窗体Form对象

xxxxxxxxxx
let myform = this.form.getDialogForm(name)

通过myform.data来访问弹出窗口中的数据集合

注意：本函数必须在父窗体才能够获得

APP原生应用无效

打开参照窗口

APP原生无效

xxxxxxxxxx
this.form.showDialog({
    name:"参照窗体formid",
    fullscreen:false,
    title:"窗口标题",
    width:'60%',
    height:'500px', 
    id:"窗体id(唯一性)",
    formpara:{
        bhead:true,
        refervue:this,
        /*bhead为false有效
        gridname:"",//表体参照时，表格名字
        griddata:[],//表体数据源数组数据
        rowindex：1，//数组序号
        */
        reffield:参照数据源字段集合(数组),
        retfield:返回字段集合(数组),
        filter:{
            表格名称:{lock:"",default:""}
        }
    }
})

formpara参数说明

说明

参照窗体界面可以自定义添加查询条件，有两种方式

1、窗体中拖入文本框等组件，“查询条件”属性打钩，绑定字段名手动修改为参照数据源中存在的字段名即可，需要指出的是如果该字段为文本类型，则是模糊匹配，如果是数字、日期类型，则条件为相等

2、点击查询按钮时手动调用刷新列表函数或者通过实现快速过滤组件或者查询按钮的点击事件，自己组织好查询条件传入 where 参数

窗体参数对象FormPara

xxxxxxxxxx
this.form.formpara //当前Form窗体中传递过来的变量对象，变量一般通过showDialog或者地址传值两种方式传入

获取当前页面地址参数集合：this.form.formpara.urlquery ，如 show?formid=123&code=001，分别通过this.form.formpara.urlquery.formid 和 this.form.formpara.urlquery.code 来获取两个参数值

重要更新：所有地址栏参数都可以通过 this.form.formpara[参数名]来获取

获取showDialog方式传递参数集合：参考showDialog中的formpara结构

打开业务流程视图

xxxxxxxxxx
this.form.showFlowMap(flowcode,key,voucherno,formid);//打开流程视图

参数说明：

系统会按照 voucherno和formid从流程图中寻找入口节点，如果找不到入口节点会报错

批量导入Excel

APP原生无效

xxxxxxxxxx
this.form.batchImport(vo,flag,pagesize) //当前Form窗体中必须有数据模型才可以使用此方法

参数说明

导入完成后，数据自动保存至数据库

说明 如果调整导入模板的列是否显示，请在老版单据中设置字段的隐藏显示

表体数据导入

APP原生无效

xxxxxxxxxx
this.form.doImport(function(data){},autocheck);//当前Form窗体中必须有数据模型才可以使用此方法

导入完成后，数据自动加载到表体，单据保存后，才最终保存到数据库。

参数说明

确认弹窗

xxxxxxxxxx
this.confirm(msg, yescb, nocb);//当前Form窗体中必须有数据模型才可以使用此方法

参数说明

示例

xxxxxxxxxx
this.confirm("确定要删除吗？",function(){
    alert("删除成功")
},function(){
    alert("取消删除")
})

菜单权限校验

通过菜单编号来检查当前用户是否具有该菜单权限

xxxxxxxxxx
this.menuAuth(menucode,callback,errcallback)
//示例
this.menuAuth("5001260209",function(menu){
   //menu结构:{title:"采购申请",url:"focus/go.htm#/show?formid=88a1a630-1b51-4785-a051-4715beba4ea2"}
   //回调函数中通过弹窗或新的浏览器窗口打开功能地址
},function(res){
    //错误回调函数，比如权限验证失败或者异常
})

打开公式定义

APP原生无效

公式定义窗口包括左侧的字段列表、函数列表，中间部分的公式编写窗口以及右侧的参数列表，通过js编写计算逻辑，最终结果通过return 的形式返回计算结果

xxxxxxxxxx
//打开公式编写窗口    
let cscript = "";
this.form.openFormulaSet({
    readOnly: false,//只读属性
    para: [{name:"dbegin",des:"开始日期"}, {name:"dend",des:"截止日期"},{name:"itemcode",des:"项目编号"}],//参数列表
    fields: //字段集合
    [
        /*通过模块区分字段集合，模块编号以字母开头*/
        { modulecode: "per", modulename: "人员信息", fields: [{ field: "ccode", title: "单据编号" }, { field: "imoney", title: "金额" }] },
        { modulecode: "dep", modulename: "部门信息", fields: [{ field: "ccode", title: "单据编号" }, { field: "imoney", title: "金额" }] },
    ],
    scriptdata: cscript //js公式内容
}, function (data) {
    //最终公式的js内容回写到相应字段
    console.log(data)
    /* 表体赋值
    row.cscript = data;
    row["sys_focusflag"] = "1"
    */
    /*表头赋值
    _this.form.data.cscript = data;
    */
});

如何后台执行公式？

公式执行需要通过自定义构件来调用，步骤如下：

1、新建类库项目

2、添加dll引用

标准版：CommonClass.dll , DataCommon.dll , Focus.log.dll , Focus.Formula.dll

微云版：Focus.Common.dll，Focus.DBFactory.dll，Focus.Logger.dll，Focus.Formula.dll

微云版注意事项：为保证运行时环境相关dll资源的正确使用，建议通过平台的扩展插件工程 Focus.UserPlugins进行自定义构件扩展，下载链接：

http://jh.focusinsoft.com/Focus.UserPlugins.rar

3、编写调用代码，如下：

xxxxxxxxxx
ComputManager manager = new ComputManager(_cmd);//实例化公式计算管理类
manager.CreateEngine();//初始化计算引擎
List<FormulaData> arrdata = new List<FormulaData>();//组织公式数据源
Dictionary<string, object> dic = new Dictionary<string, object>();
dic.Add("ccode", "0011");
dic.Add("imoney", 100);
arrdata.Add(new FormulaData { VariableName = "per", Data = dic });//VariableName对应字段集合中的模块编号
Dictionary<string, object> dic1 = new Dictionary<string, object>();
dic1.Add("ccode", "001");
dic1.Add("imoney", 150);
arrdata.Add(new FormulaData { VariableName = "dep", Data = dic1 });//VariableName对应字段集合中的模块编号

Dictionary<string, object> para = new Dictionary<string, object>();//组织公式参数
string paravalue = manager.ExcuteFormula(a.cvalscript, arrdata, para);//执行公式，并返回计算结果
manager.CloseEngine();//关闭计算引擎
Console.WriteLine(paravalue);//打印计算结果

说明：

1、公式数据源是指公式计算所使用到的数据集，比如示例代码中的 arrdata，是一个List类型的集合,FormulaData中VariableName为数据集名称（要以字母开头），Data为结果集，一般可用DataTable或Dictionary类型来传递；公式代码中通过 [数据集名称].[变量名] 就可以访问到数据集字段信息，比如DataTable实际运行是是一个Json数组，Dictionary是一个Json对象。

2、公式参数是指执行公式时，从外部传入的参数，必须一些条件参数，参数是一个Dictionary对象，实际运行时是一个Json对象，通过 params.[变量名] 即可获取变量值

3、公式执行中添加日志监控，参考 【插件管理-脚本日志】章节。

服务器响应调用

同步方式：this.doResponse(rescode,params,callback)

异步方式：this.doResponseAsync(rescode,params)

xxxxxxxxxx
this.doResponse(rescode,params,callback) 
//示例
this.doResponse("opport01",{keyid:this.form.data.keyid},function(ret){
  let str={}
  eval("str="+ret);
  if (str.bsuc==true){
    alert("成功！")
  }else{
    this.msg(str.msg)
  } 
},function(){
    //请求错误处理回调函数
})

//异步变同步方式
var ret = await this.doResponseAsync("opport01",{keyid:this.form.data.keyid})
console.log(ret.data)

参数说明

刷新Grid列表

xxxxxxxxxx
this.form.loadListData(gridname,{start:1,bsearch:0,where:''},cb)

刷新后，会自动更新关联的控件数据显示

说明：如果表格数据源为参照类型数据源，参照显示窗体中如果需要添加自定义查询条件，有两种方式

1、窗体中拖入文本框等组件，“查询条件”属性打钩，绑定字段名手动修改为参照数据源中存在的字段名即可，需要指出的是如果该字段为文本类型，则是模糊匹配，如果是数字、日期类型，则条件为相等

2、点击查询按钮时手动调用刷新列表函数或者通过实现快速过滤组件或者查询按钮的点击事件，自己组织好查询条件传入 where 参数

刷新Ajax类型数据集

xxxxxxxxxx
this.form.loadAjaxData(dscode,para,cb)

刷新后，会自动更新关联的控件数据显示

刷新脚本类型数据集

xxxxxxxxxx
this.form.loadScriptData(dscode,para,cb)

刷新后，会自动更新关联的控件数据显示

刷新自定义数据集

xxxxxxxxxx
this.form.loadUserDefData(dscode,para,cb)

刷新后，会自动更新关联的控件数据显示

刷新主数据集

xxxxxxxxxx
this.form.loadMasterData(dscode,para,cb)

刷新后，会自动更新关联的控件数据显示

调用第三方WebAPI

xxxxxxxxxx
this.callWebApi(para,cb);//回调方式
this.callWebApiAsync(para);//异步方式

para结构

返回值：

1、如果正确请求，结果即为web api的返回结果

2、如果请求发生异常，结果为json对象，格式：{bsuc:true/false,msg:"异常描述"}

示例:

xxxxxxxxxx
回调类型
this.form.callWebApi(
    {
        method: "post", posttype: "form", url: "http://localhost:8877/home/test_post", formdata: {
            flowcode: "aaa11"
        },urlpara:{para:"p1"}
    },function(data){
        console.log(data);//api返回结果
    }
)
//异步方式
let ret = this.form.callWebApiAsync(
    {
        method: "post", posttype: "form", url: "http://localhost:8877/home/test_post", formdata: {
            flowcode: "aaa11"
        },urlpara:{para:"p1"}
    }
)
console.log(ret);//api返回结果

通过Url发起异步Ajax请求

xxxxxxxxxx
this.getRemotData(url,method,para,cb,errcb)

通过Url发起同步Ajax请求

xxxxxxxxxx
this.getRemotDataAsync(url,method,para)

xxxxxxxxxx
//必须在async函数内才能使用同步请求
let data= await this.getRemotDataAsync("url","post",{code:"001"})
console.log(data)

获取FORM窗体表头数据

xxxxxxxxxx
this.form.data

数据结构：{字段名1:”值”,字段名2:”值”,字段名3:”值”,字段名4:”值”,字段名5:”值”}

示例：获取表头部门编号字段(字段名:cdepcode)数据：

xxxxxxxxxx
var cdepcode = this.form.data.cdepcode //取值
this.form.data.cdepcode = "0101" //赋值,控件值会自动刷新

获取Grid数据

xxxxxxxxxx
this.form.data.列表类型或参照类型

数据结构：[{字段1:值,字段2:值,字段3:值,字段4:值},{字段1:值,字段2:值,字段3:值,字段4:值},{字段1:值,字段2:值,字段3:值,字段4:值}...]

此数据结构为一个数组

示例：数据源001是一个数据列表，列表类型为deplist

xxxxxxxxxx
this.form.data.deplist.length //总行数
this.form.data.deplist[0].cdepcode //第一行部门编号取值
this.form.data.deplist[0].cdepcode = "0101" //第一行部门编号赋值

Grid增行

xxxxxxxxxx
(async) this.form.addRow(gridname,rowcount,startindex,cb)

增行后如果在回调函数中进行表体行赋值操作，需要设定 “sys_focusflag” 字段，1代表行数据发生变动，0代表未变动,保存时只会处理发生变动的行。如

xxxxxxxxxx
this.form.addRow(“mytb”,10,0,function(arr){
    for(let i=0;i<arr.length;i++){
        arr[i]["cinvcode"] = "001";
        arr[i]["iquantity"] = 100;
        arr[i]["sys_focusflag"] = "1";//注意赋值，1代表行数据发生变动，0代表未变动,保存时只会处理发生变动的行
    }
})

注：增行回调函数赋值中，如果给参照关联字段赋值，系统会自动带出其他参照相关字段，无需手动赋值。

Grid删行

xxxxxxxxxx
this.form.delRow(gridname,arrrow)

单据表体删行时调用此函数，如果直接将表体数组置为空，删行无效。

Grid拷贝

xxxxxxxxxx
this.form.copyRow(gridname,arrrow)

1、表格上可以设置属性“允许拷贝行”来启用，启用后在增删行按钮旁边显示拷贝行按钮

2、可以手动调用此函数拷贝行

3、拷贝后的行自动追加到最后

Grid选中行

xxxxxxxxxx
this.form.setSelection(gridname,arrrow)

Grid必须要有选择列

示例

xxxxxxxxxx
let griddata = this.form.data["ht_sobillmc"];//获取Grid数据
this.form.setSelection("grid_ht_sobillmc",[griddata[0],griddata[2]]);//将名称为grid_ht_sobillmc的表格，默认选中1、3两行

Grid清除选中行

xxxxxxxxxx
this.form.clearSelection(gridname)

Grid必须要有选择列

Grid数据筛选

xxxxxxxxxx
this.form.doFilter(gridname,callback)

示例

xxxxxxxxxx

this.form.doFilter("grid_a_plan6",function(arr){
    return arr.filter(a=>a["ddate"] == "03-19") //返回符合条件的结果集
})

Grid列筛选条件批量重置

APP原生无效

xxxxxxxxxx
this.form.clearTableFilter(gridname)

参照关联字段自动赋值

xxxxxxxxxx
this.form.setReferFieldValues(bhead,arrfield,gridname,arrrow)

注：表体增行函数 this.form.addRow的回调函数中，给参照关联字段赋值时，无需调用此函数，系统会自动带出其他参照字段。

示例

xxxxxxxxxx
//表头字段用法
this.form.data.cvencode = "001";//给参照关联字段赋值
this.form.setReferFieldValues(true,["cvencode"]);//刷新带出参照其他关联字段

//表体字段用法
this.form.data.billc[0]["cinvcode"] = "001";//第一行赋值
this.form.data.billc[1]["cinvcode"] = "001";//第二行赋值
let arr = [this.form.data.billc[0],this.form.data.billc[1]]；//形成一个行集合
this.form.setReferFieldValues(false,null,"grid_billc",arr);//刷新带出参照其他关联字段

弹出移动端行显示（编辑）卡片

xxxxxxxxxx
this.form.showDetailRowForMobil(gridname,row) //此函数只有在移动端有效

示例

xxxxxxxxxx
let row = this.form.data["数据源编号"][0];//获取table数据源第一条数据
this.form.showDetailRowForMobil("grid_a_plan6",row);

获取窗体中列表查询条件数据

xxxxxxxxxx
this.form.filterdata //查询条件数据集合

数据结构:{字段名1:”值”,字段名2:”值”,字段名3:”值”,字段名4:”值”,字段名5:”值”}

字段名系统命名规则：查询编号_数据集编号

示例：列表deplist中，查询条件编号为f01,数据集编号为001，则字段名为f01_001

xxxxxxxxxx
let cfiltervalue = this.form.filterdata.f01_001 //获取改查询字段值
this.form.filterdata.f01_001 = "001" //给查询字段赋值

获取父窗体

APP原生无效

xxxxxxxxxx
this.form.parent //父窗体对象
this.form.parent.data //父窗体表头值集合
this.form.parent.filterdata //父窗体查询字段数据集合

适用于通过 this.form.showDialog 函数打开的窗口访问父窗口，如果存在多级父窗口，通过this.form.parent.parent...来访问，具体层数取决于打开窗口的个数

说明：如果调用父窗体方法，建议使用this.form.callParent函数来解耦，尽量不要直接使用this.form.parent.方法名

示例：获取父窗体值赋值到新窗体

xxxxxxxxxx
if (this.form.formpara.copy==true){
  this.form.addVoucher("button_add")
  this.form.data.ccuscode=this.form.parent.data.ccuscode;
  this.form.data.ccusname=this.form.parent.data.ccusname;
  for(var i=0;i<this.form.parent.data.crm_orderc.length;i++){
    this.form.data.crm_orderc[i].cinvcode=this.form.parent.data.crm_orderc[i].cinvcode;
    this.form.data.crm_orderc[i].cinvname=this.form.parent.data.crm_orderc[i].cinvname;
  }
}

消息提示

xxxxxxxxxx
this.msg(message,type)

企查查接口

xxxxxxxxxx
this.qichacha({path:"",keyval:""},function(ret){
        
})

注意事项

1、如果环境为微云版，需在 appsettions.json中增加如下节点信息

xxxxxxxxxx
  "Qichacha": {
    "appKey": "",
    "appSecret": ""
  }

2、如果为标准版，需在web.config 的appSettings节点下增加如下信息

xxxxxxxxxx
    <!--企查查参数配置-->
    <add key="qcckey" value="" />
    <add key="qccsecret" value="" />

复杂消息提示

弹窗显示自定义html内容

xxxxxxxxxx
this.pop(options,html)

options属性

示例

xxxxxxxxxx
this.pop({width:"600px",title:"日程查看"},`
    <div>我的日程</div>
    <div>上午，拜访客户</div>
    <div>下午，学习提升</div>
`)

待办标识

当前单据是否是待审批单据标志

xxxxxxxxxx
this.form.isapproving ;//true或者false

获取登录信息

xxxxxxxxxx
this.form.loginInfo //登录信息对象

this.form.loginInfo.loginCode //登录人编号
this.form.loginInfo.loginName //登陆人名称
this.form.loginInfo.depCode //部门编号
this.form.loginInfo.depName //部门名称
this.form.loginInfo.corpCode //组织编号
this.form.loginInfo.corpName //组织名称
this.form.loginInfo.loginDate //登录日期
this.form.loginInfo.curDate //当前日期
this.form.loginInfo.posCode //职位编号
this.form.loginInfo.posName //职位名称

获取移动端类型

xxxxxxxxxx
let mtype = this.mobiletype();//wx:企业微信  dd:钉钉 app:聚恒V+

Form输入验证

xxxxxxxxxx
let bpass = this.form.checkValidate()
//示例
if(bpass){
    //通过
}

重置Form输入验证

消除验证提示信息

xxxxxxxxxx
this.form.clearValidate()

修改Form输入验证

消除验证提示信息

xxxxxxxxxx
/*
    动态修改必填项
    let ctl = this.form.findControl("txt_cmanage");
    ctl.options.required = true;//设为必填项
    ctl.regex = "";//设置正则验证表达式
*/
this.form.setRules()

新增单据

此方法为异步方法，如需同步调用，请使用await

xxxxxxxxxx
(async) this.form.addVoucher(btnid,bodyrows)
//示例
await this.form.addVoucher("button_add",15)

拷贝并新增单据

此方法为异步方法，如需同步调用，请使用await

xxxxxxxxxx
this.form.copyVoucher(keyid,callback)
//示例
await this.form.copyVoucher(this.form.data.keyid,function(){alert("拷贝成功")});//拷贝当前单据

此方法拷贝来源单据数据（字段是否可以拷贝在数据模型定义），并自动新增并将数据带入当前单据。

保存单据

xxxxxxxxxx
this.form.saveVoucher(cb);//系统默认使用的保存函数，保存成功后会有保存成功提示
this.form.saveVoucher1(cb);//保存成功后不会有成功提示，可在回调函数中自定义成功提示

此方法为异步方法，如果保存后做其他业务处理，代码写在回调函数当中。

暂存单据

APP原生无效

xxxxxxxxxx
this.form.saveTempData(cb)

此方法为异步方法，如果暂存后做其他业务处理，代码写在回调函数当中。

每一次暂存，系统都会按照日期记录暂存记录。

加载暂存单据

APP原生无效

xxxxxxxxxx
this.form.loadTempData()

此方法为异步方法，如果暂存后做其他业务处理，代码写在回调函数当中。

如果只有一条暂存记录，系统会将数据直接加载到单据。

如果不止一条暂存记录，系统会弹出暂存记录选择窗口，手动选择载入暂存数据。

注意：如果使用暂存数据，请注意单据相关逻辑校验时效性，最好在服务端进行逻辑校验。

删除单据

xxxxxxxxxx
this.form.deleteVoucher(btnid, cb)

删除单据(后台)

此函数不会触发按钮状态变更

xxxxxxxxxx
this.form.deleteVoucherData(voucherno,keyid, cb)

提交单据（关联按钮状态）

xxxxxxxxxx
this.form.commitVoucher(iscommit,cb)

提交单据（后台）

代码中调用，不会引发按钮状态修改

xxxxxxxxxx
this.form.commitVoucher1(voucherno,formid,keyid,iscommit,urgent, cb)

查看审批流程图

xxxxxxxxxx
this.form.showWorkFlow(vo);//vo:单据类型编号

清除缓存

APP原生无效

xxxxxxxxxx
this.refreshCache(cachetype,sourcecode,cb,errcb)

####

汉字转拼音首字母

汉字转拼音首字母

xxxxxxxxxx
let str = this.pinyin("你好");//返回 nh

汉字转拼音全拼

xxxxxxxxxx
let str = this.pinyinAll("你好");//返回 ni hao

说明：通过此函数便于生成速记码

通过地址传递列表查询条件值

此功能常用于通过一个地址打开带列表显示的Form窗体，通过地址传递查询条件参数，打开的列表条件自动赋值

如：我的待办列表地址：show?formid=b365133f-99da-4588-a48b-8f6d90ce6e67&f1_vi_bs_dsdj=报销单，其中f1_vi_bs_dsdj即为列表的查询条件编号，编号规则为：列表条件编号_列表编号，注：列表编号即为列表定义中的列表编号，也可以通过 console.log(this.form.filterdata) 来查看当前form窗体所有的查询条件编号。

客户端全局存储

所谓全局存储，就是在客户端会长期保留存储数据，即使浏览器关闭后数据也会保留

xxxxxxxxxx
this.$store //全局存储，浏览器关闭后再打开，数据依然能够获取到
this.$store.set(name,value) //数据存储
this.$store.get(name) //获取存储数据，如果存储的为对象，则返回该对象
this.$store.me //获取存储对象，也可以通过this.$store1[name]的方式获取存储数据

客户端全局临时存储

所谓临时存储，指的是只有当前浏览器窗口或标签页未关闭时才会保留数据

xxxxxxxxxx
this.$store1 //全局存储，浏览器关闭后再打开，数据依然能够获取到
this.$store1.set(name,value) //数据存储
this.$store1.get(name) //获取存储数据，如果存储的为对象，则返回该对象
this.$store1.me //获取存储对象，也可以通过this.$store1[name]的方式获取存储数据

设置表头字段隐藏显示

xxxxxxxxxx
this.form.setHeadVisible(arrfield,visible)

设置表体字段隐藏显示

xxxxxxxxxx
this.form.setBodyVisible(gridname,arrfield,visible)

设置表体字段只读

xxxxxxxxxx
this.form.setBodyReadonly(gridname,arrfield,readonly)