外部交换平台操作手册

1、NC63导入凭证，最关键的问题是组织好NC能够解析的XML文件，此文档仅限于凭证能够导入，如有其他需要可查看红皮书总体架构:聿簟内容概要: 信慧交摸平台总体结构L1信息交换平台总体结构 信瓢交换平台均吸点 信息交演平台U5Q版春 番腐 信慧交换平台V55版新 康功兼 痘息交操平台V的趣新口志稹中何文基破收据时精助信息配件整理照期 照赛Servlet 樱牧孙杀统一的玄梏-_物物商建疆存XHL 处理器 解析电 麻林翻 悻转帙外邮泉线"朋W”品根地质归正抬橹觊明定义配置外系统的一般步骤;、注册外部系统。如果不存在可用的外系统的话，请在“外部系统信息设置”界面中注册一个外部系统。功能导航消息

2、中心 手动加载界面常用功脆靠百态窿棋平台 :集成平台 圄应用管理平台 国企it瞌效管理0财会计 国贯产管理勃提交换管理+辅助信息配置,宓峨痢j轴*手搬0戴界面交横平台日志松崎文件管理集成工具开发-旧对照衰，插件开发向导功葭写版候中心讣制系薪息设置新始 催改 刑悌默认匹比顾I报漏码返回基巧茶区 规则1depl组织w门疑翩2fi 113 rl亡白办g组翅_11隽单元期劳组织中加3acca&oa会计科目1谢4incKfWuJSidass收支项日丽5USflf用户除码6vouche<lyp«花江霓别控亩码7rnanceorfl_v组织3羿单元J时务组览版本信息雕码8agunun

3、 m gK跳孱才势核过麻湾检编09corp殂织t势单元一公司扬强码1。jntyp 结不神愧躺外部肩纸耐1器1外部会克花标12按编码或是按名称，会选择不同的翻译器翻译（根据要导入的 XML选择不同的）;例如：如果是按名称，但是导入文件配置确实编码就会出错二、准备外系统数据。这份数据可能是外系统直接输出的，也可能是二次开发人员通过写程序从第三方系统数据库中抓出来的，或者由 Excel格式或其他格式文件转换过来的。写这份数据时，可以参考NC安装盘附带的XML模板，XML文件头或者说文档头的属性项。例如：<ufinterfacc account- devie'jip billt/&quo

4、t;user, fHenajs二 sroupcodci= isci<hanEe= replace roottas3 北口加二。这些属性分为三类：必须设置的属性、根据Servlet的URL参数设置决定是否必设的属性和根据需要决定是否设置的属性；Servlet的URL地址的参数中指定的信息比在XML数据文件的文档头属性中指定的信息有更高的优先级别。比如在 Servlet的 URL地址参数中指定groupcode=yk ,而在 XML数据文件的文档头属性中指定 groupcode=yy ,则最终还是将数据发送到yk组织必须设置的属性billtype 属性，悭个属性值决定了这个XML文件（文档）

5、中所有单据的单据类型，信息交换平台所有的处理都是围绕单据类型的；sender 属性，L个属性值设置的是外系统编码，指定的是数据的来源系统，即习惯上所说的发送方。【根据Servlet的URL参数设置决定是否必设的属性】：这些属性其实也是必设属性，但如果Servlet的URL参数里面设置了这几个属性的话，XML文档头里面可以不设置这几个属性值，即使设置了也不会起作用。account 属性|这个属性指定要将数据导入至NC系统的哪个帐套。groupcode 属性，这个属性值指定接收集团的编码。【根据需要决定是否设置的属性】：filename 属性，卜数据导入过程中，对于每张单据我们都可以记录其原始数据

6、、翻译后数据，对整个文档我们也可以记录其导入后的回执信息，这个filename 属性的值就是用于记录上述数据文件时的文件名。当然，如果您没有设置的话，系统会为每个导入 的文档默认生成文件名。isexchange 属性，1个属性值决定了在外系统的数据在导入NC系统的过程中，是否使用信息交换平台提供的翻译转换和校验功能。正常情况下应将这个属性设置为“ Y ”，或者干脆不设。除非从其他 NC系统产生的符合 NC转换后标准的XML数 据直接导入NC系统，并且很多基础档案数据字段直接用的是PK值，此时可以设置属性为“ N ”和“ n ”，可避免无谓的翻译转换。replace属性，卜个属性值决定是否允许将

7、相同单据往同一个接收方重复导入。V50版的插件一般允许相同单据重复导入，除了将第一次导入视作新增之外，其余导入视作更新。关于这方面的具体内容请参见2.6节内容。如果不允许相同单据的重复导入，那么将这个属性值设置为“N ”或者“ n "。否则将其设置为“Y ”或者干脆不设operator属性，|这个属性指定当前发送方对应的nc操作员pk ,在手工加载界面会自动使用当前登陆用户pk,无需设置。对于外系统发送到 NC系统，需要在其发送url里加上对应得 NC操作员pk总的来说，XML文档头的【必须设置的属性】和【根据Servlet的URL参数设置决定是否必设的属性】，均为在外系统交换文档发

8、送过程中必须得到的初始化信息， 可以在Servlet的URL地址参数中设置，也可以在 XML文档头属性中设置，但必须进行设置。而对于XML文档头的【根据需要决定是否设置的属性】，也可以在 Servlet的URL地址的参数中设置，但一般不推荐这么做。导入数据 XML>板参照 NCHOME->pfxx->billdefine->模块（如 gl ）对应XML模板格式说明外部系统XML格式说明:UTOUKEIKECbU：!= re-torn-n-na ccdik*ewcc*设置NCHOME->pfxx->businessprossor路径下相应模块的值，此配置为NC

9、调用其内部方法处理，如凭证，则调用凭证相应的方法（保存，查询等） 三、配置辅助信息（可选）。如果要导入的单据数据需要辅助信息配置，在“辅助信息配置”界面根据外部系统、单据类型、接收组织为此次文件发送配置辅助信息。四、设置基础数据对照（可选）。如果要导入的单据数据需要作基础数据对照（对于需要参照基本档案的字段， 如果其值不能按名称或者编码自动翻译过来的话，在导入过程中系统会自动提示必须为该值做基础数据对照），在“基础数据对照”界面根据需要参照的外部系统、需要参照的基本档案、组织为需要对照的值做基础数据对照。五、五、配置Servlet的URL地址。将要发送至的帐套编码作为account属性值写入要

10、发送到的 Servlet的URL中（或者写入 XML文件的头中）；将接收集团编码作为groupcode 属性写入要发送到的 Servlet的URL中（或者写入 XML文件的头中）；将接收组织的代码作为receiver属性写入要发送到的 Servlet的URL中（或者XML文件的头中）http:W1O7.3 226:80JserYlce/XChangeServlet?account0001&groupco(je=xxreceiveiyy图 221 曲型 Servlet 的 URL ttirtib信息交换平台服务器端文件目录结构exportbills 目录，存放信息交换平台发送给外系统的数

11、据文件。billdefine 目录，存放所有需要交换的档案和单据的交换规则文件。auxiregister 目录，每个模块在这个目录下注册一个文件，文件的内容是模块所涉及单据的辅助信息格式。businessprocessor 目录，每个模块在这个目录下注册一个文件， 文件的内容是模块所涉及单据在信息交换平台的注册信息，如单据类型、业务插件类名称、元数据ID、单据加锁级别等。详细内容参考 4.1节注册单据相关信息。globalset.xml 用于存放信息交换平台的全局参数，如默认帐套、单篇最大传输上限等。hw r-V htvp- . asr 丁 *r，r - ar T st » e .*

12、 wfBa. 一. ,» f一-1) p£xx 1 auxiregi ster13 billdefinebusinessprocessor；T demodata_I exportbills+ n pfxxtempii 1 recei vedbills图2.11信息交换平台服务端文件目录结构已上步骤配置好了以后，就可以导入导入凭证了二1-下二 J”： ,-11*-手动加我界面回执查百刷到数羯文件型最Lcde幼侬件目录回执目帚拉载成功转移目录g上下文爨戳回面文件西大麴目包执文件卷名颇I:单启晒上隔I:箭加6址 nrips|白f后眄dmiim&lralortD1噌松口内且

13、山培日晒 CLSt 据文件g-YTYYMMDDH HMMSS1245卜皿31 m.D. 1:707期！sehMOft/xcn 自 口 g«s«Met?acou(vt=d«lop&groupcodg=i):粼据宴件名款掂文件大小KBJ敏建时回vduithef -副本eIa2017-03-02 23:3:17vDucher.xinl72017-03-09 14:S6:Q6vGucher123 -副本.xml62017-03-09 15g55.'Dueherl23.xml2017-03-09 15:15:55注：NC信息交换平台内置了常用单据类型数据的导入功能，对于这些单据类型,果外系统数据遵照了这些单据类型的交换规则定义（即如果外系统的数据严格按照NC安装盘附带的相应单据的 XML模板生成），那么按上述步骤相对比较简单地就可以导入数据。但是如果外系统数据未能遵照单据类型的交换规则定义，则需要修改该单据类 型的交换规则定义。做法就是将该单据的普通交换规则定义文件另存为特定该外部系 统的交换规则定义文件，并根据单据交换规则定义规范修改该特定交换规则定义文件,具体需要参见第三章单据交换规则定义