洲聚零代码开放平台
开放平台简介
后端API
表单
单点登录
SAMl2.0协议
OIDC协议
CAS协议
开发指南
获取token
Rsa加密公钥
Des加密公钥
通用
执行sql
数据缓存
组织岗位
应用功能
前端API
开发指南
通用
系统
用户信息
模态
网络
消息管理
常用方法
业务服务
调用sql
个性化样式
个性化配置
数据处理
定义函数
表单
打开表单
表单属性监听
流程
流程处理
主列表
子列表
页面
自定义Vue组件
zj-cli安装使用
自定义 Vue 组件开发规范
自定义Vue组件调试
脚本示例
列表脚本示例
表单脚本示例
全局脚本示例
UI组件动态加载
其他UI框架如何引入
表单地址说明
场景示例
综合示例
列表按钮打开表单存值
点击按钮调用API回写表单
按钮
修改平台默认按钮名称
点击子表自定义按钮弹出流传表单
数据库结构
操作日志表 t_operation_log
单点登录
单点登录(Authcode)配置
单点登录第三方系统集成
异常处理
vs code 环节异常
技术参数
连接器示例
人员信息加/解密自定义接口示例
本文档使用 MrDoc 发布
-
+
首页
表单
# 表单 # 开发准备 * 脚本必须使用ES5以下的语法规则编写 * 所有内容适用于表单 # 取值 ### 获取表单信息 用于获取表单信息 ``` dataForm.getDataFormInfo() ``` #### 输入参数:无 #### 返回内容: | 参数 | | 类型 | 含义 | | --- | --- | --- | --- | | formCode | | string | 表单code | | sheetCode | | string | 原始表单code比如在引用表单里,就是引用的表单code;在正常表单里,就是表单code | | dataId | | string | 数据id | | flowId | | string | 流程id | | appItemType | | enum ('GridList' \| 'WorkflowList' \| 'ViewList') | 表单类型GridList:普通表单WorkflowList:工作流表单ViewList:视图表单 | | formViewType | | enum ('add' \| 'view' \| 'edit') | 表单模式add:新增模式view:查看模式edit:审批/编辑模式 | | isSubForm | | bool | 是否是子表 | | subCode | | string | 子表code | | subDataId | | string | 子表数据Id | | formExtensionInfo | | object | 表单扩展信息 | | | CreatorId | string | 创建人Id | | | CurrentActivityCode | string | 当前流程节点code | | | CurrentActivityName | string | 当前流程节点名称 | | | OUFullName | string | 创建人组织机构路径 | | | OUPost | string | 创建人角色 | | | Originator | string | 创建人账号 | | | ParentId | string | 创建人的部门Id | #### 返回数据样例: ``` { formCode: "7e8c13a1247fbfd3", sheetCode: "7e8c13a1247fbfd3", dataId: "8f42c97d-e135-4769-b13c-8030d2243e0b", flowId: "xxx" appItemType: "GridList", formViewType: "edit", isSubForm: false, formExtensionInfo:{ CreatorId: "18f923a7-5a5e-426d-94ae-a55ad1a4b239", CurrentActivityCode: "", CurrentActivityName: "", OUFullName: "devzuo", OUPost: "", Originator: "devzuo", ParentId: "18f923a7-5a5e-426d-94ae-a55ad1a4b240" } } ``` ### 获取所有子表对象 ``` dataForm.getAllSubTable() ``` #### 输入参数:无 #### 返回内容: | 参数 | 类型 | 含义 | | --- | --- | --- | | subTable | array | 当前表单的所有子表对象 | #### 返回数据样例: ``` const subtables = dataForm.getAllSubTable(); subtables.forEach(subtable => { // `subtable.xxx` 操作子表 }); ``` ### 获取子表对象 ``` dataForm.getSubTable(subCode) ``` #### 输入参数: | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | subCode | string | 是 | 子表code | #### 返回内容: | 参数 | 类型 | 含义 | | --- | --- | --- | | subtable | object | 子表对象 | #### 返回数据样例: ``` const subtable = dataForm.getSubTable(subCode); // `subtable.xxx` 操作子表 ``` ### 获取表单字段的值 ``` dataForm.getDataItemValue(code) ``` #### 输入参数: | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | code | string | 是 | 表单字段code | #### 返回内容: | 参数 | 类型 | 含义 | | --- | --- | --- | | value | string | number | 表单字段的值 | #### 返回数据样例: ``` const value = dataForm.getDataItemValue(code); ``` ### 获取业务规则结果 ``` dataForm.getBusinessRuleResult(rule) ``` #### 输入参数: | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | rule | string | 是 | 规则字符串 | #### 返回内容: 返回一个Promise类型的对象,可以直接通过then来处理正确回调,通过catch来处理错误回调 | 参数 | 类型 | 含义 | | --- | --- | --- | | Code | number | 网络请求的返回码 | | Status | number | 网络请求的返回状态 | | Message | string | 网络请求的返回信息 | | Result | string | 网络请求的返回值 | #### 样例 ``` dataForm.getBusinessRuleResult(rule).then(res => { const value = res.Result; // 数据处理 }).catch(error => { // 错误处理 }); ``` # 赋值 ### 设置表单字段的值 ``` dataForm.setDataItemValue(code, value) ``` #### 输入参数: | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | code | string | 是 | 表单字段code | | value | string \| number \| object \| array | 是 | 要设置的值 | #### 返回内容:无 #### 返回数据样例:无 ### 设置表单下拉框、关联控件字段的赋值 ``` dataForm.setDataItemValue(code,object) ``` #### 输入参数: | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | code | string | 是 | 表单字段code | | object | object | 是 | 要设置的值 | #### 示例: ``` // 下拉控件字段赋值 dataForm.setDataItemValue('f_5c4e67ba1f', 'bb5a5281-d7af-4303-b81c-633cb46cc215'); // 关联控件字段赋值 dataForm.setDataItemValue('f_06b0a12dbe', { name: '陈家玉叉车卸货', objectId: '6e1adf16-9e96-426e-b535-878d3671e471' }); ``` #### 返回内容:无 #### 返回数据样例:无 ### 人员控件字段的赋值 ``` dataForm.setDataItemValue(code,object) ``` #### 输入参数: | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | code | string | 是 | 表单字段code | | object | object | 是 | 数组 | #### 示例: ``` dataForm.setDataItemValue("f_ab05d8e2db", [{ ObjectID: '0400a9d8-a396-46dd-9056-d79db3be5823', Name: '李霞' }, { ObjectID: '05e911b7-7543-4c28-bc16-7c86f7be311c', Name: '孙俊' }]); ``` #### 返回内容:无 #### 返回数据样例:无 ### ~~子表给主表字段赋值~~ 暂未实现 ``` dataForm.setMainTableDataItemValue(code, value) ``` #### 输入参数: | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | code | string | 是 | 主表字段code | | value | string \| number \| object \| array | 是 | 要设置的值 | #### 返回内容:无 #### 返回数据样例:无 ### 设置可选字段的附属属性 目前只支持option的修改 ``` dataForm.setExtendAttributeByCode(code, key, value) ``` #### 输入参数: | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | code | string | 是 | 表单字段code | | key | string | 是 | 属性名 | | value | string | 是 | 要设置的值 | #### 返回内容:无 #### 样例: ``` this.form.setExtendAttributeByCode('f_xxx', 'option', [ { name: '选项一', selectionId: 1 }, { name: '选项二', selectionId: 2 } ]); ``` ### ~~提交表单数据~~ 暂未实现 ``` this.form.submitFormData(participativeIds) ``` #### 输入参数: | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | participativeIds | array | 是 | 下一步审批人Id | #### 返回内容: 返回一个Promise类型的对象,可以直接通过then来处理正确回调,通过catch来处理错误回调 #### 返回数据样例: ``` const participativeIds = ['xxx', 'yyy']; this.form.submitFormData(participativeIds).then(res => { // 正确的回调 }).catch(() => { // 错误的回调 }); ``` ### ~~保存子表数据(要校验)~~ 暂未实现 可传入单条数据或多条数据保存 ``` this.form.saveSubTableData(subCode, datas); ``` #### ### ~~保存表单~~ 暂未实现 非流程表单保存 ``` this.form.preserveFormData(); ``` #### 输入参数: | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | | | | | #### 返回内容: #### 返回数据样例: ``` ``` ### ~~重置表单:~~ 暂未实现 非流程表单保存 ``` this.form.resetFormData(); ``` #### 输入参数: | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | | | | | #### 返回内容: #### 返回数据样例: ``` ``` # 规则 ### 隐藏表单字段 ``` dataForm.hideComponentByCode(codes, hide) ``` #### 输入参数: | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | codes | array | 是 | 字段code | | hide | bool | 否 | 是否隐藏,默认false | #### 返回内容:无 #### 返回数据样例:无 ### ~~隐藏子表列~~ 暂未实现 ``` this.form.hideSubTableColums(subCode, codes, hide) ``` #### 输入参数: | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | subCode | string | 是 | 子表code | | codes | array | 是 | 子列表字段code | | hide | bool | 否 | 是否隐藏,默认false | #### 返回内容:无 #### 返回数据样例:无 ### 隐藏表单按钮 ``` this.form.isHiddenButton(titles, hide) ``` #### 输入参数: | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | titles | array | 是 | 按钮名称 | | hide | bool | 否 | 是否隐藏,默认false | #### 返回内容:无 #### 返回数据样例:无 ## 其他 ### 刷新子表 仅刷新子列表而非整个页面的刷新 ``` dataForm.refreshSubTable(subCode) ``` #### 输入参数: | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | subCode | string | 是 | 子表code | #### 返回内容: 返回一个Promise类型的对象,可以直接通过then来处理正确回调,通过catch来处理错误回调 #### 返回数据样例: ``` dataForm.refreshSubTable('xxx').then(res => { // 正确的回调 }).catch(() => { // 错误的回调 }); ``` ### 关闭表单 ``` dataForm.closeView(); ``` #### 输入参数:无 #### 返回内容:无 #### 返回数据样例:无 ### 获取控件 ``` dataForm.getComponentByCode(code) ``` #### 输入参数: | 参数 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | code | string | 是 | 控件code或者fieldId | #### 返回内容:无 #### 返回数据样例:无
fanfy
2025年7月24日 09:50
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
PDF文档(打印)
分享
链接
类型
密码
更新密码