【二开插件】一个独辟蹊径的修改工作名称文号通用插件

cgft · 发表于 2017-4-3 18:58:12

本帖最后由 cgft 于 2017-4-3 19:41 编辑

独辟蹊径的修改工作名称文号通用插件

一、问题提出

　　通达OA的工作流设计器，提供了“工作名称/文号”的修改功能。如图1所示的发文单，当“工作名称/文号”被定义为允许修改，且该流程步骤将“工作名称/文号”设计为可写字段（如图1所示）时，即可在下图中的箭头1所指之处允许人工输入“工作名称/文号”。还可单击“选择”按钮，人工选择表单的某控件，令其在“工作名称/文号”中自动填入该控件的值。

图1

　　通达OA所提供的功能，能满足“工作名称/文号”修改的基本需要，但如果工作流是图1所示的政务等类的工作流，为之后的管理方便计，其“工作名称/文号”一般都有固定（如以发文的文件标题作为工作流流程的“工作名称/文号”）的统一要求，此时通达OA所提供的功能在使用中就似存在不便之处：

　　1. 无法保证操作者在箭头1处输入的内容或使用“选择”按钮所自动填入的内容，符合用户单位的统一硬性规定的要求；

　　2. “工作名称/文号”的每次修改，都需人工操作，效率低、易出错。

二、需求分析

（一）设计环境

　　仍以图1为例，设定如下环境：

　　1. 工作流设计器中的文号表达式定义为：发文[{Y}-{N}]，则自动生成的内容就是箭头1处的文字“发文[2017-74]”。

　　2. 文件标题，即表单中箭头2所指的单行输入框控件（为便于叙述起见，以下将其称为“目标控件”），name="DATA_4"，其完整源代码如图2所示。

图2

　　3. 工作流设计器中的文号表达式定义为：发文[{Y}-{N}]，其自动生成的内容则是箭头1处的文字“发文[2017-74]”。

（二）设计要求

　　编写一个通用型的插件，在任意的工作流中，插件都应做到：

　　1. 可指定“工作名称/文号”的内容，自动与目标控件里的值同步。见图3，“工作名称/文号”的内容为“关于清明节放假安排的通知”。

图3

　　2. 可指定工作流设计器中的文号表达式所定义里的值与目标控件里的值组合后，作为“工作名称/文号”的内容。见图4，“工作名称/文号”的内容为“发文[2017-74] 关于清明节放假安排的通知”。

图4

（待续）

sydesmond · 发表于 2017-4-5 12:07:33

介绍一下怎么使用？

cgft · 发表于 2017-4-7 11:14:48

本帖最后由 cgft 于 2017-4-7 11:24 编辑

三、解决方案

　　插件由运行在客户端的前台程序和运行于服务器端的后台程序两部分组成。

（一）前台程序

　　采用JavaScript语言编写插件的前台程序：

　　1. 充分利用OA系统提供的函数、表单对象和js变量，与工作流程序实现无缝衔接（参见图1的下半段，工作流运行代码）。

　　2. 使用jQuery元素选择器，依据id识别源动控件，确保插件的通用性。

　　见图2，源动控件在表单的源代码中，其name被指定为“DATA_4”。由于每个表单，源动控件的name值会依据设计顺序的不同而不同，为了插件的通用性，应该为控件指定一个特定的元素加以标记。本插件要求人为地对源动控件增加一个id元素，并约定如下：

　　⑴ “工作名称/文号”的内容仅与源动控件里的值同步，则源动控件的id="Edit_RunName0"。表单源代码形如图5。

图5

　　⑵ “工作名称/文号”的内容等于文号表达式生成的值＋源动控件里的值，则源动控件的id="Edit_RunName"。表单源代码形如图6。

图6

　　3. 绑定事件。无论源动控件为何种类型，如要修改则先需获得焦点，因此选用绑定blur事件是较为合理的。

　　4. 文号表达式生成的原始值的读取。工作流的文号表达式生成的原始值（本例中即“发文[2017-74]”），保存在系统的MySQL数据库的工作流实例表的run_name字段中。表名可通过对系统运行时的js变量g_flow_id进行组合而获得；数据则通过系统运行时的js变量g_run_id关联实例表的run_id 字段，采用jQuery的Ajax方法，向服务器发送加载远程数据的异步请求而获得。代码如下：

$.ajax({

url:"/general/workflow/plugin/aerosun/getRunName.php",

data:{"RUN_ID":g_run_id,"FLOW_ID":g_flow_id},

type:"POST",

async:true,

success:function(data){

$("#Symbol",window.parent.document).val(data+MyRunName);

$("#run_id_block",window.parent.document).html(g_run_id+""+data+MyRunName);

} });

　　5. 前台程序还负责识别当前步骤是否允许修改“工作名称/文号”并保证图2的箭头1所指之处的控件为只读状态。

　　6. 前台程序的调用，通过在表单的源代码中用JavaScript代码添写一条引入外部js文件的语句来实现。见图7.

图7

（二）后台程序

　　采用PHP语言编写插件的后台程序，负责接收Ajax发出的查询请求，并将查询结果返回jQuery处理。如图3或图4所示，由前台的jQuery在图2的箭头1所指之处即时显示。

sydesmond · 发表于 2017-4-7 13:06:32

cgft 发表于 2017-4-7 11:14
三、解决方案
　　插件由运行在客户端的前台程序和运行于服务器端的后台程序两部分组成。

可以给一份完整代码吗？QQ见私信。

cgft · 发表于 2017-4-8 09:49:38

本帖最后由 cgft 于 2017-4-8 09:53 编辑

四、操作说明

　　现结合本实例，将操作顺序及要点叙述如下：

　　1. 用系统的表单设计器打开表单，在表单的源代码里，添加一条引入外部js文件的语句，如图7所示。（PS：所有的表单都可写上这条语句，是否起作用，由id决定）

<scripttype="text/javascript"src="/general/workflow/plugin/aerosun/DispHelpFrm.js"></script>

　　2. 找出源动控件的源代码，即

然后，为其添加id元素，即如图6所示

　　3. 在流程设计器中定义流程属性，允许修改工作名称/文号，如图8所示。

图8

　　需要在哪个步骤允许修改工作名称/文号，就在设计流程步骤时，将备选字段列表的[工作名称/文号，加入到本步骤的可写字段列表中，如图9所示。

图9

　　全部设置工作，即告结束。

　　实际运行办理工作流时，操作者只要在源动控件中输入或更新了内容，即可如图3、图4所示那样，在窗口头部就会马上跟着显现“工作名称/文号”的最新内容。这样，就完全实现了设计初衷。

（-- END　　需要完整代码的，请到ＱＱ群 627590148即可下载。）

qxhuo28 · 发表于 2017-4-9 22:12:29

不错！！！

湖北通达OA总代 · 发表于 2017-4-10 09:19:30

学习了。大神！通达如果能把这个需求做成通用的功能就好了！

cgft · 发表于 2017-4-10 09:39:48

湖北通达OA总代发表于 2017-4-10 09:19
学习了。大神！通达如果能把这个需求做成通用的功能就好了！

多交流。
唯一缺陷，是手机端不认控件绑定的事件，所以无法在手机上运行。

wjhlgz · 发表于 2018-1-19 07:51:34

cgft 发表于 2017-4-10 09:39
多交流。
唯一缺陷，是手机端不认控件绑定的事件，所以无法在手机上运行。 ...

手机网页端也不认吗?

donalz · 发表于 2018-8-22 09:44:59

这个插件现在不能用了吗

账号		自动登录	找回密码
密码			开放注册

【二开插件】一个独辟蹊径的修改工作名称文号通用插件

点评

点评

点评

点评