NCV5-外部交换平台技术红皮书

此文件受到UFIDA的保护, 并已在保护中心注册, 外泄必纠! UFIDA GUID1{9B556DBC-1AC6-8F37-3BF6-71C56F13F30F} UFIDA GUID1{A4D3866A-8E0A-C39D-50D4-050B0F9DB068}

外部交换平台 实施技术红皮书

NC-UAP 5.0

用友NC-UAP 2014-08-18

目 录

第一章

1. 2. 3.

第二章

1.

1.1

1.2

2. 3.

3.1 3.2 3.3

4.

4.1 4.2

5.

5.1 5.2 5.3 5.4 5.5 5.6 5.7 5.8

6.

6.1 6.2

第三章

1.

1.1 1.2 1.3

2.

2.1 2.2 2.3

总体概述 .................................................................................. 1

外部交换平台总体结构........................................................................... 1 外部交换平台功能特点........................................................................... 1 外部交换平台V50版新增功能 .............................................................. 2

实施简介及相关注意点 .......................................................... 4

实施方法简介........................................................................................... 4

外系统数据导入的一般步骤 ................................................................................... 4 外部交换平台服务器端文件目录结构 ................................................................... 5

Servlet的URL地址参数与XML交换文档头属性的关系 ................. 7 向NC系统发送数据方式 ....................................................................... 8

手动界面发送 ........................................................................................................... 8 后台预警发送 ........................................................................................................... 9 自定义程序发送 ..................................................................................................... 11

回执及异常出错信息............................................................................. 12

回执格式 ................................................................................................................. 12 异常和错误编码 ..................................................................................................... 12

外部交换平台总体参数设置................................................................. 13

单据导入方式 ......................................................................................................... 13 单篇最大传输上限 ................................................................................................. 14 导入过程是否记录中间文件 ................................................................................. 14 外部系统默认帐套 ................................................................................................. 14 设置客户端IP范围 ............................................................................................... 14 接收公司匹配规则 ................................................................................................. 15 回执文件后台备份 ................................................................................................. 15 回执和导出文件编码格式 ..................................................................................... 15

单据流水号和单据并发控制................................................................. 15

单据流水号的概念和作用 ..................................................................................... 15 单据并发控制 ......................................................................................................... 16

单据交换规则定义 ................................................................ 17

基础篇—简单单据配置......................................................................... 17

表头记录的配置 ..................................................................................................... 19 表体记录的配置 ..................................................................................................... 20 字段属性项的配置 ................................................................................................. 21

高级篇—复杂字段配置......................................................................... 29

VO记录的配置规则 .............................................................................................. 29 简单数组记录的配置规则 ..................................................................................... 31 VO数组记录的配置规则 ...................................................................................... 33

第 2 页

2.4 2.5 简单集合记录的配置规则 ..................................................................................... 35 VO集合记录的配置规则 ...................................................................................... 37

第四章

1. 2. 3. 4.

基于外部交换平台的单据集成开发 .................................... 43

注册单据相关信息................................................................................. 43 生成＆配置交换规则定义文件............................................................. 46 辅助信息项设置..................................................................................... 49 插件代码维护......................................................................................... 50

第 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) 对数据导入过程中的异常进行了重新划分，对于错误信息进行了编码。

前者带来的好处就是错误提示信息更加明确化，后者主要用于第三方系统程序内部识别导入过程中是否出现错误以及具体的错误信息。

第 2 页

百度搜索“77cn”或“免费范文网”即可找到本站免费阅读全部范文。收藏本站方便下次阅读，免费范文网，提供经典小说综合文库NCV5-外部交换平台技术红皮书在线全文阅读。