志可以准确定位一些常见的错误和问题。
详细日志
单据类型 发送文档单据类型 发送方 外部系统 接收方 接收组织 单据编号 文档id
是否成功接收 红叉表示失败 业务单据返回值 业务插件返回值 原始文档 原始输入文档
翻译后文档 交换平台翻译后文档
日志统计
统计一次发送的文档中的单据总数量、成功数量、失败数量
第 28 页
输入流监控
在往信息交换平台网络传输的过程中,不可避免地会出现网络传输错误、文档格式错误、文档翻译错误,和正常文档。因此准确定位错误类型,有助于快速解决问题。打开输入流监控,将降低系统性能。
在参数设置中打开输入流监控,这样所有通过信息交换平台传输的数据将会被记录。查看错误类型及查看出入文档原始文档
第 29 页
8. 翻译器配置
配置翻译器,可以根据用户需要创建个性化的翻译器。自定义翻译器需要实现nc.bs.pfxx.ITranslatorStrategy接口,并将新的翻译器类名注册到“自定义翻译器注册”界面
第 30 页
nc.bs.pfxx.ITranslatorStrategy接口说明:
1.translateExToNC(String srcValue, String metaDataID, ITranslateContext translateContext) 将外部数据翻译为NC主键。
2. translateNCToEx(String docPk, String metaDataID, ITranslateContext translateContext) 将NC主键翻译为外系统能够识别的数据。
上述两个方法中都有上下文ITranslateContext作为参数,该上下文中提供了当前集团主键,组织主键,外系统主键,翻译策略(仅按对照表;按PK;按编码;按名称)及用户自定义变量。
翻译器开发人员可以根据提供的上下文进行数据的翻译。
自定义变量的获取:
1) 可以通过定义的变量的名称作为key取得特定的数据。
如:可以通过ITranslateContext 的方法getUserdata(String key)取得特定的变量数据。 2) 可以通过配置的参数变量列表按顺序取得变量数据。
如:可以通过ITranslateContext的方法getTranslatorParams()取得变量列表,get(int)取得变量数据。
第 31 页
第三章 单据交换规则定义
本章介绍在“交换规则定义”界面上如何为在信息交换平台中注册的单据进
行外系统与NC系统之间交换规则的定义。信息交换平台除了支持内置单据的标准外系统数据以及U8系统数据的集成之外,利用单据交换规则定义扩展对其他外部系统(Sibeil,SAP等等)的第三方数据的集成的支持。关于单据交换规则的定义,我们分两部分来介绍,基础部分介绍如何完整地为一张单据配置交换规则,高级部分介绍单据交换规则中复杂字段及其对应结构的配置。
我们结合一个主子类型的单据的交换规则的配置,来介绍配置信息交换平台交换规则文件的一般知识。
1. 校验文件全局配置
我们建立了一个简单的主子表测试单据,单据类型是“exsystem”。在NC系统里为之建立exsystem的元数据,如下所示:
图3.1.1 主子单据元数据
借助于我们的插件开发向导,可以根据元数据实体生成XML的交换规则。图3.1.2就是根据该元数据信息自动生成的交换规则。但由于外系统数据与NC
第 32 页