wg-basic-doc/docs/service/oa/app.md

APP业务

js依赖

<script src="static/form/js/app-oa-form-util.js?v="></script>

初始化

页面需要隐藏 oa-form-footer-tool-bar，由原生调用方法触发

页面加载 -> APP初始化

appOaFormUtil.setForm(layui.form);
appOaFormUtil.initAppFormData(initObj);

参数

名称	类型	说明
initObj	object	初始化对象

initObj

名称	类型	说明
confirmAssignees	array	确认代理人列表
fields	array	字段列表
formButton	object	表单按钮
currentUser	object	当前用户

方法

字段赋值

APP -> 页面字段

方法

appOaFormUtil.setFieldValue(fieldName, fieldValue)

参数

名称	类型	说明	参数值
fieldName	string	字段名
fieldValue	string	字段值

附件赋值

方法

appOaFormUtil.setAttachments(attachments)

参数

名称	类型	说明	参数值
attachments	string	附件列表	格式：附件1,附件2。附件格式：ID:名称。英文冒号分割ID与名称，英文逗号分割组。名称不能有英文冒号与逗号

抄送人赋值

方法

appOaFormUtil.setCcs(ccs)

参数

名称	类型	说明	参数值
ccs	string	抄送人列表	格式：抄送人ID1,抄送人ID2。英文逗号分割。

提交表单

appOaFormUtil.submitFormReport(btnIndex);

参数

名称	类型	说明	参数值
btnIndex	int	按钮的下标

事件

回退

• Method: PUT

• Content-Type: application/json

• URL：app/oa-form-report/update-go-back/process-instance-id/{processInstanceId}/task-id/{taskId}/node-id/{nodeId}

• PathParams:

参数	说明
processInstanceId	流程实例ID
taskId	当前任务ID
nodeId	回退到的节点ID

• Headers:

{
    token: token
}

• RequestBody:

{
    reason: "原因"
}

• Response

状态码

名称	值
200	请求成功
400	请求错误
401	权限不足
403	访问禁止
500	系统错误

Body：

{
    code: "错误编码",
    msg: "错误原因"
}

强制结束

• Method: PUT

• Content-Type: application/json

• URL：app/oa-form-report/update-forced-end/process-instance-id/{processInstanceId}/task-id/{taskId}

• PathParams:

参数	说明
processInstanceId	流程实例ID
taskId	当前任务ID

• Headers:

{
    token: token
}

• RequestBody:

{
    reason: "原因"
}

• Response

状态码

名称	值
200	请求成功
400	请求错误
401	权限不足
403	访问禁止
500	系统错误

Body：

{
    code: "错误编码",
    msg: "错误原因"
}

转交

• Method: PUT

• Content-Type: application/json

• URL：app/oa-form-report/update-assignee/process-instance-id/{processInstanceId}/task-id/{taskId}

• PathParams:

参数	说明
processInstanceId	流程实例ID
taskId	当前任务ID

• Headers:

{
    token: token
}

• RequestBody:

{
    assignee: "接收人ID",
    reason: "原因"
}

• Response

状态码

名称	值
200	请求成功
400	请求错误
401	权限不足
403	访问禁止
500	系统错误

Body：

{
    code: "错误编码",
    msg: "错误原因"
}

对象说明

代理人

属性	类型	说明	参数值
assignees	Array	代理人用户列表
btnExc	string	按钮条件
btnText	string	按钮名称
nextEndEvent	boolean	下节点是否为结束节点	true：是，false：否
nodeType	string	节点类型	normal：普通（单实例）节点，multiple：多实例节点

代理人用户

属性	类型	说明	参数值
userId	string	用户ID
userName	string	用户昵称
userUsername	string	用户名
avatar	string	头像ID

字段

属性	类型	说明	参数值
fieldName	string	字段名称
isEditable	int	可编辑	0：否，1：是
isVisible	int	可显示	0：否，1：是
editHistory	string	编辑历史	noRecord：不记录（默认），latest：记录最新（签批），all：记录全部（会签）
autoBackFill	string	自动回填	noBackFill：不回填（默认），currentUserName：当前用户名，currentUserDepartment：当前用户部门

表单按钮

属性	类型	说明	参数值
btnAttachment	int	附件按钮	0：未激活，1：已激活
btnForcedEnd	int	强制结束按钮	0：未激活，1：已激活
btnPrint	int	打印按钮	0：未激活，1：已激活
btnCc	int	抄送按钮	0：未激活，1：已激活
btnGoBack	int	回退按钮	0：未激活，1：已激活
btnTransfer	int	转交按钮	0：未激活，1：已激活
goBackUserTasks	array	历史任务列表（按执行顺序），当 btnGoBack 激活时有效

历史任务

属性	类型	说明	参数值
nodeId	string	节点ID
taskName	string	任务名称

当前用户

属性	类型	说明	参数值
userId	string	用户ID
userName	string	用户名
departments	array	用户部门列表

用户部门

属性	类型	说明	参数值
departmentId	string	部门ID
departmentParentId	string	部门上级ID
departmentName	string	部门名称
departmentCode	string	部门编码
departmentNo	string	部门编号