Свойства Задачи

Этот документ предоставляет подробный список всех свойств, которые может иметь объект задачи.

Для получения сведений о свойствах объекта ссылки, обратитесь к статье Свойства Ссылки.


Обязательные Свойства

Эти свойства всегда присутствуют на стороне клиента. Gantt ожидает, что они будут включены в объект задачи при загрузке данных. Если они отсутствуют, Gantt добавит их автоматически. Удаление любого из этих свойств после загрузки задач приведет к ошибкам.

Имя Тип Описание
id string | number Уникальный идентификатор задачи. Будет сгенерирован автоматически, если не указан.
start_date Date Указывает, когда задача начинается. Если не указано, Gantt рассчитывает это на основе end_date и duration. Свойство является необязательным, если установлено unscheduled: true.
end_date Date Указывает, когда задача заканчивается. Если не указано, Gantt рассчитывает это на основе start_date и duration. Свойство является необязательным, если установлено unscheduled: true.
duration number Определяет, как долго длится задача. Если не указано, Gantt рассчитывает это на основе start_date и end_date.

Необязательные Свойства

Эти свойства являются необязательными и используются стандартной логикой и шаблонами Gantt, если они определены.

Имя Тип Описание
auto_scheduling boolean Определяет, должен ли Gantt автоматически планировать задачу (true или не указано) или нет (false).
bar_height number Регулирует высоту DOM-элемента задачи на временной шкале.
baselines Baseline[] Содержит массив базовых линий.
calendar_id number | string Назначает задаче пользовательский календарь. Имя свойства зависит от значения опции calendar_property.
color string Устанавливает цвет задачи на временной шкале (применяется к background-color элемента gantt_task_line).
constraint_date Date Указывает дату ограничения задачи, когда автопланирование с временными ограничениями включено. Не используется, если auto_scheduling_compatibility включено.
constraint_type string Определяет тип ограничения задачи (например, "asap", "alap" и т.д.) при автопланировании с временными ограничениями. Не используется, если auto_scheduling_compatibility включено.
deadline Date Устанавливает крайний срок для задачи. Когда определено, в временной шкале появляется визуальный индикатор.
editable boolean Определяет, может ли задача быть отредактирована в режиме только для чтения диаграммы Gantt. Имя свойства зависит от значения опции editable_property.
group_id string | number ID группы, к которой принадлежит задача. Добавляется к задачам, сгруппированным по определенному критерию.
hide_bar boolean Указывает, должна ли задача или этап быть скрытыми на временной шкале.
key string | number Ключ группы, добавленный к задачам, сгруппированным по критерию, указанному в виде массива.
label string Метка группы, добавленная к задачам с именами сгруппированных элементов (например, "High", "Normal", "Low" при группировке по приоритету).
open boolean Указывает, открыта ли ветвь задачи по умолчанию для отображения дочерних задач. Используйте методы open() или close() для переключения ветви после инициализации.
parent number | string ID родительской задачи. Задача не будет отображаться, если указанный родитель не существует. ID корневой задачи определяется конфигурацией root_id.
progress number Представляет прогресс задачи как значение от 0 до 1.
progressColor string Устанавливает цвет полосы прогресса на временной шкале (применяется к background-color элемента gantt_task_progress).
readonly boolean Указывает, является ли задача только для чтения. Имя свойства зависит от значения опции readonly_property.
render string Определяет, как отображаются подзадачи. Значения: "split" или "". При значении "split" подзадачи отображаются в одной строке, особенно если задача свернута и open_split_tasks включено.
resource Array<string> Хранит ресурсы, назначенные задаче. Добавляется при импорте данных из MS Project/Primavera.
rollup boolean Указывает, должна ли задача или этап отображаться на родительских проектах.
row_height number Устанавливает высоту строки задачи.
target string ID целевой задачи. Добавляется, когда включен Data Processor и задача обновляется.
text any Имя задачи. Может использоваться с любым другим именем для этого свойства.
textColor string Устанавливает цвет текста задачи на временной шкале (применяется к color элемента gantt_task_line).
type string Определяет тип задачи. Доступные значения: "task", "project", "milestone". Для подробностей о типах задач, ознакомьтесь с документацией по типам задач.
unscheduled boolean Указывает, является ли задача незапланированной. Незапланированные задачи по умолчанию не отображаются на временной шкале, и их ячейки в гриде для начальной/конечной дат остаются пустыми.

Динамические Свойства

Динамические свойства генерируются на стороне клиента и отражают текущее состояние задачи или ссылки. Эти свойства не сохраняются в базе данных и будут проигнорированы Gantt, если они указаны в вашем JSON/XML.

Имя Тип Описание
[resource_property] string | Array<any> Хранит ID ресурса, связанного с resourceGrid/Timeline/Histogram/Calendar.
$auto_end_date Date Рассчитанная дата окончания проектной задачи на основе её подзадач, обновляется, когда автопланирование выключено.
$auto_start_date Date Рассчитанная дата начала проектной задачи на основе её подзадач, обновляется, когда автопланирование выключено.
$calculate_duration boolean Системное свойство, используемое для внутренних расчетов.
$custom_data object Содержит пользовательские свойства, импортированные из MS Project/Primavera.
$dataprocessor_class string Указывает, была ли задача обновлена. Когда установлено в "updated", текст задачи отображается жирным в гриде.
$drop_target string ID целевой задачи, добавляется временно во время вертикального перетаскивания.
$effective_calendar string ID календаря, назначенного задаче. Используется для внутренних расчетов.
$expanded_branch boolean Показывает, видна ли задача в зависимости от состояния родительской (развернута или свернута).
$has_child boolean Указывает, должен ли Gantt запросить подзадачи первого уровня задачи, когда branch_loading включено.
$index number Глобальная вертикальная позиция задачи, изменяется в зависимости от состояния (открыто/закрыто) задач выше или ниже.
$level number Уровень задачи в иерархии, начиная с нуля.
$local_index number Позиция задачи в пределах её ветви. Не изменяется при открытии или закрытии задач за пределами ветви.
$new boolean Добавляется при создании новой задачи с помощью createTask() или кнопки "+". Удаляется после сохранения задачи.
$no_end boolean Указывает, что end_date не может быть рассчитана. Задача зависит от дат её подзадач или даты первой задачи. Автопланирование не применяется.
$no_start boolean Указывает, что start_date не может быть рассчитана. Задача зависит от дат её подзадач или даты первой задачи. Автопланирование не применяется.
$open boolean Показывает, открыта ли задача в данный момент. Изменение её значения и повторное отрисовывание Gantt переключит состояние задачи.
$raw object Содержит оригинальные имена свойств задачи, импортированные из MS Project/Primavera до их преобразования в ожидаемый формат Gantt.
$rendered_at string | number ID строки, в которой отображается элемент rollup или задача split.
$rendered_parent number | string ID родителя, под которым отображается задача (не фактический ID родителя).
$rendered_type string Тип отображаемой задачи. Это временное свойство.
$resourceAssignments Array<any> Содержит ID ресурсов, назначенных задаче. Фактические данные хранятся в хранилище назначений ресурсов.
$rollup Array<string | number> Содержит ID задач и этапов, которые появились на текущей задаче.
$source Array<string | number> Содержит ID всех ссылок, исходящих из задачи.
$split_subtask boolean Указывает, является ли задача подзадачей задачи split.
$target Array<string | number> Содержит ID всех ссылок, указывающих на задачу.
$transparent boolean Временное свойство, которое делает задачу слегка прозрачной во время вертикального перетаскивания.
$virtual boolean Добавляется к задачам, сгруппированным по критерию. Эти задачи удаляются после сброса группировки.
$wbs string Код WBS задачи. Обновляется после вызова метода getWBSCode().

Это завершает обзор свойств задачи в Gantt.

Пример

Вот пример того, как может выглядеть структура данных. Она содержит список задач, каждая из которых имеет свои собственные свойства, такие как id, text, start_date и duration. Некоторые задачи вложены под родительской задачей, что указывается свойством parent.

var data = {
  tasks:[
        {id:1, text:"Project #1", start_date:"01-04-2020", duration:18},
        {id:2, text:"Task #1", start_date:"02-04-2020", duration:8, parent:1},
        {id:3, text:"Task #2", start_date:"11-04-2020", duration:8, parent:1}
    ],
    links:[]
};
К началу