理解向日葵甘特(一.向日葵甘特的数据结构)

 

    现在，向日葵甘特的开发已经有了一段时间了，在这一段时间之中，我们积累了很多相关的经验和设计上的理解，这一些内容使我们的产品结构渐渐的清晰稳定下来，我们知道，不仅仅我们在开发之中需要这些内容，用户在使用我们的甘特图的时候，也需要比现在更加能理解我们的甘特图的原理和实现，因此，从现在开始，我们将渐渐的发布系列文章《理解向日葵甘特》，供大家开发时候的参考。

    这一系列文章将从数据的开始，一直讲解到最后的实现，你对该系列文章的反应将会影响到我们是否长期的进行这样的内容分享。

    这次讲解的内容是向日葵甘特的主体数据结构，向日葵甘特图按照一般的设计思路，支持以下四种数据实体：任务，资源，链接，资源分配，下面我们将逐个的讲解：

    1.任务，这个实体在甘特图数据结构之中是一种标准的树形结构，每个项目有一个根任务，根任务是代表整个文档的任务，通常不能给该任务分配资源和添加链接，也不会显示在甘特图之中，每个项目应该有且仅有一个根任务。每个任务可以有多个链接，多个资源分配；

    2.资源，这个实体在甘特图数据结构之中也是一种标准的树形结构，和任务类似，也有一个根资源，同样，根资源不能被分配，每一个资源可以有多个资源分配对象；

    3.链接，这个实体用来代表任务和任务之间的关系，仅仅是一个没有顺序的列表；

    4.资源分配，这个实体用来描述任务和资源质检的关系，也是一个没有顺序的列表；

    根据以上的描述，我们可以绘制出如下格式的数据结构示意图：

 

 

    这个示意图比较清晰的说明了以上四种数据实体之间的关系，现在，我们再了解一下每个实体的属性，虽然实体的属性可以灵活的使用，不过有一些属性是用来描述各个实体之间的关系的（下面称为结构属性），这些属性必须严格按照要求进行设置，还有一些是在后面的甘特图显示和操作之中约定使用的属性（下面称为约定属性），这些属性最好也按照约定的模式进行处理，否则部分功能可能受到影响。

        我们先看看各个实体的结构属性列表

 

类型	属性字段名称	属性类型	属性描述
任务	UID	字符串	用来唯一的标识一个任务，每个任务必须有UID而且互不相同，不会改变
任务	Summary	布尔值	用来代表该任务是不是有子任务，有子任务时该项必须为True
资源	UID	字符串	用来唯一的标识一个任务，每个任务必须有UID而且互不相同，不会改变
资源	Summary	布尔值	用来代表该任务是不是有子资源，有子资源时该项必须为True
链接	UID	字符串	用来唯一的标识一个任务，每个任务必须有UID而且互不相同，不会改变
链接	PredecessorUID	字符串	该链接前置任务的UID
链接	SuccessorUID	字符串	该链接后置任务的UID
资源分配	UID	字符串	用来唯一的标识一个任务，每个任务必须有UID而且互不相同，不会改变
资源分配	TaskUID	字符串	分配任务的UID
资源分配	ResourceUID	字符串	所分配资源的UID

 

    以上的这些字段由于是用来描述实体之间的关系，非常重要，必须严格按照内容提供数据。

    当然，下面的字段也并非不重要，因为要实现甘特图的功能，也要按照标准来使用，否则，甘特图的显示可能会不正常，在这里我们也列出甘特图之中目前所有支持的约定字段名称，这个列表可能会随着需求的增加而更改。

 

类型	属性字段名称	属性类型	属性描述
任务	ID	整数	这个字段代表任务的顺序号，实际上，因为甘特图的内容是分块加载的，考虑到性能问题，默认情况下甘特图变化的时候并不维护此字段的更新
任务	OutlineNumber	字符串	代表任务的大纲数字，实际上，因为甘特图的内容是分块加载的，考虑到性能问题，默认情况下甘特图变化的时候并不维护此字段的更新
任务	OutlineLevel	整数	代表任务的大纲级别，实际上，因为甘特图的内容是分块加载的，考虑到性能问题，默认情况下甘特图变化的时候并不维护此字段的更新
任务	Start	日期时间	代表任务的起始时间，默认情况下甘特图会维护概要任务的起止时间和所有的子任务的起止时间一致，可以拖动甘特图上的任务条更改此属性
任务	Finish	日期时间	代表任务的结束时间，默认情况下甘特图会维护概要任务的起止时间和所有的子任务的起止时间一致，可以拖动甘特图上的任务条更改此属性
任务	Name	字符串	代表任务的名称，在任务甘特图列表框可以编辑更改此属性
任务	ReadOnly	布尔值	代表该任务是否只读，如果设置为true,在甘特图的操作之中将会不允许对该任务进行操作*1
任务	PercentComplete	整数	0-100的数字，代表任务的完成进度，拖动甘特图上的任务条可以更改此属性
任务	Notes	字符串	任务的说明文字
任务	ConstraintType	整数	任务的限制类型，从0-7的整数，分别代表'越早越好','越晚越好','必须开始于','必须完成于','不得早于...开始','不得晚于...开始','不得早于...完成','不得晚于...完成'
任务	ConstraintDate	日期时间	任务的限制时间，此属性和ConstraintType属性一起使用默认会显示在甘特图的图标列里面
任务	ActualStart	日期时间	实际开始时间
任务	ActualFinish	日期时间	实际结束时间
任务	Hyperlink	字符串	超级链接的文本，此属性默认会显示在甘特图的图标列里面
任务	HyperlinkAddress	字符串	超级链接的URL地址，此属性默认会显示在甘特图的图标列里面
任务	ClassName	字符串	任务的显示样式，将影响任务在图中的样式
任务	Collapse	布尔值	该任务（概要任务）是否被折叠，点击概要任务名称之中的+-图标可以更改此属性
任务	LineHeight	整数	该任务显示行高的像素值，在任务列表中拖动任务之间的分隔条可以调整该值
任务	Critical	布尔值	代表该任务是否是关键任务
任务	BaselineStart	日期时间	跟踪甘特图的起始时间
任务	BaselineFinish	日期时间	跟踪甘特图的结束时间
资源	Name	字符串	代表资源的名称，在资源甘特图列表框可以编辑更改此属性
资源	ID	整数	这个字段代表资源的顺序号，实际上，因为甘特图的内容是分块加载的，考虑到性能问题，默认情况下甘特图变化的时候并不维护此字段的更新
资源	OutlineNumber	字符串	代表资源的大纲数字，实际上，因为甘特图的内容是分块加载的，考虑到性能问题，默认情况下甘特图变化的时候并不维护此字段的更新
资源	OutlineLevel	整数	代表资源的大纲级别，实际上，因为甘特图的内容是分块加载的，考虑到性能问题，默认情况下甘特图变化的时候并不维护此字段的更新
资源	ReadOnly	布尔值	代表该资源是否只读，如果设置为true,在甘特图的操作之中将会不允许对该任务进行操作
资源	Notes	字符串	资源的说明文字
资源	ClassName	字符串	资源的显示样式，将影响资源在图中的样式
资源	Collapse	布尔值	该资源是否被折叠，点击资源名称之中的+-图标可以更改此属性
资源	LineHeight	整数	该资源显示行高的像素值，在资源列表中拖动资源之间的分隔条可以调整该值
链接	Type	整数	0-3的整数，分别代表 '完成-完成(FF)','完成-开始(FS)','开始-完成(SF)','开始-开始(SS)'
资源分配	Units	浮点数	0-1的小数，代表资源的分配比例

 

*1：关于任务的只读：虽然任务被设置为只读理论上讲意味着所有的属性都不能更改，实际上对有些属性的更改并没有没有受到只读的限制，而这个属性的列表是允许配置的。

 

    以上就是目前甘特图支持的所有的字段列表(该列表可能随时变化)，我们建议对于类似的功能，尽量严格采用我们定义的字段和格式，我们没有定义的字段，可以灵活的自己定义。

    本文介绍的全部内容就是向日葵甘特图的基础数据结构，在后面，我们将要介绍怎么去使用和实现这些数据。

 

 

 

 

基于AJAX的向日葵甘特图组件
官方网址： http://www.51diaodu.cn/ (我要调度网) 向日葵甘特图组件交流群: 63867839
英文网站： http://www.sfgantt.com/

 

 

 

 

转载于:https://www.cnblogs.com/tidestone/archive/2009/05/04/1449148.html