Task-Eigenschaften

Diese Seite bietet eine vollständige Liste der Eigenschaften, die das Task-Objekt enthalten kann.

Die vollständige Liste der Eigenschaften des Link-Objekts finden Sie im Artikel Link Properties.

Erforderliche Eigenschaften

Diese Eigenschaften sind immer clientseitig definiert. Gantt erwartet, dass diese Eigenschaften im Task-Objekt beim Laden der Daten vorhanden sind. Falls sie fehlen, fügt Gantt sie automatisch hinzu. Das Entfernen einer dieser Eigenschaften aus geladenen Tasks führt zu Fehlern.

Name	Typ	Beschreibung
id	string \| number	Die Task-ID, die automatisch generiert wird, falls nicht angegeben
start_date	Date	Das geplante Startdatum der Aufgabe. Wenn nicht angegeben, berechnet Gantt dieses basierend auf den Eigenschaften end_date und duration. Diese Eigenschaft ist optional, wenn unscheduled: true gesetzt ist.
end_date	Date	Das geplante Abschlussdatum der Aufgabe. Wenn nicht angegeben, berechnet Gantt dieses basierend auf den Eigenschaften start_date und duration. Diese Eigenschaft ist optional, wenn unscheduled: true gesetzt ist.
duration	number	Die Dauer der Aufgabe. Wenn nicht angegeben, berechnet Gantt diese basierend auf den Eigenschaften start_date und end_date.

Optionale Eigenschaften

Diese Eigenschaften können vorhanden sein, müssen es aber nicht. Die Standardlogik und Templates in Gantt nutzen diese Eigenschaften, sofern sie verfügbar sind.

Name	Typ	Beschreibung
auto_scheduling	boolean	Legt fest, ob Gantt die automatische Terminplanung für die Aufgabe durchführen soll (true oder nicht angegeben) oder nicht (false)
bar_height	number	Legt die Höhe des DOM-Elements der Aufgabe in der Zeitleiste fest
baselines	Baseline[]	Ein Array, das die Baselines enthält
calendar_id	number \| string	Weist der Aufgabe die ID eines benutzerdefinierten Kalenders zu. Der Name der Eigenschaft hängt von der calendar_property-Option ab
color	string	Legt die Farbe der Aufgabe in der Zeitleiste fest (betrifft die background-color des gantt_task_line-Elements)
constraint_date	Date	Das Datum der Einschränkung für die Aufgabe, hinzugefügt, wenn automatische Terminplanung mit Zeitbeschränkungen aktiviert ist. Wird nicht verwendet, wenn auto_scheduling_compatibility aktiviert ist.
constraint_type	string	Gibt den Typ der Aufgabenbeschränkung an ("asap", "alap", "snet", "snlt", "fnet", "fnlt", "mso", "mfo"). Wird hinzugefügt, wenn automatische Terminplanung mit Zeitbeschränkungen aktiviert ist. Wird nicht verwendet, wenn auto_scheduling_compatibility aktiviert ist.
deadline	Date	Legt das Fälligkeitsdatum für die Aufgabe fest. Ein visueller Indikator erscheint in der Zeitleiste, wenn dies gesetzt ist.
editable	boolean	Legt fest, ob die Aufgabe in einem schreibgeschützten Gantt-Diagramm bearbeitet werden kann. Der Name der Eigenschaft hängt von der editable_property-Option ab
group_id	string \| number	Die ID der Gruppe, zu der die Aufgabe gehört. Hinzugefügt, wenn Aufgaben nach einer Objekteigenschaft gruppiert werden, die in relation_property in der groupBy()-Methode angegeben ist.
hide_bar	boolean	Legt fest, ob eine Aufgabe (type:"task") oder ein Meilenstein (type:"milestone") in der Zeitleiste ausgeblendet werden soll
key	string \| number	Der Gruppenschlüssel, hinzugefügt, wenn Aufgaben nach einer Array-Eigenschaft in der relation_property in groupBy() gruppiert werden. Wird auch Aufgaben mit dem Gruppennamen hinzugefügt (z. B. "High", "Normal", "Low", wenn nach Priorität gruppiert). Siehe Beispiel.
label	string	Das Gruppenlabel, hinzugefügt zu Aufgaben mit dem Gruppennamen (z. B. "High", "Normal", "Low", wenn nach Priorität gruppiert). Siehe Beispiel.
open	boolean	Gibt an, ob der Aufgaben-Branch initial geöffnet ist, um untergeordnete Aufgaben anzuzeigen. Zum Umschalten nach der Initialisierung verwenden Sie die Methoden close() und open().
parent	number \| string	Die ID der übergeordneten Aufgabe. Aufgaben mit nicht existierenden Eltern werden nicht angezeigt. Die Root-Task-ID wird über die root_id-Konfiguration gesetzt.
progress	number	Der Fortschrittswert der Aufgabe (zwischen 0 und 1)
progressColor	string	Legt die Farbe der Fortschrittsanzeige der Aufgabe in der Zeitleiste fest (betrifft die background-color des gantt_task_progress-Elements)
readonly	boolean	Gibt an, ob die Aufgabe schreibgeschützt sein soll. Der Name der Eigenschaft hängt von der readonly_property-Option ab
render	string	Steuert, wie Unteraufgaben angezeigt werden. Werte: "split" \| "". Wenn auf "split" gesetzt, erscheinen Unteraufgaben in einer Zeile. Wenn die open_split_tasks-Eigenschaft aktiviert ist, werden Unteraufgaben nur dann in einer Zeile angezeigt, wenn die Aufgabe eingeklappt ist.
resource	Array <string>	Ein Array von Ressourcen, die der Aufgabe zugewiesen sind. Wird hinzugefügt, wenn Daten aus MS Project oder Primavera importiert werden
rollup	boolean	Gibt an, ob eine Aufgabe (type:"task") oder ein Meilenstein (type:"milestone") im übergeordneten Projekt angezeigt werden soll.
row_height	number	Legt die Höhe der Aufgabenzeile fest
target	string	Die Ziel-Task-ID. Diese Eigenschaft entspricht der $drop_target-Eigenschaft. Wird dem Task-Objekt nur hinzugefügt, wenn der Data Processor aktiviert ist, nach Task-Updates und Serverkommunikation.
text	any	Der Name der Aufgabe. Sie können bei Bedarf einen anderen Eigenschaftsnamen verwenden. Diese Eigenschaft wird in den Standardkonfigurationen von Gantt verwendet.
textColor	string	Legt die Textfarbe der Aufgabe in der Zeitleiste fest (betrifft die color des gantt_task_line-Elements)
type	string	Der Aufgabentyp. Verfügbare Werte sind im Objekt types definiert: "task" - eine normale Aufgabe (Standard). "project" - eine Aufgabe, die mit dem frühesten Kind beginnt und mit dem spätesten Kind endet. Die Eigenschaften start_date, end_date* und duration werden für diesen Typ ignoriert.* "milestone" - eine Aufgabe mit null Dauer, die wichtige Projektdaten markiert. Die Eigenschaften duration, progress* und end_date werden für diesen Typ ignoriert.*
unscheduled	boolean	Gibt an, ob die Aufgabe ungeplant ist. Standardmäßig werden ungeplante Aufgaben nicht in der Zeitleiste angezeigt; stattdessen erscheinen leere Werte im Grid für Start- und Enddatum.

Dynamische Eigenschaften

Dynamische Eigenschaften werden clientseitig erstellt, um den aktuellen Status einer Aufgabe oder eines Links darzustellen. Sie sind nicht zur Speicherung in der Datenbank gedacht, und Gantt ignoriert sie, wenn sie in Ihrem JSON oder XML enthalten sind.

Name	Typ	Beschreibung
[resource_property]	string \| Array <any>	Diese Eigenschaft kann beliebigen Namen haben. Sie speichert die Ressourcen-ID, die mit resourceGrid/Timeline/Histogram/Calendar verknüpft ist.
$auto_end_date	Date	Ein berechnetes Enddatum für eine Projektaufgabe basierend auf deren Unteraufgaben. Wird hinzugefügt und aktualisiert, wenn "auto_scheduling" deaktiviert ist.
$auto_start_date	Date	Ein berechnetes Startdatum für eine Projektaufgabe basierend auf deren Unteraufgaben. Wird hinzugefügt und aktualisiert, wenn "auto_scheduling" deaktiviert ist.
$calculate_duration	boolean	Eine Systemeigenschaft, die intern für Berechnungen verwendet wird.
$custom_data	object	Enthält benutzerdefinierte Aufgabeneigenschaften, die während importFromMSProject() und importFromPrimaveraP6() definiert wurden
$dataprocessor_class	string	Eine Systemeigenschaft, die angibt, ob die Aufgabe aktualisiert wurde. Wird hinzugefügt, wenn der Data Processor aktiviert ist. Ist sie auf "updated" gesetzt, erscheint der Text der Aufgabe fett im Grid, obwohl benutzerdefinierte CSS-Styles angewendet werden können.
$drop_target	string	Die ID der Zielaufgabe während des vertikalen Ziehens. Diese temporäre Eigenschaft wird beim Ziehen der Aufgabe hinzugefügt.
$effective_calendar	string	Die ID des Kalenders (oder Ressourcen-Kalenders), der der Aufgabe zugewiesen ist. Wird intern für Berechnungen verwendet.
$expanded_branch	boolean	Gibt an, ob die Aufgabe sichtbar ist, basierend darauf, ob die übergeordneten Branches expandiert sind. Ist ein Elternteil eingeklappt, wird die Aufgabe ausgeblendet, mit Ausnahme von Split-Tasks (Unteraufgaben).
$has_child	boolean	Gibt an, ob Gantt das Laden von Unteraufgaben der ersten Ebene vom Server anfordern soll. Wird verwendet, wenn branch_loading aktiviert ist. Der Name der Eigenschaft hängt von der branch_loading_property-Option ab.
$index	number	Die globale vertikale Position der Aufgabe. Dieser Wert wird aktualisiert, wenn Aufgaben darüber oder darunter geöffnet oder geschlossen werden. Wenn der Elternteil eingeklappt ist, spiegelt dies nicht die tatsächliche Position wider.
$level	number	Die Hierarchieebene der Aufgabe (beginnend bei null)
$local_index	number	Die vertikale Position der Aufgabe innerhalb ihres Eltern-Branches. Dieser Wert wird nicht mit globalen Öffnen/Schließen-Änderungen aktualisiert. Wenn der Elternteil eingeklappt ist, spiegelt dies nicht die tatsächliche Position wider.
$new	boolean	Wird hinzugefügt, wenn eine neue Aufgabe über createTask() oder die "+"-Schaltfläche erstellt wird. Ist vorhanden, solange die Lightbox geöffnet ist, und wird nach dem Speichern entfernt.
$no_end	boolean	Erforderliche Systemeigenschaft, die hinzugefügt wird, wenn das end_date nicht berechnet werden kann (start_date ist gesetzt, aber keine duration oder end_date). In diesem Fall kann die Aufgabe nicht verschoben oder in der Größe verändert werden. Das end_date hängt von den Enddaten der Unteraufgaben ab, und start_date bleibt fixiert. Automatische Terminplanung ist deaktiviert. Wenn auch $no_start gesetzt ist, hängt die Aufgabe vollständig von Unteraufgaben oder ersten Aufgaben ab.
$no_start	boolean	Erforderliche Systemeigenschaft, die hinzugefügt wird, wenn das start_date nicht berechnet werden kann (end_date ist gesetzt, aber keine duration oder start_date). Das start_date hängt vom Startdatum der Unteraufgaben oder der ersten Aufgabe ab. Das end_date bleibt fixiert, es sei denn, das Startdatum der Unteraufgaben/ersten Aufgabe überschreitet es. Automatische Terminplanung ist deaktiviert. Wenn auch $no_end gesetzt ist, hängt die Aufgabe vollständig von Unteraufgaben oder ersten Aufgaben ab.
$open	boolean	Eine Systemeigenschaft, die widerspiegelt, ob die Aufgabe aktuell geöffnet ist (true). Wenn Sie diesen Wert ändern und Gantt neu zeichnen, wird die Aufgabe geöffnet oder geschlossen. Alternativ können Sie open() oder close() verwenden.
$raw	object	Enthält die ursprünglichen Eigenschaftsnamen der Aufgabe, die von MS Project oder Primavera während der Exportverarbeitung importiert wurden. Diese erscheinen vor der Umwandlung ins von Gantt erwartete Format.
$rendered_at	string \| number	Die Zeilen-ID, in der ein Rollup-Element oder eine Split-Aufgabe gerendert wird. Diese temporäre Eigenschaft erscheint nur, solange die Rollup/Split-Aufgabe angezeigt wird.
$rendered_parent	number \| string	Die ID des Elternteils, unter dem die Aufgabe gerendert wird (nicht der tatsächliche Elternteil). Wird intern und für die Gruppierung von Aufgaben verwendet.
$rendered_type	string	Temporäre Eigenschaft, die den Typ der gerenderten Aufgabe angibt.
$resourceAssignments	Array <any>	Ein Array von Ressourcen-IDs, die der Aufgabe zugewiesen sind (temporär). Die genauesten Daten werden im Resource Assignments Store gespeichert.
$rollup	Array <string \| number>	Ein Array von IDs für Aufgaben und Meilensteine, die auf dieser Aufgabe angezeigt werden
$source	Array <string \| number>	Erforderlich-ein Array von IDs aller Links, die von der Aufgabe ausgehen
$split_subtask	boolean	Vorhanden, wenn die Aufgabe eine Unteraufgabe einer Split-Aufgabe ist (wird in einer Zeile mit anderen Unteraufgaben angezeigt)
$target	Array <string \| number>	Erforderlich-ein Array von IDs von Links, die auf die Aufgabe zeigen
$transparent	boolean	Temporäre Eigenschaft, die während des vertikalen Ziehens hinzugefügt wird, wodurch die Aufgabe im Grid leicht transparent erscheint.
$virtual	boolean	Wird für Aufgaben hinzugefügt, die nach bestimmten Kriterien gruppiert sind. Aufgaben mit $virtual: true werden entfernt, wenn die Gruppierung zurückgesetzt wird.
$wbs	string	Der WBS-Code der Aufgabe (temporär). Wird nach dem Aufruf von getWBSCode() hinzugefügt. Wenn sich der Code aufgrund von Änderungen an Eltern oder Positionen ändert, rufen Sie getWBSCode() erneut auf, um ihn zu aktualisieren.

Beispiel

const data = {
  tasks: [
    { id: 1, text: "Projekt #1", start_date: "01-04-2025", duration: 18 },
    { id: 2, text: "Aufgabe #1", start_date: "02-04-2025", duration: 8, parent: 1 },
    { id: 3, text: "Aufgabe #2", start_date: "11-04-2025", duration: 8, parent: 1 }
  ],
  links: []
};

Erforderliche Eigenschaften​

Optionale Eigenschaften​

Dynamische Eigenschaften​

Beispiel​

Erforderliche Eigenschaften

Optionale Eigenschaften

Dynamische Eigenschaften

Beispiel