Aufgaben-Eigenschaften

Auf dieser Seite finden Sie die vollständige Liste der Eigenschaften, die das Aufgabenobjekt enthalten kann.

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

Erforderliche Eigenschaften

Diese Eigenschaften sind auf dem Client stets definiert. Gantt geht davon aus, dass die Eigenschaften beim Laden der Daten im Aufgabenobjekt angegeben werden, aber falls sie nicht angegeben sind, fügt Gantt sie selbst hinzu. Wenn Sie eine dieser Eigenschaften für die geladenen Aufgaben entfernen, wird Gantt Fehler melden.

Name	Typ	Beschreibung
id	string | number	Die Aufgaben-ID, automatisch generiert, falls sie nicht gesetzt ist
start_date	Date	Das Datum, an dem eine Aufgabe voraussichtlich beginnt. Datenladen Falls nicht angegeben, berechnet Gantt es anhand der Eigenschaften end_date und duration. Die Eigenschaft wird optional, wenn unscheduled: true gesetzt wird.
end_date	Date	Das Datum, an dem eine Aufgabe voraussichtlich beendet wird. Datenladen Falls nicht angegeben, berechnet Gantt es anhand der Eigenschaften start_date und duration. Die Eigenschaft wird optional, wenn unscheduled: true gesetzt wird.
duration	number	Die Aufgaben-Dauer. Datenladen Falls nicht angegeben, berechnet Gantt sie anhand der Eigenschaften start_date und end_date.

Optionale Eigenschaften

Diese Eigenschaften können definiert sein oder auch nicht. Die Standardlogik und Vorlagen von Gantt verwenden diese Eigenschaften, sofern sie definiert sind.

Name	Typ	Beschreibung
auto_scheduling	boolean	Bestimmt, ob Gantt die automatische Terminplanung der Aufgabe durchführt (true oder nicht angegeben) oder nicht (false)
bar_height	number	Setzt die Höhe des DOM-Elements der Aufgabe im Zeitstrahlbereich
baselines	Baseline[]	Ein Array mit Baselines
calendar_id	number | string	Setzt die ID des benutzerdefinierten Kalenders, der der Aufgabe zugewiesen wird. Der Name der Eigenschaft hängt vom Wert der Option calendar_property ab
color	string	Setzt die Farbe der Aufgabe im Zeitstrahlbereich (d. h. setzt background-color für das gantt_task_line-Element der Aufgabe)
constraint_date	Date	Das Datum der Aufgaben-Beschränkung. Es wird der Aufgabenobjekt hinzugefügt, wenn Auto-Scheduling mit Zeitbeschränkungen aktiviert ist. Die Eigenschaft wird nicht verwendet, wenn auto_scheduling_compatibility aktiviert ist.
constraint_type	string	Der Typ der Aufgaben-Beschränkung ("asap", "alap", "snet", "snlt", "fnet", "fnlt", "mso", "mfo"). Er wird dem Aufgabenobjekt hinzugefügt, wenn Auto-Scheduling mit Zeitbeschränkungen aktiviert ist. Die Eigenschaft wird nicht verwendet, wenn auto_scheduling_compatibility aktiviert ist.
deadline	Date	Gibt das Fälligkeitsdatum der Aufgabe an. Eine visuelle Anzeige wird im Zeitstrahl angezeigt, wenn diese Eigenschaft gesetzt ist.
editable	boolean	Definiert, ob die Aufgabe im schreibgeschützten Gantt bearbeitet werden kann (editable) in der Leseansicht von Gantt. Der Name der Eigenschaft hängt von der Option editable_property ab
group_id	string | number	Die ID der Gruppe. Sie wird den Aufgaben hinzugefügt, die nach einem Kriterium gruppiert wurden, falls die Eigenschaft für das Gruppieren der Aufgaben (relation_property in der groupBy()-Methode) als Objekt angegeben ist.
hide_bar	boolean	Gibt an, ob eine Aufgabe (type:"task") oder Meilenstein (type:"milestone") im Zeitstrahlbereich versteckt werden soll
key	string | number	Schlüssel der Gruppe. Er wird den Aufgaben hinzugefügt, die nach einem Kriterium gruppiert wurden, falls die Gruppierungs-Eigenschaft (relation_property in der groupBy()-Methode) als Array angegeben ist. Er wird auch zu den Aufgaben mit dem Namen der Gruppe hinzugefügt (z. B. zu den Aufgaben "High", "Normal", "Low", wenn Sie Aufgaben nach Priorität gruppiert haben. Beispiel prüfen).
label	string	Die Gruppen-Bezeichnung. Sie wird den Aufgaben mit dem Namen der Gruppe hinzugefügt (z. B. wenn Sie Aufgaben nach Priorität gruppiert haben, erhält jede Gruppe einen Namen wie "High", "Normal", "Low". Beispiel prüfen).
open	boolean	Gibt an, ob der Zweig der Aufgabe initial geöffnet sein soll (um Kindaufgaben anzuzeigen). Um den Zweig nach der Initialisierung von Gantt zu schließen/zu öffnen, verwenden Sie die entsprechenden Methoden: close() und open()
parent	number | string	Die ID der übergeordneten Aufgabe. Wenn der angegebene Parent nicht existiert, wird die Aufgabe in Gantt nicht gerendert. Die ID der Stammaufgabe wird durch die root_id-Konfiguration festgelegt.
progress	number	Der Fortschritt der Aufgabe (von 0 bis 1)
progressColor	string	Die Farbe des Aufgabenfortschritts im Zeitstrahlbereich (ändert z. B. background-color des Elements gantt_task_progress des Fortschritts der Aufgabe)
readonly	boolean	Definiert, ob die Aufgabe im schreibgeschützten Gantt als nur-lesbar behandelt wird (readonly-mode). Der Name der Eigenschaft hängt von der Option readonly_property ab
render	string	Legt fest, wie Unteraufgaben der Aufgabe angezeigt werden müssen. Werte: "split" | "". Falls auf "split" gesetzt, werden Unteraufgaben in einer Zeile angezeigt. Zusätzlich werden, wenn Sie die Eigenschaft open_split_tasks aktivieren, die Unteraufgaben nur dann in einer Zeile gerendert, wenn die Aufgabe zusammengeklappt ist.
resource	Array <string>	Ein Array mit Ressourcen, die der Aufgabe zugewiesen sind. Es wird dem Aufgabenobjekt beim Importieren von MS Project/Primavera hinzugefügt
rollup	boolean	Gibt an, ob eine Aufgabe (type:"task") oder Meilenstein (type:"milestone") auf den übergeordneten Projekten erscheinen soll.
row_height	number	Legt die Höhe der Zeile der Aufgabe fest
target	string	Die ID der Zielaufgabe. Die Eigenschaft zeigt denselben Wert wie die $drop_target-Eigenschaft an. Die Eigenschaft wird dem Aufgabenobjekt nur hinzugefügt, wenn Data Processor aktiviert ist, nachdem die Aufgabe aktualisiert wurde und die Daten an den Server gesendet wurden.
text	any	Der Name der Aufgabe. Falls nötig können Sie jeden anderen Namen für diese Eigenschaft verwenden. Die Eigenschaft wird in Standardkonfigurationen verschiedener Teile von Gantt verwendet.
textColor	string	Die Textfarbe der Aufgabe im Zeitstrahlbereich (d. h. setzt color für das gantt_task_line-Element der Aufgabentexte).
type	string	Der Aufgabentyp. Die verfügbaren Werte sind im Objekt types hinterlegt: "task" – eine reguläre Aufgabe (Standardwert). "project" – eine Aufgabe, die beginnt, wenn ihre früheste Kindaufgabe beginnt, und endet, wenn ihre späteste Kindaufgabe endet. Die Eigenschaften start_date, end_date, duration werden für solche Aufgaben ignoriert. "milestone" – eine Null-Dauer-Aufgabe, die verwendet wird, um wichtige Projekttermine zu markieren. Die Eigenschaften duration, progress, end_date werden für solche Aufgaben ignoriert.
unscheduled	boolean	Definiert, ob die Aufgabe unscheduled sein muss. Standardmäßig wird die unscheduled-Aufgabe im Zeitstrahlbereich nicht angezeigt; leere Werte werden in der Gitteransicht anstelle von Start- und Enddaten angezeigt.

Dynamische Eigenschaften

Dynamische Eigenschaften werden auf dem Client erstellt und stellen den aktuellen Zustand einer Aufgabe oder einer Verknüpfung dar. Sie sollten nicht in der Datenbank gespeichert werden; Gantt ignoriert diese Eigenschaften, wenn sie in Ihrem JSON/XML angegeben sind.

Name	Typ	Beschreibung
[resource_property]	string | Array <any>	resource_property Die Eigenschaft kann jeden anderen Namen haben. Diese Eigenschaft speichert die Ressourcen-ID, die mit resourceGrid/Timeline/Histogram/Calendar. verknüpft ist.
$auto_end_date	Date	Ein berechnetes Enddatum der Projektaufgabe basierend auf ihren Unteraufgaben. Hinzugefügt und aktualisiert, wenn „auto_scheduling“ deaktiviert ist.
$auto_start_date	Date	Ein berechnetes Startdatum der Projektaufgabe basierend auf ihren Unteraufgaben. Hinzugefügt und aktualisiert, wenn „auto_scheduling“ deaktiviert ist.
$calculate_duration	boolean	Ein System-Property, das in internen Berechnungen verwendet wird.
$custom_data	object	Ein Objekt, das benutzerdefinierte Eigenschaften einer Aufgabe enthält, die in den Methoden importFromMSProject() und importFromPrimaveraP6() definiert wurden
$dataprocessor_class	string	Ein System-Property, das angibt, ob die Aufgabe aktualisiert wurde. Es wird dem Aufgabenobjekt hinzugefügt, wenn Data Processor aktiviert ist. Wenn der Wert der Eigenschaft "updated" ist, wird der Text der Aufgabe in der Gantt-Grid fett dargestellt, aber Sie können Ihre eigenen Stile über CSS definieren.
$drop_target	string	Die ID der Zielaufgabe. Eine temporäre Eigenschaft, die dem Aufgabenobjekt beim vertikalen Draggen der Aufgabe hinzugefügt wird.
$effective_calendar	string	Die ID des Kalenders (oder Ressourcen-Kalenders), der der Aufgabe zugewiesen ist. Eine System-Eigenschaft, die in internen Berechnungen verwendet wird.
$expanded_branch	boolean	Eine System-Eigenschaft, die anzeigt, ob die Aufgabe sichtbar ist, abhängig davon, ob die Eltern der Aufgabe erweitert sind oder nicht. Wenn mindestens ein Elternteil zusammengeklappt ist, ist die Aufgabe nicht sichtbar. Die Ausnahme gilt nur für aufgespaltene Aufgaben (Unteraufgaben).
$has_child	boolean	Definiert, ob Gantt eine Anfrage an den Server senden soll, um die Unteraufgaben der ersten Ebene der Aufgabe zu laden. Die Eigenschaft wird verwendet, wenn die Eigenschaft branch_loading aktiviert ist. Der Name der Eigenschaft hängt von der Option branch_loading_property ab.
$index	number	Die globale vertikale Position der Aufgabe. Sie ist an die Aufgabe gebunden und ändert sich, wenn darunter oder darüber liegende Aufgaben geöffnet oder geschlossen werden. Wenn der Parent der Aufgabe zusammengeklappt ist, zeigt die Eigenschaft nicht die tatsächliche Position der Aufgabe.
$level	number	Die Ebene der Aufgabe in der Aufgaben-Hierarchie (Null-basierte Nummerierung)
$local_index	number	Die vertikale Position der Aufgabe im Zweig (unter dem Parent). Sie ist nicht an die Aufgabe gebunden und ändert sich nicht, wenn darunter oder darüber liegende Aufgaben geöffnet oder geschlossen sind – sowohl innerhalb des Zweigs als auch global. Wenn der Parent der Aufgabe zusammengeklappt ist, zeigt die Eigenschaft nicht die tatsächliche Position der Aufgabe.
$new	boolean	Wird für eine neue Aufgabe hinzugefügt, wenn sie über die Methode createTask oder über die Schaltfläche "+" erstellt wird. Die Eigenschaft wird dem Aufgabenobjekt beim Öffnen des Lightbox-Fensters hinzugefügt und nach dem Speichern der Aufgabe wieder entfernt.
$no_end	boolean	Erforderlich, eine System-Eigenschaft, die dem Aufgabenobjekt hinzugefügt wird. True, wenn die end_date-Eigenschaft nicht berechnet werden konnte (wenn beim Laden der start_date-Eigenschaft keine duration bzw. end_date vorhanden ist). In diesem Fall können Sie die Aufgabe nicht bewegen oder skalieren. Die end_date-Eigenschaft hängt vom end_date der Unteraufgaben (falls vorhanden) ab. Die start_date-Eigenschaft ist fest und ändert sich nicht. Auto-Scheduling funktioniert für eine solche Aufgabe nicht. Wenn die $no_start-Eigenschaft aktiviert ist, hängt die Aufgabe vollständig von den Daten ihrer Unteraufgaben oder dem Datum der ersten Aufgabe ab.
$no_start	boolean	Erforderlich, eine System-Eigenschaft, die dem Aufgabenobjekt hinzugefügt wird. True, wenn die start_date-Eigenschaft nicht berechnet werden konnte (wenn die end_date-Eigenschaft geladen ist, aber weder duration noch start_date vorhanden ist). Die start_date-Eigenschaft hängt von den start_date der Unteraufgaben (falls vorhanden) oder vom Datum der ersten Aufgabe ab. Die end_date-Eigenschaft wird festgelegt und ändert sich nur, wenn das Startdatum der Unteraufgaben/erste Aufgabe größer als das Enddatum der Aufgabe ist. Auto-Scheduling funktioniert für eine solche Aufgabe nicht. Wenn die $no_end-Eigenschaft aktiviert ist, hängt die Aufgabe vollständig von den Daten ihrer Unteraufgaben oder dem Datum der ersten Aufgabe ab.
$open	boolean	Eine System-Eigenschaft, die angibt, ob die Aufgabe derzeit geöffnet ist (true). Wenn Sie den Wert der Eigenschaft ändern und Gantt neu zeichnen, wird die Aufgabe geöffnet oder geschlossen. Um den Status der Aufgabe zu ändern, können Sie außerdem die Methoden open oder close verwenden.
$raw	object	Ein Objekt mit den ursprünglichen Namen von Aufgabeneigenschaften, die aus MS Project / Primavera in das Export-Modul (Export-Server) importiert wurden. Die Eigenschaften erscheinen im $raw-Objekt, während die Datei in JSON-Format konvertiert wird, aber bevor sie in die von Gantt erwarteten Namen und Formate konvertiert werden.
$rendered_at	string | number	Die ID einer Zeile, in der der Rollup-Artikel / Split der Aufgabe gerendert wird. Dies ist die temporäre Eigenschaft, die im Objekt der Rollup-/Split-Aufgabe nur dann erscheint, wenn sie auf der Seite gerendert wurde.
$rendered_parent	number | string	Die ID des Elternteils, unter dem die Aufgabe gerendert wird (nicht die ID des echten Elternteils der Aufgabe). Die Eigenschaft wird in internen Berechnungen und bei der Gruppierung von Aufgaben verwendet.
$rendered_type	string	Der Typ der gerenderten Aufgabe (eine temporäre Eigenschaft).
$resourceAssignments	Array <any>	Ein Array mit IDs von Ressourcen, die der Aufgabe zugewiesen sind (eine temporäre Eigenschaft). Die aktuellsten Daten befinden sich jedoch im Store der Ressourcen-Zuweisungen, nicht in dieser Eigenschaft.
$rollup	Array <string | number>	Ein Array mit IDs von Aufgaben und Meilensteinen, die [auf der aktuellen Aufgabe] erschienen sind
$source	Array <string | number>	Erforderlich, ein Array mit IDs aller Verknüpfungen, die von der Aufgabe ausgehen
$split_subtask	boolean	Tritt auf, wenn die Aufgabe eine Unteraufgabe einer geteilten Aufgabe ist (d. h. sie ordnet sich in einer Zeile mit anderen Unteraufgaben an)
$target	Array <string | number>	Erforderlich, ein Array mit IDs von Verknüpfungen, die in die Aufgabe hineinführen
$transparent	boolean	Eine temporäre Eigenschaft, die dem Aufgabenobjekt beim vertikalen Draggen hinzugefügt wird. Die Aufgabe wirkt im Raster beim vertikalen Draggen leicht transparent aufgrund dieser Eigenschaft.
$virtual	boolean	Sie wird Aufgaben hinzugefügt, die nach einem Kriterium gruppiert wurden. Nachdem die Gruppierung zurückgesetzt wurde, werden Aufgaben mit $virtual: true entfernt
$wbs	string	Der WBS-Code der Aufgabe (eine temporäre Eigenschaft). Sie wird dem Aufgabenobjekt nach Anwendung der Methode getWBSCode hinzugefügt. Wenn sich der Code-Wert geändert hat (Elternelement oder Position der Aufgabe geändert), müssen Sie die Methode getWBSCode erneut aufrufen, um den aktualisierten Wert des Codes zu erhalten.

Beispiel

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