Beispiele Forum Unterstützung
Dokumentation
StartAnleitungenEinrichten von Aufgaben

Task-Eigenschaften

Dieses Dokument bietet eine detaillierte Liste aller Eigenschaften, die ein Task-Objekt haben kann.

Für Details zu den Eigenschaften des Link-Objekts, siehe den Artikel Link Properties.

Erforderliche Eigenschaften

Diese Eigenschaften sind immer auf der Client-Seite vorhanden. Gantt erwartet, dass sie im Task-Objekt während des Datenladens enthalten sind. Falls sie fehlen, fügt Gantt sie automatisch hinzu. Das Entfernen einer dieser Eigenschaften nach dem Laden der Tasks führt zu Fehlern.

Name Typ Beschreibung
id string | number Eine eindeutige Kennung für die Aufgabe. Sie wird automatisch generiert, wenn sie nicht angegeben wird.
start_date Date Gibt an, wann die Aufgabe beginnt. Falls nicht angegeben, berechnet Gantt sie basierend auf end_date und duration. Die Eigenschaft ist optional, wenn unscheduled: true gesetzt ist.
end_date Date Gibt an, wann die Aufgabe endet. Falls nicht angegeben, berechnet Gantt sie basierend auf start_date und duration. Die Eigenschaft ist optional, wenn unscheduled: true gesetzt ist.
duration number Definiert, wie lange die Aufgabe dauert. Falls nicht angegeben, berechnet Gantt sie basierend auf start_date und end_date.

Optionale Eigenschaften

Diese Eigenschaften sind optional und werden von Gantts Standardlogik und -vorlagen verwendet, wenn sie definiert sind.

Name Typ Beschreibung
auto_scheduling boolean Bestimmt, ob Gantt die Aufgabe automatisch planen soll (true oder nicht angegeben) oder nicht (false).
bar_height number Passt die Höhe des DOM-Elements der Aufgabe in der Zeitleiste an.
baselines Baseline[] Enthält ein Array von Baselines.
calendar_id number | string Weist der Aufgabe einen benutzerdefinierten Kalender zu. Der Name der Eigenschaft hängt vom Wert der calendar_property Option ab.
color string Legt die Farbe der Aufgabe in der Zeitleiste fest (gilt für die background-color des gantt_task_line Elements).
constraint_date Date Gibt das Einschränkungsdatum der Aufgabe an, wenn die automatische Planung mit Zeitbeschränkungen aktiviert ist. Wird nicht verwendet, wenn auto_scheduling_compatibility aktiviert ist.
constraint_type string Definiert die Art der Aufgabeinschränkung (z.B. "asap", "alap", etc.) bei der automatischen Planung mit Zeitbeschränkungen. Wird nicht verwendet, wenn auto_scheduling_compatibility aktiviert ist.
deadline Date Setzt eine Frist für die Aufgabe. Wenn definiert, erscheint ein visueller Indikator in der Zeitleiste.
editable boolean Bestimmt, ob die Aufgabe in einem schreibgeschützten Gantt-Diagramm bearbeitet werden kann. Der Name der Eigenschaft hängt vom Wert der editable_property Option ab.
group_id string | number Die ID der Gruppe, zu der die Aufgabe gehört. Hinzugefügt zu Aufgaben, die nach einem bestimmten Kriterium gruppiert sind.
hide_bar boolean Gibt an, ob eine Aufgabe oder ein Meilenstein in der Zeitleiste versteckt werden soll.
key string | number Der Gruppenschlüssel, hinzugefügt zu Aufgaben, die nach einem als Array angegebenen Kriterium gruppiert sind.
label string Das Gruppenlabel, hinzugefügt zu Aufgaben mit Namen der gruppierten Elemente (z.B. "Hoch", "Normal", "Niedrig" bei Gruppierung nach Priorität).
open boolean Gibt an, ob der Aufgabenast anfangs geöffnet ist, um untergeordnete Aufgaben anzuzeigen. Verwenden Sie die open() oder close() Methoden, um den Ast nach der Initialisierung umzuschalten.
parent number | string Die ID der übergeordneten Aufgabe. Die Aufgabe wird nicht gerendert, wenn das angegebene übergeordnete Element nicht existiert. Die ID der Stammaufgabe ist durch die root_id Konfiguration definiert.
progress number Stellt den Fortschritt der Aufgabe als Wert zwischen 0 und 1 dar.
progressColor string Legt die Farbe der Fortschrittsanzeige in der Zeitleiste fest (gilt für die background-color des gantt_task_progress Elements).
readonly boolean Gibt an, ob die Aufgabe schreibgeschützt ist. Der Name der Eigenschaft hängt vom Wert der readonly_property Option ab.
render string Definiert, wie Unteraufgaben angezeigt werden. Werte: "split" oder "". Wenn auf "split" gesetzt, erscheinen Unteraufgaben in einer einzigen Zeile, insbesondere wenn die Aufgabe eingeklappt ist und open_split_tasks aktiviert ist.
resource Array<string> Speichert Ressourcen, die der Aufgabe zugewiesen sind. Hinzugefügt beim Import von Daten aus MS Project/Primavera.
rollup boolean Gibt an, ob eine Aufgabe oder ein Meilenstein auf übergeordneten Projekten erscheinen soll.
row_height number Legt die Höhe der Aufgabenzeile fest.
target string Die ID der Zielaufgabe. Hinzugefügt, wenn der Datenprozessor aktiviert ist und die Aufgabe aktualisiert wird.
text any Der Name der Aufgabe. Kann mit jedem anderen Namen für diese Eigenschaft verwendet werden.
textColor string Legt die Textfarbe der Aufgabe in der Zeitleiste fest (gilt für die color des gantt_task_line Elements).
type string Definiert den Aufgabentyp. Verfügbare Werte sind: "task", "project", "milestone". Für Details zu Aufgabentypen, siehe die Dokumentation zu Aufgabentypen.
unscheduled boolean Gibt an, ob die Aufgabe nicht geplant ist. Nicht geplante Aufgaben werden standardmäßig nicht in der Zeitleiste angezeigt, und ihre Rasterzellen für Start-/Enddaten bleiben leer.

Dynamische Eigenschaften

Dynamische Eigenschaften werden auf der Client-Seite generiert und spiegeln den aktuellen Zustand einer Aufgabe oder eines Links wider. Diese Eigenschaften werden nicht in der Datenbank gespeichert und von Gantt ignoriert, wenn sie in Ihrem JSON/XML angegeben sind.

Name Typ Beschreibung
[resource_property] string | Array<any> Speichert die Ressource-ID, die mit resourceGrid/Timeline/Histogram/Calendar verknüpft ist.
$auto_end_date Date Das berechnete Enddatum einer Projektaufgabe basierend auf ihren Unteraufgaben, aktualisiert, wenn die automatische Planung deaktiviert ist.
$auto_start_date Date Das berechnete Startdatum einer Projektaufgabe basierend auf ihren Unteraufgaben, aktualisiert, wenn die automatische Planung deaktiviert ist.
$calculate_duration boolean Eine Systemeigenschaft, die für interne Berechnungen verwendet wird.
$custom_data object Enthält benutzerdefinierte Eigenschaften, die aus MS Project/Primavera importiert wurden.
$dataprocessor_class string Gibt an, ob die Aufgabe aktualisiert wurde. Wenn auf "updated" gesetzt, erscheint der Aufgabentext fett im Raster.
$drop_target string Die ID der Zielaufgabe, vorübergehend hinzugefügt während des vertikalen Ziehens.
$effective_calendar string Die Kalender-ID, die der Aufgabe zugewiesen ist. Wird für interne Berechnungen verwendet.
$expanded_branch boolean Zeigt an, ob die Aufgabe basierend auf dem Zustand ihres übergeordneten Elements (erweitert oder eingeklappt) sichtbar ist.
$has_child boolean Gibt an, ob Gantt die ersten Unteraufgaben einer Aufgabe anfordern soll, wenn branch_loading aktiviert ist.
$index number Die globale vertikale Position der Aufgabe, die sich basierend auf dem Öffnungs-/Schließzustand von Aufgaben darüber oder darunter ändert.
$level number Die Ebene der Aufgabe in der Hierarchie, beginnend bei null.
$local_index number Die Position der Aufgabe innerhalb ihres Astes. Ändert sich nicht, wenn Aufgaben außerhalb des Astes geöffnet oder geschlossen werden.
$new boolean Hinzugefügt, wenn eine neue Aufgabe über createTask() oder die "+"-Schaltfläche erstellt wird. Entfernt nach dem Speichern der Aufgabe.
$no_end boolean Gibt an, dass das end_date nicht berechnet werden konnte. Die Aufgabe hängt von den Daten ihrer Unteraufgaben oder dem Datum der ersten Aufgabe ab. Automatische Planung wird nicht angewendet.
$no_start boolean Gibt an, dass das start_date nicht berechnet werden konnte. Die Aufgabe hängt von den Daten ihrer Unteraufgaben oder dem Datum der ersten Aufgabe ab. Automatische Planung wird nicht angewendet.
$open boolean Zeigt an, ob die Aufgabe derzeit geöffnet ist. Durch Ändern des Wertes und erneutes Zeichnen von Gantt wird der Zustand der Aufgabe umgeschaltet.
$raw object Enthält originale Aufgaben-Eigenschaftsnamen, die aus MS Project/Primavera importiert wurden, bevor sie in das von Gantt erwartete Format konvertiert werden.
$rendered_at string | number Die ID der Zeile, in der ein Rollup-Element oder eine geteilte Aufgabe gerendert wird.
$rendered_parent number | string Die ID des übergeordneten Elements, unter dem die Aufgabe gerendert wird (nicht die tatsächliche übergeordnete ID).
$rendered_type string Der Typ der gerenderten Aufgabe. Dies ist eine temporäre Eigenschaft.
$resourceAssignments Array<any> Enthält IDs von Ressourcen, die der Aufgabe zugewiesen sind. Die tatsächlichen Daten werden im Ressourcenzuweisungsspeicher gespeichert.
$rollup Array<string | number> Enthält IDs von Aufgaben und Meilensteinen, die auf der aktuellen Aufgabe aufgetreten sind.
$source Array<string | number> Enthält IDs aller Links, die von der Aufgabe ausgehen.
$split_subtask boolean Gibt an, ob die Aufgabe eine Unteraufgabe einer geteilten Aufgabe ist.
$target Array<string | number> Enthält IDs aller Links, die auf die Aufgabe zeigen.
$transparent boolean Eine temporäre Eigenschaft, die die Aufgabe während des vertikalen Ziehens leicht transparent erscheinen lässt.
$virtual boolean Hinzugefügt zu Aufgaben, die nach einem Kriterium gruppiert sind. Diese Aufgaben werden entfernt, nachdem die Gruppierung zurückgesetzt wird.
$wbs string Der WBS-Code der Aufgabe. Aktualisiert nach dem Aufruf der getWBSCode() Methode.

Dies schließt die Übersicht über die Task-Eigenschaften in Gantt ab.

Beispiel

Hier ist ein Beispiel, wie die Datenstruktur aussehen könnte. Es enthält eine Liste von Aufgaben, jede mit ihren eigenen Eigenschaften wie id, text, start_date und duration. Einige Aufgaben sind unter einer übergeordneten Aufgabe verschachtelt, wie durch die parent Eigenschaft angegeben.

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:[]
};
Zurück nach oben