Этот документ предоставляет подробный список всех свойств, которые может иметь объект задачи.
Для получения сведений о свойствах объекта ссылки, обратитесь к статье Свойства Ссылки.
Эти свойства всегда присутствуют на стороне клиента. 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:[]
};
К началу