自定义平台实施手册

华天动力协同办公系统自定义平台实施手册

大连华天软件有限公司

2013年8月22日

目录

1：自定义平台实施概要 (3)

2：实施子系统 (3)

2.1新建子系统 (3)

2.2模块设置 (3)

2.2.1 新建模块 (3)

2.2.2 审批流程设置 (5)

2.2.3 画面设置 (5)

2.3菜单设置 (7)

2.4后台触发程序 (8)

2.4.1 画面后台触发程序 (8)

2.4.2 流程后台触发程序 (9)

2.4.3 后台触发程序常见问题 (10)

2.5表单控件详解 (12)

2.5.1 关联设置 (12)

2.5.2 提醒设置 (13)

2.5.3 计算字段 (13)

2.5.4 宏控件 (13)

2.5.5 明细表 (14)

2.5.6 SQL字段 (14)

2.5.7 查询按钮 (14)

2.5.8 表单按钮 (16)

3：流水号 (16)

3.1流水号设置 (16)

3.1.1 设置流水号的所属类别 (16)

3.1.2 设置编号相关信息 (17)

3.2流水号应用 (17)

4：访问外部数据 (17)

4.1新建数据源 (17)

4.2获取外部数据 (17)

4.3回写外部数据 (18)

1：自定义平台实施概要

自定义平台由：子系统列表、预定义流程、节点设置、流水号设置、数据源设置等子模块构成。

其中“子系统列表”是核心模块，在这里完成大多数的自定义设置。“预定义流程”和“节点设置”是和工作流相关的模块。“流水号设置”用来设置表单中流水号的样式。“数据源设置”主要是设置外部数据源的连接。

2：实施子系统

2.1新建子系统

由菜单【自定义平台】\【子系统列表】进入子系统列表，单击“新增”按钮，则出现如下操作界面。

填写系统名称之后保存即可新建一个子系统，其后的所有操作都在子系统项下进行。

2.2模块设置

一个子系统下包含多个模块。例如：办公用品这个子系统包含了物品信息、采购申请单、入库单、物品领用单、库存维护单、库存表等模块。

一个模块中包含了一个表单、多个流程、多个画面及后台数据库中对应的一组数据表。

2.2.1新建模块

第一步：设置模块名称、附件存放方式、模块状态和后台触发程序。

关于后台触发程序的详细信息请参阅本文档的后台触发程序章节。

第二步：录入画面设置

画面基于HTML技术，设计器中有多种控件可以使用。这些控件的详细使用方法请参阅本文档的“表单控件详解”部分。

第三步：表设置

第四步：读写权限设置

注意：

当表单没有审批流程的时候，才在这里设置读写权限。

如果表单会挂接审批流程，那么可以忽略第四步。

经过上述四个步骤之后，保存就可以创建一个新模块。

2.2.2审批流程设置

这部分的设置与审批流转里面完全一致，请参考审批流转的相关文档。

2.2.3画面设置

画面分为三类：浏览画面、录入画面、类别

浏览画面以表格的形式展现数据。浏览画面中表格的各个列可以自由定义。

记录的表单，即单击菜单后页面上显示的表单是新增状态。

类别画面用来实现分类的浏览画面，通过该画面能新增、修改和删除类别记录。

2.3菜单设置

每个画面创建之后会有一个对应的激活URL，如下图所示。

通过这个URL就可以把一个画面和一个菜单项关联起来。

进入子系统列表，单击“菜单设置”按钮进入菜单设置页面。

菜单名称：填写菜单的标题。 上级菜单：选择菜单的上级菜单。 链接目标：填写画面的“激活URL ”。因为激活URL 是一个比较长字符串，通常可以在画面设置处先把激活URL 复制下来，然后粘贴到此处。 选择权限组：选择新增菜单可以被哪些权限组的用户使用。 菜单图片：在菜单左侧显示的图片，仅对第一级菜单有效。

2.4 后台触发程序

后台触发程序分为两类：画面后台触发程序和流程后台触发程序。后台触发程序使用Java 语言编写。

2.4.1 画面后台触发程序

每个画面都可以设置一个后台触发程序。

页面后台程序需要继承https://www.360docs.net/doc/b717948786.html,m.TracePublicPageProcess，并实现其中定义

2.4.2流程后台触发程序

一个模块可以设置一个流程后台触发程序。

页面后台程序需要继承https://www.360docs.net/doc/b717948786.html,m.TracePublicProcess，并实现其中定义的方

2.4.3后台触发程序常见问题

Q：如何获得主表字段的值？

A：参见如下代码

public String traceOverAfter(Map mainRecord, Map listRecordArray, Boolean yesFlg) { // “申请单单号”是字段名称

String billNumber = (String) mainRecord.get("申请单单号");

// 其他代码…

return null;

}

Q：如何遍历操作子表

A：参见如下代码

public String traceOverAfter(Map mainRecord, Map listRecordArray, Boolean yesFlg) { // official_input_detail是子表名

Map detailRecord = (Map) listRecordArray.get("official_input_detail");

int i = 0;

Map record = (Map) detailRecord.get("tr" + i++);

while (record != null) {

String categoryId = (String) record.get("物品类别");

// 其他代码….

// 获得子表的下一条记录

record = (Map) detailRecord.get("tr" + i++);

}

return null;

}

Q：程序中的dataMap公共变量的用途是什么？

2.5表单控件详解

2.5.1关联设置

关联用于：当表单的一个字段值发生变化后，其他一个或多个字段会跟着发生变化。例如：客户编码和客户名称、客户电话之间的关联，当客户编码被改变的时候，对应的客户名称和客户电话相应发生关联变化，在这种情况下需要在客户编码上设置关联。

关联是通过定义SQL文以及SQL文执行结果与表单字段的对应关系来实现。

第一步：建立数据来源的SQL文。

通过使用外部数据源，可以访问外部系统的数据。如何配置外部数据源，请参考本文档的“访问外部数据”部分。

第二步：设置表单字段内容绑定，把SQL文查询的结果的字段与表单上的字段绑定起来。

2.5.2提醒设置

提醒用于：在输入的时候，系统根据所输入的部分文字自动给出备选的信息，供快捷选择。例如：输入商品编码，会提示商品名称。

第一步：编写提醒的SQL文。

第二步：设置提醒列表中显示的字段。

【设置为提醒字段】按钮：把选中的字段设置为提醒列表中的显示字段。

【设置为使用字段】按钮：选中的字段的值会显示在当前控件上。

【设置为存储字段】按钮：存储字段的值会保存到数据库中。

2.5.3计算字段

计算字段可以实现主表的字段之间的计算、明细表的各个列之间的计算和计算明细表某列的合计。填写明细表的某列的名称，表示对明细表这列的值求和。

2.5.4宏控件

2.5.5明细表

明细表的每个列可以是：输入框、输入区、复选按钮、单选按钮、下拉列表、计算字段、SQL字段和宏控件。每种类型的使用与单独的控件是完全一致的。

2.5.6SQL字段

SQL字段能实现从其他数据表中取数。通过使用外部数据源，SQL字段也能访问其他系统中的数据。

2.5.7查询按钮

查询按钮可以和查询视图关联起来，单击查询按钮后关联的查询视图会被调用。查询视图上的数据被选择后，可以给表单上对应的字段赋值。

视图名称：按钮单击之后会调用哪个查询视图。

选取方式：用于把查询视图上的数据返回给表单的时候，允许用户只能选择一条查询视图上的数据还是允许用户选择多条查询视图上的数据。允许选择多条数据一般用于向子表传递数据。

查询条件：用SQL的where子句的语法格式向查询视图附加过滤条件。

表单字段内容绑定：用来设置如何把查询视图上的字段对应到表单上。当用户选择了查询视图上的数据后，查询视图的数据就按这个绑定关系把值传给表单上对应的控件。

2.5.8表单按钮

表单按钮用来联查表单，单击表单按钮后显示关联的表单。

第一步：选择模板名称，即要关联的表单。

第二步：设置表单选中条件绑定。通常会使用表单的唯一标志来做条件绑定，例如：使用单号来做条件绑定。“模板控件字段”是指按钮单击后显示的表单模板上的控件字段，“数据来源字段”是指当前表单上的字段。例如上图所示的“单号”是采购申请单上的字段，而“申请单单号”是当前表单（入库单）上的字段，其含义就是把当前表单（入库单）上的申请单单号字段中的数据传给采购申请单上的单号字段，并把采购申请单显示出来。

【条件有误显示全部】：如果被选中，当绑定不正确的时候，会显示一个列表，列出模板所有的记录。这只是一种异常处理手段，避免绑定不正确的时候不会显示任何数据。

3：流水号

3.1流水号设置

3.1.1设置流水号的所属类别

每个流水号都有所属类别，即说明哪些单据中可以使用该流水号。

3.1.2设置编号相关信息

自动流水号可由年、月、日和固定编号组成。固定编号可以设置长度、累加方式。3.2流水号应用

在一个表单中应用流水号要具备下列两个条件：

1、在流水号的所属类别中包含当前表单。

2、在表单中使用自动流水号宏控件才能显示出流水号。

如果放置了自动流水号宏控件，但是没有出现流水号，通常的原因就是流水号的所属类别中没有包含当前表单。（注：有时候出现这种情况是因为没有设置字段的读写权限，没有新增控件的可见权限，自然就看不见该控件）

4：访问外部数据

4.1新建数据源

数据源名称：设置数据源名称。数据源名称一旦设置后，不要轻易改动，因为后台触发程序中可能会引用该名称来编程。

用户：连接数据库的用户名

口令：连接数据库用户的密码

4.2获取外部数据

在下列地方可以使用外部数据

1、关联设置

2、提醒设置

3、SQL字段

4.3回写外部数据

回写外部数据可以使用后台触发程序来实现。关于后台触发程序更多的内容，请参加本文档的“后台触发程序”部分。