外部交換平臺(tái)操作手冊

1、NC63導(dǎo)入憑證，最關(guān)鍵的問題是組織好NC能夠解析的XML文件，此文檔僅限于憑證能夠?qū)耄缬衅渌枰刹榭醇t皮書總體架構(gòu):聿簟內(nèi)容概要: 信慧交摸平臺(tái)總體結(jié)構(gòu)L1信息交換平臺(tái)總體結(jié)構(gòu) 信瓢交換平臺(tái)均吸點(diǎn) 信息交演平臺(tái)U5Q版春 番腐 信慧交換平臺(tái)V55版新 康功兼 痘息交操平臺(tái)V的趣新口志稹中何文基破收據(jù)時(shí)精助信息配件整理照期 照賽Servlet 櫻牧孫殺統(tǒng)一的玄梏-_物物商建疆存XHL 處理器 解析電 麻林翻 悻轉(zhuǎn)帙外郵泉線"朋W”品根地質(zhì)歸正抬櫓覬明定義配置外系統(tǒng)的一般步驟;、注冊外部系統(tǒng)。如果不存在可用的外系統(tǒng)的話，請?jiān)凇巴獠肯到y(tǒng)信息設(shè)置”界面中注冊一個(gè)外部系統(tǒng)。功能導(dǎo)航消息

2、中心 手動(dòng)加載界面常用功脆靠百態(tài)窿棋平臺(tái) :集成平臺(tái) 圄應(yīng)用管理平臺(tái) 國企it瞌效管理0財(cái)會(huì)計(jì) 國貫產(chǎn)管理勃提交換管理+輔助信息配置,宓峨痢j軸*手搬0戴界面交橫平臺(tái)日志松崎文件管理集成工具開發(fā)-舊對照衰，插件開發(fā)向?qū)Ч鐚懓婧蛑行挠囍葡敌较⒃O(shè)置新始 催改 刑悌默認(rèn)匹比顧I報(bào)漏碼返回基巧茶區(qū) 規(guī)則1depl組織w門疑翩2fi 113 rl亡白辦g組翅_11雋單元期勞組織中加3acca&oa會(huì)計(jì)科目1謝4incKfWuJSidass收支項(xiàng)日麗5USflf用戶除碼6vouche<lyp«花江霓別控畝碼7rnanceorfl_v組織3羿單元J時(shí)務(wù)組覽版本信息雕碼8agunun

3、 m gK跳孱才勢核過麻灣檢編09corp殂織t勢單元一公司揚(yáng)強(qiáng)碼1。jntyp 結(jié)不神愧躺外部肩紙耐1器1外部會(huì)克花標(biāo)12按編碼或是按名稱，會(huì)選擇不同的翻譯器翻譯（根據(jù)要導(dǎo)入的 XML選擇不同的）;例如：如果是按名稱，但是導(dǎo)入文件配置確實(shí)編碼就會(huì)出錯(cuò)二、準(zhǔn)備外系統(tǒng)數(shù)據(jù)。這份數(shù)據(jù)可能是外系統(tǒng)直接輸出的，也可能是二次開發(fā)人員通過寫程序從第三方系統(tǒng)數(shù)據(jù)庫中抓出來的，或者由 Excel格式或其他格式文件轉(zhuǎn)換過來的。寫這份數(shù)據(jù)時(shí)，可以參考NC安裝盤附帶的XML模板，XML文件頭或者說文檔頭的屬性項(xiàng)。例如：<ufinterfacc account- devie'jip billt/&quo

4、t;user, fHenajs二 sroupcodci= isci<hanEe= replace roottas3 北口加二。這些屬性分為三類：必須設(shè)置的屬性、根據(jù)Servlet的URL參數(shù)設(shè)置決定是否必設(shè)的屬性和根據(jù)需要決定是否設(shè)置的屬性；Servlet的URL地址的參數(shù)中指定的信息比在XML數(shù)據(jù)文件的文檔頭屬性中指定的信息有更高的優(yōu)先級(jí)別。比如在 Servlet的 URL地址參數(shù)中指定groupcode=yk ,而在 XML數(shù)據(jù)文件的文檔頭屬性中指定 groupcode=yy ,則最終還是將數(shù)據(jù)發(fā)送到y(tǒng)k組織必須設(shè)置的屬性billtype 屬性，慳個(gè)屬性值決定了這個(gè)XML文件（文檔）

5、中所有單據(jù)的單據(jù)類型，信息交換平臺(tái)所有的處理都是圍繞單據(jù)類型的；sender 屬性，L個(gè)屬性值設(shè)置的是外系統(tǒng)編碼，指定的是數(shù)據(jù)的來源系統(tǒng)，即習(xí)慣上所說的發(fā)送方。【根據(jù)Servlet的URL參數(shù)設(shè)置決定是否必設(shè)的屬性】：這些屬性其實(shí)也是必設(shè)屬性，但如果Servlet的URL參數(shù)里面設(shè)置了這幾個(gè)屬性的話，XML文檔頭里面可以不設(shè)置這幾個(gè)屬性值，即使設(shè)置了也不會(huì)起作用。account 屬性|這個(gè)屬性指定要將數(shù)據(jù)導(dǎo)入至NC系統(tǒng)的哪個(gè)帳套。groupcode 屬性，這個(gè)屬性值指定接收集團(tuán)的編碼?！靖鶕?jù)需要決定是否設(shè)置的屬性】：filename 屬性，卜數(shù)據(jù)導(dǎo)入過程中，對于每張單據(jù)我們都可以記錄其原始數(shù)據(jù)

6、、翻譯后數(shù)據(jù)，對整個(gè)文檔我們也可以記錄其導(dǎo)入后的回執(zhí)信息，這個(gè)filename 屬性的值就是用于記錄上述數(shù)據(jù)文件時(shí)的文件名。當(dāng)然，如果您沒有設(shè)置的話，系統(tǒng)會(huì)為每個(gè)導(dǎo)入 的文檔默認(rèn)生成文件名。isexchange 屬性，1個(gè)屬性值決定了在外系統(tǒng)的數(shù)據(jù)在導(dǎo)入NC系統(tǒng)的過程中，是否使用信息交換平臺(tái)提供的翻譯轉(zhuǎn)換和校驗(yàn)功能。正常情況下應(yīng)將這個(gè)屬性設(shè)置為“ Y ”，或者干脆不設(shè)。除非從其他 NC系統(tǒng)產(chǎn)生的符合 NC轉(zhuǎn)換后標(biāo)準(zhǔn)的XML數(shù) 據(jù)直接導(dǎo)入NC系統(tǒng)，并且很多基礎(chǔ)檔案數(shù)據(jù)字段直接用的是PK值，此時(shí)可以設(shè)置屬性為“ N ”和“ n ”，可避免無謂的翻譯轉(zhuǎn)換。replace屬性，卜個(gè)屬性值決定是否允許將

7、相同單據(jù)往同一個(gè)接收方重復(fù)導(dǎo)入。V50版的插件一般允許相同單據(jù)重復(fù)導(dǎo)入，除了將第一次導(dǎo)入視作新增之外，其余導(dǎo)入視作更新。關(guān)于這方面的具體內(nèi)容請參見2.6節(jié)內(nèi)容。如果不允許相同單據(jù)的重復(fù)導(dǎo)入，那么將這個(gè)屬性值設(shè)置為“N ”或者“ n "。否則將其設(shè)置為“Y ”或者干脆不設(shè)operator屬性，|這個(gè)屬性指定當(dāng)前發(fā)送方對應(yīng)的nc操作員pk ,在手工加載界面會(huì)自動(dòng)使用當(dāng)前登陸用戶pk,無需設(shè)置。對于外系統(tǒng)發(fā)送到 NC系統(tǒng)，需要在其發(fā)送url里加上對應(yīng)得 NC操作員pk總的來說，XML文檔頭的【必須設(shè)置的屬性】和【根據(jù)Servlet的URL參數(shù)設(shè)置決定是否必設(shè)的屬性】，均為在外系統(tǒng)交換文檔發(fā)

8、送過程中必須得到的初始化信息， 可以在Servlet的URL地址參數(shù)中設(shè)置，也可以在 XML文檔頭屬性中設(shè)置，但必須進(jìn)行設(shè)置。而對于XML文檔頭的【根據(jù)需要決定是否設(shè)置的屬性】，也可以在 Servlet的URL地址的參數(shù)中設(shè)置，但一般不推薦這么做。導(dǎo)入數(shù)據(jù) XML>板參照 NCHOME->pfxx->billdefine->模塊（如 gl ）對應(yīng)XML模板格式說明外部系統(tǒng)XML格式說明:UTOUKEIKECbU：!= re-torn-n-na ccdik*ewcc*設(shè)置NCHOME->pfxx->businessprossor路徑下相應(yīng)模塊的值，此配置為NC

9、調(diào)用其內(nèi)部方法處理，如憑證，則調(diào)用憑證相應(yīng)的方法（保存，查詢等） 三、配置輔助信息（可選）。如果要導(dǎo)入的單據(jù)數(shù)據(jù)需要輔助信息配置，在“輔助信息配置”界面根據(jù)外部系統(tǒng)、單據(jù)類型、接收組織為此次文件發(fā)送配置輔助信息。四、設(shè)置基礎(chǔ)數(shù)據(jù)對照（可選）。如果要導(dǎo)入的單據(jù)數(shù)據(jù)需要作基礎(chǔ)數(shù)據(jù)對照（對于需要參照基本檔案的字段， 如果其值不能按名稱或者編碼自動(dòng)翻譯過來的話，在導(dǎo)入過程中系統(tǒng)會(huì)自動(dòng)提示必須為該值做基礎(chǔ)數(shù)據(jù)對照），在“基礎(chǔ)數(shù)據(jù)對照”界面根據(jù)需要參照的外部系統(tǒng)、需要參照的基本檔案、組織為需要對照的值做基礎(chǔ)數(shù)據(jù)對照。五、五、配置Servlet的URL地址。將要發(fā)送至的帳套編碼作為account屬性值寫入要

10、發(fā)送到的 Servlet的URL中（或者寫入 XML文件的頭中）；將接收集團(tuán)編碼作為groupcode 屬性寫入要發(fā)送到的 Servlet的URL中（或者寫入 XML文件的頭中）；將接收組織的代碼作為receiver屬性寫入要發(fā)送到的 Servlet的URL中（或者XML文件的頭中）http:W1O7.3 226:80JserYlce/XChangeServlet?account0001&groupco(je=xxreceiveiyy圖 221 曲型 Servlet 的 URL ttirtib信息交換平臺(tái)服務(wù)器端文件目錄結(jié)構(gòu)exportbills 目錄，存放信息交換平臺(tái)發(fā)送給外系統(tǒng)的數(shù)

11、據(jù)文件。billdefine 目錄，存放所有需要交換的檔案和單據(jù)的交換規(guī)則文件。auxiregister 目錄，每個(gè)模塊在這個(gè)目錄下注冊一個(gè)文件，文件的內(nèi)容是模塊所涉及單據(jù)的輔助信息格式。businessprocessor 目錄，每個(gè)模塊在這個(gè)目錄下注冊一個(gè)文件， 文件的內(nèi)容是模塊所涉及單據(jù)在信息交換平臺(tái)的注冊信息，如單據(jù)類型、業(yè)務(wù)插件類名稱、元數(shù)據(jù)ID、單據(jù)加鎖級(jí)別等。詳細(xì)內(nèi)容參考 4.1節(jié)注冊單據(jù)相關(guān)信息。globalset.xml 用于存放信息交換平臺(tái)的全局參數(shù)，如默認(rèn)帳套、單篇最大傳輸上限等。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信息交換平臺(tái)服務(wù)端文件目錄結(jié)構(gòu)已上步驟配置好了以后，就可以導(dǎo)入導(dǎo)入憑證了二1-下二 J”： ,-11*-手動(dòng)加我界面回執(zhí)查百刷到數(shù)羯文件型最Lcde幼儂件目錄回執(zhí)目帚拉載成功轉(zhuǎn)移目錄g上下文爨戳回面文件西大麴目包執(zhí)文件卷名頗I:單啟曬上隔I:箭加6址 nrips|白f后眄dmiim&lralortD1噌松口內(nèi)且

13、山培日曬 CLSt 據(jù)文件g-YTYYMMDDH HMMSS1245卜皿31 m.D. 1:707期！sehMOft/xcn 自 口 g«s«Met?acou(vt=d«lop&groupcodg=i):粼據(jù)宴件名款掂文件大小KBJ敏建時(shí)回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信息交換平臺(tái)內(nèi)置了常用單據(jù)類型數(shù)據(jù)的導(dǎo)入功能，對于這些單據(jù)類型,果外系統(tǒng)數(shù)據(jù)遵照了這些單據(jù)類型的交換規(guī)則定義（即如果外系統(tǒng)的數(shù)據(jù)嚴(yán)格按照NC安裝盤附帶的相應(yīng)單據(jù)的 XML模板生成），那么按上述步驟相對比較簡單地就可以導(dǎo)入數(shù)據(jù)。但是如果外系統(tǒng)數(shù)據(jù)未能遵照單據(jù)類型的交換規(guī)則定義，則需要修改該單據(jù)類 型的交換規(guī)則定義。做法就是將該單據(jù)的普通交換規(guī)則定義文件另存為特定該外部系 統(tǒng)的交換規(guī)則定義文件，并根據(jù)單據(jù)交換規(guī)則定義規(guī)范修改該特定交換規(guī)則定義文件,具體需要參見第三章單據(jù)交換規(guī)則定義