行业各直属单位：
　　为实现网上审批系统与各单位办公自动化系统的对接，统一国家局办公自动化系统接口标准，国家局信息中心组织有关人员制定了烟草行业网上审批系统与行业各单位办公自动化系统对接技术要求，现印发给你们。请结合本单位实际，认真做好系统对接程序的开发，并于8月1日前完成系统对接工作，实现网上申报材料的填写和提交，及时了解上报文件的接收和处理情况。本要求提供两种对接方式，各单位可根据工作需要和技术条件选择。
　　联系人：童培莉　 010-63605482
　　　　　　　　　　 tongpl@tobacco.gov.cn
　　技术服务电话：010-63605837　 63605849

二○○六年七月七日

 

 

目　 录
第一章 方式概述 1
第二章 对接条件 1
第三章 界面链接 2
3.1 功能描述 2
3.2 流程描述 2
3.3 对接开发要求 3
3.4 后台操作说明 3
3.5 示例代码 4
3.6 子系统ID的获得方法 4
第四章 公文及数据对接 6
4.1 功能描述 6
4.2 流程描述 6
4.3 对接开发要求 8
第五章 接口描述 8
5.1 MQ和配置文件配置 8
5.2 消息格式 8
5.3 中间库对接说明 17
第六章 MQ API 17
附表一、审批业务标识－名称对照表 18
附表二、组织UUID与组织名称对应表 20
第七章 数据结构 23
7.1 外国烟草制品来牌或来料加工审批 23
7.2 合作开发卷烟牌号审批 25
7.3 烟草专用机械出售审批 25
7.4 烟草专用机械报废审批 27
7.5 烟草专用机械租借审批 28
7.6 烟草专用机械转让审批 29
7.7 烟叶产、销、出口备货计划的编制与下达 31
7.8 使用进口烟叶计划的编制与下达 32
7.9 卷烟工业产、销、存计划的编制与下达 34
7.10 卷烟纸需求计划的编制与下达 35
7.11 进口滤嘴需求计划的编制与下达 36
7.12 卷烟商业购、销、存计划的编制与下达 37
7.13 省际间卷烟交易牌号审批 38
7.14 省际间卷烟联营加工审核 41
7.15 烟用丝束需求计划的编制与下达 43
7.16 审批状态ES 44

 

 

　　为方便各省级局(公司)和工业公司等单位通过行业网上审批系统完成行政审批项目的申报，制定本技术要求，以实现行业网上审批系统与各单位办公自动化系统对接。本要求是《烟草行业公文远程传输系统与省级局办公自动化系统对接技术规范》的补充，并与其保持技术兼容。
　　行业网上审批系统(以下简称"网上审批系统")与各单位的办公自动化系统(以下简称"各单位OA系统")实现对接后，项目申报人员可在本地计算机上完成申报材料的填写和提交，及时了解上报文件的接收情况和结果，提高工作效率。本要求提供两种对接方式，各单位可根据工作需要和技术条件选择：
　　1. 界面链接：
　　实现各单位OA系统与网上审批系统的界面链接，当用户登录各单位OA系统后，无需再次输入登录信息，即可登录网上审批系统，使用网上审批系统进行网上审批业务的填报，提交业务到省局文书管理员进行排版、盖章上报国家局。
　　2. 公文及数据的对接：
　　将各单位OA审核通过的公文及数据自动登记到网上审批系统，如果对接信息完整，则不需要修改，可以直接提交。
　　这样，业务承办人就可以方便的在"各单位OA系统"和"网上审批系统"之间进行切换，及业务申报、查询等工作。
　　在第三章和第四章中分别对"界面链接"和"公文及数据的对接"进行了介绍；第五章和第六章对"公文及数据的对接"涉及到的消息格式和MQ API 进行了介绍。

 

　　第二章 对接条件

　　1、 审批正文应是Word文档。
　　2、 使用MQ消息传输中间件作为双方对接的接口媒介。
　　3、 省局OA提供的MQ消息不能包含任何形式的签章。
　　4、 对接接口的内容是一个XML文档，正文和附件被使用ZIP格式压缩并BASE64编码后和公文要素一起存放XML文档中。

 

　　第三章 界面链接

　　3.1 功能描述
　　界面链接主要实现从"各单位OA系统"中方便的切换到"网上审批系统"，无需再次登录。
　　在"各单位OA系统"中增加一个"网上审批"按钮，用户点击该按钮，则弹出网上审批系统的申报界面。如下图：
　　3.2 流程描述
　　过程描述：
　　1、 用户登录"各单位OA"进行正常操作，需要进入"网上审批系统"时，点击"网上审批"按钮，直接进入"网上审批系统"。
　　2、 用户在"网上审批系统"的"在线申报"模块中选择要申报的业务，进入"申报业务"页面。
　　3、 填写业务标题、上传正文、填写数据(此项仅带数业务需要填写)之后，点击"提交"按钮。
　　4、 各单位公文传输文书管理员在"公文远程传输系统"中在"发文登记"列表中可以看到该公文，补充文号等要素，盖章之后即可发送国家局。
　　3.3 对接开发要求
　　点击上述"网上审批"按钮之后，各单位OA系统只需提供一个URL，URL的格式如下：
　　图：界面链接URL
　　说明：
　　1. "各单位OA系统"中，需要传入八个变量，即前置机 IP 地址、前置机端口号、当前登录人员的帐号、密码、人员名称、组织UUID、组织名称、子系统ID。并根据以上规则，组成链接 URL。
　　2. 其中组织UUID和子系统ID要与网上审批系统中的保持一致；对于一个单位来说，组织UUID和子系统ID是不变的，所以在获得之后，可以在程序中写入固定值。组织UUID的获得方法参照 附表二、组织UUID与组织名称对应表；子系统ID的获得方法参照 3.5 子系统ID的获得方法。
　　3. URL中传入的中文信息，需要经过UTF-8编码，否则的话可能会出现乱码问题。
　　3.4 后台操作说明
　　界面链接的后台操作主要实现人员的对接，流程如下：
　　注：以上流程由网上审批系统自动完成，需要注意的是如果出现权限冲突时，需要管理员手动的修改一下权限，具体操作方法请参考以前版本升级时下发的《toa_manual_webmaster_0507》文档。
　　3.5 示例代码
　　注：此示例代码仅供参考，可以不按此方法实现，但必须符合URL规则。
　　客户端代码：
　　linkurl = "http：//" + hostip + "：" + hostport + "/exap/ProvinceOAExchage?userid=" + userid + "&password=" + password+"&orguuid=" + orguuid + "&orgname=" + orgname + "&sysId=" + sysId + "&personName=" + personName; // 按规则组成 URL
　　URLEncoder.encode(linkurl)；// 对URL进行编码
　　window.open(linkurl); // 打开 URL
　　其中，hostip、hostport、userid、password、orguuid、orgname、sysId、personName是在各单位 OA 系统中，需要传入的八个变量。
　　3.6 子系统ID的获得方法
　　登录网上审批系统，将鼠标放在最上方"国家烟草专卖局"字样的后面，如下图：
　　点击右键－选择"查看源文件"，如下图：
　　在弹出的源文件中搜索(ctrl+F)"sysId"，如下图：
　　搜索到的结果sysId="+后面的数字就是需要传入的"子系统ID"。
　　例如上图中的子系统ID就是268。

 

　　第四章 公文及数据对接

　　4.1 功能描述
　　公文及数据对接主要实现公文、公文要素以及带数业务的数据的对接。
　　4.2 流程描述
　　4.2.1 纯文业务
　　过程描述：
　　1. "各单位OA系统"将公文放入MQ队列；
　　2. "网上审批系统"从MQ队列中获取该公文，如果验证无误，向各单位OA发送接收成功消息；
　　3. 业务承办人进入"网上审批系统"－"我的申报"模块，提交给公文远程传输系统，即文书管理员；
　　4. 文书管理员盖章并发送；
　　5. 国家局公文远程传输系统接收到该公文。
　　6. 各单位收到的国家局批复公文，通过"公文远程传输系统与省级局办公自动化系统对接接口"进入各单位OA系统。
　　对于未指定为网上审批申报材料的公文，还是按照《烟草行业公文远程传输系统与省级局办公自动化系统对接技术规范》执行。
　　4.2.2 带数业务对接
　　带数业务除了完成公文及公文要素的对接外(同纯文业务)，还要实现数据对接。
　　考虑到目前业务的数量，及各业务数据的数量比较多，所以数据的对接采用中间库来实现。具体流程如下：
　　1. 发文流程：
　　说明：
　　a) 用户――各单位OA系统中流转完成的公文，选择执行对接；
　　b) 各单位OA－网上审批对接程序――将公文及要素打包放入MQ队列中(同纯文业务)，并将数据写入中间库；
　　c) 网上审批系统――从MQ及中间库中获取信息，写入网上审批数据库；
　　d) 用户――进入"网上审批"系统，提交到公文传输；
　　e) 用户――进入"公文传输"系统，发送到国家局；
　　2. 收文流程：
　　说明：
　　a) 用户――在"公文传输"系统中签收国家局来文；
　　b) 公文传输――"公文传输"系统将公文写入MQ队列中；
　　c) 各单位OA－传输对接程序――从MQ队列中获取信息，写入各单位OA系统；
　　4.2.3 中间库
　　具体的中间库结构请参考《网上审批数据对接－中间库.doc》。
　　说明：
　　进行数据对接时，必须知道审批业务标识，否则将不能正常对接；具体业务标识对照请参考 附表一 审批业务标识－名称对照表 。
　　4.3 对接开发要求
　　公文与数据的对接依赖于"烟草行业公文远程传输系统与省级局办公自动化系统对接" 。
　　为了减少各单位OA系统的开发量，网上审批对接的xml数据包在公文传输的基础上进行了补充，具体的消息格式见第五章 接口描述。
　　审批业务标识需要与"网上审批系统"的业务标识保持一致，具体对应关系见 附表一 审批业务标识－名称对照。

 

　　第五章 接口描述

　　5.1 MQ和配置文件配置
　　"网上审批与各单位OA的对接"是在"公文传输与各单位OA对接"的基础上进行的补充，不需要再在MQ中进行任何配置。
　　配置文件在"公文传输与各单位OA对接"的基础不需要进行修改。
　　5.2 消息格式
　　5.2.1 公文数据包
　　"网上审批与各单位OA对接"在"公文传输与各单位OA对接"数据包的基础上增加以下要素：
　　序号 要素 英文标识 说明
　　1 公文UUID exap-uuid
　　2 申报名称 exap-name 申报业务的名称
　　3 审批业务标识 business-uuid 审批业务标识，此要素值不为空时，进行审批对接，需要与网上审批系统一致，具体对照参考附表一
　　数据包是一个以doc-package为根的XML文件，以下是数据包的Schema定义文件：
　　 公文数据包     公文标识* 文号 标题 有否盖章  00：秘密 01：机密 02：绝密   保密期限  00：普通 01：急件  02：特急    10：命令 13：决定 16：公告  19：通告 22：通知 25：通报  28：报告 31：批复 34：意见  37：议案 40：请示 43：会议纪要  46：函 49：批件 52：其他    10：外事 13：计划 16：经济运行  19：科技教育 22：法规 25：体改  28：财务 31：审计 34：纪检监察  37：专卖 40：人事 43：劳动  46：物资 49：进出口 52：卷烟销售  55：烟叶 58：烟草机械 61：卷烟交易  64：价格 67：烟机 70：其他   签发人 拟稿人/承办人 成文日期 发文机关 type： 0：主送，1：抄送，2：抄报   发送时间