水利电子招标投标监管试点对接说明文档 v0.1（草案）

# 第一步：环境准备

对接工作的环境准备包括准备软硬件资源、开通安全策略、部署配置小程序相关服务。

# 1.1 硬件网络环境

# 第一步、前置机的硬件配置

  交易平台准备两台独立的物理机或虚拟机，作为对接交换的前置机，提供2个公网IP，公网带宽合计不低于20M。前置机的作用为对内提供http接口、WebAPI接口，对外负责交换数据的路由转发。

  针对部署环境，前置机需要准备两台，一台用于正式环境，另一台用于测试对接。硬件配置参数如下：

序号 名称 类型 型号 台数 公网IP 带宽
1 生产服务器 PC服务器或虚拟机等(操作系统centos 7.9) 8C16G，硬盘1T 1台 20M以上
2 测试服务器 PC服务器或虚拟机等(操作系统centos 7.9) 4C16G，硬盘200G 1台 20M以上

  其中，生产环境硬盘空间划分目录结构说明：

磁盘名称 大小 说明
/ 100G 用于操作系统的基础环境及数据库
/data 900G 用于存放传输数据和附件文件

# 第二步、开通前置机(即交换机)和终端机的网络策略

  开通交换机公网访问策略使数据畅通，开通服务器内网IP到公网IP以如下防火墙开放策略列表中所有端口的一对一映射，例如： 内网IP 192.168.0.20 8850端口 映射到 47.94.148.221 8850

序号 环境类型 协议 端口号(区间) 出入站 说明
1 生产环境 TCP 8848-8858 出站 监督程序端口，对下级节点开放
2 生产环境 TCP 8088 入站/出站 管理平台的端口，管理平台可对交换机进行管理配置
3 生产环境 TCP 8089 入站/出站 交换机管理配置和数据传输开关端口
4 生产环境 TCP 9099、9111 入站/出站 文件传输端口，对上级下级节点开放
5 生产环境 TCP 9120 出站 访问管理节点端口
6 生产环境 TCP 9121 出站 访问远程仓库端口
7 生产环境 TCP 9122 入站(推荐) 运维管理平台端口，建议对中招办公网开放公网访问，方便维护部署
8 生产环境 TCP 9191 入站(推荐) 文件接收以及平台信息端口，建议中招办公网可访问，方便查看数据
9 生产环境 TCP 9180 入站(推荐) 数据传输测试端口，建议对中招办公网开放，方便部署完成后测试传输
10 生产环境 TCP 443 入站(推荐) https默认端口，建议对中招办公网开放公网访问，方便配置
11 测试环境 TCP 8848-8858 出站 监督程序端口，对下级节点开放
12 测试环境 TCP 8088 入站/出站 管理平台的端口，管理平台可对交换机进行管理配置
13 测试环境 TCP 8089 入站/出站 交换机管理配置和数据传输开关端口
14 测试环境 TCP 9099、9111 入站/出站 文件传输端口，对上级下级节点开放
15 测试环境 TCP 9120 出站 访问管理节点端口
16 测试环境 TCP 9121 出站 访问远程仓库端口
17 测试环境 TCP 9122 入站(推荐) 运维管理平台端口，建议对中招办公网开放公网访问，方便维护部署
18 测试环境 TCP 9191 入站(推荐) 文件接收以及平台信息端口，建议中招办公网可访问，方便查看数据
19 测试环境 TCP 9180 入站(推荐) 数据传输测试端口，建议对中招办公网开放，方便部署完成后测试传输
20 测试环境 TCP 443 入站(推荐) https默认端口，建议对中招办公网开放公网访问，方便配置

  开通终端机公网访问策略使数据畅通。

序号 环境类型 协议 端口号(区间) 内网出入站 说明
1 生产环境 TCP 8088 入站/出站 管理平台的端口，管理平台可对交换机进行管理配置
2 生产环境 TCP 8090 入站/出站 终端机管理配置和数据传输开关端口
3 生产环境 TCP 9099、9111 入站/出站 文件传输端口，对上级下级节点开放
4 生产环境 TCP 9120 出站 访问管理节点端口
5 生产环境 TCP 9121 出站 访问远程仓库端口
6 生产环境 TCP 9122 入站(推荐) 运维管理平台端口，建议对中招办公网开放公网访问，方便维护部署
7 生产环境 TCP 9191 入站(推荐) 文件接收以及平台信息端口，建议中招办公网可访问，方便查看数据
8 生产环境 TCP 9180 入站(推荐) 数据传输测试端口，建议对中招办公网开放，方便部署完成后测试传输
9 生产环境 TCP 443 入站(推荐) https默认端口，建议对中招办公网开放公网访问，方便配置
10 测试环境 TCP 8088 入站/出站 管理平台的端口，管理平台可对交换机进行管理配置
11 测试环境 TCP 8089 入站/出站 终端机管理配置和数据传输开关端口
12 测试环境 TCP 9099、9111 入站/出站 文件传输端口，对上级下级节点开放
13 测试环境 TCP 9120 出站 访问管理节点端口
14 测试环境 TCP 9121 出站 访问远程仓库端口
15 测试环境 TCP 9122 入站(推荐) 运维管理平台端口，建议对中招办公网开放公网访问，方便维护部署
16 测试环境 TCP 9191 入站(推荐) 文件接收以及平台信息端口，建议中招办公网可访问，方便查看数据
17 测试环境 TCP 9180 入站(推荐) 数据传输测试端口，建议对中招办公网开放，方便部署完成后测试传输
18 测试环境 TCP 443 入站(推荐) https默认端口，建议对中招办公网开放公网访问，方便配置

# 1.2 开发环境

# 第一步、部署实施阶段

  •  在前置机部署服务应用，包括小程序的服务端（含模板）、交换网络交换机和终端机。

  •  部署的小程序服务端应用，获取核心网页{MyDomain}:{Port}/{Path}/ebinterlinkintegrationindex.html，保留其链接作为交易平台集成小程序时的引用地址。

  •  部署的终端机的发送文件接口的host地址，在初始化接口中作为exchangeFileAddress字段值传入。

# 第二步、引入操作

# Web端小程序集成

  检查小程序可用性，链接小程序的引用地址，确保小程序可以正常引用和集成，小程序可用是引用页界面如下图：

image301

  复制如下代码中的div到业务页，通过iframe引入小程序，并对iframe的src属性赋值小程序的引用页ebinterlinkintegrationindex.html的完整地址。

<!DOCTYPE html>
<html>

<head>
    <title></title>
</head>

<body>
    <div>
        <div style="flex: 1;">
            <!-- 注意这里的src路径，需要改为交易平台部署在本地的小程序的完整链接，支持跨域 -->
            <iframe id="ebinterlinkintegration" height="100%" width="100%" frameborder="1" src="{MyDomain}:{Port}/{Path}/ebinterlinkintegrationindex.html"></iframe>
        </div>
    </div>
</body>

</html>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

# C#客户端小程序集成

  小程序功能的引入页是网页，需保证小程序可用性，打开小程序功能的引入地址，小程序运行正常可用的界面如下图：

image301

  从小程序的客户端demo中复制Ocx组件到项目中，通过LoadWebFrame(string url)方法传入小程序的引用页的地址，Ocx组件内的WebBrowser通过iframe引入加载小程序页：

        //业务窗体的Shown事件
        private void FormDemo_Shown(object sender, EventArgs e)
        {
            //定义小程序传回状态信息的事件
            ocx1.EbinterlinkintegrationReadyCallback += new Ocx.EventHandler(EbinterlinkintegrationReadyCallback);
            ocx1.LoadTemplateCallback += new Ocx.EventHandler(LoadTemplateCallback);
            ocx1.PreviousCallback += new Ocx.EventHandler(PreviousCallback);
            ocx1.SaveFileCallback += new Ocx.EventHandler(SaveFileCallback);
            ocx1.FinishCallback += new Ocx.EventHandler(FinishCallback);
            //引入小程序
            ocx1.LoadWebFrame(iframeUrl);
        }
1
2
3
4
5
6
7
8
9
10
11
12

← 第二步：选择对接方式 →