Beispiele Forum Unterstützung
Dokumentation
StartGantt APIMethoden

parse

lädt Daten aus einer clientseitigen Ressource

void parse(string | DataToLoad data, [string type] );
datastring | DataToLoadein String oder Objekt, das Daten repräsentiert
typestringoptional, ('json', 'xml') der Datentyp. Der Standardwert ist 'json'

Example

gantt.parse({
    data:[
        {id:1, text:"Projekt #2", start_date:"01-04-2023", duration:18},
        {id:2, text:"Aufgabe #1", start_date:"02-04-2023", duration:8,
            progress:0.6, parent:1},
        {id:3, text:"Aufgabe #2", start_date:"11-04-2023", duration:8,
            progress:0.6, parent:1}
    ],
    links:[
        { id:1, source:1, target:2, type:1},
        { id:2, source:2, target:3, type:0}
    ]
});

Related samples

Details

Gantt erwartet, dass ein Array mit Aufgaben entweder data oder tasks genannt wird, während ein Array mit Verknüpfungen links genannt wird.

Dies ist die Liste der erwarteten Eigenschaften:

  • data - ([] | NewTask[]) - das Array mit den Aufgabendaten
  • links? - (Link[]) - das Array mit den Verknüpfungsdaten
  • resources? - (NewResourceItem[]) - das Array mit den Ressourcendaten
  • assignments? - (NewAssignmentItem[]) - das Array mit den Zuweisungsdaten
  • collections? - (Сollections) - das Objekt, das die Arrays mit den benutzerdefinierten Daten enthält
gantt.parse({
    data: [
        { id: 1, start_date: "2025-09-23", duration: 42, 
            text: "Hausbau" },
        { id: 2, start_date: "2025-12-02", duration: 60, 
            text: "Hausbau" },
    ],
    "links": [
        { id: "1", source: "1", target: "2", type: "0" },
    ],
    "resources": [
        { id: 1, text: "Anna, Architektin", unit: "Stunden/Tag", 
            default_value: 8, type: "Arbeit" },
    ],
    "assignments": [
      { task_id: "1", resource_id: "1", value: "8" },
      { task_id: "2", resource_id: "1", value: "8", 
            mode: "fixedDates", start_date: "2025-09-23", 
            end_date: "2025-09-25", duration: 4, delay: 2,  },
      { task_id: "2", resource_id: "1", value: "8", 
            start_date: new Date("2025-09-23 00:00:00"), 
            end_date: new Date("2025-09-26 00:00:00"), },
    ]
})

Das data oder tasks Array erwartet das NewTask Objekt, das sich vom Task Objekt unterscheidet. Es kann ein String, ein leeres Objekt sein. Es kann die gleichen Eigenschaften wie das Task Objekt haben, und Sie können dort beliebige benutzerdefinierte Eigenschaften hinzufügen. Der Unterschied besteht darin, dass einige Eigenschaften des Task Objekts, die mit dem $ Zeichen beginnen, ignoriert werden und die Daten den string Typ haben können. Hier ist die Typbeschreibung:

  • NewTask - (string | {} | object) - das Aufgabenobjekt, das zu Gantt hinzugefügt wird. Es kann die folgenden Eigenschaften haben:
    • id? - (string | number) - optional, die Aufgaben-ID, wird automatisch generiert, wenn nicht festgelegt.
    • start_date? - (string | Date) - optional, das Datum, an dem eine Aufgabe geplant ist zu beginnen.
    • duration? - (number) - optional, die Aufgabendauer.
    • end_date? - (string | Date) - optional, das Datum, an dem eine Aufgabe geplant ist abgeschlossen zu werden.
    • text? - (string) - optional, der Aufgabenname.
    • open? - (boolean) - optional, gibt an, ob die Aufgabe beim Laden geöffnet wird (um untergeordnete Aufgaben anzuzeigen).
    • parent? - (string | number) - optional, die ID der übergeordneten Aufgabe.
    • constraint_date? - (string | Date) - optional, das Datum der Aufgabenbeschränkung.
    • [customProperty: string] - (any) - jede andere Eigenschaft, die Sie hinzufügen möchten, einschließlich derjenigen aus dem Task Objekt

Dies ist nicht die vollständige Liste der möglichen Aufgaben-Eigenschaften. Weitere Informationen finden Sie in diesem Artikel.

gantt.parse({
    data: [
        { id: 1, start_date: "2025-09-23", duration: 42, 
            text: "Hausbau" },
    ]
})

Das links Array erwartet die Link Objekte.

gantt.parse({
    data: [],
    links: [
        { id: "1", source: "1", target: "2", type: "0" },
    ]
})

Das resources Array erwartet das NewResourceItem Objekt, das die folgenden Eigenschaften haben kann:

  • NewResourceItem - (object) - das Ressourcenobjekt, das zu Gantt hinzugefügt wird. Es kann die folgenden Eigenschaften haben:
    • id? - (string | number) - optional, die Ressourcen-ID, wird automatisch generiert, wenn nicht festgelegt
    • parent? - (string | number) - optional, die ID der übergeordneten Ressource
    • text? - (string) - optional, der Ressourcenname
    • open? - (boolean) - optional, gibt an, ob die Ressource beim Laden geöffnet wird (um untergeordnete Elemente anzuzeigen)
    • unit? - (string | number) - optional, die Einheit der Ressourcenzuweisung
    • default_value? - (string | number) - optional, der Standardwert, der beim Hinzufügen der Zuweisung im Lightbox-Bereich zugewiesen wird
    • [customProperty: string] - (any) - jede andere Eigenschaft, die Sie hinzufügen möchten
gantt.parse({
    data: [],
    resources: [
        { id: 1, text: "Anna, Architektin", unit: "Stunden/Tag", 
            default_value: 8, type: "Arbeit" },
    ]
})

Das assignments Array erwartet das NewAssignmentItem Objekt, das die folgenden Eigenschaften haben kann:

  • NewAssignmentItem - (object) - das Zuweisungsobjekt, das zu Gantt hinzugefügt wird. Es kann die folgenden Eigenschaften haben:
    • id? - (string | number) - optional, die Zuweisungs-ID, wird automatisch generiert, wenn nicht festgelegt
    • task_id - (string | number) - die ID der Aufgabe, der die Ressource zugewiesen ist
    • resource_id - (string | number) - die ID der Ressource, die der Aufgabe zugewiesen ist
    • value - (number | string) - optional, der Zuweisungswert
    • mode? - (string) - optional, der Berechnungsmodus der Zeit der Ressourcenzuweisung: "default"|"fixedDates"|"fixedDuration"
    • delay? - (number) - optional, der Unterschied zwischen dem Startdatum der Zuweisung und dem Startdatum der Aufgabe
    • start_date? - (string | Date) - optional, das Datum, an dem die Zuweisung beginnen soll
    • duration? - (number) - optional, die Dauer der Zuweisung
    • end_date? - (string | Date) - optional, das Datum, an dem die Zuweisung enden soll
    • [customProperty: string] - (any) - jede andere Eigenschaft, die Sie hinzufügen möchten
gantt.parse({
    data: [],
    assignments: [
      { task_id: "1", resource_id: "1", value: "8" },
    ]
})

Das collections Objekt ermöglicht das Laden beliebiger benutzerdefinierter Daten. Die Eigenschaften können beliebige Namen haben, und der Wert sollte ein Array sein, das die Sammlungselemente enthält:

  • [collectionName: string] - ([] | СollectionItem[]) - ein Array, das die Sammlungselemente enthält.

Das СollectionItem ist ein Objekt, das beliebige Eigenschaften haben kann. Es hat die folgenden Typen für seine Eigenschaften:

  • [itemProperty: string] - (any) - jede benutzerdefinierte Eigenschaft des Sammlungselements.
gantt.parse({
    data: [
        { "id": "1", "text": "Aufgabe #1", "priority": 1, 
            "start_date": "02-04-2019", "duration": 1, },
        { "id": "2", "text": "Aufgabe #2", "priority": 2,  
            "start_date": "01-04-2019", "duration": 1, },
        { "id": "3", "text": "Aufgabe #3", "priority": 3,  
            "start_date": "02-04-2019", "duration": 1, },
        { "id": "4", "text": "Aufgabe #4", "priority": 1,  
            "start_date": "03-04-2019", "duration": 1, },
    ],
    links: [],
    collections: {
        task_priority: [
            { key: 1, label: "Hoch" },
            { key: 2, label: "Normal" },
            { key: 3, label: "Niedrig" }
        ]
    }
});

Wenn Sie Daten laden möchten, die keine Aufgaben enthalten, müssen Sie dennoch ein Array von Aufgaben im Objekt mit Daten definieren, es kann jedoch leer sein:

gantt.parse({
    tasks:[],
    links:[
        { id:1, source:1, target:2, type:1},
        { id:2, source:2, target:3, type:0}
    ]
});


Ab Version 8.0 können Sie neben Aufgaben und Verknüpfungen auch Ressourcen und Ressourcenzuweisungen über die parse() Methode in das Gantt-Diagramm laden:

gantt.parse({
    tasks: [
        ...,
        {
            id: 5,
            text: "Innenausbau Büro",
            type: "task",
            start_date: "03-04-2024 00:00",
            duration: 7,
            parent: "2",
            owner: [
                {
                    resource_id: "6",
                    value: 3,
                    start_date: "03-04-2024 00:00",
                    end_date: "05-04-2024 00:00",
                }
            ]
        },
        ...
    ],
    links: [],
    resources: [
        {id: 6, text: "John", unit: "Stunden/Tag" },
        {id: 7, text: "Mike", unit: "Stunden/Tag" },
        {id: 8, text: "Anna", unit: "Stunden/Tag" },
        {id: 9, text: "Bill", unit: "Stunden/Tag" },
        {id: 10, text: "Floe", unit: "Stunden/Tag" }
    ]
});

Weitere Informationen finden Sie hier.

See also
  • API
  • Articles
    • Zurück nach oben