FastReport Tipps und Tricks: Unterschied zwischen den Versionen

Aus GEVITAS
Wechseln zu: Navigation, Suche
(Links)
(Formatierung)
 
(128 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
== Allgemeines ==
+
Hier gibt es Tipps und Tricks für das Erstellen von Reports mit '''FastReport©''', die im Alltag hilfreich sein können. Sie sind aus der Praxis entstanden. Im Laufe der Erfahrung mit '''FastReport©''' haben sich einige Themen angesammelt, so dass die Tipps und Tricks auf mehrere Seiten aufgeteilt wurden:
  
Dieser Artikel beschreibt kleine Tipps und Tricks für das Erstellen von Reports mit '''FastReport''', die im Alltag hilfreich sein können.
 
  
 +
== Eingebaute Funktionen und Variablen ==
  
 +
* [[FastReport Tipps und Tricks: Eingebaute Funktionen und Variablen#Anzahl der Datensätze|Anzahl der Datensätze]]
 +
* [[FastReport Tipps und Tricks: Eingebaute Funktionen und Variablen#Anzahl Datensätze vergleichen mit aktuellem Datensatz Anzahl|Datensätze vergleichen mit aktuellem Datensatz]]
 +
* [[FastReport Tipps und Tricks: Eingebaute Funktionen und Variablen#Interne Variablen|Interne Variablen]]
 +
* [[FastReport Tipps und Tricks: Eingebaute Funktionen und Variablen#Kopie des Ausdrucks|Kopie des Ausdrucks]]
 +
* [[FastReport Tipps und Tricks: Eingebaute Funktionen und Variablen#Report-Name|Report-Name]]
 +
* [[FastReport_Tipps_und_Tricks:_Eingebaute_Funktionen_und_Variablen#Positionstext_ohne_RFT-Formatierung|Positionstext ohne RFT-Formatierung]]
 +
* [[FastReport_Tipps_und_Tricks:_Eingebaute_Funktionen_und_Variablen#Text-Teile_l.C3.B6schen_am_Beispiel_Pfadname_entfernen|Text-Teile löschen am Beispiel "Pfadname entfernen"]]
  
=== Anzahl der Datensätze ===
+
* '''<big>[[FastReport Tipps und Tricks: Eingebaute Funktionen und Variablen|Zum kompletten Beitrag]]</big>'''
  
Manchmal hat man das Problem, dass bestimmte Bereiche unterdrückt werden sollen, wenn es nur einen einzigen Datensatz gibt. Beispielsweise hat man ein Mahnungsformular mit der Tabelle der fälligen Rechnungen und darunter die Gesamtsumme. Die Gesamtsumme soll aber unterdrückt werden, wenn es nur '''eine''' angemahnte Rechnung in der Tabelle gibt. Dann kann im Objektinspektor des Bereich auf das Ereignis
+
== Seiten-Ansteuerung ==
  
OnBeforePrint
+
* [[FastReport Tipps und Tricks: Seiten-Ansteuerung#Manueller Seitenwechsel im Code|Manueller Seitenwechsel im Code]]
 +
* [[FastReport Tipps und Tricks: Seiten-Ansteuerung#Manueller Seitenwechsel "Nachher" im Code|Manueller Seitenwechsel "Nachher" im Code]]
 +
* [[FastReport Tipps und Tricks: Seiten-Ansteuerung#Report-Zusammenfassung am Ende der Seite|Report-Zusammenfassung am Ende der Seite]]
 +
* [[FastReport Tipps und Tricks: Seiten-Ansteuerung#Leerzeilen verhindern bei unterdrücktem Feld|Leerzeilen verhindern bei unterdrücktem Feld]]
 +
* [[FastReport Tipps und Tricks: Seiten-Ansteuerung#Aufteilung erlauben|Aufteilung erlauben]]
  
doppelklicken und diesen Code schreiben:
+
* '''<big>[[FastReport Tipps und Tricks: Seiten-Ansteuerung|Zum kompletten Beitrag]]</big>'''
  
procedure Child2OnBeforePrint(Sender: TfrxComponent);
 
begin
 
    // Band mit der Gesamtsumme unterdrücken, wenn es nur EINE Rechnung gibt:
 
    if <Line#> = 1 then
 
        Child2.Visible := False
 
    else
 
        Child2.Visible := True;             
 
end;
 
  
Die System-Variable <Line#> beihaltet die Anzahl der Zeilen (Datensätze) des Detail-Bandes.
+
== Bänder ==
  
 +
* [[FastReport Tipps und Tricks: Bänder#Kapitel-Positionen zusammenhalten|Kapitel-Positionen zusammenhalten]]
 +
* [[FastReport Tipps und Tricks: Bänder#Band per Code unterdrücken|Band per Code unterdrücken]]
 +
* [[FastReport Tipps und Tricks: Bänder#Kapitel unterdrücken wenn alle Positionen ausgegeben sind|Kapitel unterdrücken wenn alle Positionen ausgegeben sind]]
 +
* [[FastReport Tipps und Tricks: Bänder#Positionen_unterdr.C3.BCcken_wenn_Kapitel_auf_.22Nicht_drucken.22_steht|Positionen unterdrücken wenn Kapitel auf "Nicht drucken" steht]]
 +
* [[FastReport Tipps und Tricks: Bänder#Band dehnen|Band dehnen]]
 +
* [[FastReport Tipps und Tricks: Child-Band wird nicht gedruckt|Child-Band wird nicht gedruckt]]
 +
* [[FastReport_Tipps_und_Tricks:_B%C3%A4nder#Saubere_Linien_um_B.C3.A4nder.2C_auch_wenn_Child-Band_unterdr.C3.BCckt_wird|Saubere Linien trotz unterdrücktem Child-Band]]
 +
* [[FastReport_Tipps_und_Tricks: B%C3%A4nder#Details-Band_wird_nicht_gedruckt_wenn_SubdetailData_leer|Detail-Band wird nicht gedruckt wenn Subdetail-Band leer]]
 +
* [[FastReport_Tipps_und_Tricks:_B%C3%A4nder#Warum_die_Sub-Details_ganz_unten_stehen|Warum die Sub-Details ganz unten stehen]]
 +
* [[FastReport_Tipps_und_Tricks:_B%C3%A4nder#Band_unterdr.C3.BCcken_wenn_nicht_Anfrage.2FAngebot|Band unterdrücken, wenn nicht Anfrage oder Angebot]]
 +
* [[FastReport_Tipps_und_Tricks:_B%C3%A4nder#Kapitel-Zwischensumme_nicht_drucken.2C_wenn_es_nur_EIN_Kapitel_im_Auftrag_gibt|Kapitel-Zwischensumme unterdrücken, wenn es nur EIN Kapitel im Auftrag gibt]]
  
 +
* '''<big>[[FastReport Tipps und Tricks: Bänder|Zum kompletten Beitrag]]</big>'''
  
=== Farbe eines Bandes abwechselnd grau/weiß ===
+
== Formatierung ==
  
Wenn man die Farbe eines Bandes (z.B. den Detail-Bereich, also die Positionen eines Auftrags) abwechselnd grau/weiß hinterlegen will, muss man ein bisschen in die Trickkiste greifen. Im '''OnBeforePrint-Ereignis''' des Bandes schreibt man diesen Code:
+
* [[FastReport Tipps und Tricks: Formatierung#Schrift-Farbe von Felder abhängig von der Fremdmenge|Schrift-Farbe von Felder abhängig von der Fremdmenge]]
 +
* [[FastReport Tipps und Tricks: Formatierung#Schrift-Farbe_abh.C3.A4ngig_vom_Alternativ-Kennzeichen|Schrift-Farbe abhängig vom Alternativ-Kennzeichen]]
 +
* [[FastReport Tipps und Tricks: Formatierung#Farbe eines Bandes abwechselnd grau/weiß|Farbe eines Bandes abwechselnd grau/weiß]]
 +
* [[FastReport Tipps und Tricks: Formatierung#Gruppenkopf auf letzter Seite unterdrücken, wenn keine Daten mehr kommen|Gruppenkopf auf letzter Seite unterdrücken, wenn keine Daten mehr kommen]]
 +
* [[FastReport Tipps und Tricks: Formatierung#Report mit Sub-Detail-Band wird abgebrochen, wenn es keine Sub-Daten gibt|Report mit Sub-Detail-Band wird abgebrochen, wenn es keine Sub-Daten gibt]]
 +
* [[FastReport Tipps und Tricks: Formatierung#Unterschiedliche Schriftarten in Auftrags-/Rechnungspositions-Texten|Unterschiedliche Schriftarten in Auftrags-/Rechnungspositions-Texten]]
 +
* [[FastReport Tipps und Tricks: Formatierung#Rahmen per Code setzen|Rahmen per Code setzen]]
 +
* [[FastReport Tipps und Tricks: Formatierung#Positionsangaben im Code|Positionsangaben im Code]]
 +
* [[FastReport Tipps und Tricks: Formatierung#Top-Position im Code ändern|Top-Position im Code ändern]]
 +
* [[FastReport Tipps und Tricks: Formatierung#Zahlen und Datum formatieren|Zahlen und Datum formatieren]]
 +
* [[FastReport Tipps und Tricks: Formatierung#Monats-Namen aus Monats-Zahl|Monats-Namen aus Monats-Zahl]]
 +
* [[FastReport Tipps und Tricks: Formatierung#Text in Großbuchstaben|Text in Großbuchstaben]]
 +
* [[FastReport_Tipps_und_Tricks:_Formatierung#Schriftattribute_.28Fett.2C_unterstreichen_.29_in_Feldern|Schriftattribute in Feldern]]
  
+
* '''<big>[[FastReport Tipps und Tricks: Formatierung|Zum kompletten Beitrag]]</big>'''
procedure DetailPositionenOnBeforePrint(Sender: TfrxComponent);
 
begin
 
  // Dieser Code wird ausgeführt, BEVOR das Positionen-Detail-Band ausgegeben wird.
 
 
  // Farbe abwechselnd weiß/grau:
 
  if <Line> mod 2 = 1 then  // Bei jeder GERAD-STELLIGEN Zeile!
 
  begin             
 
    TfrxBrushFill(DetailPositionen.Fill).BackColor := cl3dLight; 
 
    TfrxBrushFill(ChildDetailPositionen.Fill).BackColor := cl3dLight; 
 
  end               
 
  else
 
  begin             
 
    TfrxBrushFill(DetailPositionen.Fill).BackColor := clNone;
 
    TfrxBrushFill(ChildDetailPositionen.Fill).BackColor := clNone; 
 
  end;
 
end;
 
  
Der erste Trick ist die Zeile
+
== Variablen ==
  
  if <Line> mod 2 = 1 then  // Bei jeder GERAD-STELLIGEN Zeile!
+
* [[FastReport Tipps und Tricks: Variablen#Fortlaufende Nummer|Fortlaufende Nummer]]
 +
* [[FastReport Tipps und Tricks: Variablen#Zähler-Variable zum Unterdrücken von wiederholten Werten|Zähler-Variable zum Unterdrücken von wiederholten Werten]]
 +
* [[FastReport Tipps und Tricks: Eingebaute Funktionen und Variablen#Interne Variablen|Interne Variablen]]
 +
* [[FastReport Tipps und Tricks: Variablen#Variablen_im_Code_mit_Inhalten_f.C3.BCllen|Variablen im Code mit Inhalten füllen]]
  
'''<Line>''' ist eine System-Variable, die eine fortlaufende Zeilennummer (Datensatz-Nummer) zurückgibt, die FastReport einfach hochzählt. Der erste Datensatz hat einfach die Zeilennummer 1, der nächste 2 usw.
 
  
'''mod 2''' ist eine Division und bringt den Rest der Divison zurück.
+
* '''<big>[[FastReport Tipps und Tricks: Variablen|Zum kompletten Beitrag]]</big>'''
  
 +
== Verwendung von Feldern ==
  
 +
* [[FastReport Tipps und Tricks: Verwendung von Feldern#Zeilenumbruch innerhalb von Feldern|Zeilenumbruch innerhalb von Feldern]]
 +
* [[FastReport Tipps und Tricks: Verwendung von Feldern#Zeilenabstand in Feldern|Zeilenabstand in Feldern]]
 +
* [[FastReport Tipps und Tricks: Verwendung von Feldern#Berechnungen in einem Feld|Berechnungen in einem Feld]]
 +
* [[FastReport Tipps und Tricks: Verwendung von Feldern#Zahlenwert in Text umwandeln|Zahlenwert in Text umwandeln]]
 +
* [[FastReport Tipps und Tricks: Verwendung von Feldern#Berechnungen in einem Feld mit Formatierung|Berechnungen in einem Feld mit Formatierung]]
 +
* [[FastReport Tipps und Tricks: Verwendung von Feldern#Datumsfeld unterdrücken, wenn kein Datum drin steht|Datumsfeld unterdrücken, wenn kein Datum drin steht]]
 +
* [[FastReport Tipps und Tricks: Bilder zur Laufzeit laden|Bilder zur Laufzeit laden]]
 +
* [[FastReport_Tipps_und_Tricks:_Verwendung_von_Feldern#Hyperlinks_in_Feldern|Hyperlinks in Feldern]]
 +
* [[FastReport_Tipps_und_Tricks:_Verwendung_von_Feldern#Nur_die_ersten_X_Stellen_eines_Feldes_verwenden|Nur die ersten X Stellen eines Feldes verwenden]]
  
=== Gruppenkopf auf letzter Seite unterdrücken, wenn keine Daten mehr kommen ===
+
* '''<big>[[FastReport Tipps und Tricks: Verwendung von Feldern|Zum kompletten Beitrag]]</big>'''
  
Man kann den Gruppenkopf einer Gruppe ganz gut dazu benutzen, eine Überschrift über die Positionen zu drucken, die auch auf jeder Seite wiederholt wird. Es kann nun aber vorkommen, dass die Positionen gerade an Ende einer Seite aufhören und auf der nächsten Seite trotzdem noch die Überschrift dazu gedruckt wird. Das sieht unschön aus. '''[[FastReport Gruppenkopf unterdrücken, wenn keine Daten mehr kommen|Dieser Artikel]]'''  beschreibt, wie man das verhindert.
+
== Dialoge im Report ==
  
 +
* [[FastReport Tipps und Tricks: Dialoge im Report#Ausführen des Reports per Kennzeichen verhindern|Ausführen des Reports per Kennzeichen verhindern]]
  
 +
* '''<big>[[FastReport Tipps und Tricks: Dialoge im Report|Zum kompletten Beitrag]]</big>'''
  
=== Report mit Sub-Detail-Band wird abgebrochen, wenn es keine Sub-Daten gibt ===
 
  
Ein Report hat folgende Bänder:
 
  
* Master (Kopfdaten)
+
== Sonstiges ==
** Details (Positionen)
 
*** SubDetails (Unterpositionen zu jeder Position)
 
  
Der Report wird wird jedoch '''abgebrochen''', denn es keine Sub-Daten gibt!
+
* [[FastReport Unterberichte]]
  
Grund:
+
* [[If-Then-Else: Eine Einführung in die Programmierung]]
  
Man muss die Option '''"Drucken wenn Detail leer"''' auf dem Detail-Band einschalten!
+
== Fehler ==
  
 +
* [[FastReport Tipps und Tricks: Fehler#Tabelle wird im Report nicht angezeigt|Tabelle wird im Report nicht angezeigt]]
 +
* [[FastReport Tipps und Tricks: Fehler#Band wird nicht gedruckt, obwohl Daten vorhanden sind|Band wird nicht gedruckt, obwohl Daten vorhanden sind]]
 +
* [[FastReport Tipps und Tricks: Fehler#Detail-Band mit Auftragspositionen wird mehrfach gedruckt, obwohl nur ein Datensatz vorhanden ist|Detail-Band mit Auftragspositionen wird mehrfach gedruckt, obwohl nur ein Datensatz vorhanden ist]]
 +
* [[FastReport Tipps und Tricks: Fehler#Schrift-Farbe eines Feldes wird im Editor angezeigt, in der Vorschau/im Druck nicht|Schrift-Farbe eines Feldes wird im Editor angezeigt, in der Vorschau/im Druck nicht]]
 +
* [[FastReport Tipps und Tricks: Fehler#Anzahl Seitennummern ist 0|Anzahl Seitennummern ist 0]]
 +
* [[FastReport Tipps und Tricks: Fehler#Etikettenformular: Es wird immer nur ein Etikett gedruckt|Etikettenformular: Es wird immer nur ein Etikett gedruckt]]
 +
* [[FastReport Tipps und Tricks: Fehler#Ich kann die Sortierung beim Drucken einer Ladeliste nicht ändern!|Ich kann die Sortierung beim Drucken einer Ladeliste nicht ändern!]]
 +
* [[FastReport Tipps und Tricks: Fehler#Lieferschein wird übereinander gedruckt|Lieferschein wird übereinander gedruckt]]
 +
* [[FastReport Tipps und Tricks: Fehler#Prüfprotokoll wird nicht gedruckt|Prüfprotokoll wird nicht gedruckt]]
 +
* [[FastReport Tipps und Tricks: Fehler#Fehlermeldung "Alternativ nicht gefunden" in Rechnung|Fehlermeldung "Alternativ nicht gefunden" in Rechnung]]
 +
* [[FastReport Tipps und Tricks: Fehler#Fehlermeldung "Fehler im Ausdruck';' expected"|Fehlermeldung "Fehler im Ausdruck';' expected"]]
 +
* [[FastReport Tipps und Tricks: Fehler#Fehlermeldung "Memo XX: Fehler im Ausdruck xxxx"|Fehlermeldung "Memo XX: Fehler im Ausdruck xxxx"]]
 +
* [[FastReport_Tipps_und_Tricks:_Fehler#Fehlermeldung_unter_mySQL:_.22Variante_des_Typs_.28UnicodeString.29_konnte_nicht_in_Typ_.28Double.29_konvertiert_werden|Fehlermeldung: "Variante des Typs (UnicodeString) konnte nicht in Typ (Double) konvertiert werden]]
 +
* [[FastReport_Tipps_und_Tricks:_Fehler#Bei_der_Vorschau_h.C3.A4ngt_sich_das_Programm_an_manchen_Rechner_auf|Bei der Vorschau hängst sich das Programm auf]]
  
  
=== Band wird nicht gedruckt, obwohl Daten vorhanden sind ===
+
* '''<big>[[FastReport Tipps und Tricks: Fehler|Zum kompletten Beitrag]]</big>'''
  
Ein bestehende Report wurde geändert, z.B. ein Detail-Band wurde entfernt. Das Master-Band wird nicht gedruckt, obwohl Daten vorhanden sind.  
+
* Programm hängt sich scheinbar auf:
 +
:Bei Drucken in ein PDF-Programm (also als Drucker ist z.B. PDF-Writer) über die Vorschau hängst sich das Programm scheinbar auf.
 +
;Ursache:
 +
:Im PDF-Programm ist ein Dialog "Speichern unter" geöffnet. Dieses muss geschlossen werden!
  
Grund:
+
== Export ==
  
Das Master-Datenband wurde im Original-Report nicht gebraucht und daher dauerhaft ausgeblendet. Stellen Sie die Eigenschaft '''Visible''' von '''False''' auf '''True'''.
+
* [[FastReport Tipps und Tricks: Export#Export PDF|Export PDF]]
 +
* [[FastReport Tipps und Tricks: Export#Exportierte PDF-Dateien sind sehr gross|Exportierte PDF-Dateien sind sehr gross]]
 +
* [[FastReport Tipps und Tricks: Export#Windows-Explorer mit dem Formular-Ordner öffnen|Windows-Explorer mit dem Formular-Ordner öffnen]] im Druck-Fenster
  
 +
* '''<big>[[FastReport Tipps und Tricks: Export|Zum kompletten Beitrag]]</big>'''
  
  
=== Anzahl Seitennummern ist 0 ===
 
 
In einem Report gibt es ein Feld, in dem die aktuelle Seite und die Gesamt-Seitenanzahl im Kopf gedruckt werden. Die Gesamt-Seitenanzahl ist jedoch immer 0!
 
 
Das Feld hat folgenden Inhalt:
 
 
<nowiki>Stand: [Date]    Seite [Page] von [TotalPages]</nowiki>
 
 
Beispiel:
 
 
[[Datei:FastReport_Bsp_Zweipass_01.png]]
 
 
'''Warum zeigt <nowiki>[TotalPages]</nowiki> immer 0 statt der Anzahl der Seiten?'''
 
 
;Grund:
 
:Damit <nowiki>[TotalPages]</nowiki> funktioniert, muss man dem Report "sagen", dass er zuerst den Report intern durchrechnen soll. Erst danach weiß der Report, wie viele Seiten erzeugt werden!
 
:Dazu muss man den Report im Designer öffnen und dann auf das Menü '''Report&rArr;Optionen''' klicken. Dann schaltet man die Option '''Zweipass''' ein:
 
 
[[Datei:FastReport_Bsp_Zweipass_02.png]]
 
 
:Das Ergebnis:
 
 
[[Datei:FastReport_Bsp_Zweipass_03.png]]
 
 
 
 
=== Datumsfeld unterdrücken, wenn kein Datum drin steht ===
 
 
Wenn man ein Datumsfeld im Report hat, steht dort je nach Formatierung "0" oder "30.12.1899" drin, wenn es gar kein Datum gibt. Behelfen könnte man sich, indem man das Feld im Code '''OnBeforePrint''' unterdrückt, wenn kein Datum drin steht. Einfacher ist es aber, auf dem Feld mit der '''rechten Maustaste''' zu klicken und die Option '''Nullen verbergen''' einzuschalten!
 
 
Wenn man einen Rahmen um das Feld angegeben hat, weil man die Daten tabellarisch anzeigen möchte, so fehlt in diesem Fall das Feld und auch der Rahmen. Um diese "Zahnlücke" zu füllen, kann man ein leeres Textfeld über oder unter das Datumsfeld setzen, das genauso groß ist und die Lücke füllt, falls das Datumsfeld ausgeblendet wird.
 
 
 
 
=== Berechnungen in einem Feld ===
 
 
Wenn man in einem Feld etwas berechnen möchte, muss man dazu keine Formel oder Variable verwenden wie in CrystalReports&copy;! Man kann die Rechenformel einfach in das Feld schreiben.
 
 
Beispiel:
 
 
In einer Ladeliste möchte man eine Spalte haben mit der Auftragsmenge zzgl. der Reserve-Mengte, abzgl. der Fremdmenge, also die zu ladende eigene Menge. Dazu zieht man man einfach ein Textfeld in das entsprechende Detail-Band und stellt die Formel zusammen:
 
 
[<Positionen."Menge"> + <Positionen."MengeReserve"> - <Positionen."MengeFremd">]
 
 
Die Feldnamen kann man mit diesem Button holen:
 
 
[[Datei:FastReport_Memo_MitFormel.png]]
 
 
Die eckigen Klammern
 
 
[ ... ]
 
 
legen den Anfang und das Ende der Formel fest.
 
 
Normalerweise werden Datenbank-Felder in eckigen Klammern angegeben,
 
 
;<big>Wenn innerhalb der Formel Datenbank-Felder eingebunden werden, müssen diese jedoch in '''spitzen Klammern''' angegeben werden!</big>
 
 
;Falsch:
 
 
[[Positionen."Menge"] + [Positionen."MengeReserve"] - [Positionen."MengeFremd"] ]
 
 
;Richtig:
 
 
[<Positionen."Menge"> + <Positionen."MengeReserve"> - <Positionen."MengeFremd">]
 
 
 
 
=== Zahlenwert in Text umwandeln ===
 
 
Manchmal hat man die Aufgabe, einen Zahlenwert aus der Datenbank in einen Text umzuwandeln. Ein Beispiel dafür zeigt der '''[[Report für das Lagerprotokoll]]'''.
 
 
 
 
=== Berechnungen in einem Feld mit Formatierung ===
 
 
Wenn man in einem Feld etwas berechnet, wird das Ergebnis so ausgegeben, wie es die Berechnung ergibt. Wenn man z.B. mit zwei Fließkommazahlen rechnet, wird das Ergebnis auch mit allen resultierenden Nachkommstellen ausgegeben.
 
 
;Beispiel:
 
:Im Rechnungsfuß wird der Skonto-Betrag und Skonto-Zahlungsbetrag errechnet und ausgegeben. Der Text im Feld lautet:
 
 
<nowiki>Bei Zahlung bis zum <b>[RechnungsFuss."Skonto1BisDatum"]</b> gewähren wir [RechnungsFuss."Skonto1Prozent"] % Skonto = [RechnungsFuss."Skonto1Betrag"].
 
Zahlungsbetrag mit Skonto: <b>[<RechnungsFuss."GesamtBetragBrutto"> - <RechnungsFuss."Skonto1Betrag">]</b></nowiki>
 
 
:Das Ergebnis sieht so aus:
 
 
[[Datei:FastReport_Rechnung_Skonto_Unformatiert.png|border]]
 
 
:Damit die Ergebnisse formatiert werden, kann man die eingebaute Funktion <code>FormatFloat( 'Format',Zahl )</code> verwenden. Diese formatiert die Zahl anhand der Vorgaben im Text '''Format'''.
 
 
:Die Formel dazu sieht nun so aus:
 
<nowiki> Bei Zahlung bis zum <b>[RechnungsFuss."Skonto1BisDatum"]</b> gewähren wir [RechnungsFuss."Skonto1Prozent"] % Skonto = [FormatFloat('#,##0.00 €',<RechnungsFuss."Skonto1Betrag">)].
 
Zahlungsbetrag mit Skonto: <b>[FormatFloat('#,##0.00 €', <RechnungsFuss."GesamtBetragBrutto"> - <RechnungsFuss."Skonto1Betrag">    )]</b></nowiki>
 
 
:Das Ergebnis:
 
 
[[Datei:FastReport_Rechnung_Skonto_Formatiert.png|border]]
 
 
;Die Ausdrücke der Formel im Einzelnen:
 
 
<nowiki>Bei Zahlung bis zum <b>[RechnungsFuss."Skonto1BisDatum"]</b> gewähren wir [RechnungsFuss."Skonto1Prozent"] % Skonto</nowiki>
 
 
:Es sind Verweise auf Datenbankfelder in der Formel enthalten, die mit eckigen Klammern eingefügt werden. Eigentlich müsste es nach den Regeln von oben so heißen:
 
 
<nowiki>Bei Zahlung bis zum <b>[<RechnungsFuss."Skonto1BisDatum">]</b> gewähren wir [<RechnungsFuss."Skonto1Prozent">] % Skonto</nowiki>
 
 
Das ist auch zulässig. FastReport erlaubt es jedoch, die spitzen Klammern wegzulassen, wenn der Ausdruck nur '''eine''' Variable oder nur '''ein''' Datenbank-Feld beinhaltet!
 
 
;Die Formatierung:
 
 
<nowiki>% Skonto = [FormatFloat('#,##0.00 €',<RechnungsFuss."Skonto1Betrag">)].</nowiki>
 
 
Mit
 
 
[...]
 
 
wird der "Ausdruck" (also die Formel in der Formel) begrenzt. Innerhalb des Ausdrucks befindet sich die Funktion <code>FormatFloat</code>. Dieser wird zuerst die gewünschte Formatierung übergeben <code>'#,##0.00 €'</code> und nach dem Komma der Wert, der zu formatieren ist:
 
 
<nowiki><RechnungsFuss."Skonto1Betrag"></nowiki>
 
 
Bei der Berechnung...
 
 
<nowiki>Zahlungsbetrag mit Skonto: <b>[FormatFloat('#,##0.00 €', <RechnungsFuss."GesamtBetragBrutto"> - <RechnungsFuss."Skonto1Betrag">    )]</b></nowiki>
 
 
ist das genau das Gleiche, nur dass halt zwei Datenbankfelder verrechnet werden!
 
 
;Hinweis
 
:Leider unterstützt <code>FormatFloat</code> die universelle Währungsangaben <code>%2.2m</code> '''nicht'''. Man muss das Währungssymbol also fest angeben. Wenn die Währung in Ihrem Land nicht der EURO ist, müssten Sie den Report an dieser Stelle entsprechend anpassen.
 
 
 
;Unterdrücken, wenn kein Skonto:
 
:Mit diesem, Code kann man das Feld unterdrücken, wenn kein Skonto angegeben wurde:
 
 
procedure RechnungsFussSkonto1BisDatumOnBeforePrint(Sender: TfrxComponent);
 
begin
 
  if <RechnungsFuss."Skonto1Betrag"> = 0 then
 
    RechnungsFussSkonto1BisDatum.Visible := False;
 
end;
 
 
 
=== Report-Zusammenfassung am Ende der Seite ===
 
 
Wenn man die Report-Zusammenfassung (Report Summary) am '''Ende der Seite''' drucken will, muss man im Ereignis '''ReportSummary1OnBeforePrint''' diesen Code einfügen:
 
 
 
procedure ReportSummary1OnBeforePrint(Sender: TfrxComponent);
 
begin
 
  Engine.CurY := Engine.CurY + Engine.FreeSpace - ReportSummary1.Height - 1; 
 
end;
 
 
Einzelheiten zu '''FastReport-Engine''' werden unter [[FastReport Engine: Der Report-Erzeuger]] beschrieben.
 
 
 
=== Positionsangaben im Code ===
 
 
Manchmal möchte man im Code ein Objekt verschieben.
 
 
;Beispiele:
 
 
* Der Pauschal-Betrag in einem Angebot soll nach links eingerückt werden.
 
* Ein Feld soll nach oben verschoben werden, wenn andere darüber ausgeblendet werden.
 
 
Dann kann man im Code die Position des Objektes festlegen:
 
 
;Left
 
:Legt die '''horizontale''' Position des Objektes fest, bezogen auf den linken Rand des Bands.
 
 
;Top
 
:Legt die '''vertikale''' Position des Objektes fest, '''bezogen auf das Band'''.
 
 
Beispiel:
 
 
  if <BestellFuss."Nettobetrag1"> = 0 then //JC//160209//
 
  begin
 
      RichFussStandardText.Top := 0.5 * fr1cm;
 
  end;
 
 
Dieser Code verschiebt ein Feld nach oben, und zwar auf 0,5 cm, '''bezogen auf das Band''', auf dem es liegt.
 
 
"fr1cm" ist dabei eine Umrechnungs-Variable, die FastReport zur Verfügung stellt.
 
 
Der Grund: Alle Angaben von Positionen im Code wie '''Top''', '''Left''' usw. werden in '''Pixeln''' gemacht. Dadurch ist eine sehr genaue und Hardware-unabhängige Positionierung möglich. Damit man nun die Angaben von Pixeln z.B. in '''cm''' einfach angeben kann, muss man nur die gewünschte cm-Anzahl mit '''fr1cm''' multiplizieren.
 
 
Im Beispiel oben wird das Textfeld auf die Top-Position (=von oben auf dem Band) auf 0,5 cm gesetzt.
 
 
* Beachten Sie, dass das Kommata im Code der '''Punkt''' ist! Wenn man im Code also "0,5" schreibt, erhält man eine Fehlermeldung! Man muss "0.5" schreiben!
 
 
=== Leerzeilen verhindern bei unterdrücktem Feld ===
 
 
Wenn man in einem Report mehrere Felder untereinander hat, von denen das '''unterste''' unterdrückt werden soll, hat man das Problem, dass das Feld zwar ausgeblendet wird ('''Visible := False'''), der Platz unten aber leider nicht, es bleibt also eine Leerzeile:
 
 
Beispiel:
 
 
In diesem Bereich...
 
 
 
[[Datei:FastReport_TippsUndTrick_Positionen_TextPosition.png]]
 
 
...wird das TextPositionen-Feld '''<code>RichTextArtikelText</code>''' mit diesem Code ausgeblendet:
 
 
  procedure '''RichTextArtikelText'''OnBeforePrint(Sender: TfrxComponent);
 
  begin
 
    // Kennzeichen 6 = Artikel-Texte sichtbar Ja/Nein:  //JC//160111//
 
    // (oder wenn leer)
 
    RichTextArtikelText.Visible:= True;  //JC//160111//
 
    <nowiki>if ( <AuftragsKopf."KENNZ6"> = 'Nein' )</nowiki>
 
    <nowiki>or ( <Positionen."TextPosition"> = '' ) then</nowiki>
 
    <nowiki>begin</nowiki>
 
    <nowiki>  RichTextArtikelText.Visible    := False;</nowiki>
 
    end;
 
  end;
 
 
Das Ergebnis:
 
 
[[Datei:FastReport_TippsUndTrick_Positionen_TextPosition_Vorher.png]]
 
 
An den markierten Stellen gibt es Leerzeilen. FastReport kann zwar Felder nach unten schieben und auch das Band vergrößern, wenn ein darüberliegendes Feld größer wird, aber das Band wird leider nicht verkleinert, wenn das letzte Feld ausgeschaltet wird.
 
 
Um das zu verhindern, kann man folgenden Code einfügen:
 
 
  procedure '''RichTextArtikelText'''OnAfterPrint(Sender: TfrxComponent);
 
  begin
 
    // Druckposition um die Höhe des Feldes nach oben verschieben:
 
    if  RichTextArtikelText.Visible = False then
 
        Engine.CurY := Engine.CurY - RichTextArtikelText.Height;
 
  end;
 
 
Die Zeilen verschieben die Druckposition um die Höhe des Feldes nach oben, wenn das Feld unsichtbar ist.
 
 
* Einzelheiten zu '''FastReport-Engine''' werden unter [[FastReport Engine: Der Report-Erzeuger]] beschrieben.
 
 
Das Ergebnis nun:
 
 
[[Datei:FastReport_TippsUndTrick_Positionen_TextPosition_Nachher.png]]
 
 
 
 
 
=== Kapitel-Positionen zusammenhalten ===
 
 
Es kann vorkommen, dass auf die Seite nur noch die Kapitel-Überschrift passt und keine Position mehr. Beispiel:
 
 
[[Datei:FastReport_TippsUndTrick_KapitelPositionen_Zusammenhalten_Vorher.png]]
 
 
Um das zu verhinden, setzt man die Option:
 
 
[[Datei:FastReport_TippsUndTrick_KapitelPositionen_Zusammenhalten_Option.png]]
 
 
Nachher:
 
 
 
[[Datei:FastReport_TippsUndTrick_KapitelPositionen_Zusammenhalten_Nachher.png]]
 
 
 
 
 
=== Unterschiedliche Schriftarten in Auftrags-/Rechnungspositions-Texten ===
 
 
In den Textbausteinen eines Angebots, Auftrags oder einer Rechnung kommen die Texte in unterschiedlichen Schriftarten oder -Größen. Die Schriftart-Änderung im Report ist '''ohne Wirkung'''.
 
 
;Grund:
 
:Die Schriftarten kommen '''aus den Texten''' selbst, also aus der Datenbank, nicht aus dem Report!
 
:Es handelt sich hier ja um '''RTF-formatierte''' Texte. Die Schriftart/-Größe wird in den Stammdaten festgelegt. Das ermöglicht es, innerhalb des Textes Formatierungen vorzunehmen, z.B. Fettschrift.
 
:Beim Einfügen eines solchen Textes wird die Formatierung aus den Stammdaten in die Positionen 1:1 übernommen.
 
 
;Lösung
 
:Man muss also die Schriftart in den '''Artikelstammdaten&rArr;Texte''' ändern!
 
:Will man die Änderung testen, hat das zuerst keine Auswirkung! Grund: Änderungen in den Stammdaten werden nicht in die bestehenden Positionen übernommen, sonst würden dort eventuelle individuelle Änderungen unkontrolliert überschrieben. Man muss daher in den '''[[REFLEX_Auftragspositionen#Texte_in_der_Positions-Eingabemaske|Positonen im Textbereich]]''' rechts unten auf den Sternchen-Button klicken, damit der Text neu aus den Stammdaten in die Position geholt wird.
 
 
=== Ausführen des Reports per Kennzeichen verhindern ===
 
 
Wenn man das Ausführen (Vorschau, Drucken usw.) eines Reports über ein Kennzeichen verhindern will, kann man dazu in den Report ein Dialog-Fenster einbauen, das unter bestimmten Bedingungen angezeigt wird und die Ausführung des verhindert.
 
 
;Beispiel:
 
:Man verwendet das '''Auftragskennzeichen 8''' ("Ladeliste freigegeben"), um das Drucken einer Ladeliste zu verhindern. Wenn dort "Nein" ausgewählt wird, darf die Ladeliste nicht gedruckt werden.
 
 
Dazu fügt man im Designer mit dem Menü '''Datei &rArr; einen neuen Dialog ein. In diesen Dialog fügt man ein Label (Text) und einen Button ein, wie in diesem Beispiel:
 
 
 
[[Datei:FastReport_TippsUndTrick_Dialog_01.png]]
 
 
 
* Stellen Sie die Schriftart ("Font") und die Farbe ("Color") der Objekte nach Ihren Ansprüchen ein!
 
* Die Eigenschaft '''ModalResult" ("Ergebnis des Dialogs") des Buttons stellen Sie auf "mrCancel" (Abbruch).
 
 
Wenn Sie nun den Report ausführen, wird der Dialog angezeigt und der Report nicht ausgeführt!!!
 
 
So wollen wird das natürlich nicht haben! Der Dialog soll ja nur angezeigt werden, wenn das '''Kennzeichen 8''' nicht auf "Nein" steht.
 
 
Deshalb suchen Sie im '''Report-Baum''' den Report "Report" aus.
 
 
* Den '''Report-Baum''' können Sie über das Menü '''Ansicht &rArr; Symbolleisten''' einschalten.
 
 
 
Klicken Sie nun im '''Objektinspektor''' auf '''Ereignisse''' und dort doppelklicken Sie auf '''frxReport1OnRunDialogs'''.
 
 
* Den '''Objektinspektor''' können Sie über das Menü '''Ansicht &rArr; Symbolleisten''' einschalten.
 
 
Geben Sie nun diesen Code ein:
 
 
procedure frxReport1OnRunDialogs(var Result: Boolean);
 
begin
 
  if <AuftragsKopf."KENNZ8"> = 'Nein' then
 
    Result := DialogPage1.ShowModal = mrOK
 
  else
 
    Result := True;
 
end;
 
 
 
Die Variable '''Result''' ist das Ergebnis der Abfrage:
 
 
* Wird sie auf '''True''' gestellt, wird der Report ausgeführt.
 
* Wird sie auf '''False''' gestellt, wird der Report '''nicht''' ausgeführt.
 
 
Wenn das Kennzeichen auf "Nein" steht, wird dieser Dialog angezeigt:
 
 
[[Datei:FastReport_TippsUndTrick_Dialog_02.png]]
 
 
 
=== Manueller Seitenwechsel im Code ===
 
 
Wenn man im Report einen manuellen Seitenwechsel anhand eines Kennzeichens erzeugen will, muss man im Ereignis '''OnBeforePrint''' des gewünschten Bandes diesen Code einfügen:
 
 
procedure GroupHeader1OnBeforePrint(Sender: TfrxComponent);
 
begin
 
  // Dieser Code wird ausgeführt, BEVOR das Positionen-Gruppenkopf-Band (die Kapitel-Überschrift) ausgegeben wird.
 
  // Wenn das Kennzeichen "Seitenwechsel Vorher" gesetzt ist:
 
  if <Positionen."Seitenwechsel_0Nein_1Vorher_2Nachher"> = 1 then
 
    Engine.NewPage;                                  // Neue Seite, Seitenkopf usw. drucken
 
end;
 
 
procedure DetailPositionenOnBeforePrint(Sender: TfrxComponent);
 
begin
 
  // Dieser Code wird ausgeführt, BEVOR das Positionen-Detail-Band ausgegeben wird.
 
 
  // Kapitel-Position ausblenden:
 
  if <Positionen."PosNr"> = 0 then
 
  begin
 
    DetailPositionen.Visible := False;
 
  end
 
  else
 
    DetailPositionen.Visible := True;
 
 
  // Wenn das Kennzeichen "Seitenwechsel Vorher" gesetzt ist:
 
  if <Positionen."PosNr"> > 0 then                                  // NICHT bei Kapitel-Position, das wird da schon gemacht!
 
    if <Positionen."Seitenwechsel_0Nein_1Vorher_2Nachher"> = 1 then
 
      Engine.NewPage;                                                // Neue Seite, Seitenkopf usw. drucken
 
end;
 
 
Das Feld, mit dem die Seitenwechsel-Option gespeichert wird, heißt übrigens wirklich '''Seitenwechsel_0Nein_1Vorher_2Nachher'''. Das ist zwar ungewöhnlich, zeigt aber schon im Feldnamen, welche Optionen es gibt. Ungewöhnlich aber praktisch!
 
 
 
=== Tabelle wird im Report nicht angezeigt ===
 
 
Wenn eine bestimmte Tabelle wird im Report nicht angezeigt wird, obwohl sie eigentlich vorhanden sein müsste, müssen Sie diese Tabelle u.U. erst im Report auswählen. Siehe '''[[FastReport Dataset (Tabelle) wird im Report nicht angezeigt]]'''.
 
 
Wenn eine Tabelle nicht ausgewählt wird, kann es auch zu einer Fehlermeldung kommen:
 
 
Fehler im Ausdruck ´Tabellenname."Feld": Identifier expected
 
 
In diesem Fall wird der Report nicht ausgeführt. Anstelle der Daten kommen die Feldnamen des Reports oder auch gar nichts!
 
 
=== Fehlermeldung "Alternativ nicht gefunden" in Rechnung ===
 
 
Wenn Sie einen als Auftragsformular erstellten Report kopieren und als Rechungsformular (-Grundlage) verwenden wollen, erhalten Sie eine Fehlermeldung wie diese:
 
 
[[Datei:FastReport_Rechnung_Fehlermeldung_Alternativ.png]]
 
 
Grund:
 
 
In Rechnungen gibt es kein Alternativ.
 
 
Lösung:
 
 
Entfernen Sie mit dem Report-Designer alle Verweise auf das Alternativ-Feld!
 
 
 
 
== Export PDF ==
 
 
Reports können auch im Format '''PDF/A''' exportiert werden.
 
 
[//de.wikipedia.org/wiki/PDF/A Einzelheiten]
 
  
  
  
  
 +
== Links ==
  
== Im Druck-Fenster ==
+
* [[Mehrsprachige Reports mit FastReport]]
 
 
=== Windows-Explorer mit dem Formular-Ordner öffnen ===
 
 
 
Wenn man schnell den Windows-Explorer mit dem eingestellten Formular-Ordner öffnen will, doppelklickt man einfach auf das Auswahlfeld im Druck-Fenster.
 
 
 
Wenn man dort z.B. eine Report-Datei umbenennt, muss man auf den kleinen Refresh-Button neben dem Auswahlfeld klicken. Damit wird die Auswahlliste des Feldes aktualisiert.
 
 
 
== Links ==
 
  
 
* [[FastReport Fehlermeldungen]]
 
* [[FastReport Fehlermeldungen]]
Zeile 523: Zeile 174:
  
 
* [//youtu.be/5krqu5oSuGU Video FastReport Teil 10: Vererbung, Erstellen und Verwenden eines Basis-Reports]
 
* [//youtu.be/5krqu5oSuGU Video FastReport Teil 10: Vererbung, Erstellen und Verwenden eines Basis-Reports]
 +
 +
* [//youtu.be/KwOBk12rTNg Video FastReport Teil 16: Ladeliste nach Lagerort und Artikeln]
 +
 +
* [//youtu.be/tf2W3cML7Xg Video FastReport: Artikel-Report mit Bildern]
  
 
* [//www.fast-report.com/de/ Homepage von FastReport]
 
* [//www.fast-report.com/de/ Homepage von FastReport]

Aktuelle Version vom 5. Mai 2021, 12:23 Uhr

Hier gibt es Tipps und Tricks für das Erstellen von Reports mit FastReport©, die im Alltag hilfreich sein können. Sie sind aus der Praxis entstanden. Im Laufe der Erfahrung mit FastReport© haben sich einige Themen angesammelt, so dass die Tipps und Tricks auf mehrere Seiten aufgeteilt wurden:


1 Eingebaute Funktionen und Variablen

2 Seiten-Ansteuerung


3 Bänder

4 Formatierung

5 Variablen


6 Verwendung von Feldern

7 Dialoge im Report


8 Sonstiges

9 Fehler


  • Programm hängt sich scheinbar auf:
Bei Drucken in ein PDF-Programm (also als Drucker ist z.B. PDF-Writer) über die Vorschau hängst sich das Programm scheinbar auf.
Ursache
Im PDF-Programm ist ein Dialog "Speichern unter" geöffnet. Dieses muss geschlossen werden!

10 Export




11 Links