自定义平台实施手册

华天动力协同办公系统自定义平台实施手册大连华天软件有限公司2013年8月22日目录TOC\o"1-5"\h\z\o"CurrentDocument"1：自定义平台实施概要 3\o"CurrentDocument"2：实施子系统 3\o"CurrentDocument"2.1新建子系统 3\o"CurrentDocument"2.2模块设置 3\o"CurrentDocument"2.2.1新建模块 3\o"CurrentDocument"审批流程设置 5\o"CurrentDocument"2.2.3画面设置 5\o"CurrentDocument"2.3菜单设置 7\o"CurrentDocument"2.4后台触发程序 8\o"CurrentDocument"2.4.1画面后台触发程序 82.4.2流程后台触发程序 9\o"CurrentDocument"2.4.3后台触发程序常见问题 10\o"CurrentDocument"2.5表单控件详解 12\o"CurrentDocument"2.5.1关联设置 122.5.2提醒设置 13\o"CurrentDocument"2.5.3计算字段 13\o"CurrentDocument"2.5.4宏控件 13\o"CurrentDocument"2.5.5明细表 14\o"CurrentDocument"2.5.6SQL字段 14\o"CurrentDocument"2.5.7查询按钮 14\o"CurrentDocument"2.5.8表单按钮 163：流水号 16\o"CurrentDocument"3.1流水号设置 16\o"CurrentDocument"3.1.1设置流水号的所属类别 16\o"CurrentDocument"设置编号相关信息 17\o"CurrentDocument"3.2流水号应用 174：访问外部数据 17\o"CurrentDocument"4.1新建数据源 17\o"CurrentDocument"4.2获取外部数据 17\o"CurrentDocument"4.3回写外部数据 181：自定义平台实施概要自定义平台由：子系统列表、预定义流程、节点设置、流水号设置、数据源设置等子模块构成。其中“子系统列表”是核心模块，在这里完成大多数的自定义设置。“预定义流程”和“节点设置”是和工作流相关的模块。“流水号设置”用来设置表单中流水号的样式。“数据源设置”主要是设置外部数据源的连接。2：实施子系统2.1新建子系统由菜单【自定义平台】\【子系统列表】进入子系统列表，单击“新增”按钮，则出现如下操作界面。填写系统名称之后保存即可新建一个子系统，其后的所有操作都在子系统项下进行。2.2模块设置一个子系统下包含多个模块。例如：办公用品这个子系统包含了物品信息、采购申请单、入库单、物品领用单、库存维护单、库存表等模块。一个模块中包含了一个表单、多个流程、多个画面及后台数据库中对应的一组数据表。新建模块第一步：设置模块名称、附件存放方式、模块状态和后台触发程序。关于后台触发程序的详细信息请参阅本文档的后台触发程序章节。

第二步：录入画面设置画面基于HTML技术，设计器中有多种控件可以使用。这些控件的详细使用方法请参阅本文档的“表单控件详解”部分。第三步：表设置第四步：读写权限设置注意：当表单没有审批流程的时候，才在这里设置读写权限。如果表单会挂接审批流程，那么可以忽略第四步。经过上述四个步骤之后，保存就可以创建一个新模块。审批流程设置这部分的设置与审批流转里面完全一致，请参考审批流转的相关文档画面设置画面分为三类：浏览画面、录入画面、类别浏览画面以表格的形式展现数据。浏览画面中表格的各个列可以自由定义。

录入画面就是在表单设计器中设计的界面。设置录入画面后能实现从菜单直接进入新增记录的表单，即单击菜单后页面上显示的表单是新增状态。类别画面用来实现分类的浏览画面，通过该画面能新增、修改和删除类别记录。2.3菜单设置每个画面创建之后会有一个对应的激活URL,如下图所示。通过这个URL就可以把一个画面和一个菜单项关联起来。进入子系统列表,单击“菜单设置”按钮进入菜单设置页面。@菜单设置丨新建丨修改丨上下级菜单排序丨同级菜单排序丨删除丨返回丨E牛人办公□短消息发送短消息已发短消息已收短消息短消息收藏消息草稿箱□文件传送发送文件已发文件已收文件文件收藏文件草稿箱牛人文件柜我的申诘持我审批经我审批待我阅读我的申诘持我审批经我审批待我阅读□公司电子邮件公司邮件箱菜单名称：填写菜单的标题。上级菜单：选择菜单的上级菜单。链接目标：填写画面的“激活URL”。因为激活URL是一个比较长字符串，通常可以在画面设置处先把激活URL复制下来，然后粘贴到此处。选择权限组：选择新增菜单可以被哪些权限组的用户使用。菜单图片：在菜单左侧显示的图片，仅对第一级菜单有效。2.4后台触发程序后台触发程序分为两类：画面后台触发程序和流程后台触发程序。后台触发程序使用Java语言编写。画面后台触发程序

每个画面都可以设置一个后台触发程序。页面后台程序需要继承m.TracePublicPageProcess,并实现其中定义的方法。m.TracePublicPageProcess公共变量说明dataMap方法名说明publicabstractStringcreateBefore();新建方法运行前触发publicabstractStringupdateBefore();修改方法运行前触发publicabstractStringdeleteBefore();删除方法运行前触发publicabstractStringcreateTraceBeforeBySend(MapmainRecord,MaplistRecordArray);保存方法运行前触发参数mainRecord操作主表记录参数listRecordArray操作细表记录数组publicabstractStringtraceOverAfter(MapmainRecord,MaplistRecordArray,BooleanyesFIg);保存方法运行后触发参数mainRecord操作主表记录参数listRecordArray操作细表记录数组参数yesFlg当前审批者是否同意2.4.2流程后台触发程序一个模块可以设置一个流程后台触发程序。页面后台程序需要继承m.TracePublicProcess,并实现其中定义的方法。m.TracePublicProcess公共变量说明dataMap方法名说明publicabstractMapcreateTraceInit();新建表单时，初使值的设置画面PublicabstractStringcreateTraceBeforeBySend(MapmainRecord,MaplistRecordArray);新建流程后在发送审批前触发的事件参数mainRecord操作主表记录参数listRecordArray操作细表记录数组publicabstractStringcreateTraceAfterBySend(MapmainRecord,MaplistRecordArray);新建流程后在发送审批后触发的事件参数mainRecord操作主表记录参数listRecordArray操作细表记录数组publicabstractStringcreateTraceAfterBySave(MapmainRecord,MaplistRecordArray);新建流程后保存前触发的事件参数mainRecord操作主表记录参数listRecordArray操作细表记录数组publicabstractStringtraceBefore(MapmainRecord,MaplistRecordArray);每步审批前触发的事件参数mainRecord操作主表记录参数listRecordArray操作细表记录数组publicabstractStringtraceAfter(MapmainRecord,MaplistRecordArray,BooleanyesFIg);每步审批后触发的事件参数mainRecord操作主表记录参数listRecordArray操作细表记录数组参数yesFlg当前审批者是否同意publicabstractStringbackTraceBefore(MapmainRecord,MaplistRecordArray,BooleanbackToCreaterFlg);被退文前触发的事件参数mainRecord操作主表记录参数listRecordArray操作细表记录数组参数backToCreaterFlg是否是退文到创建人publicabstractStringbackTrace(MapmainRecord,MaplistRecordArray,BooleanbackToCreaterFlg);被退文时触发的事件参数mainRecord操作主表记录参数listRecordArray操作细表记录数组参数backToCreaterFlg是否是退文到创建人publicabstractStringtraceOverAfter(MapmainRecord,MaplistRecordArray,BooleanyesFIg);审批结束后事件参数mainRecord操作主表记录参数listRecordArray操作细表记录数组参数yesFlg当前审批者是否同意后台触发程序常见问题Q：如何获得主表字段的值？A：参见如下代码publicStringtraceOverAfter(MapmainRecord,MaplistRecordArray,BooleanyesFlg){//“申请单单号”是字段名称StringbillNumber=(String)mainRecord.get("申请单单号");//其他代码…returnnull;}Q：如何遍历操作子表A：参见如下代码publicStringtraceOverAfter(MapmainRecord,MaplistRecordArray,BooleanyesFlg){//official_input_detail是子表名MapdetailRecord=(Map)listRecordArray.get("official_input_detail");inti=0;Maprecord=(Map)detailRecord.get("tr"+i++);while(record!=null){Stringcategoryld=(String)record.get("物品类别")；

//其他代码….//获得子表的下一条记录record=(Map)detailRecord.get("tr"+i++);}returnnull;}Q：程序中的dataMap公共变量的用途是什么？A：参见下表变量用法说明dataMap.get("currentStepId”)获得当前流程的审批步骤lddataMap.get("currentStepName”)获得当前流程的审批步骤名称dataMap.get("currentStepTraceActionlc”)获得审批动作iddataMap.get("currentStepTraceActionName”)获得审批动作名称dataMap.get("currentTraceUserld”)获得当前审批人lddataMap.get("currentTraceUserName”)获得当前审批人用户名dataMap.get("currentTraceUserDeptld”)获得当前审批人部门lddataMap.get("currentTraceUserDeptName”)获得当前审批人的部门名称dataMap.get("currentTraceUserRoleld”)获得当前审批人的岗位lddataMap.get("currentTraceUserRoleName”)获得当前审批人的岗位名称dataMap.get("currentTraceUserLeaderlc”)获得当前审批人的直属领导lddataMap.get("currentTraceUserLeaderName”)获得当前审批人的直属领导姓名dataMap.get("currentTraceUserTraceMinc”)获得当前审批步骤的审批意见dataMap.get("currentTraceUserTraceMindState’)获得当前审批步骤的审批状态dataMap.get("currentTraceUserTraceDateTime’)获得当前审批步骤的审批操作时间dataMap.get(“nextStepId”)获得审批流程的下一步骤lddataMap.get(“nextStepTitle”)获得审批流程的下一步骤名称dataMap.get(“nextStepName”)获得审批流程的下一步骤动作名称dataMap.get(“nextStepTraceUserldLisf)获得下一审批步骤的审批人ld列表dataMap.get(“nextStepTraceUserNameLisf)获得下一审批步骤的审批人名称列表dataMap.get("traceTitle”)申请标题dataMap.get("createTraceUserCreateDateTime”)申请时间dataMap.get("createTraceUserld”)申请人用户iddataMap.get("createTraceUserName”)申请人用户名称dataMap.get("createTraceUserDeptld”)申请人部门ld

变量用法说明dataMap.get("createTraceUserDeptName”)申请人部门名称dataMap.get("createTraceUserRolelcT)申请人岗位iddataMap.get("createTraceUserRoleName”)申请人岗位名称dataMap.get("createTraceUserLeaderUserldList”)申请人直属领导id列表dataMap.get("createTraceUserLeaderUserNameLisf)申请人直属领导名称列表2.5表单控件详解关联设置关联用于：当表单的一个字段值发生变化后，其他一个或多个字段会跟着发生变化。例如：客户编码和客户名称、客户电话之间的关联，当客户编码被改变的时候，对应的客户名称和客户电话相应发生关联变化，在这种情况下需要在客户编码上设置关联。关联是通过定义SQL文以及SQL文执行结果与表单字段的对应关系来实现。第一步：建立数据来源的SQL文。通过使用外部数据源，可以访问外部系统的数据。如何配置外部数据源，请参考本文档的“访问外部数据”部分。第二步：设置表单字段内容绑定，把SQL文查询的结果的字段与表单上的字段绑定起来。提醒设置提醒用于：在输入的时候，系统根据所输入的部分文字自动给出备选的信息，供快捷选择。例如：输入商品编码，会提示商品名称。第一步：编写提醒的SQL文。第二步：设置提醒列表中显示的字段。【设置为提醒字段】按钮：把选中的字段设置为提醒列表中的显示字段。【设置为使用字段】按钮：选中的字段的值会显示在当前控件上。【设置为存储字段】按钮：存储字段的值会保存到数据库中。计算字段计算字段可以实现主表的字段之间的计算、明细表的各个列之间的计算和计算明细表某列的合计。填写明细表的某列的名称，表示对明细表这列的值求和。宏控件序号宏控件说明1日期选择选择日期2时间选择选择时间3日期时间选择日期和时间

序号宏控件说明4表单名称表单的名称5重要度申请的重要程度6经办人IP地址显示经办人的IP地址7当前用户岗位名称显示当前用户的岗位名称8当前用户直属领导显示当前用户的直属领导9申请人姓名显示申请人的姓名10申请人部门显示申请人的部门名称11审批人签名显示审批人的签名12审批人意见显示审批人的意见13金额转大写把小与的数字转换为中文大与数字14自动流水号显示自动流水号，有多个流水号可用的时候显示下拉列表让用户选择15岗位选择选择岗位16人员选择选择人员17部门选择选择部门18类别选择选择一个类别。19多人员选择同时选择多个人员。明细表明细表的每个列可以是：输入框、输入区、复选按钮、单选按钮、下拉列表、计算字段SQL字段和宏控件。每种类型的使用与单独的控件是完全一致的。SQL字段SQL字段能实现从其他数据表中取数。通过使用外部数据源，SQL字段也能访问其他系统中的数据。查询按钮查询按钮可以和查询视图关联起来，单击查询按钮后关联的查询视图会被调用。查询视图上的数据被选择后，可以给表单上对应的字段赋值。

视图名称：按钮单击之后会调用哪个查询视图。选取方式：用于把查询视图上的数据返回给表单的时候，允许用户只能选择一条查询视图上的数据还是允许用户选择多条查询视图上的数据。允许选择多条数据一般用于向子表传递数据。查询条件：用SQL的where子句的语法格式向查询视图附加过滤条件。表单字段内容绑定：用来设置如何把查询视图上的字段对应到表单上。当用户选择了查询视图上的数据后，查询视图的数据就按这个绑定关系把值传给表单上对应的控件。

表单按钮表单按钮用来联查表单，单击表单按钮后显示关联的表单第一步：选择模板名称，即要关联的表单。第二步：设置表单选中条件绑定。通常会使用表单的唯一标志来做条件绑定，例如：使用单号来做条件绑定。“模板控件字段”是指按钮单击后显示的表单模板