exportiert ein Gantt-Diagramm als PNG-Bild
| export | object | optionale Objekt mit Exportoptionen (siehe Details unten) |
gantt.exportToPNG();
//oder
gantt.exportToPNG({
name: "mygantt.png"
});
//oder
gantt.exportToPNG({
name:"mygantt.png",
header:"<h1>My company</h1>",
footer:"<h4>Bottom line</h4>",
locale:"en",
start:"01-04-2013",
end:"11-04-2013",
skin:'terrace',
data:{ },
server:"https://myapp.com/myexport/gantt",
raw:true,
callback: function(res){
alert(res.url);
}
});
Diese Methode ist Teil der export Erweiterung, stellen Sie also sicher, dass das export_api Plugin aktiviert ist. Weitere Informationen finden Sie im Artikel Export nach PDF und PNG.
Für Gantt-Versionen älter als 8.0 müssen Sie das Skript https://export.dhtmlx.com/gantt/api.js in Ihre Seite einbinden, um den Online-Exportdienst zu nutzen, zum Beispiel:
<script src="codebase/dhtmlxgantt.js"></script>
<script src="https://export.dhtmlx.com/gantt/api.js"></script>
Die Methode exportToPNG akzeptiert ein Objekt als Parameter mit mehreren optionalen Eigenschaften:
| name | (string) Dateiname für das exportierte PNG |
| skin | ('terrace', 'skyblue', 'meadow', 'broadway') visuelles Theme für das exportierte Gantt-Diagramm |
| locale | (string) Spracheinstellung für das exportierte Gantt-Diagramm |
| start | (string) Startdatum des angezeigten Datenbereichs im exportierten Diagramm. Das Datumsformat folgt den Einstellungen in date_format |
| end | (string) Enddatum des angezeigten Datenbereichs im exportierten Diagramm. Das Datumsformat folgt den Einstellungen in date_format |
| data | (object) liefert eine benutzerdefinierte Datenquelle, die im exportierten Diagramm verwendet wird |
| header | (string) HTML-Inhalt, der als Header im exportierten PNG hinzugefügt wird |
| footer | (string) HTML-Inhalt, der als Footer im exportierten PNG hinzugefügt wird |
| server | (string) URL des API-Endpunkts für Exportanfragen. Nützlich, wenn Sie einen lokalen Exportservice betreiben. Standard ist https://export.dhtmlx.com/gantt |
| raw | (boolean) wenn true, wird das Gantt-Markup exakt wie vorhanden exportiert, inklusive benutzerdefinierter Elemente. Standard ist false. Mehr Details |
| callback | (function) Callback-Funktion, die ein JSON-Objekt mit einer URL zum Herunterladen des generierten PNG erhält |
| additional_settings | (object) zusätzliche Einstellungen, darunter:
|
Die maximale Exportgröße beträgt 10000×10000 Pixel.
Sie können die Breite und Höhe mit den Eigenschaften width und height in additional_settings anpassen, aber wenn deren Produkt 100000000 (10000×10000) überschreitet, wird das exportierte PNG beschnitten.
Um größere Diagramme zu handhaben, können Sie das Diagramm in Abschnitten exportieren und diese in einem Archiv bündeln, indem Sie die Option slice_archive unter additional_settings verwenden:
gantt.exportToPNG({
server: "https://export.dhtmlx.com/beta/gantt",
additional_settings:{
//width: 2000,
//height: 2000,
slice_archive: {width: 2000, height: 2000},
slice_check: true,
}
});
Beispiel: Export in PNG-Bilder
Sie können die Teilgrößen angeben, indem Sie slice_archive als Objekt mit width und height setzen:
slice_archive: {width: 2000, height: 2000}
Oder einfach auf true setzen, um die Standardgröße von 1000×1000 zu verwenden:
slice_archive: true
Der Exportdienst hat eine Zeitbegrenzung für die Verarbeitung.
Wenn der Export länger als 20 Sekunden dauert, wird er abgebrochen und Sie sehen diese Fehlermeldung:
Error: Timeout trigger 20 seconds
Gleichzeitige Exporte von mehreren Nutzern können die Verarbeitungszeit erhöhen, aber die Exportzeit jedes Nutzers wird separat verfolgt.
Für den Export großer Diagramme empfehlen wir die Nutzung des Standalone Export-Moduls. Dieses Modul ist kostenlos mit Commercial, Enterprise oder Ultimate Lizenzen oder kann separat hier erworben werden.