Konvertieren einer Microsoft Word-Datei (.docx) in eine FastReport .NET-Datei (.frx)

Moderne Technologien der Datenverarbeitung und Automatisierung des Dokumentenmanagements erfordern die Integration verschiedener Dateiformate, die das Zusammenspiel von Softwareprodukten gewährleisten. Aufgrund seines breiten Spektrums von Funktionen ist der Microsoft Word Texteditor zu einem der beliebtesten Editoren mit unterschiedlicher Komplexität geworden. 

In manchen Situationen ist es erforderlich, solche Dokumente in native Formate anderer Anwendungen zu konvertieren. Es gibt Fälle, in denen es notwendig ist, Microsoft Word-Dateien in das FastReport .NET-Format zu konvertieren, das zum Erstellen von FastReport-Berichtsvorlagen verwendet wird.

Kompilieren eines Projekts 

Öffnen Sie zunächst die .sln-Datei namens „FastReport.OOXMLImportPlugin.sln”. Beachten Sie, dass es zwei solcher Dateien für VisualStudio 2017 und höhere Versionen gibt. Löschen Sie dann die Links auf die Projekte FastReport und FastReport.Bars wie im Screenshot unten.

Danach müssen Sie einen Link auf die FastReport.dll hinzufügen. Diese DLL befindet sich im selben Ordner wie der Designer.

Klicken Sie mit der rechten Maustaste auf den Arbeitsbereich und anschließend auf die Schaltfläche „Assemblieren“. Gehen Sie dann zum Pfad FastReport.OOXMLImportPlugin\bin\Debug\net472 und finden Sie in dem Ordner die assemblierte Datei „OOXMLImportPlugin.dll“.

Registrierung einer DLL in FastReport 

Die Registrierung kann auf unterschiedliche Art und Weise erfolgen. 

Methode 1. Registrierung mit der FastReport-Entwicklungsumgebung

Öffnen Sie den Berichtsdesigner und wählen Sie das Menü „Datei|Einstellungen...“ in der Ribbon-Oberfläche aus (das Menü „Ansicht|Einstellungen...“ in der Standard-Oberfläche).

Fügen Sie anschließend auf der Registerkarte „Plugins“ die FastReport.OOXMLImportPlugin.dll hinzu.

Starten Sie anschließend den FastReport .NET Berichtsdesigner neu. Wenn Sie in der Visual Studio IDE arbeiten, starten Sie diese ebenfalls neu. Sobald der Designer neu gestartet ist, klicken Sie auf „Datei|Öffnen“ und wählen Sie „Microsoft Word Dokument (*.docx)“ in der Liste der verfügbaren Dateien, wie im folgenden Screenshot dargestellt.

Wählen Sie die *.docx-Datei aus, die Sie in FastReport .NET importieren möchten. Daraufhin wird die importierte Datei im Designer angezeigt. 

Methode 2. Manuelles Bearbeiten der FastReport.config-Datei

Standardmäßig befindet sich diese Datei im Ordner C:\DocumentsandSettings\user_name\Local Settings\Application Data\FastReport. Stellen Sie sicher, dass alle laufenden Instanzen von FastReport .NET geschlossen sind. Und erst danach öffnen Sie die Konfigurationsdatei in einem beliebigen Texteditor und ändern Sie sie wie folgt:

<?xml version=«1.0» encoding=«utf-8»?>
<Config>
 ...
<Plugins
<Plugin Name=«c:\.....\ OOXMLImportPlugin.dll»/>
</Plugins>
</Config

Methode 3. DLL programmgesteuert registrieren

Dazu müssen Sie zu Ihrem Projekt wie unten gezeigt einen Link auf „OOXMLImportPlugin.dll“ hinzufügen. 

Führen Sie anschließend den folgenden Code einmal aus, wenn die Anwendung gestartet wird:

FastReport.Design.DesignerPlugins.Add(typeof(FastReport.Design.ImportPlugins.OOXML.DocxImportPlugin));

Nuget-Paket FastReport.Plugins.OOXMLImport in FastReport registrieren

Installieren Sie zunächst die Nuget-Pakete FastReport.Net und FastReport.Plugins.OOXMLImport von unserem privaten Nuget-Server. Unter diesem Link finden Sie eine Installationsanleitung. 

Als nächstes müssen Sie das Plugin mit dem folgenden Code registrieren:

FastReport.Design.DesignerPlugins.Add(typeof(FastReport.Design.ImportPlugins.OOXML.DocxImportPlugin));

Starten Sie die Anwendung, klicken Sie dann auf „Datei|Öffnen“ und wählen Sie „Microsoft Word-Dokument (.docx)“ aus.

Wählen Sie die *.docx-Datei aus, die Sie in FastReport .NET importieren möchten. Daraufhin wird die importierte Datei im Designer angezeigt. 

Bekannte Einschränkungen zum Zeitpunkt der Veröffentlichung der 2025.2.0 Version

Derzeit unterstützt unser Plugin keine Hintergrundhervorhebung von Abschnitten einer Zeichenfolge, keine Formen (Shapes) sowie keine verschachtelten Vector Markup Language (VML) Vektorgrafiken und OLE-Objekte.

Manchmal werden dem resultierenden Bericht leere Seiten hinzugefügt. Sollten Sie auf das oben beschriebene Problem stoßen, wenden Sie sich bitte an unseren technischen Support unter support@fast-report.com.

Schlussbemerkung 

Der entwickelte .docx zu .frx Konverter ist somit ein wichtiger Schritt im Bereich der Vereinfachung der Automatisierung von Dokumenten- und Berichtserstellungsprozessen. Er ermöglicht es, den Zeitaufwand für die Erstellung von Berichtsvorlagen unter Verwendung vorgefertigter Word-Dateien erheblich zu reduzieren. 

Es ist wichtig zu berücksichtigen, dass die Strukturen beider Dateiformate unterschiedlich sind und diese nicht einfach ineinander eingefügt werden können. Es ist notwendig, die Strukturen der Dateien zu berücksichtigen und alles in die gewünschte Form zu bringen, damit die Daten korrekt dargestellt werden und die Formatierung erhalten bleibt. In diesem Artikel erfahren Sie, wie Sie ein Dokument aufbauen, damit es seine korrekte Struktur beibehält.