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

此文件受到UFIDA的保护, 并已在保护中心注册, 外泄必纠! UFIDA GUID1{9B556DBC-1AC6-8F37-3BF6-71C56F13F30F} UFIDA GUID1{A4D3866A-8E0A-C39D-50D4-050B0F9DB068} 外部交换平台 实施技术红皮书 NC-UAP 5.0 用友NC-UAP 2013-06-18 目 录 第一章 总体概述 1 1. 外部交换平台总体结构 1 2. 外部交换平台功能特点 1 3. 外部交换平台V50版新增功能 2 第二章 实施简介及相关注意点 4 1. 实施方法简介 4 1.1 外系统数据导入的一般步骤 4 1.2 外部交换平台服务器端文件目录结构 5 2. Servlet的URL地址参数与XML交换文档头属性的关系 7 3. 向NC系统发送数据方式 8 3.1 手动界面发送 8 3.2 后台预警发送 9 3.3 自定义程序发送 11 4. 回执及异常出错信息 12 4.1 回执格式 12 4.2 异常和错误编码 12 5. 外部交换平台总体参数设置 13 5.1 单据导入方式 13 5.2 单篇最大传输上限 14 5.3 导入过程是否记录中间文件 14 5.4 外部系统默认帐套 14 5.5 设置客户端IP范围 14 5.6 接收公司匹配规则 15 5.7 回执文件后台备份 15 5.8 回执和导出文件编码格式 15 6. 单据流水号和单据并发控制 15 6.1 单据流水号的概念和作用 15 6.2 单据并发控制 16 第三章 单据交换规则定义 17 1. 基础篇—简单单据配置 17 1.1 表头记录的配置 19 1.2 表体记录的配置 20 1.3 字段属性项的配置 21 2. 高级篇—复杂字段配置 29 2.1 VO记录的配置规则 29 2.2 简单数组记录的配置规则 31 2.3 VO数组记录的配置规则 33 2.4 简单集合记录的配置规则 35 2.5 VO集合记录的配置规则 37 第四章 基于外部交换平台的单据集成开发 43 1. 注册单据相关信息 43 2. 生成＆配置交换规则定义文件 46 3. 辅助信息项设置 49 4. 插件代码维护 50 总体概述 外部交换平台总体结构 图 1.1.1 外部交换平台总体结构图 外部数据交换平台主要用于外部系统和NC系统进行集成。利用外部数据交换平台，可以将外系统的基本档案和业务数据发送到NC系统中，并进行相关的业务操作，如审批、弃审，也可以通过发送XML格式的查询条件导出NC系统的数据（需业务插件支持），导出的数据可以附着在回执文件中，也可以直接向外部系统回发HTTP请求。 外部交换平台功能特点 采用XML格式作为统一的数据交换标准，为数据访问提供简便、 统一的模式数据转换的规则可灵活定义，独立于应用集成业务逻辑 实施简介及相关注意点 NC外部交换平台的主要功能就是将不同外系统的数据导入NC系统。由于不同系统之间对于相同单据的数据在表示上千差万别，需要外部交换平台对单据的XML格式的外系统数据进行格式转换和数值翻译，然后将转换后生成的XML格式的NC标准数据实例化为NC系统对应单据的数据对象，并调用业务模块的接口（服务）进行保存或者更新。 NC系统在后台有一个Servlet伺候服务，等待并处理客户端的POST方法请求（外部交换平台提供界面客户端和预警客户端，对于同步集成方式，外系统可以自定义发送客户端）。客户端往根据Servlet的URL建立的连接的输出流中写待发送数据文件的内容，而后台服务端则从请求的输入流中读取数据文件内容，然后再进行后续处理。关于客户端发送数据的具体内容请参考2.3节。 2.1节介绍了要将某个外系统的某种单据类型的数据文件导入至NC系统的最简单方法。其余小节介绍了在实施数据导入过程中容易混淆而需要注意的地方，或者是一些常用的工具等。 实施方法简介 外系统数据导入的一般步骤 外系统根据单据类型将相同单据类型的数据组织在一个XML文件中，然后将其发送到NC系统的某个账套下的某个公司或集团中（对于有账簿信息的单据而言，比如会计科目或者凭证，则是某个公司的某个账簿之下）。一般来说，如果需要发送某种单据类型的数据至NC系统中，需要如下几步： 一、注册外部系统。如果不存在可用的外系统的话，请在“外部系统信息注册”界面中注册一个外部系统。 二、准备外系统数据。这份数据可能是外系统直接输出的，也可能是二次开发人员通过写程序从第三方系统数据库中抓出来的，或者由Excel格式或其他格式文件转换过来的。写这份数据时，可以参考NC安装盘附带的XML模板，XML文件头或者说文档头的属性项请参照2.2节详细说明。 三、配置辅助信息（可选）。如果要导入的单据数据需要辅助信息配置，