信息交换平台 实施技术红皮书
NC-UAP 6.0
用友NC-UAP 2016-08-16
目 录
第一章
1. 2. 3. 4. 5.
总体概述 .................................................................................. 1
信息交换平台总体结构........................................................................... 1 信息交换平台功能特点........................................................................... 1 信息交换平台V50版新增功能 .............................................................. 2 信息交换平台V55版新增功能 .............................................................. 3 信息交换平台V60版新增功能 .............................................................. 3
第二章
1.
实施简介及相关注意点 .......................................................... 4
实施方法简介........................................................................................... 4
外系统数据导入的一般步骤 ................................................................................................... 4
信息交换平台服务器端文件目录结构 ................................................................................... 5
2. 3. Servlet的URL地址参数与XML交换文档头属性的关系 ................. 6 向NC系统发送数据方式 ....................................................................... 7
手动界面发送 ........................................................................................................................... 7 后台预警发送 ........................................................................................................................... 8 自定义程序发送 ..................................................................................................................... 11
4. 回执及异常出错信息............................................................................. 12
回执格式 ................................................................................................................................. 12 异常和错误编码 ..................................................................................................................... 14 查询及回执格式样例 ............................................................................................................. 14
5. 信息交换平台总体参数设置................................................................. 23
外部系统默认帐套 ................................................................................................................. 24 单篇最大传输上限 ................................................................................................................. 24 导入过程是否记录中间文件 ................................................................................................. 25 回执文件后台备份 ................................................................................................................. 25 回执和导出文件编码格式 ..................................................................................................... 25 单据导入规则设置 ................................................................................................................. 26 设置客户端IP范围 ............................................................................................................... 26
6. 单据流水号和单据并发控制................................................................. 26
单据流水号的概念和作用 ..................................................................................................... 26 单据并发控制 ......................................................................................................................... 27
7. 8. 日志查看................................................................................................. 27 翻译器配置............................................................................................. 30
第三章
1. 2. 3.
单据交换规则定义 ................................................................ 32
校验文件全局配置................................................................................. 32 表记录的配置......................................................................................... 34 字段属性项的配置................................................................................. 34
第 2 页
第四章
1. 2. 3. 4.
基于信息交换平台的单据集成开发 .................................... 44
注册单据相关信息................................................................................. 44 生成＆配置交换规则定义文件............................................................. 45 辅助信息项设置..................................................................................... 48 插件代码维护......................................................................................... 49
第五章 单据集成示例 ............................................................................ 51
1. 2. 3.
3.1 3.2 3.3 3.4 3.5
问题描述................................................................................................. 51 设计......................................................................................................... 51 具体开发指导......................................................................................... 51
单据插件信息注册 ................................................................................................. 51 单据转换规则定义 ................................................................................................. 51 插件代码编写和部署 ............................................................................................. 52 修改单据转换规则 ................................................................................................. 52 手动加载测试 ......................................................................................................... 53
第六章 安全 ............................................................................................ 54
1. 2.
加密类编写............................................................................................. 54 加密类注册............................................................................................. 56
第七章 扩展 ............................................................................................ 57 第八章 JMS及大文件传输模式 ........................................................... 59
1信息交换平台异步通信解决方案 ....................................................................... 59
1.1信息交换平台现状及存在的问题 ................................................................................... 59
1.2需求分析 ........................................................................................................................... 59 1.3 JMS简介 ........................................................................................................................... 60 1.3 JMS Client消息交互图 .......................................................................................... 62 1.5解决方案 ........................................................................................................................... 62
2.JMS传输模式 ....................................................................................................... 64 3. JMS Client For NC6.0 .......................................................................................... 65 4 大文件传输模式 .................................................................................................. 85
附录 ........................................................................................................... 86
1发送结果错误码 ................................................................................................... 86 2 K系统自定义项目档案样本defdoc.xml.............................................. 89
常见问题 .................................................................................................. 90
第 3 页
第一章 总体概述
1. 信息交换平台总体结构
日志和中间文件整理服务基础数据对照表辅助信息配置外系统自动发送数据手动加载数据XML数据包XML数据包ServletXML数据包接收外系统的文档XML数据包XML处理器解析数据并翻译转换NC业务模块适配器NC财务业务模块NC供应链业务模块自动加载代理外系统接收代理NC基础数据模块外部交换平台数据高速缓存外部系统注册转换规则定义
图 1.1.1 信息交换平台总体结构图
信息交换平台主要用于外部系统和NC系统进行集成。利用信息交换平台，可以将外系统的基本档案和业务数据发送到NC系统中，并进行相关的业务操作，如审批、弃审，也可以通过发送XML格式的查询条件导出NC系统的数据（需业务插件支持），导出的数据可以附着在回执文件中，也可以直接向外部系统回发HTTP请求。
2. 信息交换平台功能特点
? 采用XML格式作为统一的数据交换标准，为数据访问提供简便、 统一的
模式。XML格式在数据表达和描述方面有着很大的优势，逐渐成为业界的标准，采用XML格式作为交换标准格式可以很好的保护企业投资。
? 面向服务的架构。这使得第三方系统可以随时随地向NC系统发送相关
的业务数据，NC内部的预警服务及工作流引擎使得NC系统可以在合适的时候向第三方系统传送需要的数据，并且满足第三方系统的格式规范。
第 1 页
? 灵活配置。数据转换的规则可灵活定义，独立于应用集成和业务逻辑，
也就是说根据不同的外部数据结构，直接通过修改交换规则文件的定义，即可达到各种异构数据无缝集成的目的。
? 自由扩充。对于标准产品不支持的业务单据，如果有集成需求，信息交
换平台提供了向导式的二次开发工具，集成了所有与二次开发相关的功能及配置，支持动态部署，可以在用户环境上进行快速有效的开发。
3. 信息交换平台V50版新增功能
与信息交换平台V3序列产品相比，V50版信息交换平台在功能上得到了进一步的完善，在易用性上也有了很大改进。
1) 单据交换规则的定义更加丰富和灵活。可以为某一单据模型中的某一字
段定义路径，也可以为一个集合中的实体元素定义路径，甚至可以为某个字段定义XML结构查询的公式。这些都得益于对XPath功能的模拟，使得XML文件间结构转换的能力更强，但这个交换规则的学习成本可能比较大，后续版本需要图形化和简洁化。
2) 为基于信息交换平台的自定义单据的集成提供了一个快速开发工具。这
个工具以向导方式将集成一个自定义单据所要做的工作贯穿起来，包括：单据信息注册、校验文件生成、样本数据导出、辅助信息格式配置、业务插件类代码生成和编写，甚至还包括业务插件类代码的实时编译和部署，样本数据的导入测试和结果展示等。
3) 启用NCV50新缓存机制。这不但使得外部系统设置、辅助信息设置和基
础数据对照表的设置能够实时地作用于外部数据导入过程中，而且对于基本档案数据的访问也实现了实时性，效率得到了更高的优化。 4) 基础数据对照导入功能更加丰富。基础数据对照在V35版根据基本档案
自动增加的基础上，新增了基础数据对照的XML文件增加和EXCEL文件增加的功能。
5) 信息交换平台总体参数配置功能更加丰富和完整。这部分配置主要包括
单据导入方式、接收公司匹配规则、导入过程是否记录中间文件、回执和导出文件编码格式、设置客户端IP范围等，这些功能的可配置性极大地提高了信息交换平台的灵活性和可扩展性。
6) 对单据导入过程中的并发程度进行控制。对于某一单据类型，一共给出
了四种并发控制程度，实施人员可根据具体情况设置合理的并发控制级别，避免单据并发导入引发的错误。
7) 外系统数据实现后台异步发送。借助预警平台的定时触发功能，系统可
以自动将保存在服务端某个目录下的外系统数据导入NC系统中，实现了异步驻留的数据发送方式。
8) 对数据导入过程中的异常进行了重新划分，对于错误信息进行了编码。
前者带来的好处就是错误提示信息更加明确化，后者主要用于第三方系统程序内部识别导入过程中是否出现错误以及具体的错误信息。
9) 进一步约束信息交换平台导入单据的语义。对每个单据需要定义一个组
第 2 页