Exportmodul für MS Project

Dieses Exportmodul ist dafür konzipiert, die Dateiformate von MS Project und Primavera zu verarbeiten. Es ist als .NET Core-Anwendung entwickelt, sodass Sie es innerhalb der dotnet-Umgebung oder in einem Docker-Container ausführen können.

Das Modul unterstützt nicht den Import/Export für PDF-, PNG-, Excel- oder iCal-Dateien. Für diese Formate können Sie das dedizierte Exportmodul oder den Online-Server verwenden.

Installationsanleitung

Bevor Sie die Anwendung ausführen, stellen Sie sicher, dass Sie die .NET Core 7-Umgebung installiert haben. Sobald dies eingerichtet ist, kann das MSP-Exportmodul aus dem Client-Bereich unter dem Downloads-Tab heruntergeladen werden. Hier ist ein Referenzbild:

MS Exportmodul herunterladen

Sie haben zwei Möglichkeiten, den Quellcode auszuführen:

1. Ausführung über Visual Studio (nur Windows)

Um diesen Weg zu gehen, benötigen Sie Visual Studio 2022, da frühere Versionen nicht mit .NET Core 7 kompatibel sind. Nach dem Öffnen der Anwendung klicken Sie mit der rechten Maustaste auf die Lösung im rechten Bereich und wählen Sie die Option "NuGet-Pakete wiederherstellen". Sobald dies erledigt ist, können Sie entweder die http- oder https-Versionen ausführen.

2. Ausführung über die Kommandozeile

Diese Methode ist sowohl mit Windows als auch Linux kompatibel. Navigieren Sie zum Stammverzeichnis der Anwendung und installieren Sie die erforderlichen Pakete mit dem Befehl:

dotnet restore

Wechseln Sie dann in den Ordner "GanttToMSProject" und führen Sie die Anwendung aus mit:

dotnet run

Um die Anwendung zu veröffentlichen, verwenden Sie diesen Befehl:

dotnet publish -c Release -o published

Testen des Exportmoduls

Es gibt zwei Möglichkeiten, die Funktionalität des Moduls zu testen:

1. Verwendung der Testseite

Öffnen Sie diese URL: https://export.dhtmlx.com/test
Suchen Sie nach der URL des Exportmoduls in der Kommandozeilenausgabe. Zum Beispiel:

Now listening on: http://localhost:5128

Wählen Sie im Dropdown-Menü für die URL custom.
Fügen Sie die URL des Moduls in das Feld ein.

Jetzt können Sie die Schaltflächen verwenden, um Daten zu exportieren.

2. Verwendung des Snippets

Öffnen Sie diese URL: https://snippet.dhtmlx.com/kf16k0if
Finden Sie die URL des Exportmoduls in der Kommandozeilenausgabe. Zum Beispiel:

Now listening on: http://localhost:5128

Fügen Sie diese URL als Server-Parameter der Exportfunktion hinzu, so:

gantt.exportToMSProject({
    server: "http://localhost:5128",
});

Sobald dies erledigt ist, können Sie Daten mit der Schaltfläche exportieren.

Fehlerbehebung

Probleme beim Exportieren von PDF/PNG/Excel

Das MSP-Exportmodul ist speziell für die Methoden gantt.exportToMSProject oder exportToPrimaveraP6 gedacht. Es funktioniert nicht für Aufrufe wie:

gantt.exportToPDF({server:"gantt-to-msproject-url"});

Beachten Sie auch, dass bei einem Aufruf von gantt.exportToMSProject() ohne Angabe von Parametern standardmäßig der Online-Dienst unter export.dhtmlx.com verwendet wird.

Exportieren von MPP-Dateien

Das Modul und der Exportserver verwenden die MPXJ-Bibliothek zum Importieren/Exportieren von MSP- und Primavera-Dateien. Das Exportieren von MPP-Dateien wird jedoch nicht unterstützt. Sie können dennoch sowohl XML- als auch MPP-Dateien importieren.

Importieren großer Dateien

Zum Importieren großer Dateien müssen Sie die Anfragengrößenlimits anpassen. Öffnen Sie die Datei GanttToMSProject/Controllers/MspConversionController.cs und heben Sie die Auskommentierung der Zeile DisableRequestSizeLimit und der folgenden Zeile auf.

Nach dem Speichern dieser Änderungen und dem Neustart des Servers sollten große Dateien problemlos importiert werden können. Zum Beispiel wurde getestet, dass der Import einer 244Mb-Datei bis zu 4GB RAM erfordert.

Verwendung eines Docker-Images

Um ein Docker-Image zu erstellen, verwenden Sie den Befehl:

docker build -t msp_export_module

Zu Testzwecken können Sie das Docker-Image mit folgendem Befehl ausführen:

docker run -p 65163:80 msp_export_module

Um den Container zu stoppen, verwenden Sie die Ctrl+C-Tastenkombination.

Wenn Sie das Docker-Image lieber im Hintergrund ("detached" mode) ausführen möchten, verwenden Sie:

docker run -p 65163:80 msp_export_module

Zurück nach oben