groupBy

정보

이 기능은 PRO 에디션에서만 사용할 수 있습니다.

Description

지정된 작업의 속성으로 작업을 그룹화합니다

groupBy: (config: GroupConfig | boolean) => void

Parameters

• config - (required) GroupConfig | boolean - 그룹화 구성 객체, 또는 태스크를 그룹 해제하려면 false

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

• 작업 그룹화

Details

노트

이 메서드는 grouping 확장에 정의되어 있으므로 grouping 플러그인을 활성화해야 합니다. 자세한 내용은 Grouping Tasks 문서를 참조하세요.

그룹화 설정 객체에는 다음과 같은 속성이 포함됩니다:

• relation_property - (string) - 항목을 그룹화하는 데 사용될 작업 객체의 속성.
• groups - (СollectionItem[]) - 그룹(요약) 항목의 배열. 각 아이템은 기본값으로 설정된 group_id 와 group_text 매개변수에 해당하는 속성을 가져야 합니다. 기본값은 key 와 label 입니다.
• group_id? - (string) - 선택적, 그룹의 id. 기본값은 'key' 입니다.
• group_text? - (string) - 선택적, 그룹의 레이블. 기본값은 'label' 입니다.
• delimiter? - (string) - 선택적, 다중 리소스가 있는 작업에 대한 자동 그룹 생성을 위한 구분자. 기본값은 ",".
• default_group_label? - (string) - 선택적, 기본 그룹의 이름. 선택적. 기본값은 'None' 입니다.
• save_tree_structure? - (boolean) - 선택적, 그룹 내에 트리 구조를 저장할지 여부를 정의합니다. 명시되지 않았거나 false로 설정되면 Gantt 작업은 평면 목록으로 표시됩니다.

참고 사항:

• 각 그룹 객체는 최소 두 개의 속성을 가져야 하며, 각각 'group_id'와 'group_text'로 정의된 id와 텍스트 레이블입니다. 기본값은 key와 label입니다. "id"를 제외한 다른 이름을 사용할 수 있으며, 그룹 배열에 존재해야 합니다.

노트

"id" 속성은 허용되지 않습니다. Gantt는 가상 그룹 작업을 생성하고 여기에 'group_id'와 'group_text' 속성을 삽입하기 때문입니다. 따라서 그룹화된 작업은 기본적으로 'key'와 'value' 속성을 갖습니다. 각 작업이 이미 'id' 속성을 가지고 있기 때문에 기본 id를 변경하면 트리 구조가 손상될 수 있습니다.

• 원본 'project' 작업은 그룹화 모드에서 표시되지 않지만 API를 통해 접근할 수 있습니다.
• 그룹 항목은 'readonly' 플래그가 설정된 'project' 유형 작업으로 추가됩니다. 이들은 '$virtual' 속성으로 식별할 수 있으며 일반 작업처럼 처리할 수 있습니다:

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

• 기본 그룹은 다른 그룹에 할당되지 않은 작업을 포함합니다. 이는 relation_property가 string|number 값으로 지정된 작업을 제외합니다.

노트

sample Save tree structure when grouping tasks

Related Guides

• 작업 그룹화

Change log

• save_tree_structure 옵션은 v8.0에서 도입되었습니다.