auto_scheduling

信息

此功能仅在 PRO 版本中可用。

Description

启用自动排程

auto_scheduling: AutoSchedulingConfig | boolean

Example

gantt.config.auto_scheduling = {
    enabled: true,
    gap_behavior: "compress"
};

gantt.init("gantt_here");

Default value: false

Related samples

• Auto Scheduling extension

Details

注释

该配置在 auto_scheduling 扩展中定义，因此你需要激活 auto_scheduling 插件。请在 Auto Scheduling 文章中查看详细信息。

尽管可以将 auto_scheduling 配置设置为布尔值，但使用对象定义的方式来配置自动排程行为是推荐的方法。

以对象形式设置时，可以使用以下选项：

enabled

Type: boolean

Default: false

开启或关闭自动排程（与直接使用布尔值相同）。

gantt.config.auto_scheduling = {
    enabled: true
};

apply_constraints

Type: boolean

Default: true

启用或禁用在自动排程中对时间约束的使用。

gantt.config.auto_scheduling = {
    enabled: true,
    apply_constraints: false
};

将该值设为 false 将把自动排程切换到忽略与任务相关的约束的模式（例如 ASAP、ALAP、SNET 等），排程仅依赖任务依赖关系。

此属性取代了已弃用的 auto_scheduling_compatibility 设置。

• Basic Scheduling
• Constraint Scheduling

gap_behavior

Type: String

Allowed values: "preserve"|"compress"

Default: "preserve"

定义 Gantt 在排程过程中如何处理依赖任务之间的空隙。

• "preserve" - 如果没有冲突，任务保持在当前的位置
• "compress" - 将任务移动到最早允许的日期（如果启用 schedule_from_end 则移动到最晚日期）

默认情况下，只有当当前日期违反约束或依赖时才会重新排程。

gantt.config.auto_scheduling = {
    enabled: true,
    apply_constraints: false,
    gap_behavior: "compress"
};

descendant_links

Type: boolean

Default: false

允许或禁止在父任务（项目）及其子任务之间创建链接。

默认情况下，不允许创建此类链接。

gantt.config.auto_scheduling = {
    enabled: true,
    apply_constraints: false,
    descendant_links: true
};

schedule_on_parse

Type: boolean

Default: true

定义 Gantt 在数据加载/解析时是否执行自动排程。

gantt.config.auto_scheduling = {
    enabled: true,
    schedule_on_parse: false
};

move_projects

Type: boolean

Default: true

默认情况下（当属性设置为 true），在自动排程期间会移动整个项目。也就是说，同一项目中的所有任务相对于彼此和项目开头的位置保持不变。

如果把 move_projects 设置为 false，自动排程会移动项目内部的单独任务。因此，一些任务会被移动，而其他任务会保持原位。

注释

如果使用约束排程（apply_constraints: true），只有当 gap_behavior 属性设置为 "preserve" 时，move_projects 配置才会生效：

gantt.config.auto_scheduling = {
    enabled: true,
    apply_constraints: true,
    move_projects: true,
    gap_behavior: "preserve"
};

use_progress

Type: boolean

Default: false

指定完成的任务是否应影响排程和关键路径计算。

gantt.config.auto_scheduling = {
    enabled: true,
    use_progress: true
};

当该属性开启时，关键路径、松弛以及自动排程算法将考虑任务进度的值，与 MS Project 的做法类似，具体而言：

1. 已完成的任务（进度达到 100% 的任务）始终没有松弛时间；

2. 已完成的任务不参与自动排程计算。将前置任务与已完成任务之间的关系忽略；

3. 已完成的任务不能成为关键任务。

• Use progress for auto-scheduling, critical path and slack calculations

schedule_from_end

Type: boolean

Default: false

启用向后排程。

将此配置设置为 true 将把自动排程切换到尽可能晚的模式。

该值只有在同时指定 project_end 时才会生效。

gantt.config.project_end = new Date(2025, 10, 1);
gantt.config.auto_scheduling = {
    enabled: true,
    schedule_from_end: true
};

• Backward Scheduling

project_constraint

Type: boolean

Default: false

定义子任务是否应继承其父项目的约束类型。

gantt.config.auto_scheduling = {
    enabled: true,
    project_constraint: true
};

默认情况下，父项目的约束类型不会影响其嵌套任务的约束类型。

如果将配置设为 true，子任务（除非它们有自己的约束类型）将具有与父项目相同的约束类型（例如， finish no later than）。

• Constraint Scheduling

show_constraints

Type: boolean

Default: false

控制在甘特图上显示任务约束。

设为 true 以显示约束，设为 false 以隐藏它们。

例如，要启用自动排程但禁用任务约束的显示：

gantt.config.auto_scheduling = {
    enabled: true,
    show_constraints: false
};
gantt.init("gantt_here");

• Constraint Scheduling

Related API

• project_start
• project_end
• auto_scheduling_initial
• auto_scheduling_descendant_links
• auto_scheduling_move_projects
• auto_scheduling_project_constraint
• auto_scheduling_strict
• auto_scheduling_use_progress
• constraint_types
• findCycles
• isCircularLink
• onAfterAutoSchedule
• onAfterTaskAutoSchedule
• onBeforeAutoSchedule
• onBeforeTaskAutoSchedule
• onCircularLinkError
• onAutoScheduleCircularLink

Related Guides

• Auto Scheduling

Change log

• 自 v9.1 版本起，建議使用物件配置 auto_scheduling。
• 自 v9.0 版本起，可將其設定為物件。