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.
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. |
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](Zusätzliche Elemente in der Zeitleiste) 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:
|
| 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 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. |
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: []
};