EdoGantt甘特图中间件的任务操作

 当创建显示易度甘特图之后，我们可以对甘特图对象做一些操作，如： 新增任务，删除任务，修改任务，移动任务（移动任务到另一个任务前、下、内），升级、降级任务等。下面一一例举操作代码。

 

    1.新增任务

    首先需要创建一个有必要默认属性的任务对象，可以使用如下代码：

var task = dataProject.createTask();

    我们创建了一个任务对象，现在可以马上把它加入到甘特图数据对象内，并马上反应到甘特图显示组件上。

    如果我们想在创建一个任务对象的时候，马上赋予一些自定义的属性，如Name,Start,Finish,PercentComplete等，我们可以这样写：

var task = dataProject.createTask();
//一个一个加属性
task.Name = '新任务';
//批量加属性
Edo.apply(task, {
    Name: '新任务',
    Start: new Date(2009, 1, 1),
    Finish: new Date(2009, 1, 3)
});

    现在我们得到一个满意的任务对象，只需要把它加入到dataProject的任务数据内就可以了：

var task = dataProject.createTask();
task.Name = '<新任务>';
//获得甘特图当前选中行:也是一个任务对象
var parentTask = project.getSelected();
//这里的逻辑是把新建的任务对象,插入到选中行任务的第一个索引处.
dataProject.Tasks.insert(0, task, parentTask);
//如果您有不同的处理, 只需要改变插入任务的逻辑, 比如插入到选中行前面等.
//您也可以参考易度甘特图网站上,默认的新增任务插入逻辑代码

    不需要手动去刷新甘特图显示组件，易度甘特图是MVC模型的组件架构，数据源dataProject和显示组件GanttView是绑定的，当有对dataProject进行操作，会自动马上反应到甘特图显示组件上，更新了界面。

 

    2. 删除任务

    一般是对当前选中行做删除操作，也可以对查找出来的任务做删除。删除任务代码如下：

var task = project.getSelected();
if(task){   //加一个判断, 这样可以确定有选中的任务
    dataProject.Tasks.remove(task);
}

   

   3.修改任务

    修改任务是指修改任务的属性，如Name,Start,Finish,PercentComplete等。

    当修改任务的“非关联属性”时，是一件简单的事，比如修改Name：

var task = project.getSelected();
if(task){
    dataProject.Tasks.update(task, 'Name', "新的任务名");                            
}

    当修改任务的"关联属性"时，事件就变得复杂了。

    比如您修改任务的“工期”，那么就会影响此任务的“完成日期”，进而影响和调整此任务的“关联任务”的开始和完成日期。

    您可以参考以下代码，是监听处理任务的编辑事件，易度甘特图官方提供的处理“任务属性改变”逻辑的代码：

function onTaskChange(e){
    var property = e.property, value = e.value, task = e.task, tasks = dataProject.Tasks;
    switch(property){
        case 'Duration':
            //默认8小时工作日, 这里简单处理, 直接在Start上加Duration的时间.
            
            var hours = parseInt(value.Duration / 8) * 24 + value.Duration % 8; 
            var finish = task.Start.add(Date.HOUR, hours);
            
            //如果工期,日期数据是逻辑允许的, 则更新好日期数据.
            if(syncData(task, task.Start, finish, true) !== false){            
                tasks.updateRecord(task, value); 
            }
            
        break;
        case 'Start':
            var finish = new Date(value.getTime() + (task.Finish - task.Start))
            syncData(task, value, finish, true);
        break;
        case 'Finish':            
             syncData(task, task.Start, value, true);   
        break;
        default:                   
            tasks.update(task, property, value);
            
            if(property == 'PercentComplete'){
                //同步父/子任务的完成百分比
                dataProject.syncPercentComplete(task);
            }
            
        break;
    }    
}

    甘特图应用中，任务属性改变的处理，是非常复杂的一个环节，因为修改了一个属性之后，其他的属性会被关联修改，进而有任务相关性的任务，还会继续被关联修改。

 

    4.移动任务

    所谓“移动任务”，是指把一个任务，移动到另一个任务前（后，内），是一个顺序和父任务调整的逻辑。

    请参考以下代码：

//将task1, 移动到task2(方式preend, append, add)
var task1 = dataProject.Tasks.getAt(0);                         //用索引号获取任务
var task2 = dataProject.Tasks.find({Name: '分析/软件需求'});    //用查找来获取任务
dataProject.moveTask(task1, task2, 'add');                      //移动任务

 

    5.升级、降级任务

    升级、降级任务，是对任务节点层次的操作，此功能也是参考微软Project而来，功能逻辑与Project一致。

    代码如下：

var task = project.getSelected();
if(task){
    dataProject.upgradeTask(task);      //升级任务
}
var task = project.getSelected();
if(task){
    dataProject.downgradeTask(task);    //降级任务
}

网站:www.edogantt.com

 www.edojs.com