[关闭]
@ruoli 2017-05-08T09:18:07.000000Z 字数 2852 阅读 2446

网厂协同系统接口测试指南

工作记录


1、网厂协同系统目前的网络和部署图

20170504170243.png-65.1kB
目前网厂系统在测试环境有四个工程在运行,分别如下:
1. GPCDMS,网厂系统主要工程,直接与用户操作相关的各种功能集合。
访问地址为:http://10.122.111.83/GPCDMS
2. DispatchServer,主要负责为主工程提供接口服务,在网厂协同平台的接口部分功能,主要放在这里,具体实现向中调发送请求时参数拼装,接收中调请求时参数接收及持久化。
访问地址为:http://10.122.111.83/DispatcherServer/
日志目录:D:/GPCDMS_FILE/DispatchLog
3. PcServer,此服务器可以和中调网络直接通信,负责发送和接受WebServer请求。
访问地址为:http://10.122.111.83/PCServer/
日志目录:D:/GPCDMS_FILE/PcServerLogFile
4. 模拟中调工程,可以模拟中调下发执行数据。
访问地址为:http://10.122.111.83/Mzd/
5. 接口交互简要说明
网厂协同系统接口交互简易说明.pdf191.8kB

2、所有接口汇总

电厂与中调主要接口如下:

1、输变电检修单(总共3个接口)

1、电厂上报输变电检修单白单内容给中调(10)

此接口在电厂流程【管生产副厂长审批】环节发送下一步时自动调用,调用接口返回成功才会将流程流转至下一步

输变电_推送数据给中调10.xml5.4kB
响应信息为:OK 或者 错误信息。

2、同步输变电综合信息(电厂→中调→电厂)

电厂请求报文为:
输变电_同步_请求.xml0.6kB
中调响应报文为:
输变电_同步_响应.xml50.7kB

业务规则:

回退:中调响应报文中退回信息节点信息中交互类型节点的值为退回 并且最外层节点流程状态节点值为运方检修输专责编制申请单则说明中调退回了此检修单,电厂应将流程自动退回至【输变电专责编制检修单】环节,电厂在原单中修改后再提交。

中调响应的报文中包含了签发信息节点,此节点说明如下:

此处中调可能下发白单本身数据,也可能仅仅下发签发的审批数据,此处分为两种情况,电厂上报的白单被中调关联后下发的签发信息时不会下发白单数据,如果中调自己新建的白单,下发给电厂的数据,此处就有白单信息,具体通过接口数据中的白单来源字段进行区分,白单来源有如下几个值:
1:电厂,此处为电厂上报的单。
2:新建,此处为中调新建的白单。
3:空值,此处为中调下发的补单。
此处对应两种不同类型的报文。
中调下发的白单,在系统中应该展示在接收中调检修单列表,并做累积展示。
关键字段解释:此接口中业务ID代表白单ID,关联ID代表黄单ID,使用白单关联黄单的形式。

中调响应的报文中包含了执行信息节点,此节点说明如下:

此接口可能中调在不同的审批节点多次发送,每次发送一部分内容,直至检修单的状态为终结,如果中调执行状态为:已终结,已归档,已作废,其中一种,则电厂将此条检修单流转至归档

中调响应的报文中包含了中调延期信息,此部分内容包含在执行信息中:

中调延期的字段主要为:延期意见,延期后工作结束时间,专业签发人。这三个字段填充在检修单申请延期模块中,还有延期审批意见信息,填充在申请签发模块覆盖填写,其他字段暂时不做展示。

中调响应的报文中包含了方式变更单节点,此节点说明如下:

在输变电流程图中,通报黄单,黄单批复信息,下发黄单,三个功能合并在这一个接口调用。此接口中的业务ID为黄单ID,所有参数中不包含检修单ID
此处接口报文本身不关联白单关系,需要由白单主动关联黄单,如果某一个黄单没有被白单关联,则为纯黄单,没有白单。
70接口如何区分四种不同的内容?
仅通报单时需要区分,当接口报文字段中通报单位有值时,则为通报黄单,需要电厂填写通报回执,且只通报一次。
其他三种类型不用做区分,做到全部兼容即可,仅展示给电厂查看。

中调响应的报文中包含了白单关联状态节点,此节点说明如下:
此部分数据会在“接收中调批复信息”中的 “中调已处理”中展示。

3、电厂发送通报回执信息给中调(80)

输变电_电厂发送通报回执.xml0.7kB
响应信息为:OK 或者 错误信息。
此部分数据会在“接收中调批复信息”中的 “中调已处理”中展示。

2、年度机组检修申请(总共2个接口)

1、电厂发送年度检修计划到中调(10)

年度_机组_新增发送至中调.xml1.8kB
响应信息为:OK 或者 错误信息。

2、同步年度机组检修计划信息(电厂→中调→电厂)

电厂请求报文为:
年度_机组_同步_请求.xml0.5kB
中调响应报文为:
年度_机组_同步_响应.xml2.8kB


业务规则:

退回操作(当响应报文中退回信息节点中的交互类型退回时,则说明中调执行了退回操作,电厂将流程自动退回至【电厂年度计划编制】环节,电厂在原单中修改后再提交。)


归档操作(当响应报文中流程状态字段的值为:已完工 已归档 已作废 之一时,表明中调流程已完成,电厂应该将此流程流转至结束环节。)


其他中调的流程审批信息,在电厂表单中展示即可。

3、月度机组检修申请(总共3个接口)

1、电厂发送月度检修计划到中调(10)

月度机组检修_10.xml1.4kB
响应信息为:OK 或者 错误信息。

业务规则同年度

2、同步月度机组检修计划信息(电厂→中调→电厂)

电厂请求报文为:
月度_机组_同步_请求.xml0.4kB
中调响应报文为:
月度_机组_同步_响应.xml4kB

业务规则同年度

4、日前机组检修申请(总共6个接口)

1、电厂发送日前机组检修单给中调(10)

日前机组检修_10.xml3.5kB
响应信息为:OK 或者 错误信息。

2、同步日前机组检修单信息(电厂→中调→电厂)

电厂请求报文为:
日前_机组_同步_请求.xml0.5kB

业务规则同年度

中调响应报文为:
日前_机组_同步_响应.xml17kB

业务规则:

退回与归档同年度,同时还将下发 签发信息 执行信息 延期信息

3、电厂发送延期信息给中调

日前机组检修_50.xml0.4kB

业务规则:

电厂可发送延期的条件为:中调流程状态为中调执行,执行状态为待开工 开工操作任务中 正在检修中 其中之一,而且工期不能过半:当前时间不能超过批准工作开始时间批准工作结束时间之间的一半。

输变电检修单流程交互图

添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注