混凝土拌合站信息管理系统调研开发实施规范文档101版.docx
《混凝土拌合站信息管理系统调研开发实施规范文档101版.docx》由会员分享，可在线阅读，更多相关《混凝土拌合站信息管理系统调研开发实施规范文档101版.docx（20页珍藏版）》请在冰豆网上搜索。
混凝土拌合站信息管理系统调研开发实施规范文档101版
版本所有：
上海同望软件有限公司
保密级别：
□普通■保密□机密
文件编号：
记录编号：
混凝土拌合站信息管理系统
调研、开发、实施规范文档
版本：
1.0
修订历史
版本
发布日期
生效日期
修订说明
作者
审核人
批准人
当前状态
0.9
2010-7-31
新建
成研
试用发布
1.0
2010-8-2
完善硬件软件要求及实施流程
成研
试用发布
1.01
2010-8-4
在“采集端注意事项”中增加一点要求；
修改软件实施端口号；
完善软件客户端部署细节
孙灏
成研
试用发布
目录
1.导读1
2.整体工作流程1
2.1.流程图1
2.2.说明1
2.3.事先准备1
3.调研流程及相关文档2
3.1.调研流程2
3.2.调研文档2
3.2.1.拌合机类型描述2
3.2.2.拌和机软件调研附属内容3
4.研发流程及相关规范和文档3
4.1.研发流程3
4.2.采集端开发规范3
4.2.1.规范说明3
4.2.2.采集端流程设计4
4.2.3.采集端流程说明4
4.2.4.采集输出格式说明5
4.2.5.采集端函数说明6
4.2.6.采集端方法说明7
4.2.7.发送端数据库字段解析表9
4.3.采集端开发注意事项11
4.4.采集端书写要求11
5.实施流程及相关文档12
5.1.产品方案12
5.1.1.硬件部分12
5.1.2.软件部分12
5.2.实施流程12
5.2.1.硬件设备安装测试流程12
5.2.2.实施流程12
5.3.实施相关文档14
1.导读
⏹本文档主要用于规范混凝土拌合站信息管理系统调研、开发、实施过程中的规范流程，以及相应文档的模板。
⏹注明：
该规范文档中所涉及到的调研、开发和实施文档，都有相关的模板给予使用，文档中体现的模板只表示文档的样式。
2.整体工作流程
2.1.流程图
⏹待补充
2.2.说明
⏹调研人员进行现场调研，完成调研文档，提交给研发部经理；
⏹研发部经理组织人手进行分析，判断调研文档中每一种类的拌和机是否是开发过的采集端软件，如果是，则将软件提交给实施人员；
⏹如果未开发过，分配给某一研发人员研发，研发时间最长不超过2日，争取一日内搞定；
⏹实施人员接收到采集端软件，测试GPRS设备，开始实施。
2.3.事先准备
⏹截图软件：
用于保存软件截图
⏹Cpu-z软件：
用于测试系统硬件环境
⏹最新版本360安全防护软件和360杀毒软件
⏹GHOST软件
⏹发送端软件测试数据库一个
⏹U盘一个：
用于存储实施和调研材料
⏹测试sim卡一张：
用于调试
⏹USB转串口线若干：
用于测试，以及客户拌合站工控PC没有PCI接口的情况
⏹花式螺丝刀一个；
3.调研流程及相关文档
3.1.调研流程
⏹调研以一个标段为基本单元，展开调研。
⏹与该标段相关负责人沟通，确定拌和机数量以及行程；
⏹针对每一拌和机进行细致调研，并完成调研文档；
⏹提交调研文档。
3.2.调研文档
3.2.1.拌合机类型描述
包含的数据项有：
⏹项目部名称：
每一标段分为若干项目部，要获得每一项目部相关系统使用人员名称及角色，方便实施的时候进行人员初始化
⏹拌合站名称：
方便实施时初始化拌合站名称，也是GPRS设备的编号
⏹工控PC类型：
工控PC基础信息，方便研发人员进行开发环境的验证；
⏹工控PC数量：
用来确定实施的拌和机数量
⏹提供设备厂家：
必须获得设备厂家的联系方式，便于在实施过程中遇到问题及时排查；
⏹工控PC与拌和机数据接口类型：
主要看是工控PC专用接口还是普通串口；
⏹是否具备额外的串口：
如果具备额外的串口，则实施的时候不用配备转接卡，直接安装；
⏹操作系统：
明确软件运行环境
⏹CPU：
明确CPU类型和主频等信息，能够确认系统使用速度
⏹内存容量：
明确CPU类型和主频等信息，能够确认系统使用速度
⏹主板芯片信息：
明确主板芯片，可以知道主板PCI接口是老式PCI接口，还是新式PCI-E接口，可以明确转接卡类型；
⏹软件名称：
明确工控PC软件名称，也作为我们采集端软件开发版本名称；
⏹数据库类型：
明确软件解析方式，并配合具体数据库来进行开发解析
⏹备注
3.2.2.拌和机软件调研附属内容
⏹数据文件
⏹安装后的软件包
⏹软件各项功能截图（在该文档附属文件中提供了样式），截图时，必须包括拌合时间详细截图：
10秒以下一张、10秒-100秒一张、100秒以上一张，方便软件开发调试。
这其中，主要采集到的数据为：
配合比、拌合材料用量、拌合时间。
⏹拌合时间采集方式确认：
属于直接从数据文件中解析还是需要进行截屏采集；主要是看自动生产还是手动生产；
⏹提交拌合站路线图。
⏹每一项目部相关系统使用人员名称及角色
4.研发流程及相关规范和文档
4.1.研发流程
⏹收取调研文档；
⏹确认每一拌和机是否需要从新开发；
⏹针对需要全新开发的软件进行任务分配；
⏹开发完成后，汇总给研发部经理并统一发放给实施人员；
4.2.采集端开发规范
4.2.1.规范说明
采集端开发是一个复杂过程，对于以前开发其他的程序有以下几点不同。
1.种类繁多，开发环境复杂，开发过程中可能会遇到意想不到的问题。
2.我们是建立读取别人程序的基础上，需要揣测出别人的流程，才能自己写。
3.有些流程会很复杂，需要我们花费大量力气去理顺。
基于以上原因，编制此规范，用于指导和约束开发过程
4.2.2.采集端流程设计
4.2.3.采集端流程说明
1.初始化配置文件（初始化配置文件，分为采集数据路径初始化和设备编号等基本信息的初始化）。
2.读取数据标识内容（数据标识文件是用来标识，当前数据采集到哪一条了）。
3.读取基本用料信息（基本信息包含用料信息和施工配合比信息，以及操作员，施工部位等信息）。
4.检测数据是否重复（可能需要）。
5.读取系统时间和搅拌时间
6.存入数据库
7.释放连接读取客户数据连接
8.更新数据标识内容
9.设置定时器，定时调用读取程序
4.2.4.采集输出格式说明
采集端输出格式采用统一输出格式：
输出到access数据库中。
Access数据库已经建好，到时会统一发给开发人员，以下是对每个字段含义。
数据库密码为：
‘toone’；
采集分为：
必须采集和可以采集两种。
必须采集的用“0”表示非必须采集用“1”标识
序号
字段名称
字段类型
说明
备注
1
bianhao
自增类型
记录标识
该字段不用管
2
gongdanhao
文本
工单号
1
3
chaozuozhe
文本
操作者
0
4
sha1_shijizhi
文本
砂1实际值
0
5
shi1_shijizhi
文本
石1实际值
0
6
shi2_shijizhi
文本
石2实际值
0
7
sha2_shijizhi
文本
砂2实际值
0
8
guliao5_shijizhi
文本
骨料5实际值
1
9
shuini1_shijizhi
文本
水泥1实际值
0
10
shuini2_shijizhi
文本
水泥2实际值
0
11
kuangfen3_shijizhi
文本
矿粉3实际值
0
12
feimeihui4_shijizhi
文本
粉煤灰4实际值
0
13
fenliao5_shijizhi
文本
粉料5实际值
1
14
fenliao6_shijizhi
文本
粉料6实际值
1
15
shui1_shijizhi
文本
水1实际值
0
16
shui2_shijizhi
文本
水2实际值
1
17
waijiaji1_shijizhi
文本
外加剂1实际值
0
18
waijiaji2_shijizhi
文本
外加剂2实际值
0
19
waijiaji3_shijizhi
文本
外加剂3实际值
1
20
waijiaji4_shijizhi
文本
外加剂4实际值
1
21
chuliaoshijian
文本
出料时间
0
22
sha1_lilunzhi
文本
砂1理论值
0
23
shi1_lilunzhi
文本
石1理论值
0
24
shi2_lilunzhi
文本
石2理论值
0
25
sha2_lilunzhi
文本
砂2理论值
0
26
guliao5_lilunzhi
文本
骨料5理论值
0
27
shuini1_lilunzhi
文本
水泥1理论值
0
28
shuini2_lilunzhi
文本
水泥2理论值
0
29
kuangfen3_lilunzhi
文本
矿粉3理论值
0
30
feimeihui4_lilunzhi
文本
粉煤灰4理论值
0
31
fenliao5_lilunzhi
文本
粉料5理论值
1
32
fenliao6_lilunzhi
文本
粉料6理论值
1
33
shui1_lilunzhi
文本
水1理论值
0
34
shui2_lilunzhi
文本
水2理论值
1
35
waijiaji1_lilunzhi
文本
外加剂1理论值
0
36
waijiaji2_lilunzhi
文本
外加剂2理论值
0
37
waijiaji3_lilunzhi
文本
外加剂3理论值
1
38
waijiaji4_lilunzhi
文本
外加剂4理论值
1
39
gongchengmingcheng
文本
工程名称
0
40
sigongdidian
文本
施工单位
0
41
jiaozuobuwei
文本
浇筑部位
0
42
shuinipingzhong
文本
水泥品种
0
43
waijiajipingzhong
文本
外加剂品种
1
44
peifanghao
文本
配方号
0
45
qiangdudengji
文本
强度等级
1
46
jiaobanshijian
文本
搅拌时间
0
47
shebeibianhao
文本
设备编号
0
48
baocunshijian
文本
保存时间
0
49
biaoshi
文本
标识是否发送
默认值为0表示未发送
4.2.5.采集端函数说明
函数名
说明
备注
WinExec
无返回错误值的调用其他exe程序
Zhuangz
装载调用dll函数，用于解析图片
fnOprVari
图片解析函数，需要传入坐标
fuzhi
复制客户数据到我们数据库中
Jianc
检查客户数据库是否重复
Gengx
更新采集到哪条数据标识
4.2.6.采集端方法说明
⏹Access数据库有密码的数据库动态链接方法
path:
=path+'\GGshuj.mdb';
ADOConnection2.Close;
ADOConnection2.ConnectionString:
='Provider=Microsoft.Jet.OLEDB.4.0;PersistSecurityInfo=False;DataSource='+path+';UserId=admin;JetOLEDB:
DatabasePassword=toone;';
ADOConnection2.Open;
Path指当前路径
⏹Access数据库无密码的数据库动态链接方法
lujing1:
=lujing1+'\ATic.mdb';
ADOConnection1.Close;
ADOConnection1.ConnectionString:
='Provider=Microsoft.Jet.OLEDB.4.0;DataSource='+lujing1+';UserId=admin;Password=;';
ADOConnection1.Open;
lujing1指数据库路径
⏹VF数据库连接方法
ADOConnection1.Close;
ADOConnection1.ConnectionString:
='Provider=VFPOLEDB;DataSource='+lujing+';Mode=ShareDenyNone;ExtendedProperties="";UserID="";Password="";MaskPassword=False;CacheAuthentication=False;EncryptPassword=False;CollatingSequence=MACHINE;DSN=""';
ADOConnection1.LoginPrompt:
=false;
ADOConnection1.Open;
⏹DLL动态加载方法
procedureZhuangz;
type
TIntFunc=function（x:
integer;y:
integer;mc:
string）:
integer;stdcall;
var
Th:
Thandle;
Tf:
TIntFunc;
Tp:
TFarProc;
i:
integer;
begin
Th:
=LoadLibrary（'XPR.dll'）;{装载DLL}
ifTh>0then
try
Tp:
=GetProcAddress（Th,PChar（'fnOprVari'））;
ifTp<>nil
thenbegin
Tf:
=TIntFunc（Tp）;
i:
=Tf（strtoint（x）,strtoint（y）,mingcheng）;
end
else
ShowMessage（'函数没有找到'）;
finally
FreeLibrary（Th）;{释放DLL}
end
else
ShowMessage（'dll没有找到'）;
end;
⏹读取ini文件方法
UsesIniFiles
Myinifile:
Tinifile;//定义全局变量
myinifile:
=Tinifile.Create（path+'peizhi.ini'）;
lujing:
=myinifile.Readstring（'begin','lujing','0'）;
说明：
目前我接触到的采集端：
有三种大类型
1.能用文本直接打开：
该类型的数据，可以先读取memo到，利用memo行来分析数据，借助于Tstringlist来分离数据，然后，来存放数据。
（遇到这种类型的数据可以参考宏强老的采集端）。
2.VF类型的数据：
该类型的数据库，采用上面提供的连接方式来连接。
3.access类型数据库：
该类型的数据库，采用上面提供的连接方式来连接。
4.2.7.发送端数据库字段解析表
Xiangxixx表
3bianhaobigint80自动编号字段
0gongdanhaovarchar501工单号
0chaozuozhevarchar501操作者
0sha1_shijizhivarchar501骨料1（通常是砂1）每盘实际值
0shi1_shijizhivarchar501骨料2（通常是碎石1）每盘实际值
0shi2_shijizhivarchar501骨料3（通常是碎石2）每盘实际值
0sha2_shijizhivarchar501骨料4（通常是砂2）每盘实际值
0guliao5_shijizhivarchar501骨料5每盘实际值
0shuini1_shijizhivarchar501粉料1（通常是水泥1）每盘实际值
0shuini2_shijizhivarchar501粉料2（通常是水泥2）每盘实际值
0kuangfen3_shijizhivarchar501粉料3（通常是矿粉）每盘实际值
0feimeihui4_shijizhivarchar501粉料4（通常是粉煤灰）每盘实际值
0fenliao5_shijizhivarchar501粉料5每盘实际值
0fenliao6_shijizhivarchar501粉料6每盘实际值
0shui1_shijizhivarchar501水1每盘实际值
0shui2_shijizhivarchar501水2每盘实际值
0waijiaji1_shijizhivarchar501外加剂1每盘实际值
0waijiaji2_shijizhivarchar501外加剂2每盘实际值
0waijiaji3_shijizhivarchar501外加剂3每盘实际值
0waijiaji4_shijizhivarchar501外加剂4每盘实际值
0chuliaoshijianvarchar501出料时间
0sha1_lilunzhivarchar501骨料1（通常是砂1）每盘理论值
0shi1_lilunzhivarchar501骨料2（通常是碎石1）每盘理论值
0shi2_lilunzhivarchar501骨料3（通常是碎石2）每盘理论值
0sha2_lilunzhivarchar501骨料4（通常是砂2）每盘理论值
0guliao5_lilunzhivarchar501骨料5每盘实际值每盘理论值
0shuini1_lilunzhivarchar501粉料1（通常是水泥1）每盘理论值
0shuini2_lilunzhivarchar501粉料2（通常是水泥2）每盘理论值
0kuangfen3_lilunzhivarchar501粉料3（通常是矿粉）每盘理论值
0feimeihui4_lilunzhivarchar501粉料4（通常是粉煤灰）每盘理论值
0fenliao5_lilunzhivarchar501粉料5每盘理论值
0fenliao6_lilunzhivarchar501粉料6每盘理论值
0shui1_lilunzhivarchar501水1每盘理论值
0shui2_lilunzhivarchar501水2每盘理论值
0waijiaji1_lilunzhivarchar501外加剂1每盘理论值
0waijiaji2_lilunzhivarchar501外加剂2每盘理论值
0waijiaji3_lilunzhivarchar501外加剂3每盘理论值
0waijiaji4_lilunzhivarchar501外加剂4每盘理论值
0gongchengmingchengvarchar1001工程名称
0sigongdidianvarchar1001施工里程（地点）
0jiaozuobuweivarchar1001浇注部位
0shuinipingzhongvarchar501水泥品种
0waijiajipingzhongvarchar501外加剂品种
0peifanghaovarchar501配方号
0qiangdudengjivarchar501强度等级
0jiaobanshijianvarchar501搅拌时间
0shebeibianhaovarchar501设备编号（GRPS设备）
0baocunshijianvarchar501保存时间（从对方数据库复制到我们数据库的时间）
0biaoshivarchar501标志位（代表此条记录是否已上传）
Biaoshi表
Biaoshi标志位，记录当前已复制对方数据的最大编号
说明：
具体字段的含义说明如上，所有字段按以上的规定采集，有特殊情况的开发采集端时做好说明。
4.3.采集端开发注意事项
⏹开发前先分析出客户软件的基本流程，根据基本流程理顺自己的思路，必要的时候可以画流程图，并反复推敲这个自己的思路是否有什么遗漏，这样可以减少到客户机器上运行时，可能因为个别地方疏忽提取不到数据。
⏹开发时，不要直接操作客户的数据，一般先读取出来，零时存放，然后立刻释放掉，避免照成错误，再在我们临时存放数据里分析数据。
⏹开发过程中，每写一个函数，测试一次，测试通过后，在写。
不要等写完了，在集中测试，这样不利于发现问题，很容易出问题
⏹请参考范例程序开发，注册热键ctrl+alt+q，完善程序的异常处理和信息输出，便于实施人员的观察。
4.4.采集端书写要求
⏹对于书写规则，简洁，清晰。
⏹命名规则：
我建议采用拼音的命名方式。
（这里不采用英文命名方式，是因为我们开发人员大部分英语不好，增加阅读难度）。
⏹函数调用：
我建议函数调用嵌套调用不要超过3层，以免增加阅读难度。
⏹系统函数使用：
尽量不要使用生僻的系统函数，如使用了必须注明。
⏹注释规则：
建议简单的语法和流程，尽量注册。
复杂的语法和流程必须注释
5.实施流程及相关文档
5.1.产品方案
5.1.1.硬件部分
⏹定制硬件设备，将GPRS设备、电源接口改造部分（电源采用机箱内部电源供电方式）整合进统一封装好的硬件设备中，硬件设备尺寸与3.5寸硬盘大小一致
⏹硬件设备要求：
具备2个接口，分别为电源2pin口，电压为5伏，以及串口一个；具备GPRS设备天线出口一个；具备固定螺丝若干；公司LOGO：
上海同望软件有限公司、贵广高铁混凝土拌合站信息管理系统专用。
⏹PCI转串口板卡一个；
⏹串口线一条
⏹防拆标签3个；
5.1.2.软件部分
⏹软件安装要求：
安装在客户拌和机控制软件数据目录下，如果客户电脑系统问题比较多，现场进行系统GHOST备份之后再进行系统部署；
5.2.实施流程
5.2.1.硬件设备安装测试流程
⏹硬件设备电源接口测试：
采取目测办法，是否黑红线（5v电压）能够正确接入电源接口
⏹烧录服务器域名、端口、心跳字符、心跳时间；
⏹拆开硬件设备，放入测试sim卡，连接设备接线；进行测试连接，收到服务器返回信息“OK”，则硬件设备连接成功
⏹连续时间测试：
让设备运行10分钟，测试设备稳定运转情况；
5.2.2.实施流程
⏹与标段负责人员沟通行程，事先要确认sim卡到位情况；
⏹调研开始前，进行硬件设备的安装，用于验证设备稳定性及电源供电情况；硬件设备流程如下；
⏹注意：
调研过程只针对被
升级会员 