exportToExcel

exportiert Daten aus dem Gantt-Diagramm in ein Excel-Dokument

void exportToExcel( [object export] );

export

object

optional, ein Objekt mit Exporteinstellungen (siehe die Details)

Example

gantt.exportToExcel({
    name:"document.xlsx", 
    columns:[
        { id:"text",  header:"Titel", width:150 },
        { id:"start_date",  header:"Startdatum", width:250, type:"date" }
    ],
    server:"https://myapp.com/myexport/gantt",
    callback: function(res){
        alert(res.url);
    },
    visual:true,
    cellColors:true,
    date_format: "dddd d, mmmm yyyy"
});

Details

Diese Methode ist in der export-Erweiterung definiert, daher müssen Sie das export_api Plugin aktivieren. Lesen Sie die Details im Artikel Export/Import für Excel, Export zu iCal.

Wenn Sie eine Gantt-Version verwenden, die älter als 8.0 ist, müssen Sie https://export.dhtmlx.com/gantt/api.js auf Ihrer Seite einfügen, um den Online-Exportdienst zu aktivieren, z.B.:

<script src="codebase/dhtmlxgantt.js"></script>
<script src="https://export.dhtmlx.com/gantt/api.js"></script>

Die exportToExcel() Methode nimmt als Parameter ein Objekt mit mehreren Eigenschaften (alle Eigenschaften sind optional):

name - (string) legt den Namen der Ausgabedatei mit der Erweiterung '.xlsx' fest
columns - (array) ermöglicht die Konfiguration der Spalten des Ausgabeblattes in Excel. Die Eigenschaften der Spaltenobjekte sind:
- 'id' - (string,number) eine Eigenschaft des Ereignisses, die der Spalte zugeordnet wird
- 'header' - (string) die Spaltenüberschrift
- 'width' - (number) die Breite der Spalte in Pixel
- 'type' - (string) der Spaltentyp
server - (string) legt den API-Endpunkt für die Anfrage fest. Kann mit der lokalen Installation des Exportdienstes verwendet werden. Der Standardwert ist https://export.dhtmlx.com/gantt
callback - (function) Wenn Sie eine URL zum Herunterladen einer generierten XLSX-Datei erhalten möchten, kann die Callback-Eigenschaft verwendet werden. Sie erhält ein JSON-Objekt mit der URL-Eigenschaft
visual - (boolean) fügt das Zeitdiagramm in das exportierte Excel-Dokument ein; standardmäßig false. Lesen Sie wie man Aufgabenfarben hinzufügt zur exportierten Datei
cellColors - (boolean) wenn auf true gesetzt, haben die Zellen des exportierten Dokuments die durch die timeline_cell_class Vorlage definierten Farben, die color und background-color Eigenschaften werden exportiert
data - (object) legt eine benutzerdefinierte Datenquelle fest, die im ausgegebenen Gantt-Diagramm angezeigt wird
date_format - (string) legt das Format fest, in dem das Datum im exportierten Excel-Dokument angezeigt wird. Der folgende Formatcode kann verwendet werden:

Formatcode	Ausgabe
d	9
dd	09
ddd	Mo
dddd	Montag
mm	01
mmm	Jan
mmmm	Januar
mmmmm	J
yy	12
yyyy	2021
mm/dd/yyyy	01/09/2021
m/d/y	1/9/21
ddd, mmm d	Mo, Jan 9
mm/dd/yyyy h:mm AM/PM	01/09/2021 18:20
dd/mm/yyyy hh:mm:ss	09/01/2012 16:20:00

Standard-Datumsparameter

Das Exportmodul erwartet, dass die start_date und end_date Spalten den Date-Typ haben und die duration Spalte den number-Typ hat.

Im Falle der Anwendung von benutzerdefinierten Vorlagen ist es notwendig, entweder einen Wert des erwarteten Typs zurückzugeben oder einen anderen Wert in der name-Eigenschaft der Spaltenkonfiguration zu definieren. Zum Beispiel:

 
gantt.config.columns = [
    ...
    {name: "start_date", align: "center", width: 100, resize: true, 
        editor: start_dateEditor},
    {name: "end_date", align: "center", width: 100, resize: true, 
        editor: end_dateEditor},
    {name: "duration_formatted",         align: "center", width: 40, resize: true, 
        editor: durationEditor, 
        template: function(task){             return formatter.format(task.duration_formatted);         }
    },
    ...
];

Andernfalls werden die Gantt-Daten nicht exportiert. Überprüfen Sie das zugehörige Beispiel.