NCV6X-信息交换平台技术红皮书(4)

回一个回执信息，记录单据导入成功与否，以及失败的原因。回执信息也是一个XML文件，其一般格式如下： 12315601022323 -31202 单据12315601022323开始处理... (1)单据翻译转换错误:根据基础档案[部门档案]无法翻译[pk_deptdoc]字段,待翻译值:部门yk,翻译方式:按名称., 翻译参照的公司：yk。 (2)单据翻译转换错误:根据基础档案[岗位档案]无法翻译[pk_om_job]字段,待翻译值:测试,翻译方式:按名称., 翻译参照的公司：yk。 (3)单据翻译转换错误:根据基础档案[人员类别]无法翻译[pk_psncl]字段,待翻译值:测试人员yk,翻译方式:按名称., 翻译参照的公司：yk。 单据12315601022323处理错误:单据翻译转换错误:单据校验转换失败 图2.4.1 回执文档的一般格式

回执信息中还可以嵌套单据，这个时候可以将信息交换平台看作简单的信息中心，外系统发送过来一个消息，NC系统回应一个消息。如查询类的单据，外系统发送一个表示查询条件的信息，NC系统返回所有符合查询条件的单据，这些单据就是内嵌在回执信息中的。再如，用这个功能来实现NC系统和外系统在某种程度上的流程集成，外系统发送一张走流程平台的单据，然后再由信息交换平台返回流程平台处理后得到的单据。

第 13 页

异常和错误编码

异常信息对于使用信息交换平台是极为重要的，有助于实施人员分析数据导入结果，查找数据导入失败原因。信息交换平台中的异常分类：环境初始化异常、单据转换异常和业务插件处理异常。这个划分是基于一个外系统某单据类型的XML交换文档在导入NC系统过程中所需处理阶段而给出的。如果单据导入失败，那么在回执信息的中会给出发生了什么异常以及出错信息。如果需要更详细的出错信息，请检查后台日志，信息交换平台对于导入数据过程中发生的异常，记录在nchome/nclogs/server/pfxx-log.log日志文件中。

错误编码则直接定位于发生错误的分类：配置错误、数据错误、系统错误，然后在某种错误下再进行细分。这些错误信息都通过错误编码的方式在单据导入的回执信息的中给出。这些错误编码信息主要是给第三方系统程序内部用于识别数据交换过程中是否出现问题，以及具体出了什么问题，便于程序内进行控制。对于实施人员，如果拿到一份回执，只需要知道1表示正确传送，其他的代表各种错误码，一般均为负数。

对于无法翻译的文档，在回执中也有具体描述，其中段中 name表示改文档在外系统中对应的文档名称(如果nc基本档案资源列表里没有，则为基础数据对照表中对应外系统档案名称)，文本内容为其代翻译的值。

查询及回执格式样例

注册查询单据类型

第 14 页

生成交换规则

生成样本文件并保存为文件

第 15 页

修改样例

a a a a a a 2011-07-13 11:37:17 2011-07-13 11:37:17 N 第 16 页

0 0 a a a a a N 0 a a

插件样例

package pfxx.example11; import nc.bs.framework.common.NCLocator; import nc.bs.logging.Logger; import nc.bs.pfxx.ISwapContext; import nc.itf.uap.bd.accsubj.IAccsubjDataQuery; import nc.itf.uap.pfxx.IPFxxEJBService; import nc.vo.bd.b02.AccsubjVO; import nc.vo.pfxx.auxiliary.AggxsysregisterVO; import nc.vo.pfxx.exception.PfxxPluginException; import nc.vo.pfxx.util.PfxxPluginUtils; import nc.vo.pfxx.util.PfxxUtils; import nc.vo.pub.BusinessException; import org.w3c.dom.Document; import org.w3c.dom.Element; import org.w3c.dom.NodeList; 第 17 页