groupBy

организация задач на основе конкретного свойства задачи

void groupBy(GroupConfig | boolean config);

config

GroupConfig | boolean

объект конфигурации для группировки или false для отключения группировки

Available only in PRO Edition

Example

// группировка одного уровня
gantt.groupBy({
    relation_property: "priority",
    groups: [
        {key:0, label: "High"},
        {key:4, label: "Normal"},
        {key:5, label: "Low"},
    ],
    group_id: "key",
    group_text: "label",
    save_tree_structure: true
});
 
// многоуровневая группировка
gantt.groupBy({
    relation_property: "priority",
    groups: [
        {key:0, label: "High"},
        {key:4, label: "Normal"},
        {key:5, label: "Low"},
        // вложенные группы
        {key:1, label: "Give High Attention", "priority":0},
        {key:2, label: "Resolve Immediately", "priority":0},
        {key:3, label: "Keep For Next Release", "priority":5}
    ],
    group_id: "key",
    group_text: "label"
});
 
// использование предопределённых коллекций
gantt.serverList("priority", [
    {key:1, label: "High"},
    {key:2, label: "Normal"},
    {key:3, label: "Low"}
]);
gantt.groupBy({
    groups: gantt.serverList("priority"),
    relation_property: "priority",
    group_id: "key",
    group_text: "label"
});
 
// отключение группировки
gantt.groupBy(false);

Related samples

Tasks grouping

Details

Эта функция доступна только в PRO-версии.

Этот метод является частью расширения grouping, поэтому плагин grouping должен быть включён. Подробнее см. статью Группировка задач.

Объект конфигурации группировки включает в себя следующие свойства:

relation_property - (string) - свойство задачи, по которому происходит группировка.
groups - (СollectionItem[]) - массив элементов групп (сводных элементов). Каждый элемент должен содержать свойства, указанные в group_id и group_text (по умолчанию key и label).
group_id? - (string) - необязательный идентификатор групп. По умолчанию 'key'.
group_text? - (string) - необязательная метка групп. По умолчанию 'label'.
delimiter? - (string) - необязательный разделитель, используется для автоматического создания групп для задач с несколькими ресурсами. По умолчанию ",".
default_group_label? - (string) - необязательная метка для группы по умолчанию. По умолчанию 'None'.
save_tree_structure? - (boolean) - необязательный параметр, определяющий, сохраняет ли Gantt исходную древовидную структуру внутри групп. Если не указано или false, задачи отображаются как плоский список.

Обратите внимание:

Каждый объект группы должен иметь как минимум два свойства: идентификатор и текстовую метку, определённые через 'group_id' и 'group_text' соответственно. По умолчанию это key и label. Можно использовать другие имена, кроме "id", при условии, что они присутствуют в массиве групп.

Свойство "id" не разрешено, так как Gantt создаёт виртуальные групповые задачи и вставляет в них свойства 'group_id' и 'group_text'. Это означает, что сгруппированные задачи по умолчанию будут иметь свойства 'key' и 'value'. Поскольку у каждой задачи уже есть свойство 'id', изменение этих стандартных идентификаторов может нарушить структуру дерева.

Исходные задачи типа 'project' не отображаются в режиме группировки, но остаются доступными через API.
Элементы групп добавляются как задачи типа 'project' с установленным флагом 'readonly'. Их можно идентифицировать по свойству '$virtual' и обрабатывать как обычные задачи:

gantt.templates.task_class=function(start, end, task){
  if(task.$virtual)
    return "summary-bar";
};

Группа по умолчанию содержит задачи, не относящиеся к другим группам. Она исключает задачи, у которых relation_property задано как string|number.
Related sample: Save tree structure when grouping tasks