解决方案使用手册

解决方案使用说明
解决方案主要目的为了实现统一的二次开发以及构建工作，适用于单个Cloud实施项目的二次开发工作，以及基于Cloud的产品，或是行业特性的迭代开发。

主要特点：1）完整的团队开发模式，通过tfs或是svn，实现代码与业务对象的源代码管理
2）开发与构建的一体化，你所做的二次开发工作都可以通过解决方案的构建，形成安装包，完整的将所有开发工作移植到正式环境或是其他需要的环境
3）反向工程，将已有的零碎的二次开发成果反向生成解决方案，实现项目二次开发的统一管理
4）项目管理，通过多次构建形成更高版本的安装包，实现产品的不断迭代推进，或是项目里程碑管理
1·二次开发环境准备
1.1正式环境准备
在部署二次开发环境之前，我们首先应该部署企业正式的环境，包括数据库服务器，业务服务器，并创建管理中心，并在管理中心下创建正式的业务数据中心
1.2测试账套准备
创建与正式业务数据中心一致的测试业务中心，以下简称正式库与测试库
1.3本地开发环境安装
通过安装包为开发人员部署本地的安装环境，安装过程需要注意
1）在进行功能选择时，不需要选择管理中心，而是加载到已有管理中心
2）点击高级，选择已有管理中心
3）通过检查之后，就可以正常安装
4）打开本机的cloud站点，就可以进入关联的管理中心的业务中心，如果找不到业务中心，可以打开关联的管理中心，选中测试库，通过站点关联，配置你本地的cloud能够使用的业务中心，这样，我们可以隔离正式库与测试库的使用站点，使其无不干扰
1.4源码管理环境支持
Cloud二次开发支持TFS,SVN两种源代码管理方式，通过源代码管理，可以支持多人的团队，开发保存您在boside、vs中业务对象、插件信息，并通过这些信息进行整体的构建，从测试库完整迁移到正式库，并能实现构建包的版本管理。

需要您的开发团队建立源代码服务器，并在开发机器本地建立workcopy
2·二次开发解决方案的开发过程
2.1解决方案的创建
1）如果需要新建，则点击新建解决方案，也可以通过打开解决方案和开启过的方案，选择已有方案
2）解决方案请使用英文
3）目录是指当前方案所在位置，如果勾选新建工程文件夹，则会新建与方案名称一致的文件夹，如果您需要进行源代码管理，这个目录一定要在workcopy之下，不然无法进行源代码管理的
4）业务领域是指：业务的大领域分类，Cloud已有以下系统
二次开发可以通过新增业务领域，专门建一个业务领域来进行客户自定义的开发
5）源代码设置
我们提供了tfs与svn两种源代码管理方式，都需要架设好相应服务器，并在本地建立
workcopy
Tfs设置
选择服务器，选择工作区
远程目录，与本地目录有默认值，但是如果测试不通过，可以在本地vs或是tfs检查：
SVN设置
通过SVN客户端确定url和本地目录
点击测试进行基本的测试
2.2解决方案本地目录结构与树结构
2.2.1组合包根结点MyProject
对应的工程目录下KD-Composite-Package.pkgdef文件，他控制需要开发、构建的组件包和元数据包
双击组合包跟节点，注意组件引用路径，默认是你安装cloud的website bin目录，在编译您的插件和构建组件时候需要的引用目录，没有特殊情况，走默认配置即可
如果你需要修改或是添加源代码管理，除了在新建方案时，在这里节点右键选择源代码管理，也可以进行源代码管理设置
2.2.2组件包Assembly Package
组件包主要是针对cloud所需要的实体文件，包括二次开发组件（dll文件）以及自定义配置文件等其他资源
根节点Assembly Package
对应文件目录
该文件指定了需要构建的插件工程，或是运行文件
客户端插件
客户端插件是.NET类库工程，可以添加多个客户端使用插件，包括已经预置模板的：
通过新建工程建立net工程：
需要填写工程名的前缀，工程目录默认在code中
如果你正常安装了cloud，没有特殊情况，工程目录，引用路径，输出路径不用修改，在编译过程中会自动将cloud website bin目录作为一个引用目录，并将编译的组件放到该目录下
建立工程后的工程文件夹
建立工程节点后，通过右键添加插件，添加对应的C#文件或是文件夹
一般来说，我们会针对某个业务对象进行插件编写，为改对象的插件集合建一个文件夹
双击cs节点，便可以直接在boside编辑我们的插件，并能进行编译，并能将生成的dll放入你的cloud引用目录中
服务端插件
与客户端插件基本一致，其内置了服务层所需的插件模板
.net工程
如果不涉及到Cloud插件开发的，可以在这个节点编辑工程处理，但是建议在插件工程中处理所有的二次开发内容
其他资源
其他资源包括：客户需要的配置文件，第三方组件等，可以在这里添加，最终通过构建，以打包的方式进入正式环境
需要注意的是部署路径，如果这里是bin，意味着，最终会部署到cloud webisite bin目录下，如果需要部署到其他目录，可以通过相对website的路径进行设置
Dll文件会默认部署到bin目录下，而其他文件默认部署到website根目录下
2.2.3元数据包MetaData Package
元数据包主要包含了子系统的二次开发的业务对象，以及相关的预置的业务数据，预置的菜单数据，预置的权限数据，预置单据转换，反写规则，工作流，业务流，以及客户自定义的Ksql文件
根节点MetaData Package
对应文件，说明了该元数据包需要构建的文件
反向工程
主要功能是将原有二次开发的内容（业务对象，权限对象，菜单，单据转换，反写规则，业务流等）反向生成为一个元数据包，可以快速的定位二次开发成果，并重新构建二次开发完整包
点击“生成当前业务中心元数据包”，将对当前开发商进行的所有的元数据开发成功进行归集，弹出做过二次开发的子系统列表
选中你需要反向工程的子系统，可以多选，确定即可。

如果你进行的二次开发设计子系统较多，可以新加一个元数据包对不同的子系统进行反向处理。

子系统
子系统是业务领域下更小的分类，也是一系列相关业务对象的集合：
系统已预置子系
统
子系统的添加以及对应的目录文档变化
点击根节点，右键，可以找到“添加子系统”菜单，添加子系统是将系统已有子系统加入，扩展原有业务对象，或是添加新的业务对象
没有特殊需要不需要填写子系统目录
对应文件夹在：
采购管理文件夹
添加之后，默认是没有任何业务对象的，如果需要对某个业务对象进行扩展，需要引入该业务对象
可以一次性引入全部业务对象，但是推荐只引用需要的业务对象，这样可以节省元数据管理的文件和构建的时间
[]内容是该业务对象的开发商，预置的业务对象开发商均为kingdee，
开发商信息在第一次打开boside时，会初始化，请谨慎填写
现在可以引入你需要扩展的单据并进行扩展，或是新建业务对象
子系统的创建以及对应的目录文档变化
创建过程与添加子系统过程类似，但是他是新建一个全新的子系统，没有已有业务对象引入，可以新建业务对象
子系统目录默认不用处理
新建的子系统元数据新增
元数据本地文件对应位置，处在对应子系统目录下：
对应预置子系统sql说明
在添加和新增子系统时，会将新的子系统预置sql自动导出
业务对象权限导出
开发业务对象之后，一般会对其在cloud中设计权限对象，权限项，设计完成之后，可以在业务对象-右键-“导出权限对象”进行直接导出，如果权限对象有改动，可以再执行一次，重新导出
业务对象自身包含的预置数据
业务对象dym文件本身还包括了：
1）根据业务对象字段定义的表结构，会在安装时自动生成表
2）视图预置数据
3）辅助资料预置数据
4）枚举预置数据
主控菜单
新建菜单数据自动生成sql
通过右键-发布菜单，进行菜单发布，发布完成之后，会自动生成你发布菜单的sql语句
原有菜单数据引出sql
如果你原来已经发布了菜单，需要将原来的菜单引入，则通过右键-发布菜单，
选中你要引入的菜单，通过脚本按钮引入
Sql脚本
通过新增和添加sql脚本，实现自定义的数据操作需要
预置数据处理
通过右键菜单，可以引入需要的预置数据
其中所引入的对象，可以通过刷新更新原有数据
2.2.4组件包与元数据包添加
如果项目较大，导致一个组件包或是元数据包太大，可以添加新的组件包或是元数据包3．二次开发解决方案的构建
构建主要工作：将解决方案中定义的插件工程编译为组件，与元数据dym，sql脚本以及各种预置数据打包为kdpkg文件，通过执行该文件，可以将所有内容注入相应的站点和数据中心，与打补丁过程一致
如果你开启了元数据管理，则会从源码管理器上获取最新的文件之后进行构建。