Behebung der häufigsten Probleme bei der Installation von FastReport VCL

Um FastReport VCL und seine Komponenten zu installieren, verwenden Sie den FastReport Online Installer. Das Installationsprogramm verfügt über eine einfache, intuitive Benutzeroberfläche. Wir empfehlen Ihnen dringend, die neueste Version des Installationsprogramms zu verwenden. Dieses können Sie unter diesem Link herunterladen.

In manchen Fällen treten jedoch während des Installationsvorgangs Probleme auf. In diesem Artikel werden wir betrachten, wie diese Probleme gelöst oder verhindert werden können. 

Wenn Sie den FastReport Online Installer starten, prüft er automatisch, ob es Updates gibt und gegebenenfalls fordert Sie auf, die neue Version herunterzuladen. 

Als nächstes wird mit Hilfe eines Browsers (der im System standardmäßig ausgewählt ist) geprüft, ob Sie bereits FastReport-Komponenten erworben haben. Wenn Sie keine gekauften Produkte auf Ihrem Konto haben, steht Ihnen nur das Demo-Center mit Testversionen von FastReport zur Verfügung.

Achtung! Das Konto (E-Mail-Adresse), mit dem Sie Ihre Kopie von FastReport erworben haben, muss mit dem Konto übereinstimmen, das Sie bei der Anmeldung bei Ihrem persönlichen Fast Reports Inc.-Kundenkonto verwendet haben. Wenn Sie Probleme haben, sich mit dem richtigen Konto anzumelden, versuchen Sie, den Cache Ihres Browsers zu löschen und sich erneut anzumelden. 

Wenn Ihre Lizenz die Installation auf mehreren Computern zulässt (z. B. Team, Site, OEM), müssen Sie sich auf jedem Computer unter dem Benutzer, für den die Lizenz erworben wurde, bei Ihrem persönlichen Fast Reports Inc.-Kundenkonto anmelden. 

Oder Sie können eine alternative Methode verwenden, wobei die Zugriffsrechte übertragen werden. Dazu müssen Sie in Ihrem persönlichen Kundenkonto zu Einstellungen -> Profil gehen und auf der Registerkarte Accesses für den Benutzer Zugriff auf die gewünschten Produkte und deren Versionen hinzufügen. Klicken Sie anschließend auf die Schaltfläche „Lizenzzugriff hinzufügen“. In dem daraufhin erscheinenden Fenster geben Sie die E-Mail-Adresse des Benutzers und das gewünschte Produkt an und wählen die gewünschte Version aus der Liste der verfügbaren Versionen aus. 

Während der Installation werden Sie vom Installationsprogramm aufgefordert, alle derzeit laufenden IDEs zu schließen. Wenn eine IDE geöffnet ist, wird das folgende Fenster angezeigt:

Manuelle Anmeldung 

Wenn Sie aus irgendeinem Grund die Online-Identifizierung nicht nutzen können, steht Ihnen die manuelle Anmeldung zur Verfügung. Um Ihren Anmeldungscode zu erhalten, kopieren Sie den Text aus dem Feld „Anmeldungsinformationen“ und senden Sie ihn an support@fast-report.com. Wenn Sie einen Anmeldungscode für eine andere E-Mail-Adresse erhalten wollen, dann geben Sie bitte im Nachrichtentext die E-Mail-Adresse an, mit der Sie sich in das persönliche Kundenkonto einloggen.

Schließen Sie das Installationsprogramm erst, wenn Sie den Anmeldungscode mit den dat-Dateien in einer E-Mail-Antwort erhalten haben. Legen Sie dann die dat-Dateien im selben Ordner wie das Installationsprogramm ab und fahren Sie mit der Installation fort.

Es gibt eine dritte Möglichkeit, FastReport-Komponenten zu installieren. Starten Sie die Online-Installation auf einem Gerät, das mit dem Netzwerk verbunden ist. Übertragen Sie dann die dat-Dateien und das Installationsprogramm auf einen Computer, der keinen Zugriff auf das Netzwerk hat, und schließen Sie die Installation auf diesem Computer ab. Fordern Sie zuvor einen Anmeldungscode beim technischen Support an, wie oben beschrieben. 

Bitte denken Sie daran, dass Sie den Online Installer nicht schließen dürfen, bevor Sie den Anmeldungscode erhalten haben!  

*dat-Dateien können zwischen Computern übertragen werden, vorausgesetzt, dass die Installation für denselben Benutzer (an dieselbe E-Mail-Adresse) erfolgt. Darüber hinaus können dat-Dateien auch während der Online-Installation auf einen anderen Computer übertragen werden (auch für einen Benutzer), wodurch Zeit beim Herunterladen gespart wird.

Installation der Komponenten 

Als nächstes haben Sie die Möglichkeit, FastReport-Komponenten zu installieren (Install) oder zu ändern (Modify), wenn die Produkte bereits auf Ihrem Computer installiert sind, erneut zu kompilieren (Recompile), zu reparieren (Repair) oder zu entfernen (Remove). 

„Erneut kompilieren“ bedeutet die Reinstallation der FastReport-Bibliothek auf Ihrem Computer. Dies kann erforderlich sein, wenn Sie Änderungen am Quellcode der Bibliothek vorgenommen haben und diese in der IDE neu installieren müssen.

Mit „Reparieren“ können Sie FastReport auf Ihrem Computer mit den aktuell gewählten Einstellungen neu installieren. Diese Funktion kann auch ohne Internetverbindung funktionieren.

„Entfernen“ deinstalliert die Bibliothek vollständig von Ihrem Computer. 

„Installieren“ oder „Ändern“ - wenn Sie diese Option wählen, zeigt das nächste Fenster die IDEs an, in denen FastReport installiert werden kann. Sie wählen die zu installierenden Komponenten und den Installationstyp Trial oder Source. Die Anzahl der verfügbaren Komponenten hängt von der Lizenz ab, die Sie erworben haben.

Bitte beachten Sie, dass auf Ihrem Computer mindestens eine IDE installiert sein muss, in der FastReport installiert werden kann. 

Es kann Delphi ab Version 2010 oder Lazarus der neuesten Versionen sein. Die Liste der von FastReport unterstützten Delphi-Versionen kann hier eingesehen werden. Wenn Sie eine ältere Version von FastReport benötigen, beispielsweise für Delphi 7, wenden Sie sich bitte an den technischen Support. Das Installationsprogramm kann für jede installierte IDE verschiedene Versionen von FastReport installieren. 

Vorinstallation von zusätzlichen Komponenten 

Achtung! Bevor Sie FastReport installieren, müssen Sie die zusätzlichen Komponenten installieren, die Sie mit FastReport verwenden möchten. 

Wenn Sie zum Beispiel BDE-Komponenten in FastReport verwenden möchten, muss BDE bereits vor der Installation in Ihrer IDE installiert sein. Andernfalls kann das Installationsprogramm einfach keine FastReport-Pakete erstellen, die BDE verwenden. Für andere Komponenten müssen Sie auch FIB, TeeChart und so weiter vorher installieren.

Wir empfehlen Ihnen dringend, alle älteren Versionen von FastReport sowie FastReport Embarcadero Edition aus Ihren IDEs zu entfernen, bevor Sie die Installation starten. Dies ist für den normalen Betrieb des Installationsprogramms notwendig. Es ist auch notwendig, .bpl-Dateien für alte Versionen von FastReport zu löschen. Wenn das Installationsprogramm diese erkennt, kann es mit der Installation nicht fortsetzen. 

Solche Dateien können sich zum Beispiel in den folgenden Ordnern befinden:

C:\Users\Public\Documents\Embarcadero\Studio\23.0\Bpl\
C:\Users\Your_User_Name\AppData\Local\VirtualStore
C:\Windows\SysWOW64

Bpl-Dateien haben die folgende Form (wobei XX die Zahl im Namen ist, die von der installierten IDE-Version abhängt): 

• fr*XX.bpl,
• fs*XX.bpl,
• fqb*XX.bpl .

Eine Tabelle mit den Abhängigkeiten von Delphi IDE Version, Compiler und Paketversion finden Sie hier.

Wenn im System noch bpl-Dateien von alten Versionen vorhanden sind und das Installationsprogramm diese aus irgendeinem Grund nicht gefunden hat, kann beim Starten der IDE der folgende Fehler auftreten: 

In diesem Fall sollten alle alten bpl-Dateien gelöscht werden.

Das Installationsprogramm sucht in der Registrierung nach installierten IDE-Versionen. Wenn bei der Installation einer IDE Fehler und/oder fehlende Register-Schlüssel gefunden werden, ist es nicht möglich, diese IDE zu installieren! Außerdem wird diese IDE nicht in der Liste der für die Installation verfügbaren IDEs aufgeführt.

Fehler „Keine bpl-Datei der entfernten Version gefunden“

Manchmal entfernt das Installationsprogramm fälschlicherweise die alte Version von FastReport. Die Dateien werden gelöscht, aber die Verweise in der Registrierung auf bpl bleiben bestehen. In diesem Fall erscheint beim Starten von Delphi das folgende Fenster: 

Um dieses Problem zu beheben, klicken Sie in jedem Fenster auf die Schaltfläche „Abbrechen“ oder drücken Sie die Escape-Taste. Dadurch werden diese Fenster nicht mehr angezeigt. Wenn die bpl-Versionsnummer in der Fehlermeldung mit der Nummer der Version übereinstimmt, die Sie installieren möchten, dann ist der Fehler nicht bpl-bedingt. Meistens treten solche Fehlermeldungen auf, wenn Steema, TeeChart oder Interbase Express (IBX) Components nicht installiert sind.

Manchmal kommt es vor, dass FastReport-Komponenten zur Installation ausgewählt werden, diese aber nach der Installation nicht in der Komponentenpalette angezeigt werden. In diesem Fall kann die Reparieren-Funktion des Installationsprogramms helfen. 

Wenn diese Methode Ihnen nicht hilft, sollten Sie überprüfen, ob diese Komponenten im Fenster IDE Components -> Install Packages ausgewählt sind. Sie können auch versuchen, diese f*.bpl-Dateien manuell zu installieren. Sie befinden sich (bei der Standardinstallation) unter folgendem Pfad:

«C:\Program Files (x86)\FastReport VCL\<FRVersion>\Sources\LibRS<CompilerVersion>\VCL\Win32\» 

Fehler beim Kompilieren und Installieren von Paketen in der DIE 

Wenn das Installationsprogramm zwar die FastReport-Bibliothek herunterladen konnte, die Pakete jedoch aus irgendeinem Grund nicht in der IDE kompilieren und installieren konnte, können Sie versuchen, sie manuell zu kompilieren und herunterzuladen. Verwenden Sie dazu die Installationsanweisungen unter diesem Link und die Embarcadero-Dokumentation unter diesem Link. 

Vergewissern Sie sich, dass die Pfade zu diesen Bibliotheken in der IDE-Variable PATH enthalten sind und dass die FastReport-Quellcodepfade korrekt konfiguriert sind. Sie sollten auch überprüfen, ob die IDE-Variable FRL vorhanden ist. Der Standardpfad sollte etwa wie folgt lauten: 

«C:\Program Files (x86)\Fast Reports VCL\2024.2.6\Sources»

Sie können überprüfen, wie die Bibliotheken kompiliert wurden, indem Sie während der Installation eine Protokollierung ausführen. Geben Sie dazu in den Eigenschaften der Verknüpfung des Installationsprogramms das Schlüsselwort „-log“ ein.

VCLOnlineInstaller.exe -log:"c:\test.log".

Wenn Sie diesen Parameter verwenden, empfehlen wir dringend, einen absoluten Pfad anzugeben, um die Suche nach der resultierenden Logdatei in Zukunft zu vermeiden.

Wenn während der Installation zusätzliche Verzeichnisse angegeben werden müssen, in denen sich die für die FastReport-Kompilierung erforderlichen Bibliotheken befinden, können Sie das Installationsprogramm mit dem Parameter „-addCustomPaths“ ausführen. 

VCLOnlineInstaller.exe -addCustomPaths

In diesem Fall erscheint nach der Auswahl der FastReport-Komponenten ein Fenster, in dem Sie die Suchpfade für Bibliotheken für den Compiler festlegen können.

Auch während des Installationsvorgangs kann es vorkommen, dass die IDE nach der Installation überhaupt keine FastReport-Komponenten enthält. Um dieses Problem zu beheben, sollten Sie überprüfen, ob *.dat-Dateien des Installationsprogramms vorhanden sind. Falls sie nicht vorhanden oder zu klein sind (die kleinste Datei sollte mehr als 280 KB groß sein), starten Sie die Installation mit deaktivierter Firewall und Antivirus-Software neu (oder fügen Sie das Installationsprogramm zu den Ausnahmen hinzu).

Nutzinformation 

Bitte beachten Sie, dass wenn Sie FastReport aktualisieren, kann es vorkommen, dass ein in der neuen Version gespeicherter Bericht nicht in der alten Version geöffnet werden kann. Dies liegt daran, dass neue Eigenschaften der Berichtskomponenten und die neuen Komponenten selbst hinzugefügt wurden. Ältere Versionen wissen nichts über diese Eigenschaften und Komponenten. Im Allgemeinen sollten veraltete .fr3 Berichte in neuen Versionen von FastReport normal geöffnet werden können.

Wenn Sie die kostenlose FastReport Embarcadero Edition installieren möchten, können Sie dies mit GetIT in der Delphi IDE tun. 

Zur Installation gehen Sie zu Tools->GetIt Package Manager und wählen Sie FastReport Embarcadero Edition aus. 

Bitte beachten Sie jedoch, dass diese Version von FastReport nicht in Delphi CE installiert werden kann.

Bitte beachten Sie auch, dass viele FastReport-Anwendungsbeispiele im Lieferumfang enthalten sind. Sie werden standardmäßig im Ordner "C:\Users\Public\Documents\Fast Reports VCL\2024.2.6\Sources\" installiert. In diesem Ordner finden Sie auch die Offline-Dokumentation. Im Lieferumfang ist auch ein Demo-Center enthalten (Sie können dieses separat installieren), mit dem Sie sich mit einigen Funktionen von FastReport vertraut machen können, ohne es auf Ihrem Computer installieren zu müssen. 

FastReport wird ständig weiterentwickelt und um neue Möglichkeiten und Funktionen ergänzt. Wenn Sie Fragen zu deren Anwendung haben, können Sie sich jederzeit an unseren technischen Support wenden!