de:app:020cor:040rpt:0020rptgen

Reportgenerator für Kontraktauswertungen

Für jeden Geschäftsbereich existiert eine Transaktion zum Erzeugen von Reports basierend auf den Kontrakten des Geschäftsbereichs.

Es stehen, soweit im Geschäftsbereich verfügbar, normalerweise folgende Daten zur Verfügung:

  • Kontraktdaten des Geschäftsbereichs, sowie zusätzliche Bereiche, die mit dem aktuellen Geschäftsbereich verbunden sein können, wie z.B. Subbereiche, Finanzierungen, Bevorschussungen oder Übertragungen.
  • Kontraktsalden
  • Beteiligte
  • Termine
  • Transaktionen
  • Nachrichten
  • Gebührenpool

Transaktions-Panels

Felder Auswahl

Das Feld “Titel” enthält den Titel für den Report, der beispielsweise in der Titelleiste des Browserfensters angezeigt wird. In PDF ist dieses Element der Titel auf jeder Seite.

Mit einem Klick auf das Icon wird der Report gemäß der “Liste der im Report enthaltenen Felder” und den dazugehörigen Einstellungen und “Formatierung” aus dem Subpanel “Details zum ausgewählten Feld” erzeugt und angezeigt.

Durch Klicken des Icons gelangt man zum Panel “Ausgabe Einstellung”.

Das Icon schließt den Reportgenerator.

Das Listenfeld “Verfügbare Module für Report” enthält alle Module, die im gewählten Geschäftsbereich für Auswertungen verwendet werden können.

Das Listenfeld “Im Report zur Verfügung stehende Felder des Moduls” enthält die Felder, die zu dem in dem Listenfeld “Verfügbare Module für Report” ausgewählten Modul für die Verwendung in einem Report zur Verfügung stehen. Die Felder eines Moduls sind prinzipiell in “Suchschlüsselfelder”, “Salden”, “Normale Datenfelder” und “INR-Felder” gegliedert und innerhalb dieser Gliederung aufsteigend sortiert, um das Finden und Auswählen zu erleichtern. Mit einem Klick auf den Button [+ Feld] wird das markierte Feld in die Tabelle “Liste der im Report enthaltenen Felder” übernommen.

In der Tabelle “Liste der im Report enthaltenen Felder” werden alle Felder angezeigt, die im Report enthalten sind. Felder, die über eine Bedingung oder spezielle Attribute verfügen, sind blau eingefärbt. Die Reihenfolge der Darstellung in der Tabelle von oben nach unten entspricht der Reihenfolge der Felder im Report von links nach rechts. Um ein Feld anders zu positionieren, ist die entsprechende Zeile in der Tabelle zu markieren und mit den Button [Nach Oben] das Feld nach oben (im Report also weiter links) zu verschieben. Mit dem Button [Nach Unten] wird das Feld in der Tabelle eine Zeile weiter nach unten (im Report also weiter rechts) verschoben. Die Tabelle enthält folgende Spalten:

Spalte Beschreibung
S “S”equenz- bzw. Reihenfolgenummer der Einträge der “Liste der im Report enthaltenen Felder”.
Instanz Name der Instanz gemäß dem ausgewählten Modul aus dem Listenfeld “Verfügbare Module für Report”
Feldname Name des Feldes aus dem Listenfeld “Im Report zur Verfügung stehende Felder des Moduls”
Sortierung (Sort.) Definiert über eine Combobox die Sortierung nach diesem Feld im Report. Es können bis zu 5 Sortierungsebenen definiert werden.
Spaltenüberschrift Text, der im Report als Spaltenüberschrift angezeigt wird. Dieser Text ist frei editierbar.
Formatierung Hier sind die Formatierungen in einer internen Codierung ersichtlich, die unter [Details] vorgenommen werden.

Durch Anklicken des Buttons [+ Bed.] wird für das aktuell ausgewählte Feld eine Bedingung angelegt und das Panel “Bedingungen” zusammen mit dem Subpanel zur Bearbeitung dieser Bedingung angezeigt.

Mit einem Klick auf den Button [Details] wird das Subpanel “Details zum ausgewählten Feld” zum Feld der ausgewählten Zeile in der Tabelle angezeigt.

Mit dem Button [Löschen] wird eine markierte Zeile aus der Tabelle vollständig entfernt, also einschließlich der ggf. bereits festgelegten Einstellungen im Subpanel “Details”.

Im Feld “Name der Report Definition” wird der Dateiname des erzeugten Reports angezeigt.

Details zum ausgewählten Feld

Dieses Subpanel zeigt zu einer ausgewählten Zeile der Tabelle “Liste der im Report enthaltenen Felder” weitere Informationen an und ermöglicht die Änderung von Einstellungen für dieses Feld. Zusätzlich können Formatierungen für das Feld vorgenommen werden.

Das Feld “Instanz des Feldes” zeigt den Namen der Feldinstanz für die ausgewählte Zeile an.

Das Feld “Feldname” zeigt den Namen des Feldes der ausgewählten Zeile an.

Die Checkbox “Unsichtbares Feld” kann markiert werden, wenn ein Feld z.B. zur Sortierung benötigt wird, es jedoch nicht im Report angezeigt werden soll.

Die Checkbox “Join für Mehrfacheinträge verwenden” muss verwendet werden, wenn zu einem Kontrakt alle abhängigen Daten im Report mit ausgewiesen werden sollen. Anderenfalls würde immer nur genau der erste Eintrag einer anderen Tabelle im Report angezeigt werden. Wenn z.B. alle Termine zu einem Kontrakt mit ausgewiesen werden sollen, muss bei einem der Felder aus der Instanz “DIA” diese Checkbox markiert werden.

Über die Combobox “Sortierung” wird festgelegt, nach welcher Hierarchie die ausgewählten Felder im Report sortiert werden sollen.

Die Combobox “Keine Summe/Anzahl unter Ebene” wird dazu verwendet, das Zählen/Summierung der Werte für Summenzeilen unter bestimmten Ebenen zu unterbinden.

Die Combobox “Keine Wiederholung auf und unter” dient dazu, dass sich wiederholende Spalteninhalte nicht in jeder darunter liegenden Spalte erneut angezeigt werden.

Durch “Ausgabe der Summe” können die Summen von Beträgen (z.B. für einen bestimmten Beteiligten) ausgegeben werden.

Wird “Ausgabe der Anzahl” markiert, wird für die ausgewählte Ebene die Anzahl von Datensätzen in einer separaten Zeile zusammen mit dem “#”-Symbol ausgegeben.

“Wert in Gruppenkopf ausweisen” wird markiert, wenn der Wert des ausgewählten Feldes in der Kopfzeile der jeweiligen Gruppe angezeigt werden soll.

“Wert in Gruppenfuß ausweisen” wird markiert, wenn der Wert des ausgewählten Feldes in der Fußzeile der jeweiligen Gruppe angezeigt werden soll.

Im Feld “Fester Text” kann für jede entsprechende Ebene ein eigener Präfix ausgegeben werden.

Über die Combobox “Decodieren mithilfe e. Codetable” ist es möglich, den Langtext einer Abkürzung im Report anzuzeigen. Beispiel: Die Währung (z.B. “USD”) soll beispielsweise in Langtext umgewandelt werden. Dazu wird in dieser Option “Extern” für eine externe Codetable ausgewählt. Unter der Combobox “Verw. Codetable” wird die zu verwendende Codetable ausgewählt, in diesem Fall “CURTXT”. Im Report werden die Währungen dann im Langtext angezeigt (“US Dollar” statt “USD”). Wenn der zur Dekodierung verwendete Codetable nicht global definiert ist, wird zur Dekodierung der für den aktuellen Benutzer definierte Codetable verwendet, der ggfs. von der aktuell ausgewerteten Entitygroup abweichen kann.

“Zusammenfügen m. nächst. Feld” wird dazu verwendet, ein Feld mit einem darauf folgenden Feld zu verbinden. Bei Beträgen und Währung ist dies beispielsweise sinnvoll. Wenn hier andere Trennzeichen als die standardmäßig verfügbaren verwendet werden sollen, muss “Anderes Trennzeichen” in der Combobox ausgewählt werden. Dann wird das Feld “Trennzeichen” aktiviert, in dem das neue Trennzeichen eingegeben wird.

“Spaltenbreite bei PDF / XML Ausgabe” ermöglicht die Angabe einer festen Spaltenbreite. Wenn diese gesetzt ist, kann in der daneben stehenden Combobox die zugehörige Einheit (Zeichen, Prozent, Millimeter oder Punkte) ausgewählt werden.

Formatierung

Um die Anzeige / den Ausdruck optisch aufbereiten zu können, werden einige Formatierungsoptionen angeboten (Header = Kopfzeile, Footer = Fußzeile).

Diese werden über die “Details” automatisch in die Spalte “Formatierung” eingetragen und werden in der Spalte “Formatierung” angezeigt. Mehrere Formatierungen können durch Leerstellen getrennt hintereinander verwendet werden.

Formatierung Beschreibung
bx Verbindet die aktuelle Spalte mit der nachfolgenden Spalte mit einem Leerzeichen (s), Komma (c) oder einer neuen Zeile (r) und stellt den Inhalt in der Spalte des aktuell gewählten Feldes dar. Es ist möglich, diese Formatierung über mehrere aufeinander folgende Spalten anzuwenden, um beispielsweise 4 Spalten in einer Spalte darzustellen.
cx Ausgabe der Gesamtanzahl im Footer in der über x definierten Sortierungsebene für alle zu der Sortierungsebene gehörenden Zeilen.
dxxxxxx Ermittelt zu dem im Feld gespeicherten Code den Langtext. Kann der Langtext nicht ermittelt werden, wird der Inhalt des Feldes in der Spalte angezeigt.
e Unterdrückt die Ausgabe dieser Spalte in der Detailzeile. Der Inhalt dieser Spalte kann aber trotzdem im Header und/oder Footer angezeigt werden.
ex Unterdrückt die Ausgabe der Spalte, wenn der vorhergehende Eintrag in der gleichen Spalte den gleichen Wert hat. Das gilt nur für Spalten, die auf der gleichen Sortierungsebene liegen.
fx Ausgabe der Spalte zusätzlich im Footer. x definiert die Sortierungsebene.
hx Ausgabe der Spalte zusätzlich im Header. x definiert die Sortierungsebene.
i Das Feld wird nur intern verwendet (um beispielsweise die Auswahl weiter einzuschränken) und wird weder im Header, Footer noch im Detaileintrag des Reports ausgewiesen.
n Definiert die Spalte als Numerisch. Numerische Spalten werden rechtsbündig ausgegeben.
nax.y Definiert die Spalte als Betrag. Für eine Formatierung in Abhängigkeit der Währung kann optional über x.y die Spalte definiert werden, welche die Währung enthält. x bezeichnet die Instanz und y den Feldnamen. Standardmäßig wird der Inhalt in der vorhergehenden Spalte als Währungsspalte angenommen.
Bei Angabe von na~ wird der Betrag gemäß der Systemwährung formatiert.
rx Schränkt das Summieren bzw. die Zählung auf jeweils nur die ersten Sätze bis zur angegebenen Sortierungsebene ein. Dadurch werden beispielsweise Beträge über 1:n-Beziehungen nicht mehrfach ausgegeben.
Beispiel für die Verwendung von rx:
Es sollen die eigene Referenz, der Auftraggeber, die Währung, der Betrag, der Gegenwert sowie die abgewickelten Transaktionen unter einer Garantie ausgewiesen werden.
Die Sortierung soll sein: Auftraggeber, eigene Referenz und Transaktion.
Um die Gesamtsumme des Gegenwertes auszugeben, muss diese Spalte summiert werden. Da aber mehrere Transaktionen pro Garantie abgewickelt werden können, würde ein einfaches Summieren den Gegenwert mehrfach addieren. Durch Angabe von r2 wird das mehrfache Addieren unterdrückt.
Hinweise zur Formatierung für dieses konkrete Beispiel:
Bei den Feldern aus der Garantie, der Währung sowie den Beträgen sollte die Formatierung e und h2 oder nur e2 angegeben werden. Analog sollte bei den Feldern des Auftraggebers e und h1 oder nur e1 angegeben werden. Damit werden Wiederholungen von identischen Einträgen vermieden und eine bessere Lesbarkeit erreicht.
sx Ausgabe der Gesamtsumme im Footer in der über x definierten Sortierungsebene für alle der Sortierungsebene zugehörigen Zeilen. Bei Summen von Beträgen muss darauf geachtet werden, dass jeweils die Währung in der vorherigen Spalte ausgegeben wird, damit eine korrekte Formatierung der Summe gewährleistet ist.
tx Definiert die Spalte als Datum. Das optionale x definiert das Format des Datums. Standardmäßig wird das Kurzformat (zweistelliger Tag, zweistelliger Monat, zweistelliges Jahr) für die Aufbereitung verwendet. Als Optionen können s (Kurzformat) und l (Langformat) und die Vorgabe der Formatierungszeichen, wie z.B. DD.MMMMM.YYYY, gemäß der Funktion “FmtDate()” verwendet werden. Aus Performance-Gründen sollte diese Formatierung nur wirklich dort eingesetzt werden, wo sie unbedingt erforderlich ist.
nt Die Formatierung für Zeitangaben in Feldern (n = numerisch; t = Zeit)
ntl Der Formatierung für Zeitangaben in Feldern (n = numerisch; t = Zeit; l = lang [hh:mm:ss])
wx Die Formatierung für die Breite einer Spalte. Das X kann für folgende Werte stehen:
x = Anzahl der Zeichen anstatt der Anzahl der Zeichen aus der Datenbank bzw. aus der Codetable
x = Zahl + relative Breite in %
x = Absolute Breite der Spalte (in mm oder cm)

Layout

Es kann für jede Ebene eine eigene Darstellung definiert werden.

Für jede Ebene lässt sich ein eigener Style verwenden, mit dem sich die Ansicht der Daten definieren lässt. Für jede Ebene kann einzeln eingestellt werden, ob es ausgegeben oder unterdrückt werden soll, damit man denselben Report mit mehr oder weniger Details nutzen kann ohne ihn neu gestalten zu müssen.

Die vorkonfigurierten Styles werden aus der TradeDesign Styletabelle entnommen. Für weitere Formatierungsmöglichkeiten können die einzelnen Darstellungselemente, die sonst durch einen Style automatisch gesetzt werden, auch individuell für die einzelnen Reportelemente gesetzt werden.

Ein Style oder benutzerdefinierte Darstellung können ein oder mehrere der folgenden Optionen nutzen:

  • Font
  • Fontgröße (in Punkten)
  • Vordergrundfarbe (in RGB-Notation)
  • Hintergrundfarbe (in RGB-Notation)
  • Fett
  • Kursiv
  • Unterstrichen

In das Feld “Informationstext der Auswertung” können beschreibende Texte erfasst werden, welche die Inhalte und Gründe des Reports aus Anwendersicht beinhalten.

Konfiguration Eingabefelder

Auf dem Panel “Konfiguration Eingabefelder” kann für die vorgesehenen Eingabefelder ein Feldname definiert werden. Eingabefelder, die über einen Namen definiert sind, sind anschließend auf dem Panel “Eingabefelder” unter diesem Namen ausgewiesen und bei der Ausführung eines Reports dann eingebbar.

Für die Nutzung automatisch berechneter Datumswerte kann eine durch Leerzeichen getrennte Liste von Berechnungsregeln erfasst werden. Diese basieren auf dem eingegebenen Wert dieses Eingabefeldes. Jede Berechnungsregel enthält einen optionalen Anker und eine Reihe von Berechnungsgruppen. Der Anker wird definiert mit dem Präfix “<”, gefolgt von einer Periodenkennzeichnung. Eine Berechnungsgruppe wird wie folgt festgelegt:
Mit einem führenden Berechnungzeichen “+” oder “-” , gefolgt von einer einstelligen Zahl, die die Anzahl Perioden bestimmt und dahinter die Periode (“D” Tag, “W”oche, “M”onat, “Q”uartal, “H”albjahr, “Y”Jahr).
Beispiel:
Um den Monatsanfang (“<M”) und den Monatsanfang des Vormonats (“<M-1M”) zu nutzen, kann folgende Regel eingegeben werden: “<M <M-1M”.

Eingabefelder

Auf dem Panel “Eingabefelder” können zu den vorkonfigurierten Eingabefeldern die entsprechenden Eingaben getätigt werden. Diese Eingabewerte können in den definierten Reports als Kriterien für Bedingungen oder für die Deklaration von Registerfeldern verwendet werden.

Bedingungen

Durch Anklicken des Buttons [+ Bed.] wird das Panel “Bedingungen” zusammen mit dem Subpanel zur Eingabe einer neuen Bedingung angezeigt. Dieses Subpanel kann auch durch Klicken des Buttons [Details] auf dem “Bedingungen” Panel angezeigt werden.

Auf dem Haupt-Panel sind die vorhanden Bedingungen eines Reports tabellarisch aufgeführt. Mit den Buttons [Rauf] und [Runter] können die Bedingungen in der Reihenfolge verschoben und über den Button [Löschen] entfernt werden.

Die Angabe eines Datums im Feld “Default Beträge per” berücksichtigt alle Salden zu dem vorgegebenen Datum, sofern Felder aus dieser Feldgruppe in dem Report enthalten sind.

Hinweis: Wird die Reportdefinition gespeichert, wird die Differenz des Tagesdatums zum eingegebenen Datum gespeichert. Wenn die Reportdefinition geladen wird, wird die Differenz des gespeicherten Datums zum Tagesdatum errechnet. Ist die Differenz 0 oder Negativ, wird das Datum auf Basis dieser Differenz neu errechnet und im Feld “Default Beträge per” gesetzt. Wenn die Differenz positiv oder größer als 7 Tage ist, wird das gespeicherte Datum in das Feld “Default Beträge per” eingetragen.

Über die Combobox “Kontrakt eröffnet per” kann ausgewählt werden, ob alle Kontrakte berücksichtigt werden sollen (“<keine Prüfung>”). Bei Auswahl von “Default Beträge per” werden die Kontrakte ausgewählt, die:

  • am oder vor dem Datum im Feld “Default Beträge per” eröffnet wurden und
  • nach dem Datum im Feld “Default Beträge per” geschlossen wurden oder
  • nicht geschlossen sind.

Die Bedingungen werden über das Subpanel definiert. Je nach ausgewähltem Bedingungstyp können unterschiedliche Bedingungen für ausgewählte Felder definiert werden. Der SQL-Ausdruck für eine Bedingung wird jeweils im Feld “Beschreibung” angezeigt. Wird “Direkt ausführbares SQL” ausgewählt, kann im Feld “SQL-Ausdruck” direkt eine SQL-Bedingung eingegeben werden. Für die Nutzung der Beteiligtenauswahl muss die INR des Beteiligten als Datenfeld ausgewählt werden. Dieses Feld wird automatisch auf unsichtbar gestellt.

Wird die Checkbox “Identifizieren des Feldes in Beschreibung über Instanz.Feldname anstatt über Spaltenkopf” markiert, wird ein Feld über den internen Namen “Instanz:Feldname” anstatt über die Überschrift der Spalte identifiziert.

Wird die Checkbox “Nur das Panel mit Eingabefeldern bei der Ausführung zeigen” markiert, dann wird bei der Ausführung eines Reports nur das Panel mit den Eingabefeldern und das mit den Ausgabeoptionen sichtbar. Die anderen Panele, in denen die Reportdefinition sonst zumindest gesehen, wenn auch nicht geändert, werden kann, bleiben dann für den Bediener unsichtbar.

Details zu der ausgewählten Bedingung

Wählt man aus der Liste der verfügbaren Bedingungen einen Eintrag aus und klickt auf den Button [Details], wird das Subpanel “Details der ausgewählten Bedingung” angezeigt. Über die Combobox “Verbinden mit vorherigen Bedingung” kann die ausgewählte Bedingung mit der in der Liste vorherigen Bedingung verknüpft werden. Dabei kann zwischen den Operatoren “AND” und “AND (” ausgewählt werden.

Beide dienen der Mehrfachauswahl von Parametern:

Beispiele:

AND ---> wenn beispielsweise a=1 AND b=2
AND ( ---> wenn beispielsweise a=1 AND (b=2 OR c=3)

Ein Bedingung kann über die Checkbox “Bedingung umkehren” invertiert werden.

Ist die Checkbox “Veränderbar in Job” markiert, kann diese Bedingung auch im Jobsystem bearbeitet werden.

Die Felder, für die die Bedingungen miteinander verknüpft werden sollen, werden durch den “Bedingungstyp” definiert und mittels des “Vergleichstyps” verbunden. Je nach Bedingungstyp sind eine Reihe unterschiedlicher Parameter auf dem Panel definierbar.

Die resultierende Bedingung wird im Feld “Beschreibung” dargestellt.

Benutzte Tabellen, Verbindung und endgültiges SQL

Über den Button [Zeige SQL] werden in einem separaten Popup-Panel die Informationen angezeigt, die zur Erzeugung der SQL-Abfrage verwendet werden. Diese Informationen stellen jedoch keinen ausführbaren Code dar, sondern liefern lediglich Informationen zum Aufbau der SQL-Abfrage.

Ausgabe Einstellung

Siehe unter Ausgabe Einstellung.

Suchreihenfolge für Verzeichnisse

Insbesondere im Client/Server-Umfeld ist die Suchreihenfolge bzw. das automatisierte Anlegen von Zielverzeichnissen (z.B. für das Herunterladen eines Reports) auf dem lokalen PC wichtig. Wenn ein Zielverzeichnis nicht vorhanden ist, wird der Benutzer gefragt, ob das Zielverzeichnis angelegt werden soll oder nicht.

Bei den temporären Verzeichnissen erfolgt eine automatische Prüfung und ggf. Anlage des temporären Verzeichnisses.

Die Suchreihenfolge ist wie folgt:

C:\TEMP -> C:\TMP -> (lokal)TEMP -> (lokal)TMP

Öffnen von XML-Tabellenkalkulationsdateien

Damit erzeugte XML-Tabellenkalkulationsdateien von dem jeweiligen PC auch direkt geöffnet werden können sollte auf den Arbeitsplätzen die Dateiextension XML auch mit einem passenden Programm verknüpft sein.

de/app/020cor/040rpt/0020rptgen.txt · Last modified: 2023/10/17 12:26 by dm