NCV6X-信息交换平台技术红皮书.doc

发布时间：2022-05-29 发布人：admin 分类：说明书资料大小：2.39M 资料格式：doc 举报版权申诉

ds590-10882258-4744302542872833955.doc.pdf-第1页.png

第1页 / 共95页

ds590-10882258-4744302542872833955.doc.pdf-第2页.png

第2页 / 共95页

ds590-10882258-4744302542872833955.doc.pdf-第3页.png

第3页 / 共95页

ds590-10882258-4744302542872833955.doc.pdf-第4页.png

第4页 / 共95页

ds590-10882258-4744302542872833955.doc.pdf-第5页.png

第5页 / 共95页

ds590-10882258-4744302542872833955.doc.pdf-第6页.png

第6页 / 共95页

ds590-10882258-4744302542872833955.doc.pdf-第7页.png

第7页 / 共95页

ds590-10882258-4744302542872833955.doc.pdf-第8页.png

第8页 / 共95页

第一章总体概述

1. 信息交换平台总体结构

2. 信息交换平台功能特点

3. 信息交换平台V50版新增功能

4. 信息交换平台V55版新增功能

5. 信息交换平台V60版新增功能

第二章实施简介及相关注意点

1. 实施方法简介

外系统数据导入的一般步骤

信息交换平台服务器端文件目录结构

2. Servlet的URL地址参数与XML交换文档头属性的关系

3. 向NC系统发送数据方式

手动界面发送

后台预警发送

自定义程序发送

4. 回执及异常出错信息

回执格式

异常和错误编码

查询及回执格式样例

5. 信息交换平台总体参数设置

外部系统默认帐套

单篇最大传输上限

导入过程是否记录中间文件

回执文件后台备份

回执和导出文件编码格式

单据导入规则设置

设置客户端IP范围

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

单据流水号的概念和作用

单据并发控制

7. 日志查看

8. 翻译器配置

第三章单据交换规则定义

1. 校验文件全局配置

2. 表记录的配置

3. 字段属性项的配置

第四章基于信息交换平台的单据集成开发

1. 注册单据相关信息

2. 生成＆配置交换规则定义文件

3. 辅助信息项设置

4. 插件代码维护

第五章单据集成示例

1. 问题描述

2. 设计

3. 具体开发指导

3.1单据插件信息注册

3.2单据转换规则定义

3.3插件代码编写和部署

3.4修改单据转换规则

3.5手动加载测试

第六章安全

1. 加密类编写

2. 加密类注册

第七章扩展

第八章 JMS及大文件传输模式

1信息交换平台异步通信解决方案

1.1信息交换平台现状及存在的问题

1.2需求分析

1.3 JMS简介

1.3JMS Client消息交互图

1.5解决方案

1.5.1．系统架构

1.5.2. 子集群详细架构：

2.JMS传输模式

3. JMS Client For NC6.0

3.1 JMS Client API

3.2 JMS 实例代码

4 大文件传输模式

附录

1发送结果错误码

2K系统自定义项目档案样本defdoc.xml

常见问题

信息交换平台实施技术红皮书 NC-UAP 6.0 用友 NC-UAP 2016-08-16

目录第一章总体概述...................................................................................1 1. 2. 3. 4. 5. 信息交换平台总体结构.......................................................................... 1 信息交换平台功能特点.......................................................................... 1 信息交换平台 V50 版新增功能............................................................. 2 信息交换平台 V55 版新增功能............................................................. 3 信息交换平台 V60 版新增功能............................................................. 3 第二章实施简介及相关注意点.......................................................... 4 1. 2. 3. 4. 5. 6. 7. 8. 实施方法简介.......................................................................................... 4 外系统数据导入的一般步骤.................................................................................................... 4 信息交换平台服务器端文件目录结构.................................................................................... 5 Servlet 的 URL 地址参数与 XML 交换文档头属性的关系................. 6 向 NC 系统发送数据方式.......................................................................7 手动界面发送.............................................................................................................................7 后台预警发送.............................................................................................................................8 自定义程序发送.......................................................................................................................11 回执及异常出错信息............................................................................ 12 回执格式...................................................................................................................................12 异常和错误编码.......................................................................................................................14 查询及回执格式样例.............................................................................................................. 14 信息交换平台总体参数设置................................................................ 23 外部系统默认帐套...................................................................................................................24 单篇最大传输上限...................................................................................................................24 导入过程是否记录中间文件.................................................................................................. 25 回执文件后台备份...................................................................................................................25 回执和导出文件编码格式...................................................................................................... 25 单据导入规则设置...................................................................................................................26 设置客户端IP 范围.................................................................................................................26 单据流水号和单据并发控制................................................................ 26 单据流水号的概念和作用...................................................................................................... 26 单据并发控制...........................................................................................................................27 日志查看................................................................................................ 27 翻译器配置............................................................................................ 30 第三章单据交换规则定义................................................................ 32 1. 2. 3. 校验文件全局配置................................................................................ 32 表记录的配置........................................................................................ 34 字段属性项的配置................................................................................ 34 第 2 页

第四章基于信息交换平台的单据集成开发....................................44 1. 2. 3. 4. 注册单据相关信息................................................................................ 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数据包 XML数据包 XML数据包 Servlet 接收外系统的文档 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 页

织字段，用于确保往某个接收方，比如说 A 公司做加载数据时，导入的数据能真正进入 A 公司，这个组织字段一般是公司或者主体账簿。为单据定义组织字段之后，如果数据里相应组织字段的值不为空，则要求其值与接受方保持一致，如果数据里相应组织字段的值为空，则取接受方的内容为组织字段的值。 10) 易用性改进。【手动加载界面】对文件目录、回执目录、目标 URL 地址、加载成功转移目录的配置增加记忆功能，就是说以相同公司相同用户登陆时，上述各项的配置内容默认显示为最后一次用户设置的值，避免用户每次都需要重新设置。【交换规则定义】增加了查找、定位字段的功能，单据交换规则树上的右击菜单也更加简练明确，同时为字段的导入导出公式定义增加新版本的公式编辑器，定义公式更加方便简洁。上述功能我们在接下来的内容中会具体提到。 4. 信息交换平台 V55 版新增功能 1) 最大传输上限界面最大 20M 2) 业务插件扩展功能见第七章扩展 3) 基础数据对照界面 EXCEL 内外对照数据导入分为两列，其中第一列为外系统值，第二列为 NC 所对应值，系统会自动检查 NC 值的合法性，不合法则置空。 4) 交换规则增加合并功能 5) Ufinterfacevo 填充 NC 操作员信息 6) 增加日志统计和输入流监控，便于进行日志分析，定位网络错误 5. 信息交换平台 V60 版新增功能 1) 信息交换平台全面支持 NCV60 元数据进行数据处理。 2) 增加自定义翻译器注册界面，可以建立自定义的翻译器。 3) 插件开发向导支持通过元数据和 VO 类生产交换规则。 4) 对枚举类型数据的自动转换。第 3 页

第二章实施简介及相关注意点 NC 信息交换平台的主要功能就是将不同外系统的数据导入 NC 系统。由于不同系统之间对于相同单据的数据在表示上千差万别，需要信息交换平台对单据的 XML 格式的外系统数据进行格式转换和数值翻译，然后将转换后生成的 XML 格式的 NC 标准数据实例化为 NC 系统对应单据的数据对象，并调用业务模块的接口（服务）进行保存或者更新。 NC 系统在后台有一个 Servlet 伺候服务，等待并处理客户端的 POST 方法请求（信息交换平台提供界面客户端和预警客户端，对于同步集成方式，外系统可以自定义发送客户端）。客户端往根据 Servlet 的 URL 建立的连接的输出流中写待发送数据文件的内容，而后台服务端则从请求的输入流中读取数据文件内容，然后再进行后续处理。关于客户端发送数据的具体内容请参考 2.3 节。 2.1 节介绍了要将某个外系统的某种单据类型的数据文件导入至 NC 系统的最简单方法。其余小节介绍了在实施数据导入过程中容易混淆而需要注意的地方，或者是一些常用的工具等。 1. 实施方法简介外系统数据导入的一般步骤外系统根据单据类型将相同单据类型的数据组织在一个 XML 文件中，然后将其发送到 NC 系统的某个账套下的某个组织中。一般来说，如果需要发送某种单据类型的数据至 NC 系统中，需要如下几步：一、注册外部系统。如果不存在可用的外系统的话，请在“外部系统信息设置”界面中注册一个外部系统。二、准备外系统数据。这份数据可能是外系统直接输出的，也可能是二次开发人员通过写程序从第三方系统数据库中抓出来的，或者由 Excel 格式或其他格式文件转换过来的。写这份数据时，可以参考 NC 安装盘附带的 XML 模板，XML 文件头或者说文档头的属性项请参照 2.2 节详细说明。三、配置辅助信息（可选）。如果要导入的单据数据需要辅助信息配置，在 “辅助信息配置”界面根据外部系统、单据类型、接收组织为此次文件发送配置辅助信息。四、设置基础数据对照（可选）。如果要导入的单据数据需要作基础数据对照（对于需要参照基本档案的字段，如果其值不能按名称或者编码自动翻译过来的话，在导入过程中系统会自动提示必须为该值做基础数据对照），在“基础数据对照”界面根据需要参照的外部系统、需要参照的基本档案、组织为需要对照第 4 页

的值做基础数据对照。六、配置 Servlet 的 URL 地址。将要发送至的帐套编码作为 account 属性值写入要发送到的 Servlet 的 URL 中（或者写入 XML 文件的头中）；将接收集团编码作为 groupcode 属性写入要发送到的 Servlet 的 URL 中（或者写入 XML 文件的头中）；将接收组织的代码作为 orgcode 属性写入要发送到的 Servlet 的 URL 中（或者 XML 文件的头中）。详细说明请参见 2.2 节。最后，就可以利用客户端触发该单据类型的数据文件的发送了。 NC 信息交换平台内置了常用单据类型数据的导入功能，对于这些单据类型，如果外系统数据遵照了这些单据类型的交换规则定义(即如果外系统的数据严格按照 NC 安装盘附带的相应单据的 XML 模板生成)，那么按上述步骤相对比较简单地就可以导入数据。但是如果外系统数据未能遵照单据类型的交换规则定义，则需要修改该单据类型的交换规则定义。做法就是将该单据的普通交换规则定义文件另存为特定该外部系统的交换规则定义文件，并根据单据交换规则定义规范修改该特定交换规则定义文件，具体需要参见第三章[单据交换规则定义]，然后再行导入。对于非系统内置或者自定义的单据的导入，需要基于信息交换平台做二次开发，这部分内容可参见第四章。信息交换平台服务器端文件目录结构信息交换平台服务端的目录结构安排如图 2.1.1 所示，其中 NC_COMMON 为安装盘根目录，也是中间件的工作目录。从上图可以看出，信息交换平台配置文件目录 pfxx 与 webapps 一样同在安装盘根路径下，其中： pfxxtemp 目录，存贮信息交换平台接受到的原始数据文件、转换翻译完毕的标准 XML 文件、传送失败的文件。 exportbills 目录，存放信息交换平台发送给外系统的数据文件。 billdefine 目录，存放所有需要交换的档案和单据的交换规则文件。 auxiregister 目录，每个模块在这个目录下注册一个文件，文件的内容是模块所涉及单据的辅助信息格式。详细情况参考 4.3 节辅助信息项设置。 businessprocessor 目录，每个模块在这个目录下注册一个文件，文件的内容是模块所涉及单据在信息交换平台的注册信息，如单据类型、业务插件类名称、元数据 ID、单据加锁级别等。详细内容参考 4.1 节注册单据相关信息。 globalset.xml 用于存放信息交换平台的全局参数，如默认帐套、单篇最大传输上限等。第 5 页

分享到：

赞收藏

资料库

NCV6X-信息交换平台技术红皮书.doc

相关推荐

开发技术

热门标签

最新资料