Migration CrystalReports zu FastReport: Unterschied zwischen den Versionen

Version vom 8. Dezember 2015, 16:13 Uhr

1 Allgemeines

FastReport kann in GEVITAS-Programmen zur Ausgabe von Daten verwendet werden (ab 10/2015), alternativ zu CrystalReports.

Dieser Artikel beschreibt, wie Sie von CrystalReports auf FastReport umsteigen können.

1.1 Reports konvertieren?

Es gibt leider keine richtig funktionierende Möglichkeit, Reports von CrystalReports nach FastReport zu konvertieren. Reports müssen neu erstellt werden.

Es gibt auf dem Markt einige Konverter, die in unseren Tests jedoch alle mehr oder weniger versagt haben. Vor allem komplexe Reports mit Formeln, Unterberichten usw. konnten nicht konvertiert werden. Der Aufwand, diese "Rumpf"-Reports vernünftig und zukunftsweisend zum Laufen zu bringen, ist unverhältnismäßig groß.

2 Vergleich CrystalReports zu FastReport

In diesem Artikel werden die Unterschiede zwischen den beiden Produkten beschrieben.

3 Bestandsaufnahme

Als erster Schritt ist es empfehlenswert, alle vorhanden Reports (Formulare) darauf zu untersuchen, ob/welche überhaupt noch benutzt werden. Erfahrungsgemäß sammeln sich in einem Unternehmen im Laufe der Zeit Reports an, die nicht mehr benutzt werden.

Danach sollte man sich überlegen, warum es diese unterschiedlichen Reports überhaupt gibt. Ziel sollte es sein, mit möglichst wenig Reports auszukommen, im Idealfall mit nur einem einzigen!

4 Einstellungen in REFLEX

4.1 Programmparameter, Report-Versionen

Unter dem Menü Datei⇒Admin-Optionen⇒Programmparameter⇒Firmen-Daten, Formular-Texte, Report-Einstellungen⇒Registerseite "Report-Versionen" kann man einstellen, welches Formular mit welcher Report-Version (CrystalReports© oder FastReport ©) gedruckt werden soll.

• Wenn wir "gedruckt" sagen, meinen wir damit natürlich auch die Vorschau, das mailen usw.!

Einzelheiten dazu finden Sie hier.

4.2 Programmparameter, Standard-Formular-Texte

Unter dem Menü Datei⇒Admin-Optionen⇒Programmparameter⇒Firmen-Daten, Formular-Texte, Report-Einstellungen⇒Registerseite "Standard-Formular-Texte" kann man die Standard-Formular-Texte für die verschiedenen Formulare festlegen.

Einzelheiten dazu finden Sie hier.

4.3 Auftragskennzeichen festlegen

Oft hat man verschiedene Reports, die sich nur in Kleinigkeiten unterscheiden. Beispielsweise soll manchmal das Firmenlogo gedruckt werden, manchmal nicht. Oder es sollen bei manchen Kunden Einzelpreise ausgegeben werden, bei anderen nicht.

Dazu gibt es z.B. in REFLEX die sog. Auftragskennzeichen, mit denen die Ausgabe eines Reports gesteuert werden kann. Im Report kann man diese Felder abfragen und einzelne Objekte oder ganze Bänder ausgeben oder nicht.

Diese Felder können über die Tabelle Auftragskopf und die Felder Kennz1 bis Kennz12 abgerufen werden.

Man kann beispielsweise über einen Code im Report festlegen, dass das Feld Einzelpreis unterdrückt (Visible=False) werden soll, wenn das Kennzeichen Kennz1 auf "Nein" steht. Dazu klickt man einfach auf das Feld im Report-Designer und wählt im Objektinspektor das Register Ereignisse an. Dann doppelklickt man auf das Ereignis OnBeforePrint und gibt diesen Code ein:

Beispiel:

procedure MemoEinzelpreisOnBeforePrint(Sender: TfrxComponent);
begin
  if <AuftragsKopf."Kennz1"> = 'Nein' then
       MemoEinzelpreis.Visible := False
  else
       MemoEinzelpreis.Visible := True;
end;

Unter dem Menü Datei⇒Admin-Optionen⇒Programmparameter⇒Auftrag⇒Auftragskennzeichen kann man die Kennzeichen festlegen, mit deren Hilfe man die Varianten von Formularen steuern kann.

Weitere Einzelheiten dazu finden Sie hier.

5 Varianten

5.1 Verschiedene Sprachen

Mehrsprachige Reports zu erstellen, bedeutet natürlich einen zusätzlichen Aufwand. Dabei gibt es im Wesentlichen diese Probleme zu lösen:

5.1.1 Artikel-Texte

Das ist das geringste Problem, weil das Programm automatisch den zugehörigen Artikel-Text in der ausgewählten Sprache des Auftrags zur Verfügung stellt. Dazu gibt es in der Tabelle Positionen das Feld TextPosition. In diesem Feld steht der Artikel-Text in der ausgewählten Sprache.

5.1.2 Titel des Formulars

Auch das ist kein Problem, weil der Titel des Formulars in REFLEX durch das Programm festgelegt wird. Dazu muss man im Report eine neue Variable mit dem Namen "Titel" anlegen. Das Programm ersetzt den Inhalt der Variable durch den Titel, der in Datei-->Admin-Optionen-->Formular-Texte angegeben wurde.

5.1.3 Feste Texte

Feste Texte sind Felder für Überschriften, Feld-Titel usw. Das stellt einen erheblichen Aufwand dar! Die einzig sinnvolle Möglichkeit, dies zu lösen, ist es Code (in CrystalReports: Formeln) zu schreiben.

Dazu fügen Sie ein Textfeld in den Report ein. Dies bekommt anfangs den Namen "MemoXX", wobei XX einfach eine Fortlaufende Nummer ist.

In der Eigenschaft Name geben Sie dem Feld nun einen aussagekräftigen Namen, z.B. "MemoNummer", wenn es um eine Auftragsnummer, Bestellnummer usw. geht.

Nun schalten Sie auf das Register Ereignisse um und Doppelklicken auf OnBeforePrint. Es öffnet sich er Code-Editor, in dem Sie nun Befehle eingeben können, die z.B. den Text festlegen, der ausgegeben werden soll.

• Das EreignisOnBeforePrint wird von FastReport aufgerufen, bevor das Feld ausgegeben wird! In diesem Ereignis können Sie Code schreiben, der z.B. die Sichtbarkeit (Visible) auf Wahr (True) oder Falsch (False) setzen können. Sie können aber auch den Text festlegen, der ausgegeben werden soll.

Nun geben Sie den Code ein, der festlegt, was bei welcher Sprache ausgegeben werden soll. Beispiel:

procedure MemoNummerOnBeforePrint(Sender: TfrxComponent);
begin
  if <AuftragsKopf."Sprache"> = 'E' then
       MemoNummer.Memo.Text := 'Number:'
  else
  if <AuftragsKopf."Sprache"> = 'F' then
       MemoNummer.Memo.Text := 'Nombre:'
  else
       MemoNummer.Memo.Text := 'Nummer:';  
end;

In diesem Beispiel wird der der "Number" ausgegeben, wenn das Sprachkennzeichen auf "E" steht. Wenn nicht ("else"), wird "Numero" ausgegeben, wenn das Sprachkennzeichen auf "F" steht. Wenn nicht ("else"), wird "Nummer" ausgegeben.

Übersetzt bedeutet dieser Code:

  Wenn <AuftragsKopf."Sprache"> = 'E' dann
       Der Text des Feldes ist 'Number:'
  ansonsten
  Wenn <AuftragsKopf."Sprache"> = 'F' dann
       Der Text des Feldes ist 'Nombre:'
  ansonsten
       Der Text des Feldes ist 'Nummer:';  

Das ";" am Ende muss eingegeben werden.

Das ist natürlich ein erheblicher Aufwand. Alle festen Texte müssen so behandelt werden. Der Lohn der Arbeit ist aber ein Report, der in allen Sprachen funktioniert!

6 Standard-Kopf- und Fußbereiche

Es gibt das Problem, dass auf jedem offiziellen Formular (=Report) ein Kopfbereich und ein Fußbereich stehen soll, der die Firmendaten beinhaltet, z.B. im Seitenkopf ein Logo und im Seitenfuß die Bankverbindung, die Firmendaten usw.

Das kann man über einen Basis-Report lösen, wie hier beschrieben.

7 Verzeichnisse

Beispiel einer Verzeichnis-Struktur:

8 Links

• FastReport Seitenformat

• FastReport Daten, Tabellen und Felder

• FastReport Bands

• FastReport Objekte und Elemente eines Reports

• FastReport: Abhängige Formatierung von Feldern

• FastReport: Summen im Report bilden

• Ladeliste/Packliste mit FastReport

• Video FastReport Teil 1: Allgemeines

• Video FastReport Teil 2: Erstes Kennenlernen

• Video FastReport Teil 3: Den ersten Report erstellen

• Video FastReport Teil 4: Summen im Report erstellen

• Video FastReport Teil 10: Vererbung, Erstellen und Verwenden eines Basis-Reports

• Homepage von FastReport

• Etikettendruck Allgemeines

• GEVITAS Label-Print Installation

• GEVITAS-Carnet