exportiert ein Gantt-Diagramm im PNG-Format
| export | object | optional, ein Objekt mit Export-Einstellungen (siehe die Details) |
gantt.exportToPNG();
//oder
gantt.exportToPNG({
name: "mygantt.png"
});
//oder
gantt.exportToPNG({
name:"mygantt.png",
header:"<h1>Mein Unternehmen</h1>",
footer:"<h4>Schlussfolgerung</h4>",
locale:"de",
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 in der export-Erweiterung definiert, daher müssen Sie das export_api Plugin aktivieren. Lesen Sie die Details im Artikel Exportieren als PDF und PNG.
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 Methode exportToPNG nimmt als Parameter ein Objekt mit mehreren Eigenschaften (alle Eigenschaften sind optional):
| name | (string) der Name der Ausgabedatei |
| skin | ('terrace', 'skyblue', 'meadow', 'broadway') das Design des exportierten Gantt-Diagramms |
| locale | (string) legt die Sprache fest, die im exportierten Gantt-Diagramm verwendet wird |
| start | (string) legt das Startdatum des Datenbereichs fest, der im exportierten Gantt-Diagramm angezeigt wird. Das Datumsformat wird durch die date_format Konfiguration definiert |
| end | (string) legt das Enddatum des Datenbereichs fest, der im exportierten Gantt-Diagramm angezeigt wird. Das Datumsformat wird durch die date_format Konfiguration definiert |
| data | (object) legt eine benutzerdefinierte Datenquelle fest, die im exportierten Gantt-Diagramm angezeigt wird |
| header | (string) gibt die Kopfzeile an, die dem exportierten PDF-Bild hinzugefügt wird. Hinweis: Sie können hier beliebiges HTML verwenden |
| footer | (string) gibt die Fußzeile an, die dem exportierten PDF-Bild hinzugefügt wird. Hinweis: Sie können hier beliebiges HTML verwenden |
| 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 |
| raw | (boolean) definiert, dass alle Gantt-Markup so exportiert werden, wie sie sind, mit allen benutzerdefinierten Elementen. false standardmäßig. Lesen Sie die Details |
| callback | (function) Wenn Sie eine URL zum Herunterladen einer generierten PNG-Datei erhalten möchten, kann die Callback-Eigenschaft verwendet werden. Sie erhält ein JSON-Objekt mit der URL-Eigenschaft |
| additional_settings | (object) ein Objekt mit zusätzlichen Einstellungen. Das Objekt kann die folgenden Attribute enthalten:
|
Die maximalen Größen der exportierten Datei betragen 10000х10000.
Sie können eine der Größen erhöhen und die andere entsprechend über die Attribute width/height der additional_settings-Eigenschaft verringern. Wenn jedoch das Produkt der Werte von Breite und Höhe größer als 100000000 (10000х10000) ist, wird das ausgegebene PNG-Bild abgeschnitten.
Es besteht die Möglichkeit, das Gantt-Diagramm in Teilen zu exportieren und diese im Archiv zu erhalten, indem Sie das Attribut slice_archive der additional_settings-Eigenschaft der Methode 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,
}
});
Verwandtes Beispiel: Export in PNG-Bilder
Sie können entweder die Größen der ausgegebenen PNG-Bilder festlegen, indem Sie das Attribut als Objekt mit den Optionen width und height setzen:
slice_archive: {width: 2000, height: 2000}
oder Sie können das Attribut auf true setzen. In diesem Fall haben die exportierten Teile des Gantt-Diagramms die Standardgrößen: 1000×1000.
slice_archive: true
Der Exportdienst hat Zeitbeschränkungen.
Wenn der Prozess länger als 20 Sekunden dauert, wird der Export abgebrochen und der folgende Fehler tritt auf:
Error: Timeout trigger 20 seconds
Wenn mehrere Personen gleichzeitig Gantt exportieren, kann der Prozess länger als üblich dauern. Aber das ist in Ordnung, da die für die Exportanfrage eines bestimmten Benutzers benötigte Zeit separat gezählt wird.
Wenn Sie große Diagramme exportieren müssen, können Sie ein eigenständiges Exportmodul verwenden. Das Exportmodul wird kostenlos bereitgestellt, wenn Sie Gantt unter einer Commercial, Enterprise oder Ultimate Lizenz erworben haben, oder Sie können das Modul separat kaufen.