E9 流程表单前端 API 速查参考

整理目标：按场景快速找 WfForm API。本文保留接口名、常量、配置名和关键注意事项，省略原始截图、长演示和重复说明。

基本规则

#

• 全局对象：window.WfForm，通常直接使用 WfForm。
• 移动端判断：WfForm.isMobile()；后端可读请求参数 _ec_ismobile。
• 前端代码入口：模板代码块、路径基础设置的自定义页面、应用设置的全局自定义页面。
• 路径级和全局自定义页面不要引入 init_wev8.js。
• 表单字段操作优先使用 WfForm API，不推荐 jQuery("#field111").val()，禁止原生 DOM 强改字段。
• 字段标识：主字段一般是 field111，明细字段一般是 field111_0 这种带行标识格式。
• viewAttr：1 只读、2 可编辑、3 必填、4 隐藏字段标签和内容、5 隐藏字段所在行。

打开表单

#

动作事件

#

执行前拦截

#

WfForm.registerCheckEvent(type, fn) 在动作前执行。回调里必须调用 callback() 才继续，不调用就是阻断。

jQuery(function () {
  WfForm.registerCheckEvent(WfForm.OPER_SUBMIT, function (callback) {
    // 校验通过后继续
    callback();
  });
});

执行后钩子

#

WfForm.registerAction(actionName, fn) 在动作完成后执行。

WfForm.registerAction(WfForm.ACTION_ADDROW + '1', function (index) {
  console.log('new row index:', index);
});

字段基础 API

#

const field = WfForm.convertFieldNameToId('zs');
WfForm.changeFieldValue(field, { value: '文本值' });

WfForm.changeFieldValue('field11_2', {
  value: '2,3',
  specialobj: [
    { id: '2', name: '张三' },
    { id: '3', name: '李四' }
  ]
});

字段事件与自定义渲染

#

WfForm.bindFieldChangeEvent('field27555,field27556', function (obj, id, value) {
  console.log(id, value);
});

明细表 API

#

const rows = WfForm.getDetailAllRowIndexStr('detail_1');
(rows ? rows.split(',') : []).forEach(function (rowIndex) {
  const value = WfForm.getFieldValue('field222_' + rowIndex);
  console.log(value);
});

全局 API

#

特定字段类型 API

#

WfForm.appendBrowserDataUrlParam('field111', { cus_type: 'A' });
WfForm.controlDateRange('field222_0', '2019-05-01', '2019-05-31');

签字意见 API

#

历史 E8 兼容接口

#

常用系统配置

#

下列配置通常对当前 Ecology 系统全部流程生效，修改前确认影响范围。

常用 CSS 场景

#

其他场景

#

• 移动端异构系统提交表单后刷新流程列表：提交后跳转到 当前Ecology服务器地址 + '/workflow/workflow/WfRefreshList.jsp'。
• 移动端有反向代理时，服务器地址要使用代理后的可访问地址。

AI 检索关键词

#

• 字段值：getFieldValue、changeFieldValue、specialobj、changeMoreField。
• 字段状态：changeFieldAttr、getFieldCurViewAttr、viewAttr。
• 字段联动：triggerFieldAllLinkage、bindFieldChangeEvent、bindDetailFieldChangeEvent。
• 明细行：addDetailRow、delDetailRow、getDetailAllRowIndexStr、getDetailRowCount。
• 浏览按钮：appendBrowserDataUrlParam、getBrowserShowName、overrideBrowserProp。
• 选择框：removeSelectOption、controlSelectOption、getSelectShowName。
• 签字意见：getSignRemark、setSignRemark、appendSignEditorBottomBar。
• 配置：updateWfConfig、support_html_textarea_field、MobileWFOfficeSign.properties。