PlusProject 二次开发指南 V3.0.docVIP

普加项目管理中间件软件 二次开发指南 V3.0 上海普加软件有限公司 目录 安装部署 2 项目文件目录介绍 4 二次开发工作 4 加载数据 5 保存数据(全部) 7 保存数据(局部) 8 扩展任务属性 9 标准列 10 自定义表格列 14 自定义单元格内容 14 自定义单元格可编辑 16 自定义条形图外观 17 自定义右键菜单 19 集成到第三方JS框架(jQuery、Ext等) 19 语言本地化 20 项目数据据 20 JSON数据结构 20 数据库表结构 26 PlusProject API参考 29 属性 29 方法 31 事件 40 常见问题 44 安装部署下载开发包访问 /download/获得软件开发包后解压缩，并把解压缩后的项目文件，放入到Web项目。如果是.Net版本，可以直接用Visual Studio以打开网站的方式打开运行。如果是Java版本，请使用Eclipse以导入项目的方式导入打开。数据库安装在下载解压缩后的文件夹内，有一个dbsql目录，里面有mssql.sql、oracle.sql、mysql.sql数据库表文件。请使用这里的表结构创建一个数据库。比如新建一个数据库，名字为：testproject。然后把拷贝的SQL运行一下，就生成了plus_project、plus_task表。 创建数据库表完成后，请在App_Code\Utils\DBUtil.cs修改数据库连接配置信息以便正常运行。Java的文件路径是src\PluSoft\DBUtil.java。 导入项目运行demo/ImportProject.aspx文件。选择本地MS PROJECT XML文件，上传导入到数据库中。 如果导入成功，会弹出提示信息，可以选择跳转到Load.html查看刚才导入的项目数据。如果导入失败，会弹出异常提示，定位解决错误。（注：通常导入错误都是数据库配置信息有误；或文件选择错误。）必须导入Upload\软件开发-100.xml项目文件，它是作为DEMO示例的示例项目数据。 新建项目 运行demo/NewProject.aspx文件。此文件使用服务端Project对象，创建一个空项目，并保存到项目中。 查看项目 运行demo/Projects.aspx文件，打开一个当前项目列表，可以选择“打开”项目，跳转到Load.html，查看项目。.Net开发包目录文件一一如下： DBProject.cs文件：项目加载、保存的后台文件 dbsql目录：数据库SQL文件 demo目录：甘特图示例 scripts/plusproject/js：甘特图javascript文件，有任务面板TaskWindow.js、 日历面板CalendarWindow.js、右键菜单ProjectMenu.js、数据交互ProjectServices.js等。 doc.html文件：甘特图开发指南文档，包括API、二次开发要点等。 index.html文件：开发包资源索引页面。以下详细介绍PlusProject是如何从数据库加载数据，以及如何保存到数据库内的。 DBProject类 DBProject是用来处理从数据库加载和保存项目的。里面有两个重要方法：LoadProject和SaveProject。 开发者往往会改造这个类，修改项目加载和保存的实现方式，以满足开发的需要。 PlusProject并不关心和限制开发者如何加载和保存项目数据，只需要在创建和使用PluSoft.Data.Project时，提供好符合数据格式的数据即可。所以开发者可以使用任意的数据库，以及数据库操作方式，灵活性和可控性非常高。 加载数据 在DBProject的LoadProject方法中，根据项目UID，加载项目数据和任务数据，并进行数据格式转换工作，最后得到一个Hashtable对象返回。开发者可以参考LoadProject方法的代码，使用自己熟悉的数据库操作方式，比如IBatis、Hibernate等第三方类库，查询数据后，按项目数据结构进行格式转换工作。 需要注意的是，获取任务的方法SelectTasks。从数据库查询出任务列表后，需要进行一个for循环遍历操作，一一将任务属性转换为标准任务字段。 foreach (Hashtable dbtask in dbtasks) { Hashtable task = new Hashtable(); task[UID] = dbtask[UID_]; //唯一标识符 task[ID] = dbtask[ID_]; //序号 ...... tasks