groupBy

Gruppiert Aufgaben nach dem angegebenen Attribut der Aufgabe

void groupBy(GroupConfig | boolean config);
configGroupConfig | booleandas Gruppierungskonfigurationsobjekt oder false, um Aufgaben zu entgruppieren

Available only in PRO Edition

Example

// Ein-Level-Gruppierung
gantt.groupBy({
    relation_property: "priority",
    groups: [
        {key:0, label: "Hoch"},
        {key:4, label: "Normal"},
        {key:5, label: "Niedrig"},
    ],
    group_id: "key",
    group_text: "label",
    save_tree_structure: true
});
 
// Mehrfach-Level-Gruppierung
gantt.groupBy({
    relation_property: "priority",
    groups: [
        {key:0, label: "Hoch"},
        {key:4, label: "Normal"},
        {key:5, label: "Niedrig"},
        // Mehrfach-Level-Gruppen
        {key:1, label: "Hohe Aufmerksamkeit geben", "priority":0},
        {key:2, label: "Sofort lösen", "priority":0},
        {key:3, label: "Für nächste Veröffentlichung aufbewahren", "priority":5}
    ],
    group_id: "key",
    group_text: "label"
});
 
// Verwendung von Sammlungen
gantt.serverList("priority", [
    {key:1, label: "Hoch"},
    {key:2, label: "Normal"},
    {key:3, label: "Niedrig"}
]);
gantt.groupBy({
    groups: gantt.serverList("priority"),
    relation_property: "priority",
    group_id: "key",
    group_text: "label"
});
 
// Entgruppierung von Aufgaben
gantt.groupBy(false);

Related samples

Details

Diese Funktionalität ist nur in der PRO-Edition verfügbar.

Diese Methode ist in der grouping Erweiterung definiert, daher müssen Sie das grouping Plugin aktivieren. Lesen Sie die Details im Artikel Gruppierung von Aufgaben.

Das Gruppierungskonfigurationsobjekt hat die folgenden Eigenschaften:

  • relation_property - (string) - eine Eigenschaft eines Aufgabenobjekts, die verwendet wird, um Elemente zu gruppieren.
  • groups - (СollectionItem[]) - ein Array der Gruppen (Zusammenfassungs-)Elemente. Jedes Element sollte die in den group_id und group_text Parametern festgelegten Eigenschaften haben (standardmäßig key und label).
  • group_id? - (string) - optional, die ID der Gruppe. Der Standardwert ist 'key'.
  • group_text? - (string) - optional, das Label der Gruppe. Der Standardwert ist 'label'.
  • delimiter? - (string) - optional, das Trennzeichen wird für die automatische Erstellung von Gruppen für Aufgaben mit mehreren Ressourcen verwendet. Der Standardwert ist ",".
  • default_group_label? - (string) - optional, der Name der Standardgruppe. Optional. Der Standardwert ist 'None'.
  • save_tree_structure? - (boolean) - optional, definiert, ob der Gantt seine Baumstruktur innerhalb der Gruppen speichern soll. Wenn nicht angegeben oder auf false gesetzt, werden Gantt-Aufgaben in einer flachen Listenansicht angezeigt.

Bitte beachten Sie:

  • Jedes 'group' Objekt muss mindestens 2 Eigenschaften enthalten (aber beliebig viele zusätzliche): die ID und die Textbeschreibung, die durch die Parameter 'group_id' und 'group_text' festgelegt sind. Standardmäßig haben diese Parameter die Werte key und label. Sie können andere Werte für diese Parameter verwenden (außer "id"), vorausgesetzt, sie sind im Gruppenarray angegeben.

Der "id" Wert ist nicht zulässig, da der Gantt beim Gruppieren von Aufgaben virtuelle Gruppierungsaufgaben erstellt und die Parameter 'group_id' und 'group_text' in diese Aufgaben hinzufügt. Das bedeutet, dass die gruppierten Aufgaben standardmäßig die Eigenschaften 'key' und 'value' haben. Gleichzeitig hat jede Aufgabe bereits die Eigenschaft 'id', und das Ändern der Standard-IDs von Aufgaben würde die Baumstruktur brechen.

  • Die 'project' Aufgaben aus dem ursprünglichen Datensatz werden im Gruppierungsmodus nicht angezeigt, sind jedoch über die API verfügbar.
  • Gruppenobjekte werden als Elemente mit dem Typ 'project' und der aktivierten Eigenschaft 'readonly' in den Datensatz eingefügt. Sie können durch die '$virtual' Eigenschaft erkannt und wie reguläre Datenelemente behandelt werden:
gantt.templates.task_class=function(start, end, task){
  if(task.$virtual)
    return "summary-bar";
};
See also
Change log
  • Der save_tree_structure Parameter wurde in v8.0 hinzugefügt.
Zurück nach oben