Quelltext der Seite FastReport: Anlegen und verwenden von Variablen im Report

== Allgemeines ==

Eine Variable in FastReport ist eine Art "Platzhalter" mit einem bestimmten Namen. Die Variable hat einen variablen Wert/Inhalt, daher der Name.

=== Systemvariablen ===

Es gibt '''Systemvariablen''', die von FastReport zur Verfügung gestellt werden, z.B.

;<nowiki>[Page]</nowiki>
:Die aktuelle Seiten-Nummer

;<nowiki>[TotalPages]</nowiki>
:Die höchste Seiten-Nummer. Damit diese einen Wert zeigt, muss in den Report-Optionen die Option "Zweipass" eingeschaltet sein! In diesem Fall wird der Report zweimal ausgeführt: Das erste Mal "im Stillen", ohne dass der Report ausgegeben wird. Danach "weiß" der Report die Gesamtseitenzahl und gibt den Report nun aus. Dieses zweimalige Ausführen des Reports dauert natürlich etwas länger. Deshalb sollte man die Option nur einschalten, wenn man die Gesamtseitenzahl auch wirklich braucht!

;<nowiki>[Date]</nowiki>
:Das aktuelle Datum

;<nowiki>[Time]</nowiki>
:Die aktuelle Zeit

;<nowiki>[Line]</nowiki>
:Die Zeilen-Nummer (Datensatz-Nummer) eines Detail-Bandes.

=== Eigene Variablen ===

Eigene Variablen kann man z.B. dazu verwenden, in einem Report einen bestimmten Wert zu berechnen, z.B. aus der Menge und dem Gewicht das Gesamt-Gewicht.


=== Programm-Variablen ===

Diese Variablen stellt das Programm zur Verfügung, siehe '''[[GevitasFormPrint#Variablen|GevitasFormPrint Variablen]]'''.

Die Namen dieser Variablen sind festgelegt und müssen '''genau so''' angelegt werden, wie beschrieben!


== Anlegen einer Variablen ==

Zum Anlegen einer Variablen klickt man auf das Menü '''Report &rArr; Variablen'''. In diesem Fenster kann man die eigenen oder Programm-Variablen anlegen:

[[Datei:FastReport_Variablen_Fenster_Bsp.png]]

Jede Variable, die man selbst anlegt, muss zu einer bestimmten Kategorie gehören, im Beispiel oben "EigeneVariablen".

Wenn es noch keine gibt, muss man diese mit dem Button oben links zuerst anlegen. Der Name der Kategorie ist beliebig. Wenn man in einem Report viele Variablen hat, kann man auch mehrere Kategorien anlegen und die Variablen passend dazu anlegen.

Die Kategorien dienen nur der besseren Übersicht. Die Namen der Variablen müssen '''eindeutig''' sein, d.h. keine Variable darf so heißen wie eine andere, auch wenn diese in einer anderen Kategorie ist!

Wenn Sie eine neue Variable anlegen wollen, klicken Sie auf:

[[Datei:FastReport_Variablen_Fenster_Neu.png]]

Die Variable wird erst mal als "New Variable1" in den Baum eingefügt. Klicken Sie diesen Eintrag an und drücken '''F2'''. Dann geben Sie der Variable einen aussagekräftigen Namen.

Im Eingabefeld '''Ausdruck''' können Sie der Variable einen Vorgabe-Wert geben, müssen das aber nicht!

Variablen in FastReport sind typenfrei (sog. "Varianten"), d.h. der Typ des Inhalts (Zahl, Text, Datum usw.) muss nicht festgelegt werden! Erst wenn man die Variable verwendet (z.B. etwas damit berechnet), wird der Typ festgelegt: 

* Wenn man die Variable zum Rechnen benutzt, wird diese als Zahl betrachtet.
* Wenn man die Variable im Report ausgibt, wird sie als Text behandelt. Gibt man jedoch ein Zahlenformat oder ein Datumsformat vor, wird die Variable automatisch umgewandelt.



== Ausgeben einer Variable im Report ==

Eine Variable kann ganz einfach per Drag And Drop aus dem Reiter "Variablen" in den Report eingefügt werden.


== Ändern eines Variablen-Werts im Report-Code ==

Im Code kann man einer Variable einen Wert zuweisen mit dem Kommando 

 <nowiki>Set( 'VariablenName','Wert' )</nowiki>
 

'''Wichtig:'''<br>

Wenn man einer Variablen einen String-Wert (Text) zuweise will, muss man den Wert zwischen ein einfaches Anführungszeichen [[Datei:EinfachesAnfZeichen.png]] setzen!

Bei einem konstanten Text geht das ja einfach (s.o.), schwieriger wird es, wenn man z.B. ein Datenbank-Feld zuweisen will.

Würde man 

 <nowiki>Set( 'VariablenName','<RückgabBisDatumUhrzeit>' )</nowiki>

schreiben, so würde nicht das Feld zugewiesen werden sondern der Text "<RückgabBisDatumUhrzeit>"!!! Deshalb muss man in diesem Fall die seltsame Konstruktion verwenden:

 <nowiki>Set( 'VariablenName','''' + <RückgabBisDatumUhrzeit> + '''' )</nowiki>


* Das erste [[Datei:EinfachesAnfZeichen.png]] leitet den String ein. 
* Die beiden nachfolgenden [[Datei:EinfachesAnfZeichen.png]][[Datei:EinfachesAnfZeichen.png]] ergeben zusammen '''ein''' [[Datei:EinfachesAnfZeichen.png]].
* Das letzte [[Datei:EinfachesAnfZeichen.png]] beendet den String.

Ähnlich geht das, wenn man z.B. einen Backslash einfügen will. Auch dieser ist ein Steuerzeichen. Das sieht dann so aus:

 <nowiki>'\\'</nowiki>

* Das erste [[Datei:EinfachesAnfZeichen.png]] leitet den String ein. 
* Die beiden nachfolgenden \ ergeben zusammen '''einen \'''.
* Das letzte [[Datei:EinfachesAnfZeichen.png]] beendet den String.



Beispiele:


;Feld mit Zahlenwert:

 <nowiki>  Set( <MeineZahlenVariable>,17 )</nowiki>

----

;Feld mit einfachen Anführungszeichen:


  <nowiki>  // Uhrzeit nur, wenn KENNZ3 auf "Ja" steht:  </nowiki>
  <nowiki>  // Nicht oder "Nein": KEINE Uhrzeit drucken!</nowiki>
  <nowiki>  Set( 'UhrzeitVon','''' + '''' );      // Default: Leer!</nowiki>
  <nowiki>  Set( 'UhrzeitBis','''' + '''' );      // Default: Leer!</nowiki>
  <nowiki>  if UpperCase( <AuftragsKopf."VersandArt"> ) = 'ABHOLER' then</nowiki>
  <nowiki>    Set( 'UhrzeitVon','''' + 'ab 14:00' + '''' )</nowiki>
  <nowiki>  else</nowiki>
  <nowiki>  if UpperCase( <AuftragsKopf."KENNZ3"> )='JA' then</nowiki>
  <nowiki>  begin</nowiki>
  <nowiki>    if <AuftragsKopf."VA-VonZeit"> > '' then</nowiki>
  <nowiki>      Set( 'UhrzeitVon','''' + <AuftragsKopf."VA-VonZeit"> + '''' );</nowiki>
  <nowiki>    if <AuftragsKopf."VA-BisZeit"> > '' then</nowiki>
  <nowiki>      Set( 'UhrzeitBis','''' + <AuftragsKopf."VA-BisZeit"> + ''''); </nowiki>
  <nowiki>  end;</nowiki>


----


;Variable zur Summenbildung im Report-Code:

:Manchmal kann man zur Summenbildung keine eingebauten Summen-Funktion benutzen, weil z.B. Bänder ausgeschaltet werden und die Summe nur unter bestimmten Bedingungen addiert werden soll.

;Beispiel:

:Im Report wird unter '''Report &rArr; Variablen''' eine Variable mit dem Namen "GesSummeNetto" definiert.
:Im Report-Titel (ganz am Anfang) wird die Variable auf 0 gestellt:
:(Muss man eigentlich nicht zwingend, ist aber sauberer Programmier-Stil)

 
  <nowiki>procedure ReportTitle1OnBeforePrint(Sender: TfrxComponent);</nowiki>
  <nowiki>begin</nowiki>
  <nowiki>  // Variable für Summenbildung:</nowiki>
  <nowiki>  Set( 'GesSummeNetto', 0 );</nowiki>
  <nowiki>end;</nowiki>
 

:Im Gruppen-Kopf (wo z.B. ein Auftragskopf-/Fuss steht) wird die Summe in die Variable addiert:
 
  <nowiki>procedure GroupHeader1OnBeforePrint(Sender: TfrxComponent);</nowiki>
  <nowiki>begin</nowiki>
  <nowiki>  // Variable für Summenbildung:</nowiki>
  <nowiki>  Set( 'GesSummeNetto', <GesSummeNetto> + <TurnDownListe."AuftrFuss_Nettobetrag1"> );</nowiki>
  <nowiki>end;</nowiki>
 

----

== Links ==

Siehe:

* [//www.youtube.com/watch?v=eIhzB2Cuc_g Video Anlegen einer Variable]

* Der schnellere aber etwas komplizierte Weg, Variablen in einen Report einzufügen, wird '''[[Physischer Aufbau einer FastReport-Datei|hier]]''' beschrieben.


{| class="hintergrundfarbe1"
|-
|[[FastReport Seitenformat]]
|[[FastReport Daten, Tabellen und Felder]]
|[[FastReport Tabellen der Reports]]
|'''Beispiele:'''
|-
|[[FastReport Bands]]
|[[FastReport Objekte und Elemente eines Reports]]
|[[FastReport: Abhängige Formatierung von Feldern]]
|[[Ladeliste/Packliste mit FastReport]]
|-
|[[FastReport: Standard-Formular-Texte|Standard-Formular-Texte]]
|[[FastReport: Steuerung des Report mit Auftragskennzeichen|Steuerung des Report mit Auftragskennzeichen]]
|[[FastReport: Summen im Report bilden|Summen im Report bilden]]
|[[FastReport: Leasing-Liste|Leasing-Liste]]
|-
|[[FastReport Farb-Konstanten]]
|[[FastReport Namensgebung der Datenbank-Tabellen und -Felder|Namensgebung der Datenbank-Tabellen und -Felder]]
|[[FastReport Tipps und Tricks|Tipps und Tricks]]
|[[FastReport: Inventar-Liste|Inventar-Liste]]
|-
|[[REFLEX Standard-Reports]]
|[[Etikettendruck Allgemeines]]
|[[Mehrsprachige Formulare mit FastReport]]
|[[FastReport: Geräte-Liste|Geräte-Liste]]
|-
|[[GEVITAS Label-Print Installation]]
|[[GEVITAS-Carnet]]
|[[Videos zu FastReport]]
|
|}