金蝶K/3V14.3BOS客戶化開發工具包用戶手冊版權聲明本書著作權屬于金蝶軟體（中國）有限公司所有，在未經本公司許可的情況下，任何單位或個人不得以任何方式對本書的部分或全部內容擅自進行增刪，改編，節錄，翻譯，翻印，改寫。金蝶軟體（中國）有限公司2016年12月-1-前言感謝您使用《金蝶K/3V14.3客戶化開發工具包用戶手冊》。本手冊包含的內容可以幫助您進行有效的應用K/3ERP系統的客戶化工具包，主要包括以下內容： 系統總述 操作建議 詳細的操作流程 系統的功能和特點 系統設置在手冊的前言部分還向您提供了獲得其他幫助資訊的途徑及編寫約定。讀者對象本手冊假設您在本手冊涉及的業務領域具有較好的工作經驗和知識，並假設您對金蝶K/3產品基礎知識有整體的瞭解。如果您沒有使用過本系統，我們建議您接受一次或者更多的本子系統的培訓課程（請同金蝶本地分支機搆聯繫，獲得更多培訓資訊）。如果您希望瞭解更加深入的系統知識，如系統介面等，請先瞭解金蝶K/3系統架構、MSSQLSERVER知識和閱讀金蝶K/3系統技術文檔。相關資訊來源您還可以通過以下途徑瞭解我們的系統，並獲取您需要的服務和幫助。1.線上資訊如果您需要及時瞭解金蝶K/3產品動態，交流產品應用解決方案，可以登錄金蝶網站（http://www.kingdee.com/）。2.售前諮詢服務根據企業的發展和管理需要，提供管理諮詢及解決方案，幫助企業作出快速、準確的決策。3.產品培訓金蝶公司秉承技術創新、管理創新的宗旨，不斷提供給客戶完整的行業解決方案。在提供優秀產品的同時，不斷推出配套的培訓服務，幫助用戶在應用軟體時達到事半功倍的效果。4.實施諮詢服務金蝶公司吸收十多萬客戶的經驗，結合國內外先進的管理理念和管理軟體的實施-2-方法，推出符合中國國情的標準軟體實施方法--金手指實施方法。我們願意運用我們在企業管理及IT技術方面的知識，幫助顧客獲得更大的成功！5.現場支援服務我們的資深專業人員面對面地和您溝通，在運行現場對問題進行研究分析，使問題迅速得到解決。6.CRM服務借助客戶關係管理系統（金蝶EAS-CRM）我們建立了客戶綜合資訊管理庫，能夠快速地解決客戶的問題並保留歷史記錄，以便提供長期、持續、高效的服務。7.CSP服務支援金蝶公司融合多年客戶服務經驗與國外先進的管理思想，提煉出客戶常用的和最需要的服務為一體的CSP服務。它是以金蝶公司先進的科技手段和專業化的服務隊伍為依託，在業界領先推出的項目完整、功能全面的系統性服務產品。8.呼叫中心通過客戶呼叫中心服務（CallCenter），提供全面、周到的服務，快速解答客戶應用問題。9.個性化服務針對企業個性化的需求，我們提供"量身定制"服務，使用一切資源，包括和合作夥伴一道為您提供全面的應用解決方案。10.便利服務金蝶不僅是解決方案的提供者，也是相關附屬產品的提供者。我們提供的便利服務不僅省去您選擇的苦惱，還有利於保證相關產品和系統的相容性和一致性。11.合作聯盟服務我們和其他IT領域先導型的企業進行戰略合作，為您提供企業管理諮詢、系統集成、相關知識培訓等全方位的服務。在此，您不僅能得到金蝶的服務資源，也能以優惠的條件享受金蝶合作夥伴的資源。12.版本升級服務版本升級服務將使您隨時代的進步而保持投資的增值，以優惠的價格實現軟體"以舊換新"。金蝶K/3產品設計思想金蝶K/3以企業基礎管理為核心設計思想，對覆蓋產品（服務）價值鏈的業務的流程進行全面的計畫、組織、協調，及對業務的有效處理和有效控制的管理。針對戰略企業管理的特點，強調對企業基礎資料、基本業務流程、內部控制、知識管理、員工行為規範等管理，通過豐富的工具與方法有機整合並提供貫穿戰略企業管理全過程所需的決策資訊，即時監控戰略執行過程中的問題，幫助企業創造持續增長的核心競爭力。基礎管理是企業持續的管理實踐的基石。基礎管理的好壞決定了企業的戰略目標能否實現，也決定了企業持續發展是否有堅實的基礎。強調過程管理是基礎管理的特性，是因為它是能真實反映業務處理過程的第一手的、最詳盡的資料，使企業的業務決策和戰略決策建立在“理性＂的基礎上。關於金蝶金蝶國際軟體集團有限公司是亞太地區領先的企業管理軟體及電子商務應用解決方案供應商，是全球軟體市場中成長最快的獨立軟體廠商之一，是中國軟體產業的領導廠商。金蝶開發和銷售的軟體產品包括針對快速成長的新興市場中企業管理需求的企業管理軟體、通過互聯網提供服務的電子商務應用軟體和為企業構築電子商務平臺的中間件軟體。同時，金蝶向全球範圍內的顧客提供與軟體產品相關的管理諮詢、實施與技術服務。金蝶獨特的“快速配置，快速實施，快速應用，快速見效＂的全球化產品與服務定位，能夠幫助顧客從容面對不確定商業環境帶來的挑戰，實現業務流程與IT技術的完美結合，有效管理變革，確保組織快速、持續和健康成長。金蝶國際軟體集團有限公司是中國第一個WINDOWS版財務軟體；第一個純-3--4-JAVA中間件軟體；第一個基於互聯網平臺的三層結構的ERP系統—金蝶K/3的締造者，同時金蝶K/3還是中國中小型企業ERP市場中佔有率最高的企業管理軟體。2004年10月，金蝶正式對外發佈了新一代產品—金蝶EAS4.0(KINGDEEENTERPRISEAPPLICATIONSUITE)。金蝶EAS構建于金蝶自主研發的商業作業系統—金蝶BOS之上，面向中大型企業，採用最新的ERPⅡ管理思想和一體化設計，有超過50個應用模組高度集成，涵蓋企業內部資源管理、供應鏈管理、客戶關係管理、知識管理、商業智慧等，並能實現企業間的商務協作和電子商務的應用集成。編寫約定 通用格式約定格式意義宋體正文。下劃線輸入資訊。斜體提示資訊。 圖形介面格式約定格式意義“＂窗口名稱。〖〗普通功能表項或樹狀結構功能表項。【】視窗中的按鈕。<>表單中的選項。→連續選擇功能表及其子功能表或樹狀結構。 鍵盤操作約定格式意義[鍵1]鍵盤上的鍵名。[鍵1+鍵2]在鍵盤上同時按下兩個鍵。 滑鼠操作約定格式意義單擊按下滑鼠左鍵點擊某一對象。雙擊連續兩次滑鼠左鍵打開某一對象。右擊選中某一物件按下滑鼠右鍵。拖放按住滑鼠左鍵不放移動滑鼠到指定位置，放開滑鼠鍵。 特別標誌格式意義溫馨提醒：提醒某些操作可能會導致一些嚴重的後果，請用戶謹慎使用。注意：提供一些應用關鍵的描述。舉例：列舉實例以便用戶加深理解。操作前提：進行某一操作之前,必須先完成的操作。定義：定義內容中出現的財務或電腦術語。圖例說明本手冊中的主要業務流程均採用EPC（Event-driven-ProcessChain）圖進行描述。EPC全稱Event-driven-ProcessChain，即事件驅動的流程鏈方法，通過連接事件和任務，用戶可以明確地建立複雜的業務流程的模型，並開展分析。EPC方法不僅使用易於理解的符號和語言幫助用戶、諮詢顧問描述業務資訊系統，而且還集成了組織結構、功能、資料和資訊流等重要特性。EPC模型可以顯示出任務鏈和責任鏈發生中斷，將如何影響到公司優化其流程的能力。通過將組織與各個任務進行匹配，用戶可以非常方便地看到一個流程中涉及到哪些部門或崗位。EPC圖中涉及到的元素說明如下表：名稱圖示定義示例事件事件描述了狀態的發生，它反過來又充當了一個觸發器。收到原始憑證功能錄入憑證功能描述了初始狀態向最終狀態的轉換。組織單元組織單元描述了企業的大體結構。財務部會計科目資訊、物料、資源物件資訊、物料或者資源物件描述了現實世界中的物件（比如業務物件、實體）。流程路徑流程路徑顯示了流程之間的前後連接關係（可以輔助導航）。憑證處理流程邏輯操作符描述了事件和功能或流程之間的邏輯關係。邏輯操作符“XOR＂：表示從多個流程中，必須並且只能選擇其一；“V＂：表示“或＂的關係；“Λ＂：表示“且＂的關係。-5-控制流-6-控制流描述了事件和功能或流程之間的先後和邏輯依賴關係。資訊流/物流定義了某個功能是否被讀取、變更或者寫入。信息流、物流資源/組織單元分配描述了哪個單元（員工）或資源來處理某個功能或者流程。資源、組織單元分配意見回饋感謝您使用我們的產品及用戶手冊。在本手冊的最後附有意見回饋表，您可以在上面說明您對我們的產品或用戶手冊的意見和建議，並通過金蝶分支機搆或直接傳真至(0755)26615016K/3產品事業部回饋給我們,我們將期待您給予我們好的建議和意見。金蝶K/3BOS系统用户手册-1-目錄第1章系統概述.31.1系統構成..31.2系統特點..41.3系統在K3ERP中的位置.7第2章資料庫描述生成工具.92.1查看K/3資料庫結構.92.2增加自定義表、欄位..132.3生成描述SQL.142.4自定義sql維護資料字典注意事項..15第3章金蝶Schema編輯器.173.1方案操作..173.2Schema設置規範.203.3Schema編輯器工具的定位.24附錄A意見回饋表.25金蝶客戶化工具包用戶手冊第1章系統概述第1章系統概述隨著K/3系統的客戶越來越多，一些客戶有些特殊的需求在通用版中難以得到滿足。所以為了能解決這些客戶的需求，金蝶公司特別提供了客戶化開發工具包。利用這個工具包，客戶可以基於K/3系統做適當的二次開發以滿足特殊需要。客戶化工具包是提供給K/3產品的諮詢顧問、實施顧問和企業資訊建設人員，在K/3系統的基礎上通過這個工具包，為有特殊需求的K/3客戶進行行業版本的定制、製作特殊的報表、進行現有系統的功能擴展以及第三方系統集成等。1.1系統構成客戶化工具包是所有的二次開發支援工具、元件介面及其說明、資料字典和資料交換標準等資訊的全部集成。客戶化工具包中的內容都是從各業務子系統提煉、整理得來。下面就是本系統與其他系統的集成圖：3第1章系統概述金蝶客戶化工具包用戶手冊41.2系統特點客戶化工具包的特點是對外提供金蝶K/3系統的軟體標準、設計思想、設計原則，為二次開發人員提供一套基於K/3系統作二次開發的應用平臺，完整的開發工具和開發參考。客戶化工具包具有以下特點：A詳盡的資料字典B符合W3C規範的資料交換標準C實用的支援工具D完整的線上幫助E有代表性的示例代碼1.2.1詳盡的資料字典資料庫是K/3系統的技術核心，詳盡的資料字典也就是K/3資料庫表結構說明文檔。它可以讓有二次開發能力的用戶清楚K/3系統的資料存儲情況及表間的關聯關係。如果知道了資料是如何存儲的，那你就可以：A、通過SQL查詢語句直接查詢並輸出金蝶報表不提供的、但你又需要的部分資料。B、通過編程提供部分資料的操作介面，實現一些特殊功能。C、通過資料庫說明文檔直接編程實現資料交換，與其他軟體進行資料集成。1.2.2符合W3C規範的資料交換標準金蝶資料交換標準介面的特點是：採用W3C國際標準將K/3系統的業務物件定義成XMLSchema，並提供支援資料引入、引出的元件。將能通過XMLSchema檢查的XML資料文檔與K/3系統資料進行交換。金蝶資料交換標準介面包括：A、所有業務物件的交換介面說明B、所有業務物件的XMLSchema金蝶客戶化工具包用戶手冊第1章系統概述5C、金蝶Schema編輯器一、所有業務物件的交換介面說明業務物件的交換介面說明是一個Excel文檔。有相關的業務物件、物件包含的專案及其關聯關係的詳細說明。XMLSchema就是根據這份文檔中提供的物件、專案、關聯關係、來定義的。只要你的電腦上安裝了Excel，雙擊就可打開此文檔。二、所有業務物件的XMLSchema業務物件的XMLSchema是根據需要交換的內容進行的格式定義，是為了與K/3系統交換資料時，進行資料合法性校驗。可通過IE或金蝶Schema編輯器來查看其結構。三、金蝶Schema編輯器金蝶Schema編輯器是可以定義業務物件Schema的工具。最初是為了制定金蝶資料交換Schema而開發，現在將它提供給用戶，用戶可以用此工具定義其他業務物件的Schema。1.2.3實用的支援工具二次開發工具包是一個為二次開發或賬套數據檢查、升級時提供幫助的工具包，包含以下內容：A、補丁包安裝B、資料檢測C、賬套升級一、補丁包安裝當二次開發用戶自己開發了一些元件，或為在K/3資料庫中增加一張表而寫的SQL語句，該如何自動將這些組件和SQL載入到用戶端安裝目錄並註冊，或加入到中間層呢？補丁包中有相應的選項供你選擇，完成這些操作，並且可以將你的SQL語句執行到資料庫。二、資料檢測資料檢測是檢查用戶賬套的結構與最新資料庫結構是否一致，用戶的賬套數據是否完整。如果結構不一致或資料不完整有相應的詳細提示列表。用戶通過閱讀此提示日誌，根據實際需要手工或做其他處理，完善結構或資料以達到正確結果。三、賬套升級第1章系統概述金蝶客戶化工具包用戶手冊6賬套升級工具是提供金蝶財務軟體V6.2/3升級到K/3系統V8.0。然後用戶可從K/3系統V8.0升級到更高版本1.2.4完整的線上幫助金蝶SDK線上幫助是提供K/3系統業務物件元件的介面說明文檔。用戶通過閱讀此文檔，可以瞭解這些業務物件的哪些元件完成哪些功能，及其調用的方法。用戶在二次開發時可有選擇地調用這些元件完成相關的資料存取、功能擴展。金蝶SDK線上幫助包括：1、BaseDataExchange元件參考手冊2、BaseDataExChange2元件使用參考3、EBCGL元件參考手冊4、ExpImp80使用手冊5、K3客戶化開發工具包6、K3系統自定義主控台說明7、KFO元件參考手冊8、XMLKFO2參考手冊9、代理服務二次開發參考手冊10、商貿單據元件參考11、二次開發平臺VBA參考12、二次開發平臺應用方案13、發票介面參考手冊14、憑證介面參考手冊15、萬能報表參考手冊16、用戶登錄參考手冊金蝶客戶化工具包用戶手冊第1章系統概述7只要你的電腦上安裝了AdobeAcrobat4.0以上，雙擊以上參考手冊文檔就可打開流覽。1.2.5有代表性的示例代碼示例代碼是一系列業務元件介面調用的示例，完成一些與元件相關的報表查詢或維護功能等。這些示例代碼可以在二次開發平臺+VBA的環境下運行。1.2.6完整的BOS插件開發手冊金蝶BOS插件開發手冊是提供K/3BOS插件模型的介面說明文檔。用戶通過閱讀此文檔，可以瞭解這些BOS物件的提供的方法、屬性、函數及其調用的案例。用戶在二次開發時可有選擇地應用來完成相關的插件開發。1.3系統在K3ERP中的位置系統在K3ERP中的位置如下圖1-1所示：第1章系統概述金蝶客戶化工具包用戶手冊圖1-1系統在K/3ERP中的位置8金蝶客戶化工具包用戶手冊第2章資料庫描述生成工具9第2章資料庫描述生成工具資料庫描述生成工具主要用於萬能報表中文資料字典的維護、K/3資料庫結構的查看。通過該工具用戶可直接將新增資料庫表直接添加到萬能報表資料字典中。資料庫描述生存工具包括： 查看K/3資料庫結構 中文資料字典中增加自定義表 中文資料字典中增加自定義欄位 生成描述sql 自定義sql維護資料字典注意事項2.1查看K/3資料庫結構2.1.1登錄主介面安裝客戶化工具包後，進入BOSIDE，點擊功能表K3BOSSDK 二次開發工具 資料庫描述生成工具，顯示出K/3系統的統一登錄介面，選擇具體的賬套就可以進入資料庫描述生成工具。這裏，必須保證賬套的正確性、用戶、密碼的合法性。K/3系統的統一登錄介面，單擊[確定]，進入工具主介面（圖2-1）。第2章資料庫描述生成工具金蝶客戶化工具包用戶手冊圖2-1資料庫描述生成工具主介面2.1.2查看K/3資料庫結構1.在工具主介面中，列示了萬能報表表描述的詳細資訊：屬性說明資料庫顯示表代碼表ID您可以通過表ID，來識別該表是系統預設表或者用戶自定義新增表：一子系統內前5000ID（0<=ID<5000），為系統預設表；一子系統內後5000ID（5000<=ID<10000），為自定義表；T_TableDescription.FTableID表名稱資料庫表名T_TableDescription.FName表描述表的中文描述名稱T_TableDescription.FDescription10金蝶客戶化工具包用戶手冊第2章資料庫描述生成工具11所屬子系統當前表所屬子系統名的名稱T_TableDescription.FSubsytemID子系統名稱當前表所屬子系統的代碼T_SubSystem.FSubSysID表類型當前表屬於何種類型：FType=0，當前表顯示在萬能報表資料字典中；FType=1，當前表不在萬能報表資料字典中顯示；FType=3，當前表為視圖，且在萬能報表中顯示；T_TableDescription.FType生成SQL開關選中該選項，則能夠生成SQL語句；反之。2.根據需要將列示在介面上的資料字典，進行： 按子系統排序 按表排序； 查看某張表、欄位資訊；在“查找＂輸入框內，輸入表名，目標表將顯示在所有列表的最上面；3.查看目標表中，欄位描述資訊：1)選中一目標表，雙擊，彈出“維護表結構資訊＂介面，在該介面中，列示了當前表的屬性；資料項目目說明表名當前表的中文描述名表注釋對當前表的一些說明性文字是否自定義當前表是否是用戶自己新增的自定義表；如表被置為“自定義＂表，則在賬套升級到新版本時，該表描述以及其中的欄位描述不會被刪除，而繼續保留。用戶無需重新添加新表；對應資料庫T_Tabledescriptio.FSefDefSign（FSefDefSign=0，非自定義表；FSefDefSign=1，自定義表）；第2章資料庫描述生成工具金蝶客戶化工具包用戶手冊是否在萬能報表中顯示當前表是否在萬能報表資料字典中顯示；當為視圖時，該選項為禁用狀態，即：系統默認顯示在萬能報表中；對應資料庫T_Tabledescriptio.FType（FType=0，在萬能報表中顯示；FType=1，不在萬能報表中顯示）；圖2-2維護表結構資訊介面2)在“維護表結構資訊＂介面中，顯示當前表中所有欄位以及中文描述；屬性說明對應資料庫欄位欄位名資料庫欄位名T_FieldDescripTion.FFieldName欄位描述欄位中文描述T_FieldDescripTion.FDescription欄位類型欄位類型在萬能報表中，僅支援4種欄位類型：Integer、Float、String、T_FieldDescripTion.FFieldType12金蝶客戶化工具包用戶手冊第2章資料庫描述生成工具DateTime是否在報表中顯示當前欄位是否在萬能報表中文資料字典中顯示T_FieldDescripTion.FType備註對當前欄位的一些描述資訊T_FieldDescripTion.FNote是否自定義當前欄位是否是用戶自定義新添的、或者修改的欄位描述T_FieldDescripTion.FSefDefSign2.2增加自定義表、欄位在實際應用中，用戶常常會通過二次開發新增表，來存放企業特色資料資訊，這些資料同樣需要通過報表來進行分析、展示；允許用戶紛紛選擇萬能報表工具，但是系統預設萬能報表資料字典中根本沒有這些用戶自定義表描述資訊，此時，我們可以通過資料庫描述生成工具來完成表、欄位描述添加工作。1.在工具主介面的工具欄中，選擇“添加新增表＂，彈出“生成表及欄位描述表＂（圖2-3），在介面左邊的資料庫表列示框中，選擇需要在萬能報表資料字典中顯示的一張或者多張新增表（ctrl、shift鍵有效）；圖2-3生成表及欄位描述表2.將選中的新增表，添加到介面右邊的空白框中；3.在介面底部的“子系統ID＂列表中，選擇您將要把新增表添加到哪個子系統中。注意事項由於萬能報表是根據子系統進行許可權控制的，所以，務必保證添加道的目標子系統的正確無誤。13第2章資料庫描述生成工具金蝶客戶化工具包用戶手冊4.單擊“生成描述表＂，系統自動根據選擇的表和子系統，將表資訊添加到萬能報表表描述表（T_TableDescription）中；5.回到工具主介面，找到剛才我們添加的表，雙擊表，在“維護表結構資訊＂介面中，對表及欄位根據實際需要進行維護；注意事項•對於新增的表描述，一定要記得將選項“是否自定義表＂選上，這樣，在下次升級賬套時，您自定義維護的新增表才會繼續保存並顯示在資料字典中；•對於新增的欄位描述，一定要記得江選項“是否自定義欄位＂選上，這樣，在下次升級賬套時，您自定義維護的欄位描述才會繼續保存並顯示在資料字典中；•在資料庫描述生成工具中添加或修改完描述後，為保證這些新增、修改描述一定顯示在萬能報表資料字典中，請進行萬能報表後，使用“刷新K/3系統資料描述＂功能；•您可以通過任意一個方法，識別表是否自定義：1、表ID：一子系統內前5000ID（0<=ID<5000），為系統預設表；一子系統內後5000ID（5000<=ID<10000），為自定義表；2、直接查看“維護表結構資訊＂介面中“是否自定義表＂屬性；2.3生成描述SQL在升級賬套前，為保證升級後自定義表、欄位描述資訊的完整性，您還可以通過生成SQL語句功能，來將自定義表或者自定義欄位的描述sql語句保存成檔。步驟如下：選中您需要生成sql檔的自定義表，選擇“工具＂功能表下：1.第一步，標注無用表；2.第二步，更新資料類型；3.第三步，更新特殊類型；4.第四步，生成SQL語句（圖2-4）；圖2-4生成語句1)在｀生成SQL語句＇對話方塊，如需要生成自定義新增表的SQL描述，請選擇“自定義＂-“表描述＂；2)如需生成自定義欄位描述的SQL，請選擇“自定義＂-“欄位描述＂；14金蝶客戶化工具包用戶手冊第2章資料庫描述生成工具153)選擇並確定SQL檔保存位置；4)在賬套升級後，將這些SQL檔直接對賬套資料庫執行即可。注意事項如果，您只是生成部分表的描述SQL，請注意：生成SQL中表ID，與升級後的同表ID是否指的是同一個表，或者出現ID衝突，請仔細檢查；如，表為用戶自定義新增的表，請添加手工在sql中，將該表ID改為系統id+5000或5000以上的最大值+1；如，表為系統預設表，出現表ID衝突時手工在sql中，將該表ID改為最大表ID+1（表ID<5000）；2.4自定義sql維護資料字典注意事項如果您不是使用我們提供的“資料庫描述生成工具＂來進行新增表、欄位描述的維護，而是直接通過編寫sql來添加描述資訊，請根據以下規則進行：1.T_Tabledescription、T_Fielddescription中，新增表的表ID必須=當前子系統ID+5000，再新增表的表ID=當前子系統ID+5001，以此類推。例：在子系統“商業採購＂中，新增用戶自定義表t_def_notes，則該表ID為子系統ID：13+5000=135000；2.T_Tabledescription、T_Fielddescription中，欄位FSefDefSign=1（是否自定義為真）；金蝶客戶化工具包用戶手冊第3章金蝶Schema編輯器17第3章金蝶Schema編輯器Schema編輯器工具主要用於自動生成描述業務對象的Schema檔，產生的Schema檔符合W3C的標準。它使開發人員或業務人員在不熟悉W3C標準的情況下，也可以生成正確的符合W3C和金蝶資料交換標準的Schema檔。Schema編輯器工具包括：A、方案操作B、節點操作C、從資料庫引入功能介紹D、引入外部物件功能介紹E、生成Schema檔功能介紹F、生成資料灌入結構功能說明G、Schema規範及設置規範3.1方案操作3.1.1登錄主介面按照K/3系統的統一登錄介面，選擇具體的賬套就可以進入Schema自動生成工具。登錄前必須保證賬套正確，並且用戶是使用賬套的合法用戶以及當前帳套已經升級K/3V12.3。3.1.2方案操作方案是該工具中涉及到的一個比較重要的概念，一個方案可以生成一個獨立的Schema檔，在生成資料灌入結構中，也是按照方案生成的。在方案中可以描述一個或多個業務物件（建議是邏輯相關的多個業務物件的集合），在一個方案中除了自己定義一些節點外，還可以直接從資料庫引入業務物件的結構資訊，也可以從別的方案中引入允許作為外部引用的對象。第3章金蝶Schema編輯器金蝶客戶化工具包用戶手冊18一、新建方案新建一個方案，選擇〖方案〗→〖新建方案〗，Root節點作為起始節點，可以在下面增加業務物件的屬性節點。二、裝載方案可以打開以前的方案進行查看或編輯修改，選擇〖方案〗→〖打開方案〗。具體方案的選擇可以根據需要從“物件選擇介面＂的列表中選擇。三、設置方案屬性一個方案具有＜方案名稱＞、＜檔案名稱＞、＜功能變數名稱空間＞三個屬性。方案名稱標記方案；檔名稱為選擇生成相應的Schema檔時所對應的檔路徑和檔案名稱，如果省略路徑，則輸出到程式的當前路徑中；功能變數名稱空間是為了在檔內部標記不同的Schema檔，所以功能變數名稱空間一旦確定，最好不要修改，並且在整個系統中，功能變數名稱空間必須保證它的全局唯一性。如果需要改變以上三項中任一項的內容，請選擇〖方案〗→〖設置方案屬性〗。四、保存方案保存對當前方案的修改操作，選擇〖方案〗→〖保存方案〗，在保存時必須提供方案的名稱和功能變數名稱空間。在保存方案時，系統會檢查方案中各節點設置的正確性。如非葉節點命名的唯一性，同一層節點命名的唯一性等。五、關閉方案關閉當前的方案，同時新建一個方案，選擇〖方案〗→〖關閉方案〗。關閉時，系統會提示用戶保存所做的修改。六、刪除方案當一個方案打開後，可以執行刪除操作，選擇〖方案〗→〖刪除方案〗，方案一旦刪除就不可以恢復。並且它同時刪除在資料灌入中已經產生的關於該方案的資料庫臨時表的結構資訊，也不可以恢復。3.1.3節點操作節點代表著各個業務物件的屬性資訊。一、增加節點選擇〖節點〗→〖增加節點〗可以在非外部引用節點中增加節點。節點有多個資訊，含義分別闡述如下：資料項目說明英文名稱為節點名稱，在一個業務物件中，應該是唯一的。中文名稱或描述增加注釋資訊，可以存放中文名稱或者說明文字，資料類型節點的類型資訊，W3C的標準類型。當為非葉節點時，類型只能金蝶客戶化工具包用戶手冊第3章金蝶Schema編輯器19資料項目說明為[isRef]。數據長度表示數位中出現的字元的總個數（包括小數點）。小數位數有些資料類型可以設置資料的長度或小數位數。預設值當在XML資料檔案中，節點缺省時提供的數值。約束條件正則運算式，可以對該節點允許出現的數值進行約束。參考[正則運算式]。最小次數在資料檔案中，允許出現的最小次數。最小為0，最大為1。最大次數在資料檔案中，允許出現的最大次數。Unbounded表示允許出現無窮多次。枚舉類型當該節點是枚舉類型時，填入枚舉值。在枚舉類型下的方框中右擊【增加】、【刪除】增、刪枚舉值。允許為空在資料檔案中，是否允許出現空值。是否主鍵在該業務物件中，該節點是否為主鍵，或者屬於主鍵組的一部分。按鈕操作說明：單擊【保存】：保存對當前節點的修改。單擊【取消】：取消對當前節點的修改。單擊【應用】：保存對當前節點的修改，並體現在左邊的節點中。以上是“基本資訊＂的維護，下面還可以設置“擴展資訊＂：＜是否引出為外部物件＞：這個只對非葉子節點並且是非外部引用才有效。當選上＜是否引出為外部物件＞的核取方塊時，則該節點代表的業務物件可以在別的方案中被引用。並且在這個方案中的任何修改同時體現在引用該業務物件的方案中。否則不能在別的方案中被引用。＜是否為外部引用＞：當該業務物件為外部引用物件時，它所屬的任何節點都不能修改，當把一個業務物件從外部引用選為非外部引用時，則它的所有節點將作為該方案獨有的節點，不受其他方案的限制，就可以做任何的操作。注意：不能由非外部引用轉為外部引用。二、刪除節點選擇〖節點〗→〖刪除節點〗可以刪除任何一個非外部引用的節點。三、修改節點資訊可以選擇業務物件左邊的任何一個非外部引用的節點進行修改，修改內容可以是節點的基本屬性和擴展屬性中的任何一個屬性。四、上移節點單擊〖上移節點〗可以向上移動任何一個葉子節點。五、下移節點單擊〖下移節點〗可以向下移動任何一個葉子節點。第3章金蝶Schema編輯器金蝶客戶化工具包用戶手冊203.1.4從資料庫引入功能介紹選擇〖工具〗→〖從資料庫引入結構〗直接從K/3資料庫中引入業務物件的節點資訊，只能在葉節點中進行此項操作。從“物件選擇介面＂中列出的K/3資料庫表選擇需要用來定義Schema的表。3.1.5引入外部物件功能介紹選擇〖工具〗→〖引入外部物件〗可以直接引入在別的方案中產生的業務物件，或者是預定義的全局業務對象。外部引用的物件不能進行修改，並且該節點以不同的圖示表示。當在擴展屬性中將＜是否為外部引用＞核取方塊的選項去掉時，外部物件可在別的方案中更改，改變只體現在當前的方案中，Schema檔必須重新生成。3.1.6生成Schema檔功能介紹根據方案的設置選擇〖工具〗→〖生成Schema〗，產生業務物件描述的Schema檔。3.1.7生成資料灌入結構功能說明根據方案選擇〖工具〗→〖生成資料灌入結構〗，產生資料灌入中需要的臨時表的結構資訊。3.2Schema設置規範3.2.1方案設置的合法性在設置方案中，有多方面的限制用以符合W3C的標準和金蝶自己的標準。具體內容如下：1、在根節點Root下面不能直接存放葉子節點，必須放置代表業務物件的非葉子節點。2、節點的名稱不能為空，不能包含下劃線或者空白鍵。3、非葉節點命名不允許重複，除非是外部引用物件。4、非葉節點的資料類型必須為isRef，葉子節點的資料類型不允許為isRef。5、非葉子節點出現的最大次數大於1時，它的子節點中必須至少有一個主鍵。6、同一級節點的命名不允許出現重複情況。金蝶客戶化工具包用戶手冊第3章金蝶Schema編輯器217、不能交換identity欄位的值。8、一個節點不能由非外部引用改為外部引用。如果要這樣實現，先刪除該節點，再做外部引用。9、當為主鍵時，不允許為空。10、不允許修改外部引用物件。11、不能刪除已經被外部引用的業務物件以及該業務物件的方案。3.2.2相關的組件支援金蝶Schema編輯器運行的組件有：金蝶FlexBar，ADO2.5，MicrosoftXML4.0，金蝶KFO。3.2.3相關的資料庫結構資料灌入結構，Schema表，K/3資料庫表及欄位資訊表。3.2.4正則運算式在金蝶Schema編輯器中定義節點的約束條件的運算式，是引用W3C規範中支援的Unicode正則運算式規範，它跟Perl語言上的正則運算式相容。具體的語法請參看下面的示例。Pattern（正則運算式）的使用示例運算式正確的匹配Chapter\dChapter0,Chapter1,Chapter2..Chapter\s\dChapter後接空白符，回車換行符等，再接一個數字Chapter\s\wChapter後接空白符，回車換行符等，再接一個數位或字母EspanñolaEspañola\p{Lu}任意的大寫字母\p{IsGreek}任意的希臘字母a*xx,ax,aax,aaax..a?xax,xa+xax,aax,aaax..(a|b)+xax,bx,aax,abx,bax,bbx,aaax,aabx,abax,abbx,baax,babx,bbax,bbbx,aaaax..[abcde]xax,bx,cx,dx,ex第3章金蝶Schema編輯器金蝶客戶化工具包用戶手冊22[a-e]xax,bx,cx,dx,ex[-ae]x-x,ax,ex[ae-]xax,ex,-x[^0-9]x非數位字母後跟x\Dx數位字母後跟x.x任何字母後跟x.*abc.*1x2abc,abc1x2,z3456abchooray..ab{2}xabbxab{2,4}xabbx,abbbx,abbbbxab{2,}xabbx,abbbx,abbbbx..(ab){2}xababx3.2.5資料類型定義及對應說明支援金蝶Schema編輯器運行的組件有：金蝶FlexBar，ADO2.5，MicrosoftXML4.0，金蝶KFO。類型名稱說明String字串類型anyURIURI統一資源定位HexBinary16進制數Date日期類型Time時間類型DateTime日期時間類型Double雙精度64位浮點數Float單精確度32位浮點數Decimal任意精度的數值類型金蝶客戶化工具包用戶手冊第3章金蝶Schema編輯器23Boolean布林類型Integer整型有符號decimal.Long長整型-9223372036854775808+9223372036854775807Int整型-2147483648+2147483647Short短整型-32768+32767Byte0~255的整數參考nonNegativeIntegerUnsignedLong無符號長整型0~18446744073709551615UnsignedInt無符號整型0~4294967295UnsignedShort無符號短整型0~65535UnsignedByte0~255的整數0~255unsignedInteger無符號整型參考IntegernonPositiveInteger負整型參考IntegernegativeInteger負整型包含-號的整數，參考nonPositiveInteger.nonNegativeInteger正整數可以等於0positiveInteger正整數參考Integer3.2.6SqlServer與Schema資料類型對應關係支援金蝶Schema編輯器運行的組件有：金蝶FlexBar，ADO2.5，MicrosoftXML4.0，金蝶KFO。第3章金蝶Schema編輯器金蝶客戶化工具包用戶手冊24SqlServer資料類型Schema資料類型SqlServer資料類型Schema資料類型BigIntIntegerMoneyIntegerBitBooleanNcharStringCharStringNTextstringDateTimeDateTimeNumericDecimalDecimalDecimalNvarcharstringFloatDoubleRealFloatIntIntegerSmallDateTimeDateTimeSmallIntIntegerTinyIntunsignedIntSmallMoneyIntegerVarcharstringTextstring3.3Schema編輯器工具的定位該工具的使用物件為：1金蝶軟體研發中心的程式師2需要編寫與K/3系統進行資料交換的行業開發者3需要瞭解K/3系統如何定義資料交換標準的技術愛好者金蝶K/3客戶化工具包用戶手冊附錄A意見回饋表25附錄A意見回饋表《金蝶K/3客戶化工具包用戶手冊》1、請您對以下各項指標作出評價，並在相應的單元評價結果後面打“√＂非常滿意滿意一般不滿意內容正確內容完整使用方便表達清晰圖表形式整體意見2、您認為我們還需在哪些方面進行改進： 文字表達 專業性程度 結構編排 圖表說明 附錄形式 表述方式 目錄結構 增加典型實例 操作流程性說明 提供更多幫助請您對以上改進建議進行詳細說明：3、你對本手冊的哪些內容比較滿意4、其他建議5、為了我們能夠及時與您聯繫，請你填寫個人資訊：姓名：職稱：電話：E-mail：單位：地址：附錄A意見回饋表金蝶K/3客戶化工具包用戶手冊26
