Exportieren und Importieren von Daten
dhtmlxGantt kann ein Diagramm in PDF-, PNG-, Excel-, iCal-, MS-Project-, Primavera-P6- und JSON-Dateien exportieren und Daten aus Excel-, MS-Project- und Primavera-P6-Dateien importieren. Jeder Datei-Export und -Import läuft über einen Exportdienst: entweder über den von DHTMLX gehosteten Online-Exportdienst oder über ein Exportmodul, das Sie auf Ihrem eigenen Server installieren.
In dieser Dokumentation gilt:
- Exportdienst ist die Software, die Gantt-Daten in eine Datei oder eine Datei in Gantt-Daten umwandelt;
- Online-Exportdienst ist die Instanz des Exportdienstes, die DHTMLX unter
https://export.dhtmlx.combetreibt; - Exportmodul ist ein Exportdienst, den Sie selbst installieren und betreiben.
Was Sie exportieren und importieren können
| Format | Export | Import | Methoden | Exportmodul | Anleitung |
|---|---|---|---|---|---|
| Ja | - | exportToPDF() | PDF/PNG/Excel-Modul | PDF und PNG | |
| PNG | Ja | - | exportToPNG() | PDF/PNG/Excel-Modul | PDF und PNG |
| Excel | Ja | Ja | exportToExcel(), importFromExcel() | PDF/PNG/Excel-Modul | Excel |
| iCal | Ja | - | exportToICal() | PDF/PNG/Excel-Modul | iCal |
| MS Project | Ja | Ja | exportToMSProject(), importFromMSProject() | MS Project/P6-Modul | MS Project |
| Primavera P6 | Ja | Ja | exportToPrimaveraP6(), importFromPrimaveraP6() | MS Project/P6-Modul | Primavera P6 |
| JSON-Datei | Ja | - | exportToJSON() | PDF/PNG/Excel-Modul | - |
| JSON oder XML auf der Seite | Ja | - | serialize() | nicht erforderlich, läuft im Browser | JSON und XML |
Informationen zum Export und Import von Daten auf der Serverseite finden Sie unter Export und Import von Daten in Node.js.
So funktioniert der Export
- Sie aktivieren das Plugin
export_apimit der Methode plugins und rufen eine Export- oder Importmethode auf, zum Beispielgantt.exportToPDF(). - Die Methode sendet die Gantt-Daten in einer POST-Anfrage an einen Exportdienst.
- Der Exportdienst erstellt die Datei oder liest die importierte Datei.
- Der Browser erhält die Datei. Beim Import erhält die
callback-Funktion der Methode die Daten. Beim Export kann einecallback-Funktion stattdessen die URL der generierten Datei erhalten.
Standardmäßig senden alle Methoden Anfragen an den Online-Exportdienst unter https://export.dhtmlx.com/gantt. Um sie an einen anderen Exportdienst zu senden, zum Beispiel an Ihr eigenes Exportmodul, legen Sie den Parameter server der Methode fest:
gantt.exportToPDF({
server: "https://myapp.com/myexport/gantt"
});
Online-Exportdienst oder eigene Installation
- Wasserzeichen. Der Online-Exportdienst ist kostenlos, aber die von ihm erstellten PDF- und PNG-Dateien enthalten ein Wasserzeichen, sofern Sie keine gültige Lizenz haben. Siehe Lizenz und Wasserzeichen.
- Limits. Der Online-Exportdienst hat Zeit- und Größenlimits für Anfragen. Siehe Limits des Online-Exportdienstes. Ein Exportmodul, das Sie installieren, hat die Limits, die Sie konfigurieren.
- Speicherort der Daten. Der Online-Exportdienst verarbeitet Ihre Daten auf den Servern von DHTMLX. Mit Exportmodulen können Sie die Daten in Ihrem Netzwerk behalten. Siehe Zusammenspiel der beiden Module.
- Einrichtung. Der Online-Exportdienst erfordert keine Einrichtung. Ein Exportmodul benötigt einen Server: Node.js oder Docker für das PDF/PNG/Excel-Modul, .NET für das MS Project/P6-Modul. Siehe Export-Module.
Limits des Online-Exportdienstes
Der Online-Exportdienst hat Zeit- und Größenbeschränkungen für Anfragen.
Zeitlimits
Wenn der Prozess länger als 20 Sekunden dauert, wird der Export abgebrochen und folgender Fehler tritt auf:
Error: Timeout trigger 20 seconds
Wenn mehrere Personen gleichzeitig Gantt exportieren, kann der Prozess länger dauern als üblich. Das ist jedoch unproblematisch, da die Zeit, die für die Exportanfrage eines bestimmten Benutzers aufgewendet wird, separat gezählt wird.
Limits der Anfragegröße
Es gibt einen gemeinsamen API-Endpunkt https://export.dhtmlx.com/gantt, der für alle Exportmethoden (exportToPDF, exportToPNG, exportToMSProject, etc.) dient. Die maximale Anfragegröße beträgt 10 MB.
Es gibt auch einen separaten API-Endpunkt https://export.dhtmlx.com/gantt/project, der speziell für die Export-/Import-Dienste von MS Project und Primavera P6 (nur exportToMSProject / importFromMSProject / exportToPrimaveraP6 / importFromPrimaveraP6) vorgesehen ist. Maximale Anfragegröße: 40 MB. Wie Sie ihn verwenden, erfahren Sie für MS Project und Primavera P6.
Lizenz und Wasserzeichen
Der Online-Exportdienst ist kostenlos, aber die ausgegebenen PDF- und PNG-Dateien enthalten das Wasserzeichen der Bibliothek. Um ohne Wasserzeichen zu exportieren, benötigen Sie eine gültige Lizenz – das Exportergebnis steht ohne Wasserzeichen während der gültigen Support-Periode (12 Monate für alle PRO-Lizenzen) zur Verfügung.
Exportmodule sind nicht im Gantt-Paket enthalten. Ein Exportmodul wird kostenlos bereitgestellt, wenn Sie Gantt unter einer Commercial-, Enterprise- oder Ultimate-Lizenz erworben haben, oder Sie können das Modul separat kaufen. Lesen Sie den entsprechenden Artikel, um die Nutzungsbedingungen jedes Moduls zu erfahren.