金蝶KIS旗舰版BOS客户化开发工具包用户手册本书著作权属于金蝶软件（中国）有限公司所有，，任何单位或个人不得以任何方式对本书的部分或全部内容擅自进行增删，改编，节录，翻译，翻印，改写。金蝶软件（中国）有限公司-1-前言感谢您使用《金蝶KIS旗舰版客户化开发工具包用户手册》。本手册包含的内容可以帮助您进行有效的应用KISERP系统的客户化工具包，主要包括以下内容： 系统总述 操作建议 详细的操作流程 系统的功能和特点 系统设置在手册的前言部分还向您提供了获得其它帮助信息的途径及编写约定。读者对象本手册假设您在本手册涉及的业务领域具有较好的工作经验和知识，并假设您对金蝶KIS产品基础知识有整体的了解。如果您没有使用过本系统，我们建议您接受一次或者更多的本子系统的培训课程（请同金蝶本地分支机构联系，获得更多培训信息）。如果您希望了解更加深入的系统知识，如系统接口等，请先了解金蝶KIS系统架构、MSSQLSERVER知识和阅读金蝶KIS系统技术文档。相关信息来源您还可以通过以下途径了解我们的系统，并获取您需要的服务和帮助。1.在线信息如果您需要及时了解金蝶KIS产品动态，交流产品应用解决方案，可以登录金蝶网站（http://www.kingdee.com/）。2.售前咨询服务根据企业的发展和管理需要，提供管理咨询及解决方案，帮助企业作出快速、准确的决策。3.产品培训金蝶公司秉承技术创新、管理创新的宗旨，不断提供给客户完整的行业解决方案。在提供优秀产品的同时，不断推出配套的培训服务，帮助用户在应用软件时达到事半功倍的效果。4.实施咨询服务金蝶公司吸收十多万客户的经验，结合国内外先进的管理理念和管理软件的实施-2-方法，推出符合中国国情的标准软件实施方法--金手指实施方法。我们愿意运用我们在企业管理及IT技术方面的知识，帮助顾客获得更大的成功！5.现场支持服务我们的资深专业人员面对面地和您沟通，在运行现场对问题进行研究分析，使问题迅速得到解决。6.CRM服务借助客户关系管理系统（金蝶EAS-CRM）我们建立了客户综合信息管理库，能够快速地解决客户的问题并保留历史记录，以便提供长期、持续、高效的服务。7.CSP服务支持金蝶公司融合多年客户服务经验与国外先进的管理思想，提炼出客户常用的和最需要的服务为一体的CSP服务。它是以金蝶公司先进的科技手段和专业化的服务队伍为依托，在业界领先推出的项目完整、功能全面的系统性服务产品。8.呼叫中心通过客户呼叫中心服务（CallCenter），提供全面、周到的服务，快速解答客户应用问题。9.个性化服务针对企业个性化的需求，我们提供"量身定制"服务，使用一切资源，包括和合作伙伴一道为您提供全面的应用解决方案。10.便利服务金蝶不仅是解决方案的提供者，也是相关附属产品的提供者。我们提供的便利服务不仅省去您选择的苦恼，还有利于保证相关产品和系统的兼容性和一致性。11.合作联盟服务我们和其它IT领域先导型的企业进行战略合作，为您提供企业管理咨询、系统集成、相关知识培训等全方位的服务。在此，您不仅能得到金蝶的服务资源，也能以优惠的条件享受金蝶合作伙伴的资源。12.版本升级服务版本升级服务将使您随时代的进步而保持投资的增值，以优惠的价格实现软件"以旧换新"。-3-金蝶KIS产品设计思想金蝶KIS以企业基础管理为核心设计思想，对覆盖产品（服务）价值链的业务的流程进行全面的计划、组织、协调，及对业务的有效处理和有效控制的管理。针对战略企业管理的特点，强调对企业基础数据、基本业务流程、内部控制、知识管理、员工行为规范等管理，通过丰富的工具与方法有机整合并提供贯穿战略企业管理全过程所需的决策信息，实时监控战略执行过程中的问题，帮助企业创造持续增长的核心竞争力。基础管理是企业持续的管理实践的基石。基础管理的好坏决定了企业的战略目标能否实现，也决定了企业持续发展是否有坚实的基础。强调过程管理是基础管理的特性，是因为它是能真实反映业务处理过程的第一手的、最详尽的资料，使企业的业务决策和战略决策建立在“理性”的基础上。关于金蝶金蝶国际软件集团有限公司是亚太地区领先的企业管理软件及电子商务应用解决方案供应商，是全球软件市场中成长最快的独立软件厂商之一，是中国软件产业的领导厂商。金蝶开发和销售的软件产品包括针对快速成长的新兴市场中企业管理需求的企业管理软件、通过互联网提供服务的电子商务应用软件和为企业构筑电子商务平台的中间件软件。同时，金蝶向全球范围内的顾客提供与软件产品相关的管理咨询、实施与技术服务。金蝶独特的“快速配置，快速实施，快速应用，快速见效”的全球化产品与服务定位，能够帮助顾客从容面对不确定商业环境带来的挑战，实现业务流程与IT技术的完美结合，有效管理变革，确保组织快速、持续和健康成长。-4-编写约定 通用格式约定格式意义宋体正文。下划线输入信息。斜体提示信息。 图形界面格式约定格式意义“”窗口名称。〖〗普通菜单项或树状结构菜单项。【】窗口中的按钮。<>窗体中的选项。→连续选择菜单及其子菜单或树状结构。 键盘操作约定格式意义[键1]键盘上的键名。[键1+键2]在键盘上同时按下两个键。 鼠标操作约定格式意义单击按下鼠标左键点击某一对象。双击连续两次鼠标左键打开某一对象。右击选中某一对象按下鼠标右键。拖放按住鼠标左键不放移动鼠标到指定位置，放开鼠标键。 特别标志格式意义温馨提醒：提醒某些操作可能会导致一些严重的后果，请用户谨慎使用。注意：提供一些应用关键的描述。举例：列举实例以便用户加深理解。操作前提：进行某一操作之前,必须先完成的操作。-5-定义：定义内容中出现的财务或计算机术语。图例说明本手册中的主要业务流程均采用EPC（Event-driven-ProcessChain）图进行描述。EPC全称Event-driven-ProcessChain，即事件驱动的流程链方法，通过连接事件和任务，用户可以明确地建立复杂的业务流程的模型，并开展分析。EPC方法不仅使用易于理解的符号和语言帮助用户、咨询顾问描述业务信息系统，而且还集成了组织结构、功能、数据和信息流等重要特性。EPC模型可以显示出任务链和责任链发生中断，将如何影响到公司优化其流程的能力。通过将组织与各个任务进行匹配，用户可以非常方便地看到一个流程中涉及到哪些部门或岗位。EPC图中涉及到的元素说明如下表：名称图标定义示例事件事件描述了状态的发生，它反过来又充当了一个触发器。收到原始凭证功能功能描述了初始状态向最终状态的转换。录入凭证组织单元组织单元描述了企业的大体结构。财务部会计信息、物料、资源对象信息、物料或者资源对象描述了现实世界中的对象（比如业务对象、实体）。科目流程路径流程路径显示了流程之间的前后连接关系（可以辅助导航）。凭证处理流程逻辑操作符XORVV逻辑操作符描述了事件和功能或流程之间的逻辑关系。“XOR”：表示从多个流程中，必须并且只能选择其一；“V”：表示“或”的关系；“Λ”：表示“且”的关系。控制流控制流描述了事件和功能或流程之间的先后和逻辑依赖关系。信息流、物流信息流/物流定义了某个功能是否被读取、变更或者写入。资源、组织单元分配资源/组织单元分配描述了哪个单元（员工）或资源来处理某个功能或者流程。-6-意见反馈感谢您使用我们的产品及用户手册。在本手册的最后附有意见反馈表，您可以在上面说明您对我们的产品或用户手册的意见和建议，并通过金蝶分支机构或直接传真至(0755)26710817产品管理部反馈给我们,我们将期待您给予我们好的建议和意见。金蝶K/3BOS系统用户手册-1-目录第1章系统概述.31.1系统构成..31.2系统特点..41.3系统在KISERP中的位置..7第2章数据库描述生成工具.92.1查看KIS数据库结构..92.2增加自定义表、字段..132.3生成描述SQL..142.4自定义sql维护数据字典注意事项..15第3章金蝶Schema编辑器.173.1方案操作..173.2Schema设置规范..203.3Schema编辑器工具的定位..24附录A意见反馈表..25金蝶客户化工具包用户手册第1章系统概述3第1章系统概述随着KIS系统的客户越来越多，一些客户有些特殊的需求在通用版中难以得到满足。所以为了能解决这些客户的需求，金蝶公司特别提供了客户化开发工具包。利用这个工具包，客户可以基于KIS系统做适当的二次开发以满足特殊需要。客户化工具包是提供给KIS产品的咨询顾问、实施顾问和企业信息建设人员，在KIS系统的基础上通过这个工具包，为有特殊需求的KIS客户进行行业版本的定制、制作特殊的报表、进行现有系统的功能扩展以及第三方系统集成等。1.1系统构成客户化工具包是所有的二次开发支持工具、组件接口及其说明、数据字典和数据交换标准等信息的全部集成。客户化工具包中的内容都是从各业务子系统提炼、整理得来。下面就是本系统与其它系统的集成图：第1章系统概述金蝶客户化工具包用户手册41.2系统特点客户化工具包的特点是对外提供金蝶KIS系统的软件标准、设计思想、设计原则，为二次开发人员提供一套基于KIS系统作二次开发的应用平台，完整的开发工具和开发参考。客户化工具包具有以下特点：A详尽的数据字典B符合W3C规范的数据交换标准C实用的支持工具D完整的在线帮助E有代表性的示例代码1.2.1详尽的数据字典数据库是KIS系统的技术核心，详尽的数据字典也就是KIS数据库表结构说明文档。它可以让有二次开发能力的用户清楚KIS系统的数据存储情况及表间的关联关系。如果知道了数据是如何存储的，那你就可以：A、通过SQL查询语句直接查询并输出金蝶报表不提供的、但你又需要的部分数据。B、通过编程提供部分数据的操作界面，实现一些特殊功能。C、通过数据库说明文档直接编程实现数据交换，与其它软件进行数据集成。1.2.2符合W3C规范的数据交换标准金蝶数据交换标准接口的特点是：采用W3C国际标准将KIS系统的业务对象定义成XMLSchema，并提供支持数据引入、引出的组件。将能通过XMLSchema检查的XML数据文档与KIS系统数据进行交换。金蝶数据交换标准接口包括：A、所有业务对象的交换接口说明B、所有业务对象的XMLSchema金蝶客户化工具包用户手册第1章系统概述5C、金蝶Schema编辑器一、所有业务对象的交换接口说明业务对象的交换接口说明是一个Excel文档。有相关的业务对象、对象包含的项目及其关联关系的详细说明。XMLSchema就是根据这份文档中提供的对象、项目、关联关系、来定义的。只要你的电脑上安装了Excel，双击就可打开此文档。二、所有业务对象的XMLSchema业务对象的XMLSchema是根据需要交换的内容进行的格式定义，是为了与KIS系统交换数据时，进行数据合法性校验。可通过IE或金蝶Schema编辑器来查看其结构。三、金蝶Schema编辑器金蝶Schema编辑器是可以定义业务对象Schema的工具。最初是为了制定金蝶数据交换Schema而开发，现在将它提供给用户，用户可以用此工具定义其它业务对象的Schema。1.2.3实用的支持工具二次开发工具包是一个为二次开发或账套数据检查、升级时提供帮助的工具包，包含以下内容：A、补丁包安装B、数据检测C、账套升级一、补丁包安装当二次开发用户自己开发了一些组件，或为在KIS数据库中增加一张表而写的SQL语句，该如何自动将这些组件和SQL加载到客户端安装目录并注册，或加入到中间层呢？补丁包中有相应的选项供你选择，完成这些操作，并且可以将你的SQL语句执行到数据库。二、数据检测数据检测是检查用户账套的结构与最新数据库结构是否一致，用户的账套数据是否完整。如果结构不一致或数据不完整有相应的详细提示列表。用户通过阅读此提示日志，根据实际需要手工或做其它处理，完善结构或数据以达到正确结果。三、账套升级第1章系统概述金蝶客户化工具包用户手册6账套升级工具是提供金蝶财务软件升级到KIS系统。然后用户可从KIS系统升级到更高版本。1.2.4完整的在线帮助金蝶SDK在线帮助是提供KIS系统业务对象组件的接口说明文档。用户通过阅读此文档，可以了解这些业务对象的哪些组件完成哪些功能，及其调用的方法。用户在二次开发时可有选择地调用这些组件完成相关的数据存取、功能扩展。金蝶SDK在线帮助包括：1、BaseDataExchange组件参考手册2、BaseDataExChange2组件使用参考3、EBCGL组件参考手册4、ExpImp80使用手册5、KIS客户化开发工具包6、KIS系统自定义主控台说明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插件开发手册是提供KISBOS插件模型的接口说明文档。用户通过阅读此文档，可以了解这些BOS对象的提供的方法、属性、函数及其调用的案例。用户在二次开发时可有选择地应用来完成相关的插件开发。1.3系统在KISERP中的位置系统在KISERP中的位置如下图1-1所示：第1章系统概述金蝶客户化工具包用户手册8图1-1系统在KISERP中的位金蝶客户化工具包用户手册第2章数据库描述生成工具9第2章数据库描述生成工具数据库描述生成工具主要用于万能报表中文数据字典的维护、KIS数据库结构的查看。通过该工具用户可直接将新增数据库表直接添加到万能报表数据字典中。数据库描述生存工具包括：查看KIS数据库结构中文数据字典中增加自定义表中文数据字典中增加自定义字段生成描述sql自定义sql维护数据字典注意事项2.1查看KIS数据库结构2.1.1登录主界面安装客户化工具包后，进入BOSIDE，点击菜单K3BOSSDK二次开发工具数据库描述生成工具，显示出KIS系统的统一登录界面，选择具体的账套就可以进入数据库描述生成工具。这里，必须保证账套的正确性、用户、密码的合法性。KIS系统的统一登录界面，单击[确定]，进入工具主界面（图2-1）。第2章数据库描述生成工具金蝶客户化工具包用户手册10图2-1数据库描述生成工具主界面2.1.2查看KIS数据库结构1.在工具主界面中，列示了万能报表表描述的详细信息：属性说明数据库显示表代码表ID您可以通过表ID，来识别该表是系统预设表或者用户自定义新增表：一子系统内前5000ID（0<=ID<5000），为系统预设表；一子系统内后5000ID（5000<=ID<10000），为自定义表；T_TableDescription.FTableID表名称数据库表名T_TableDescription.FName表描述表的中文描述名称T_TableDescription.FDescription金蝶客户化工具包用户手册第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章数据库描述生成工具金蝶客户化工具包用户手册12是否在万能报表中显示当前表是否在万能报表数据字典中显示；当为视图时，该选项为禁用状态，即：系统默认显示在万能报表中；对应数据库T_Tabledescriptio.FType（FType=0，在万能报表中显示；FType=1，不在万能报表中显示）；图2-2维护表结构信息界面2)在“维护表结构信息”界面中，显示当前表中所有字段以及中文描述；属性说明对应数据库字段字段名数据库字段名T_FieldDescripTion.FFieldName字段描述字段中文描述T_FieldDescripTion.FDescription字段类型字段类型在万能报表中，仅支持4种字段类型：Integer、Float、String、T_FieldDescripTion.FFieldType金蝶客户化工具包用户手册第2章数据库描述生成工具13DateTime是否在报表中显示当前字段是否在万能报表中文数据字典中显示T_FieldDescripTion.FType备注对当前字段的一些描述信息T_FieldDescripTion.FNote是否自定义当前字段是否是用户自定义新添的、或者修改的字段描述T_FieldDescripTion.FSefDefSign2.2增加自定义表、字段在实际应用中，用户常常会通过二次开发新增表，来存放企业特色数据信息，这些数据同样需要通过报表来进行分析、展示；允许用户纷纷选择万能报表工具，但是系统预设万能报表数据字典中根本没有这些用户自定义表描述信息，此时，我们可以通过数据库描述生成工具来完成表、字段描述添加工作。1.在工具主界面的工具栏中，选择“添加新增表”，弹出“生成表及字段描述表”（图2-3），在界面左边的数据库表列示框中，选择需要在万能报表数据字典中显示的一张或者多张新增表（ctrl、shift键有效）；图2-3生成表及字段描述表2.将选中的新增表，添加到界面右边的空白框中；3.在界面底部的“子系统ID”列表中，选择您将要把新增表添加到哪个子系统中。注意事项由于万能报表是根据子系统进行权限控制的，所以，务必保证添加道的目标子系统的正确无误。第2章数据库描述生成工具金蝶客户化工具包用户手册144.单击“生成描述表”，系统自动根据选择的表和子系统，将表信息添加到万能报表表描述表（T_TableDescription）中；5.回到工具主界面，找到刚才我们添加的表，双击表，在“维护表结构信息”界面中，对表及字段根据实际需要进行维护；注意事项对于新增的表描述，一定要记得将选项“是否自定义表”选上，这样，在下次升级账套时，您自定义维护的新增表才会继续保存并显示在数据字典中；对于新增的字段描述，一定要记得江选项“是否自定义字段”选上，这样，在下次升级账套时，您自定义维护的字段描述才会继续保存并显示在数据字典中；在数据库描述生成工具中添加或修改完描述后，为保证这些新增、修改描述一定显示在万能报表数据字典中，请进行万能报表后，使用“刷新KIS系统数据描述”功能；您可以通过任意一个方法，识别表是否自定义：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，请选择“自定义”-“字段描述”；金蝶客户化工具包用户手册第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登录主界面按照KIS系统的统一登录界面，选择具体的账套就可以进入Schema自动生成工具。登录前必须保证账套正确，并且用户是使用账套的合法用户以及当前帐套已经升级KISV1.0。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从数据库引入功能介绍选择〖工具〗→〖从数据库引入结构〗直接从KIS数据库中引入业务对象的节点信息，只能在叶节点中进行此项操作。从“对象选择界面”中列出的KIS数据库表选择需要用来定义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、同一级节点的命名不允许出现重复情况。7、不能交换identity字段的值。金蝶客户化工具包用户手册第3章金蝶Schema编辑器218、一个节点不能由非外部引用改为外部引用。如果要这样实现，先删除该节点，再做外部引用。9、当为主键时，不允许为空。10、不允许修改外部引用对象。11、不能删除已经被外部引用的业务对象以及该业务对象的方案。3.2.2相关的组件支持金蝶Schema编辑器运行的组件有：金蝶FlexBar，ADO2.5，MicrosoftXML4.0，金蝶KFO。3.2.3相关的数据库结构数据灌入结构，Schema表，KIS数据库表及字段信息表。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[a-e]xax,bx,cx,dx,ex第3章金蝶Schema编辑器金蝶客户化工具包用户手册22[-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任意精度的数值类型Boolean布尔类型金蝶客户化工具包用户手册第3章金蝶Schema编辑器23Integer整型有符号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需要编写与KIS系统进行数据交换的行业开发者3需要了解KIS系统如何定义数据交换标准的技术爱好者金蝶KIS客户化工具包用户手册附录A意见反馈表25附录A意见反馈表《金蝶KIS旗舰版客户化工具包用户手册》1、请您对以下各项指标作出评价，并在相应的单元评价结果后面打“√”非常满意满意一般不满意内容正确内容完整使用方便表达清晰图表形式整体意见2、您认为我们还需在哪些方面进行改进：文字表达专业性程度结构编排图表说明附录形式表述方式目录结构增加典型实例操作流程性说明提供更多帮助请您对以上改进建议进行详细说明：3、你对本手册的哪些内容比较满意4、其它建议5、为了我们能够及时与您联系，请你填写个人信息：姓名：职称：电话：E-mail：单位：地址：附录A意见反馈表金蝶KIS客户化工具包用户手册26
