Quelltext der Seite Reporteditor

{{WL|Hauptseite|Optionen}}

Die Anwendung nutzt für die Ausgabe von Dokumenten Quickreportdesignerdateien (QR2), welche in einem integrierten Reporteditor bearbeitet werden können. Kassenbons liegen im Textformat (TXT) vor. Für die Bearbeitung der Kassenbons kann der integrierte [[Boneditor]] unter {{Menü|Optionen}} &rarr; {{Menü|[[Datei:Konfigurieren.png|link=]] Einstellungen}} &rarr; {{Menü|Formulare}} &rarr; {{Menü|Kassensystem}} &rarr; [[Datei:Drucken.png|link=]] im ''ESC-Direktdruck''-Druckmodus genutzt werden.

Der integrierte grafische Reporteditor ermöglicht das Erstellen und Bearbeiten von Vorlagen für die Druckausgabe der Anwendung. Dazu gehören insbesondere Auftragsbelege und Stücklisten, aber auch Briefvorlagen.
Der Reporteditor kann im Hauptmenü unter {{Menü|Optionen}} &rarr; {{Menü|[[Datei:Drucken.png|link=]] Reporteditor}} oder mit {{Taste|&uArr;}} + {{Taste|F11}} aufgerufen werden.<br />
Einzelne Formularvorlagen können auch direkt durch [[Datei:Drucken.png|link=]] „Formular im Reportgenerator bearbeiten“ hinter den Verzeichnisfeldern im [[Register Formulare]] der [[Einstellungen]] unter {{Menü|Optionen}} &rarr; {{Menü|Einstellungen}} &rarr; {{Menü|Formulare}} aufgerufen werden.
[[File:reporteditor.png|gerahmt|ohne|Der '''Reporteditor'''|link=]]
<!--**************************************************-->

==Tipps zum Reporteditor==

Bei der Installation der Anwendung wird eine große Auswahl von Reporten für die Nutzung bereitgestellt. Der integrierte Reporteditor ermöglicht darüber hinaus die Veränderung oder das Erstellen von neuen Reporten. In den meisten Fällen können diese aus bestehenden Vorlagen abgewandelt oder angepasst werden. Die mitgelieferten Reporte sind daher die ideale Basis für die individuelle Bearbeitung.

Damit die flexible Bearbeitung von Reporten gewährleistet ist, speichert die Anwendung - beispielsweise für den Belegdruck - die wichtigsten Daten in einer zentralen Tabelle: „rechtab.db“. In der Regel müssen also keine weiteren Tabellen für den Belegdruck mit der Drucktabelle verknüpft werden. Andererseits werden Datenquellen für den Druck von Stücklisten in den entsprechenden Reporten grundsätzlich als Abfrage ausgeführt. Diese Abfragen können flexibel an die eigenen Anforderungen angepasst werden.

Für die Bearbeitung von Belegreporten sollte vor dem Öffnen des Reporteditors zunächst ein Ausdruck in der [[Grundlagen der Auftragsverwaltung|Auftragsverwaltung]] unter {{Menü|Aufträge}} &rarr; {{Menü|[[Datei:calc.png|link=]] Auftragsbearbeitung}} durchgeführt werden. Dieser kann auch als Bildschirmvorschau ausgeführt werden. Dadurch wird die Drucktabelle '''„rechtab.db“''' mit Nutzdaten ausgestattet. Diese können in der Druckvorschau des Reporteditors verwendet werden, um das Ergebnis einer Bearbeitung überprüfen zu können.
<!--**************************************************-->

==Werkzeuge==

{{Karte|14 Der Reporteditor.png|border|link{{=}}|1|43|670|118|Menüleiste (1)|1|125|40|610| Werkzeugleiste (2)|824|143|985|573|Datenfeldfenster (3) }}

In der Menüleiste (1) am oberen Rand werden Datei- und Bearbeitungsoperationen angeboten. Weiterhin stehen für das Arrangieren von Reportelementen Schaltflächen zur Verfügung, die das Ausrichten von gewählten Elementen erleichtern.

<!--//////////     Tabelle ANFANG     //////////-->
{| class="wikitable"
|-
! style="background:#B3B7FF" | Schaltfläche
! style="background:#B3B7FF" | Funktion
! style="background:#B3B7FF" | Tastenkombination
|-
| [[Datei:New.png|center|link=]]|| Neuen Report erstellen || <kbd class="light">STRG</kbd> + <kbd class="light">N</kbd>
|-
| [[Datei:Open.png|center|link=]] || Report laden  || <kbd class="light">STRG</kbd> + <kbd class="light">O</kbd>
|-
| [[Datei:Save.png|center|link=] || Report speichern || <kbd class="light">STRG</kbd> + <kbd class="light">S</kbd>
|-
| [[Datei:Print.png|center|link=]] || Report drucken || <kbd class="light">STRG</kbd> + <kbd class="light">P</kbd>
|-
| [Datei:Preview.png|center|link=]] || Vorschau anzeigen || <kbd class="light">STRG</kbd> + <kbd class="light">Alt</kbd> + <kbd class="light">P</kbd>
|-
| [[Datei:Xtray.png|center|link=]] || Ausschneiden || <kbd class="light">STRG</kbd> + <kbd class="light">X</kbd>
|-
| [[Datei:Copy.png|center|link=]] || Kopieren || <kbd class="light">STRG</kbd> + <kbd class="light">C</kbd>
|-
| [[Datei:Paste.png|center|link=]] || Einfügen || <kbd class="light">STRG</kbd> + <kbd class="light">V</kbd>
|-
| style="text-align:center" | [[Datei:BringToFront.png|link=]][[Datei:HideToBack.png|link=]] || colspan="2" style="text-align:left"| Report, wenn sich mehrere Reportelemente
überlappen, in den Hintergrund oder Vordergrund setzen
|-
| [[Datei:SetToLeft.png|link=]][[Datei:CentreToCenter.png|link=]][[Datei:CollectToCenter.png|link=]][[Datei:SetToCenter.png|link=]][[Datei:SetToRight.png|link=]]
[[Datei:SetToTop.png|link=]][[Datei:CollectToMiddle.png|link=]][[Datei:SetToMiddle.png|link=]][[Datei:CollectHorizontal.png|link=]][[Datei:CollectBottom.png|link=]] 
| colspan="2" style="text-align:left" | Ausrichten von Reportelementen
|-
| [[Datei:Exit.png|center|link=]] || Reportdesigner verlassen || <kbd class="light">STRG</kbd> + <kbd class="light">Q</kbd>
|}
<!--//////////     Tabelle ENDE     //////////-->

Außerdem ist es möglich die Texteigenschaften (Schriftart, Schriftgröße, Fettdruck, Kursiv, Unterstrichen) des gewählten Reportelemets zu bearbeiten.

{| class="wikitable"
|-
! style="background:#B3B7FF" | Schaltfläche
! style="background:#B3B7FF" | Funktion
|-
| [[Datei:Color.png|center|link=]] || Schriftfarbe wählen
|-
| style="text-align:center" | [[Datei:Left.png|link=]][[Datei:Middle.png|link=]][[Datei:Right.png|link=]] || Ausrichten des Textes
|-
|[[Datei:Frame.png|center|link=]] || Rahmen um das gewählte Reportelement setzen
|}

Reportelemente werden aus der Werkzeugleiste (2) am linken Rand und aus dem Datenfeldfenster (3) in den Report eingefügt. Die Werkzeugleiste enthält folgende Hilfsmittel:

{| class="wikitable"
|-
! style="background:#B3B7FF" | Schaltfläche
! style="background:#B3B7FF" | Funktion
|-
| [[Datei:Band.png|center|link=]] || Standardband einfügen
|-
| [[Datei:Childband.png|center|link=]] || Childband einfügen
|-
| [[Datei:Subdetailband.png|center|link=]] || Subdetailband einfügen
|-
| [[Datei:Groupband.png|center|link=]] || Groupband einfügen
|-
| [[Datei:Edit.png|center|link=]] || Eindimensionale Texte bis zu 256 Zeichen einfügen
|-
| [[Datei:Memo1.png|center|link=]] ||  Mehrdimensionale Texte mit mehr als 246 Zeichen, sogenannte „Memos“ einfügen.
Memos aus Tabellen können nicht aus dem Datenfeldfenster in den Report gezogen werden
|-
| [[Datei:Picture.png|center|link=]] || Grafik einfügen
|-
| [[Datei:Shape.png|center|link=]] || Form einfügen
|-
| [[Datei:System.png|center|link=]] || Systemfeld einfügen
|-
| [[Datei:Field.png|center|link=]] || Datenfeld aus einfügen
|-
| [[Datei:BLOB.png|center|link=]] || Grafik aus Datenbank einfügen
|-
| [[Datei:Function.png|center|link=]] || Berechnungen unter Verwendung von Datenfeldern oder Systemvariablen einfügen
|-
| [[Datei:RTF.png|center|link=]] || Mehrdimensionale Texte mit Formatierungen im RTF-Format einfügen
|-
| [[Datei:DB RTF.png|center|link=]] || Memotexte aus Tabellen einfügen
|-
| [[Datei:Barcode.png|center|link=]] || Barcode einfügen
|}
<!--**************************************************-->

==Datenquellen==

Die Daten, mit denen der Report beim Ausdruck gefüllt wird, werden aus einer Datenquelle gelesen. Diese Quelle besteht aus einer oder mehreren Datenbanktabellen.

Um dem Report eine Datenquelle zuzuweisen, gehen Sie wie folgt vor:

# Klicken Sie im Hauptmenü auf {{Menü|Report}} &rarr; {{Menü|Datenbanken...}}. Es öffnet sich der Dialog ''Tabellen'', in dem die verwendeten Datenquellen angezeigt werden. Im Feld „Haupttabelle“ wird die Basistabelle angezeigt, im Feld „Verfügbare Tabellen“ alle zugewiesenen Tabellen. Die Haupttabelle steuert bestimmte Verhaltensweisen beim Ausdruck. Andere Tabellen können an die Tabelle angekoppelt werden und werden dann von der Haupttabelle gesteuert. Ist nur eine Tabelle zugewiesen, wird diese automatisch als Haupttabelle verwendet. [[File:Report_Datenbank.png|gerahmt|ohne|Der Dialog '''Tabellen'''|link=]]
# Um eine Tabellenzuweisung zu bearbeiten, führen Sie auf dem gewünschten Eintrag einen Doppelklick aus. Es öffnet sich ein neuer Dialog.<br /> Um eine neue Tabelle zuzuweisen, klicken Sie auf {{Menü|Neu}} und wählen Sie {{Menü|Tabelle}}. Die Tabelleneigenschaften werden in einem neuen Dialog angezeigt. [[File:Report_Datenbank_Bearb.png|gerahmt|ohne|Der '''Bearbeitungsdialog'''|link=]]
# Tragen Sie eine beliebige Bezeichnung im Feld „Name“ ein, wählen Sie aus der Auswahloption „Datenbank“ den Alias „RECHTABDB“ und im Auswahlfeld „Tabelle“ die „rechtab.db“ aus.<br /> Die Anwendung nutzt virtuelle Aliase, um die Speicherorte der Datentabellen dynamisch zuzuweisen. Dies ist von Vorteil, wenn ein Installationspfad verändert wird; die Datenquellen müssen dann nicht angepasst werden. Zwei Aliase sind für die Verwendung von Bedeutung: Der Alias „DATADB“ ist für die Zuweisung von Datenquellen wie [[Kundenstamm|Kunden-]], [[Lieferantenstamm|Lieferanten-]], [[Warenstamm|Ware-]] oder [[Pfandstamm|Pfanddaten]] unter {{Menü|Stammdaten}} nutzbar, der Alias „RECHTABDB“ für die Zuweisung der Drucktabelle für den Belegdruck. 

Bestätigen Sie die Bearbeitung mit {{Menü|OK}} und schließen Sie den Konfigurationsdialog. Nach der Zuweisung werden alle Tabellen der Datenquelle im Datenfeldfenster angezeigt und können in den Report gezogen werden.
<!--**************************************************-->

==Bänder==

Der Report wird nun in funktionale Bereiche, sogenannte „Bänder“ [[Datei:Band.png|link=]] unterteilt. Die Bandtypen haben unterschiedliche Funktionen:
* Das Band ''Titel'' wird unter der Kopfzeile auf der ersten Druckseite verwendet. Es kann beispielsweise die Empfängeradresse aufnehmen.
* Das Band ''Seitenheader'' wird als Kopfzeile als erstes Band auf jeder Druckseite verwendet. Es kann beispielsweise einen Briefkopf aufnehmen.
* Das Band ''Detail'' wird als Postenzeile verwendet. Es vervielfältigt sich selbständig mit der Anzahl der Datensätze in der Haupttabelle. Es kann beispielsweise die Belegposten oder Stücklistenposten aufnehmen.
* Das Band ''Gruppenheader'' wird als Spaltenüberschrift auf jeder Druckseite verwendet. Es kann beispielsweise die Tabellenüberschriften für die Postenliste eines Beleges oder einer Stückliste aufnehmen.
* Das Band ''Summary'' wird als Summenbereich auf der letzten Druckseite verwendet. Es kann beispielsweise die Summen eines Beleges oder einer Stückliste aufnehmen.
* Das Band ''Seitenfooter'' wird als Fußzeile als letztes Band auf jeder Druckseite verwendet. Es kann beispielsweise die Seitennummerierung aufnehmen.

Die Bänder werden automatisch sortiert. Die Höhe der Bänder kann durch das Aufziehen eingestellt werden.
<!--**************************************************-->

==Elemente==

In den erstellten Bändern können nun Elemente durch Klicken auf die Schaltfläche in der linken Werkzeugliste verwendet werden. Das neue Element wird durch Klicken an die Position des Mauszeigers eingefügt und der Eigenschaftsdialog des neuen Elements angezeigt. Tabellenfelder können aus dem Datenfeldfenster an eine gewünschte Position gezogen werden.

Um Elemente zu verändern, können diese mit der Maus ausgewählt und dann durch Maus- oder Tastaturoperationen verschoben oder verändert werden. Mit {{Taste|←}}{{Taste|↑}}{{Taste|↓}}{{Taste|→}} werden Elemente um einen Pixel, bei gehaltenen {{Taste|Strg}} + {{Taste|&uArr;}} in größeren Schritten bewegt. Die Schrittgröße ist unter {{Menü|Ansicht}} &rarr; {{Menü|Optionen}} einstellbar. Mit gehaltener {{Taste|&uArr;}} und den {{Taste|←}}{{Taste|↑}}{{Taste|↓}}{{Taste|→}} werden Elemente gestaucht oder gestreckt. Bei gehaltener {{Taste|&uArr;}} können mehrere Elemente mit der Maus ausgewählt werden. Bei gehaltener {{Taste|Strg}} kann mit der Maus ein Markierungsrahmen aufgezogen werden, in dem alle enthaltenen Elemente ausgewählt werden.

Größe und Position von Elementen können auch in einem Dialog bearbeitet werden. Dieser kann durch einen Rechtsklick {{RMB}} auf das Element in einem Optionsmenü ausgewählt werden. Mit der Auswahl „Optionen“ können Position und Größe des Elements bearbeitet werden können. Mit {{Taste|↵}} werden die Eigenschaften eines oder mehrerer Elemente angezeigt.
<!--**************************************************-->

==Berechnungen==

Berechnete Felder stellen umfangreiche Funktionen zur Berechnung und Ausgabe von Informationen bereit.

Um einen berechneten Ausdruck zu erstellen, gehen Sie wie folgt vor:

# Fügen Sie mit [[Datei:Function.png|link=]] ein berechnetes Feld ein. Es öffnet sich der Dialog ''Berechneter Ausdruck''.[[File:Report_Berechneter_Ausdruck.png|gerahmt|ohne|Der Dialog '''Berechneter Ausdruck'''|link=]]
# Klicken Sie auf die Schaltfläche {{Menü|...}} hinter dem Eingabefeld  "Ausdruck"  für die Berechnungsformel. Alternativ können Sie eine Formel auch direkt eingeben. Es öffnet sich folgender Dialog: [[File:Report_Berechneter_Ausdruck2.png|gerahmt|ohne|Der Dialog '''Ausdruck'''|link=]]
# Klicken Sie auf {{Menü|Funktion}}. Sie können die Funktion auch direkt eingeben. {{Tipp1|Eine einfache Berechnung kann beispielsweise durch die Eingabe 1+2+3+4+5 erstellt werden. Das Ergebnis kann durch {{Menü|Prüfen}} abgefragt werden. Wenn die Eingaben korrekt verarbeitet werden können, wird das Ergebnis angezeigt, im Beispiel „15“.}} Es öffnet sich folgender Dialog: [[File:Report_Berechneter_Ausdruck3.png|gerahmt|ohne|Der Dialog '''Funktion auswählen'''|link=]]
# Wählen Sie die gewünschte [[Reporteditor#Funktionen|Funktion]], indem Sie diese einfach per linker Maustaste {{LMB}} anklicken. Im oben gezeigtem Beispiel wird die Funktion '''„IF“''' ausgewählt.
# Klicken Sie auf {{Menü|Weiter}}. Es öffnet sich anschließend folgender Dialog: [[File:Report_Berechneter_Ausdruck4.png|gerahmt|ohne|Der Dialog '''Parameter für Funktion eingeben'''|link=]]
# Geben Sie nun die Berechnungswerte ein. Mit den Schaltflächen {{Menü|...}} hinter den Eingabefeldern "Argument..." können weitere Funktionen oder Variablen eingefügt werden.
# Übernehmen Sie abschließend die Eingaben mit einem Klick {{LMB}} auf {{Menü|OK}}.

Um eine Berechnung mit Datenfeldern einzufügen, gehen Sie wie folgt vor:
# Fügen Sie mit [[Datei:Function.png|link=]] ein berechnetes Feld ein. Es öffnet sich der Dialog ''Berechneter Ausdruck''.[[File:Report_Berechneter_Ausdruck.png|gerahmt|ohne|Der Dialog '''Berechneter Ausdruck'''|link=]]
# Klicken Sie auf die Schaltfläche {{Menü|...}} hinter dem Eingabefeld  "Ausdruck". Es öffnet sich folgender Dialog: [[File:Report_Berechneter_Ausdruck2.png|gerahmt|ohne|Der Dialog '''Ausdruck'''|link=]]
# Klicken Sie auf {{Menü|Datenfeld}}. Es öffnet sich folgender Dialog: [[File:Report_Berechneter_Ausdruck5.png|gerahmt|ohne|Der Dialog '''Datenfeld in Ausdruck einfügen'''|link=]]
# Wählen Sie einen Eintrag aus der Liste der verfügbaren Tabellen aus, beispielsweise „Beleg.Name“. Somit ist das Datenfeld "Name" aus der Tabelle "Belege" ausgewählt. Zunächst wird also die Tabelle und dann, durch einen Punkt getrennt, der Feldname angegeben. 

Um mehrere Tabellenfelder darzustellen, können diese als Variablen in eine Formel eingesetzt werden. Um zwei numerische Datenfelder „Wert1“ und „Wert2“ aus der Tabelle „Tabelle“ zu summieren, geben Sie „Tabelle.Wert1 + Tabelle.Wert2“ ein.<br />
Es können auch Texte und Felder kombiniert werden. Dazu müssen Texte von Apostrophen {{Taste|'}} eingeschlossen werden.<br />
Wenn zwei Zeichenfelder „Vorname“ und „Name“ kombiniert werden sollen, dabei zwischen den Feldern jedoch ein Leerzeichen eingefügt werden soll, kann dies durch „Tabelle.Vorname+ ' ' +Tabelle.Name“ realisiert werden.
<!--**************************************************-->

===Funktionen===

Um komplexere Berechnungen durchzuführen, bietet der Reporteditor eine Funktionssammlung an, die im Dialog ''Ausdruck'' durch {{Menü|Funktion}} aufgerufen werden kann. Als Beispiel sollen hier zwei Funktionen erläutert werden:

*Die Funktion '''TRIM''' löscht automatisch Leerzeichen am Anfang und am Ende eines Ausdrucks. Dies kann beispielsweise genutzt werden, wenn zwei Felder „Vorname“ und „Name“ mit einem Leerzeichen zwischen den Feldern zusammengefügt werden. Ist das Feld „Vorname“ leer, würde das Leerzeichen zu einer Einrückung des Ausdrucks führen. Dieser optische Mangel kann durch den Ausdruck „TRIM(Tabelle.Vorname+ ' ' +Tabelle.Name)“ behoben werden. Die Funktion „TRIM“ steht in der Funktionsauswahl zur Verfügung und ermöglicht die Zusammenstellung der Anweisung in einem Assistenten.

*Die Funktion '''IF''' ermöglicht eine bedingte Anweisung. Um die TRIM-Funktion mit der IF- Funktion nachzubauen, muss eine Bedingung, das sogenannte „Argument“ formuliert werden und die Ausgabe für die Fälle „Ausdruck ist wahr“ und „Ausdruck ist nicht wahr“ erstellt werden. Der Ausdruck lautet „IF(Tabelle.Vorname = ' ', Tabelle.Name, Tabelle.Vorname+ ' ' +Tabelle.Name)“. Der Datentyp muss bei der Abfrage beachtet werden.
<!--**************************************************-->

==Tabellenabfragen==

Als Datenquelle für den Report können auch Abfragen auf Tabellen verwendet werden. Diese ermöglichen Filterung und Sortierung einer Tabelle. Abfragen werden ähnlich den Tabellen in der Datenquellenkonfiguration eingestellt.

Um eine Abfrage zu erstellen, gehen Sie wie folgt vor:
# Wählen Sie im Hauptmenü {{Menü|Report}} &rarr; {{Menü|Datenbanken}}. Es öffnet sich folgender Dialog: [[File:Report_Datenbank.png|gerahmt|ohne|Der Dialog '''Tabellen'''|link=]]
# Klicken Sie auf {{Menü|Neu}} und wählen Sie {{Menü|SQL Anfrage}}. Die Abfrageeigenschaften werden angezeigt.[[File:17 B SQL Text.png|gerahmt|ohne|link=]]
# Starten Sie den Abfrageassistenten mit {{Menü|Query Wizard}}. Dieser Assistent ermöglicht das einfache Zusammenstellen von [[Besondere Steuerelemente#Bedingungen definieren|Filtern]] und Sortierung. [[File:17 C SQL Wizard.png|gerahmt|ohne|link=]]
# Wählen Sie in den Registern des Assistenten die gewünschten Filter- und Sortierbedingungen aus.
Abfragen werden unter Verwendung einer Tabelle erstellt. Als Abfragesprache wird ein eingeschränkter SQL- Dialekt
eingesetzt.
<!--**************************************************-->

==Tabellenkombinationen==

Tabellen können durch Datenfelder einer weiteren Tabelle oder Abfragen erweitert werden. Die Kombination von Tabellen muss durch eine Verknüpfung zwischen indizierten Feldern der Tabellen definiert werden.

Um eine Kombination zu erstellen, gehen Sie wie folgt vor:

# Wählen Sie im Hauptmenü des Reporteditors {{Menü|Report}} &rarr; {{Menü|Datenbanken}} und fügen Sie die Tabellen „Vollgut“ als „Ware“ und „Leergut“ als „Pfand“ zu den verfügbaren Tabellen hinzu. Die Tabelle „Vollgut“ muss als Haupttabelle eingestellt werden. Wählen Sie die Tabelle „Pfand“ aus und klicken Sie auf {{Menü|Eigenschaften}}.[[File:Report_Tabkombi1.png|gerahmt|ohne|link=]]
# Wählen Sie im Auswahlfeld „Master-Tabelle“ des Eigenschaftsdialoges der Tabelle „Pfand“ die Tabelle „Ware“ aus und klicken Sie auf {{Menü|...}} hinter dem Eingabefeld „Verbundene Felder“.[[File:Report_Tabkombi2.png|gerahmt|ohne|link=]]
# Wählen Sie im Auswahlfeld „Masterfeld“ des Verknüpfungsdialogs das Feld „LeergutNr“ der Mastertabelle aus und klicken Sie auf {{Menü|Hinzufügen}}.[[File:Report_Tabkombi3.png|gerahmt|ohne|link=]]

Die Tabelle „Pfand“ ist nun durch die Verknüpfung des Feldes „LeergutNr“ mit dem gleichnamigen indizierten Feld der Tabelle „Ware“ mit dieser verknüpft.
:: [[File:Report_Tabkombi4.png|gerahmt|ohne|link=]]

----

{{WL|Hauptseite|Optionen}}