没有合适的资源?快使用搜索试试~ 我知道了~
泛微E9流程表单前端接口API(2020).pdf
4星 · 超过85%的资源 需积分: 47 89 下载量 194 浏览量
2020-10-23
11:03:38
上传
评论 5
收藏 881KB PDF 举报
温馨提示
试读
49页
泛微E9流程表单前端接口 API说明\泛微E9流程表单前端接口 API说明\泛微E9流程表单前端接口 API说明
资源推荐
资源详情
资源评论
E9 流程表单前端接口 API
1.说明
1.1 简介
所有接口统一封装在全局对象 window.WfForm 中
部分接口存在使用范围,最低 kb 版本以及是否移动端/PC 端独有。没有特殊注明情况下
通用
表单字段相关操作,不推荐使用 jQuery,禁止原生 JS 直接操作 DOM 结构!
大家开发过程中,推荐都使用 API 接口操作,由产品统一运维;同时使用 API 才能完整的
兼容移动终端
1.2 移动端兼容
WfForm 对象下接口,兼容新版移动端 EM7
由于 API 接口在 PC 端与移动端已经统一,为减少开发工作量以及后期维护成本;
故 EM7 表单在移动终端不再引入 workflow_base 表 custompage4emoble 列作为自定
义页面,直接引入 custompage 列(与 PC 模板一致)作为自定义页面
前端(JS 方法)区分终端:
可通过方法 WfForm.isMobile()判断是否移动端
1. var isMobile = WfForm.isMobile(); //true 表示是 eMobile、微信、钉钉等移动终
端,false 代表 PC 端
后端请求(自定义页面等)区分终端:
1. boolean isMobile = "true".equals(request.getParameter("_ec_ismobile"));
//true 表示是 eMobile、微信、钉钉等移动终端,false 代表 PC 端
1.3 前端代码开发方式
方式 1:模板上代码块,针对单个节点,在显示/打印/移动模板单独配置
方式 2:workflow_base 表 custompage,针对当前路径所有节点,显示及打印及移动端
注意流程如果与预算、考勤、车辆等关联此字段可能有值。
方式 3:路径管理-应用设置-全局自定义页面,针对系统所有非模板模式的场景(PC 及移
动)。注意此页面为全局 custompage,应避免写 ready、checkCustomize 等全局函数,
只定义些函数体
特别注意:方式二、方式三禁止引入 init_wev8.js。
如遇配置不生效,请先将代码块/custompage 仅写 alert 确认是否生效,再逐步排查错误
原因。
1.4 PC 端打开表单的方式
新建请求:传参路径 id,会自动计算活动版本的路径 id
1. window.open("/workflow/request/CreateRequestForward.jsp?workflowid=747"
);
查看请求:传参请求 id,用户需本身具备此请求查看权限,主次账号需带入账号信息
1. window.open("/workflow/request/ViewRequestForwardSPA.jsp?requestid=5963
690");
1.5 移动端打开表单的方式
移动端表单链接:
1. //
新建链接,传参路径
id
2. var createUrl =
"/spa/workflow/forwardMobileForm.html?iscreate=1&workflowid=747";
3. //
查看链接,传参请求
id
4. var viewUrl = "/spa/workflow/forwardMobileForm.html?requestid=4503066";
第一种方式(推荐):调用封装好的方法
如果是通过移动端脚手架打包的模块,可以直接调用
如果是自行开发的界面,需要引入/spa/coms/openLink.js
最低支持版本:KB900190601
openLink.openWorkflow(url, callbackFun, returnUrl)
参数
参数类型
说明
url
String
打开表单的链接
callbackFun
Function
仅限 EM 客户端,返回时的回调函数
returnUrl
String
非 EM 客户端,返回/提交后到指定链接
1. window.openLink.openWorkflow(createUrl, function(){
2. alert("E-mobile 打开表单链接,返回或提交后触发此回调函数");
3. });
4.
5. //非 EM 终端打开,返回或提交后返回到流程中心界面
6. window.openLink.openWorkflow(createUrl, null,
"/spa/workflow/static4mobile/index.html#/center/doing");
第二种方式:仅限于 EM 客户端,打开表单并可控制表单返回/提交后事件回调
使用 EM-SDK,弹 webview 方式实现
1. //分为两步,第一步调用 SDK 弹 webview,第二步调用 SDK 控制回调刷新
2. window.em.openLink({
3. url: viewUrl,
4. openType: 2
5. });
6. window.em.ready(function(){
7. window.em.registerBroadcast({
8. name: "_closeWfFormCallBack",
9. action: function (argument) {
10. alert("E-mobile 打开表单链接,返回或提交后触发此回调函数");
11. }
12. });
13. });
第三种方式: window.open 或者 window.location.href 跳转。
此方式 url 需要传参 returnUrl 并转码,用于指定返回/提交后跳转地址。
建议如果是 EM 客户端采用方式一或方式二!
1. window.open(viewUrl+"&returnUrl="+window.encodeURIComponent("/test.jsp?
param1=test11¶m2=test22"));
2.注册自定义事件
2.1 注册拦截事件,指定动作执行前触发,并可阻断
/放行后续操作
支持多次注册,按注册顺序依次执行;支持异步 ajax,避免请求卡住
场景 1:表单提交、保存、退回、转发、强制收回等操作执行前,执行自定义逻辑并阻断/
放行后续操作
场景 2:明细添加行、删除行前,执行自定义逻辑并阻断/允许后续操作
动作类型
说明
WfForm.OPER_SAVE
保存
WfForm.OPER_SUBMIT
提交/批准/提交需反馈/不需反馈等
WfForm.OPER_SUBMITCONFIRM
提交至确认页面,如果是确认界面,点确认触发的是 SUBMIT
动作类型
说明
WfForm.OPER_REJECT
退回
WfForm.OPER_REMARK
批注提交
WfForm.OPER_INTERVENE
干预
WfForm.OPER_FORWARD
转发
WfForm.OPER_TAKEBACK
强制收回
WfForm.OPER_DELETE
删除
WfForm.OPER_ADDROW
添加明细行,需拼明细表序号
WfForm.OPER_DELROW
删除明细行,需拼明细表序号
WfForm.OPER_PRINTPREVIEW
打印预览
WfForm.OPER_EDITDETAILROW
移动端-编辑明细
接口名称及参数说明
registerCheckEvent:function(type,fun)
参数
参数类型
必
须
说明
type
String
是
动作类型(详见上表),多个逗号分隔
剩余48页未读,继续阅读
资源评论
- lee151662020-12-31很不错的资料,有了这个接口API,让我很容易的知道该如何进行调用。
lh0572
- 粉丝: 3
- 资源: 7
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
最新资源
- 探索tecreate:软件开发的未来之星.zip
- 打标机项目C#源码连接扫码
- 基于SSM的房屋租赁系统的设计与实现
- xyctf:从入门到精通的实用指南.zip
- mmqrcode1714153659780.png
- Screenshot_2024-04-27-06-08-58-486_com.baidu.xin.aiqicha.jpg
- 基于Javaweb+Tomcat+MySQL的大学生公寓管理系统+sql文件.zip
- 实训作业基于javaweb的订单管理系统源码+数据库+实训报告.zip
- 多机调度问题贪心算法基于最小堆和贪心算法求解多机调度问题.zip
- 基于同态加密技术的匿名电子投票系统源码.zip
资源上传下载、课程学习等过程中有任何疑问或建议,欢迎提出宝贵意见哦~我们会及时处理!
点击此处反馈
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功