Berichte & Listen: Unterschied zwischen den Versionen

Aus e-vendo Wiki
Wechseln zu: Navigation, Suche
 
(21 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 +
{{bread-spezial1}}{{btt}}
 +
Das Modul ''Berichte & Listen'' bzw. der Report Explorer bietet die Möglichkeit, aus allen im System gespeicherten Daten eigene Auswertungen zu entwickeln.
 +
 +
Gegenüber den Reports in den Druckdialogen der einzelnen Module sind die hier zur Verfügung stehenden Daten nicht begrenzt.
 +
 +
 
__TOC__
 
__TOC__
  
[[Image:Reportexplorer.jpg]]
 
  
Im Modul Report-Explorer werden alle verfügbaren Reports (Berichte) zur besseren Übersicht in verschiedene Kategorien unterteilt.
+
[[image:berichte-listen.png|verweis=]]
 +
 
 +
 
 +
Alle verfügbaren Reports (Berichte) werden zur besseren Übersicht in verschiedene Kategorien unterteilt. Im Ordner ''Auswertungen e-vendo'' befinden sich weitere Unterordner mit von e-vendo entwickelten Reports. Eigene Reports können im Ordner ''Benutzereigene Auswertungen'' erstellt und bearbeitet werden.
 +
 
 +
{{info|Reports im Ordner ''Auswertungen e-vendo'' sind Standard-Reports und können nicht vom Nutzer bearbeitet werden.}}
 +
 
 +
 
 +
==Arbeiten mit dem Modul==
 +
 
 +
*Ein Doppelklick auf einen Report führt diesen aus. Dabei erscheint - je nach Konfiguration - eine Suchmaske und anschließend die Ergebnisliste in einer Seitenansicht. Diese ist für den Ausdruck vorgesehen. Diese Funktion kann alternativ über einen Rechtsklick und die Wahl des Punktes ''Öffnen'' im Kontextmenü erreicht werden.
 +
 
 +
*Ein Rechtsklick auf einen Report öffnet ein Kontextmenü; der Punkt ''Entwurf'' kann genutzt werden, um den Report in den Entwurfsmodus zu versetzen. Es öffnet sich der ReportBuilder und der Report kann bearbeitet werden.
 +
 
 +
*Im Ordner ''Benutzerdefinierte Auswertungen'' kann in der Reportliste ein Rechtsklick auf eine freie Fläche (oder einen bestehenden Report) getätigt werden. Das erscheinende Kontextmenü enthält u.a. den Eintrag ''Neu''. Hiermit wird ein neuer Report erstellt, der nach eigenen Wünschen ausgebaut werden kann.
 +
 
 +
{{info|Nach dem Öffnen eines Reports (für die Druckansicht) kann es vorkommen, dass dieser trotz Überschriften oder Titeln leer bleibt. Dies ist darauf zurückzuführen, dass keine Datensätze der eigentlichen Suche vorhanden sind und folglich auch Überschriften, Titel etc. nicht ausgegeben werden.}}
  
Der Report Explorer umfasst folgende Hauptfunktionen:
 
  
* Öffnen eines ausgewählten Reports mit dem Ziel der Seitenansicht bzw. des Druckens.
+
== Benutzerdefinierte Reports ==
* Öffnen eines ausgewählten Reports im Entwurfsmodus. In diesem Modus können Sie den Aufbau bzw. das Layout des Reports verändern.
 
* Erstellung eines neuen Reports mit Hilfe des zu Grunde liegenden DataDictionary. Hierbei haben Sie Zugriff auf alle Tabellen Ihrer Datenbank und können individuell für den neuen Report ein spezifisches Datenmodell erstellen.<br><br>Alle Reports, die im Original standardmäßig integriert sind, müssen zunächst in dem Ordner für ''Benutzereigene Auswertungen'' gespeichert werden. Ein Überschreiben originaler Report ist nicht möglich. Beim Versuch des Überschreibens von originalen Reports erscheint der nachfolgend abgebildete Hinweis.
 
  
[[Image:Reportexplorer report speichern.jpg]]
+
Ein neuer Report kann wie folgt erstellt werden:
 +
*Im Ordner ''Benutzereigene Auswertungen'' (oder einem Unterordner davon) kann ein Rechtsklick im rechten Bereich des Fensters (der Reportliste) getätigt werden.
 +
*Im daraufhin erscheinenden Kontextmenü wird die Option ''Neu'' gewählt.
 +
*Es wird in der Folge ein neuer Report erstellt und im ReportBuilder (also im Entwurfsmodus) geöffnet.
 +
*Im Reiter ''Daten'' werden die für den Report benötigten Tabellen und Felder gewählt. Dies geschieht im Hauptmenü über ''Datei'' > ''Neu''.
 +
*Im Reiter ''Entwurf'' können Layout und enthaltene Daten festgelegt werden.
 +
*Im Reiter ''Berechnungen'' können Berechnungen oder Logiken zu einzelnen Feldern hinterlegt werden.
 +
*Der Reiter ''Vorschau'' bildet eine Vorschau der aktuellen Konfiguration ab.
 +
<div style="margin-top:10px;">{{info|Achtung: Ein Wechsel in den Reiter ''Vorschau'' bildet alle Datensätze ab; eine eventuelle Suchfunktion wird hier nicht beachtet. Dadurch kann die Generierung der Vorschau etwas Zeit in Anspruch nehmen.
 +
<hr>
 +
Das Erstellen und Anpassen von Reports ist nicht Bestandteil des e-vendo Supports. Gerne unterstützen wir Sie hierbei aber im Rahmen unseres Consultings.
 +
<hr>
 +
Informationen für das Arbeiten im Entwurfsmodus eines Reports können Sie die '''[http://www.e-vendo.de/imgev/handbuecher/RBuilder.pdf Dokumentation des ReportBuilders]''' nutzen. Ein deutschsprachiger Lehrgang findet sich in Textform '''[https://www.digital-metaphors.com/download/LearnRB/LearnRBGermanDoc.zip hier]''' und ein von uns erstelltes Webinar über die Grundfunktionen '''[https://forum.e-vendo.de/index.php?thread/69-webinar-reportbuilder-basic hier]'''.}}</div>
  
Hinweis: Auch wenn Ihr Report eventuell mit einer Überschrift oder einem Titel versehen wurde,
 
so erhalten Sie trotzdem ein leeres Blatt, wenn vor  dem Druck des Reports festgestellt wurde,
 
dass keinerlei Datensätze für den Druck des Reports vorhanden sind.
 
Das bedeutet: wenn keine Daten vorhanden sind die gedruckt werden können, so wird auch kein
 
Titel, keine Überschrift und keine Fußzeile gedruckt.
 
  
== Aufbau des Modules ==
+
== Ausgabe in eine Datei ==
Das Fenster des Reportexplorer unterteilt sich in drei wesentliche Bestandteile:
 
* Menübereich am oberen Fensterrand
 
* die Auswertungskategorie links im Explorer
 
* die einzelnen Reports bzw. Unterordner im rechten Teil des Explorers
 
  
== Funktionsweise ==
+
Genau wie bei den Reports aus den verschiedenen Modulen können die Ergebnisse, die ein Report liefert, in eine Datei exportiert werden.
Um einen Report für die Seitenansicht zu öffnen gibt es zwei Möglichkeiten:
 
* Ausführen eines Doppelklick mit der Maus auf den gewünschten Report
 
* über dem gewünschten Report die rechte Maustaste betätigen und im erscheinenden Popup-Menü den Menüpunkt "Öffnen" selektieren. <br>Mehr Informationen im Bereich ''"Das Menü auf Report-Ebene"''.
 
  
== Die Menüstruktur ==
+
Dafür muss für den Report {{link|Report_als_Text_exportieren|die Dateiausgabe eingerichtet}} werden.
=== Reportbuilder ===
 
==== DataDictionary bilden ====
 
  
Alle verfügbaren Reports arbeiten auf der Grundlage des im Hintergrund verwalteten DataDictionarys. Es sollte nur dann aktualisiert werden, wenn im Rahmen von Updates neu zur Verfügung gestellte Felder noch nicht im aktuellen DataDictionary bereit stehen und diese für neue Auswertungen unbedingt benötigt werden.<br>[[Erstellen des DataDictionary|Mehr Informationen zum Erstellen des DataDictionary]]
 
  
==== Maskeneditor ====
+
==Data Dictionary bilden==
Um für Auswertungen von Datenmengen die entsprechenden Abfragekriterien zu implementieren haben Sie folgende Möglichkeiten:
 
* Im Entwurfsmodus des Reports im Bereich Daten/Abfrageditor auf dem Reiter Suchen die Felder für den sich automatisch bildenden Suchdialog festzulegen
 
* für die Eingabe von Suchkriterien die zur Verfügung stehenden Suchdialoge des Warenwirtschaftssystems zu nutzen.
 
  
[[Image:Reportexplorer suchmasken.jpg]]
+
Alle verfügbaren Reports arbeiten auf der Grundlage des im Hintergrund verwalteten Data Dictionary. Hierbei handelt es sich um einen Cache, der eine Übersicht aller in der Datenbank verwendeten Tabellen und deren Felder beinhaltet.
  
=== Datei ===
+
Änderungen an der Datenbank können nicht immer automatisch in das Data Dictionary übernommen werden. Deshalb kann es notwendig werden, dass eine Aktualisierung des Data Dictionary manuell vorgenommen werden muss.
Das Menü Datei des Report-Explorers bezieht sich auf Ordner und Reports in gleicher Art und Weise.
 
  
==== Öffnen ====
+
Das Data Dictionary muss neu erstellt werden, wenn neue Tabellen oder Felder nicht in den entsprechenden Auswahlfenstern zur Verfügung stehen oder wenn beim Öffnen eines Reports Meldungen nach folgendem Muster erscheinen:
Das Öffnen des Reports bewirkt eine Seitenansicht auf dem Bildschirm.<br>Dieser Menüpunkt steht Ihnen immer dann zur Verfügung, wenn Sie vor dem Öffnen des Menüs in der Liste der Reports einen Report selektiert haben. Der Aufruf des Menüpunktes hat die gleiche Funktionalität wie ein Doppelklick mit der linken Maustaste auf den gewünschten Report.
 
  
==== Neu ====
+
TdaMetaCache.GetFields: unable to find table ARTIKEL in cache.
Nach der Auswahl dieses Menüpunktes wählen Sie bitte, ob Sie einen neuen Ordner oder einen neuen Report erstellen möchten.
+
oder
 +
TdaSQL.BuildSQL92JoinExpression: Join field not included in field list of data dictionary.
  
==== Entwurf ====
 
Dieser Menüpunkt steht Ihnen immer dann zur Verfügung, wenn Sie vor dem Öffnen des Menüs in der Liste der Reports einen Report selektiert haben. Nach Aufruf des Menüpunktes wird der selektierte Report durch den integrierten Report-Designer im Entwurfsmodus geöffnet.
 
Einen Report kann auch im Entwurfsmodus geöffnet werden, in dem Sie über dem selektierten Report die rechte Maustaste betätigen und den Menüpunkt ''Entwurf'' auswählen.
 
  
==== Drucken ====
+
In einem solchen Fall ist es nötig, das Data Dictionary neu zu generieren. Dieser Prozess ist problemlos vom Nutzer durchführbar und dauert - je nach Datenbankgröße - etwa fünf bis zehn Minuten.
Das Öffnen des Reports bewirkt die Ausgabe auf Ihren definierten Standard-Drucker.<br>Dieser Menüpunkt steht Ihnen immer dann zur Verfügung, wenn Sie vor dem Öffnen des Menüs in der Liste der Reports einen Report selektiert haben.
 
Den selektierten Report können Sie auch drucken, in dem Sie über dem selektierten Report die rechte Maustaste betätigen und den Menüpunkt ''Drucken'' selektieren.
 
  
==== Löschen ====
+
Der Ablauf zur Generierung des Data Dictionary ist dabei wie folgt:
Durch Auswahl dieses Menüpunktes wird entweder der aktuell selektierte Ordner oder der aktuell selektierte Report gelöscht. Beim Löschen eines Ordners werden die sich darin befindlichen Reports zunächst in den Papierkorb des Report-Explorers verschoben. Um die im Papierkorb befindlichen Reports zu löschen betätigen Sie über dem Symbol des Papierkorbes die rechte Maustatse und wählen das Menü ''Papierkorb leeren''.<br>Um einen Report zu löschen können Sie auch über dem selektierten Report die rechte Maustatse betätigen und das Menü ''Löschen'' selektieren.
 
  
=== Ansicht ===
 
==== Werkzeugleiste ====
 
Durch jeweilige Anwahl dieses Menüpunktes wird die Buttonleiste unterhalb des Menüs ein- bzw. ausgeblendet.
 
  
==== Statusleiste ====
+
{{gbox|berichte-listen dd 00.png|480|Data Dictionary bilden|Zuerst muss im Modul ''Berichte & Listen'' (von beliebiger Stelle aus) im Hauptmenü der Punkt ''ReportBuilder'' aufgerufen werden.<br>Im erscheinenden Menü wird der Punkt ''DataDictionary bilden'' gewählt. Damit wird der Prozess gestartet.}}
Durch jeweilige Anwahl dieses Menüpunktes wird die Statausleiste im Fußbereich des Fensters ein- bzw. ausgeblendet.  
 
  
==== Liste ====
+
{{gbox|berichte-listen dd 01.png|480|Abfrage bestätigen|Wurde dies getan, kommt eine Abfrage zum Vorschein, die darauf hinweist, dass die Bildung des Data Dictionary einige Zeit in Anspruch nehmen kann.<br>
Für die Anzeige der Reports können Sie hier die Listenansicht wählen.
+
Sie wird mit ''Ja'' bestätigt.}}
  
==== Detail ====
+
{{gbox|berichte-listen dd 02.png||Data Dictionary|Daraufhin öffnet sich ein neues Fenster mit dem Titel ''Data Dictionary Builder''. Dies ist das tatsächliche Data Dictionary.<br>
Für die Anzeige der Reports können Sie hier die Detailansicht wählen.
+
Es beinhaltet drei Reiter, die ihre respektiven Daten aus der Datenbank enthalten:<br>
 +
Der Reiter ''Tables'' enthält eine Liste aller Tabellen, der Reiter ''Fields'' enthält alle in den Tabellen enthaltenen Datenbankfelder, und der Reiter ''Joins'' beinhaltet alle Verknüpfungen (Relationen) zwischen den Tabellen. Für das Data Dictionary sind nur die Tabellen und Felder relevant.<br>
 +
Daher wird zuerst in den Reiter ''Tables'' gewechselt.}}
  
=== Hilfe ===
+
{{gbox|berichte-listen dd 03.png||Daten generieren|Mittels Rechtsklick an eine beliebige Stelle in der Liste im Reiter ''Tables'' wird das links sichtbares Kontextmenü hervorgerufen.<br>
Bei Aufruf dieses Menüpunktes wird die originale Hilfe zur Funktionalität des im Warenwirtschaftssystem integrierten ReportBuilders geöffnet. In dieser Hilfe erhalten Sie u.a. detaillierte Informationen zum RAP-Interface (Report Application Programming), welches an die Programmiersprache Pascal anlehnt.
+
Hier muss der Eintrag ''Generate'' geklickt werden. Es werden dadurch alle Tabellen neu aus der Datenbank ausgelesen und, sofern sie hier fehlen, eingetragen.<br><br>
 +
Im Anschluss muss dieser Vorgang im Reiter ''Fields'' wiederholt werden. Im Reiter ''Joins'' ist keine Aktion notwendig.
 +
{{info|Im Reiter ''Fields'' dauert der Vorgang bis zu zehn Minuten.}}<br>
 +
Ist dieser Vorgang beendet, kann das Fenster geschlossen werden. Im Anschluss sollte e-vendo neu gestartet werden.}}

Aktuelle Version vom 18. April 2024, 07:53 Uhr

Templ loc-blk.png
erreichbar über:
Spezial 1
zum Anfang der Seite

Das Modul Berichte & Listen bzw. der Report Explorer bietet die Möglichkeit, aus allen im System gespeicherten Daten eigene Auswertungen zu entwickeln.

Gegenüber den Reports in den Druckdialogen der einzelnen Module sind die hier zur Verfügung stehenden Daten nicht begrenzt.



Berichte-listen.png


Alle verfügbaren Reports (Berichte) werden zur besseren Übersicht in verschiedene Kategorien unterteilt. Im Ordner Auswertungen e-vendo befinden sich weitere Unterordner mit von e-vendo entwickelten Reports. Eigene Reports können im Ordner Benutzereigene Auswertungen erstellt und bearbeitet werden.

Templ info-blk.png
Reports im Ordner Auswertungen e-vendo sind Standard-Reports und können nicht vom Nutzer bearbeitet werden.


Arbeiten mit dem Modul

  • Ein Doppelklick auf einen Report führt diesen aus. Dabei erscheint - je nach Konfiguration - eine Suchmaske und anschließend die Ergebnisliste in einer Seitenansicht. Diese ist für den Ausdruck vorgesehen. Diese Funktion kann alternativ über einen Rechtsklick und die Wahl des Punktes Öffnen im Kontextmenü erreicht werden.
  • Ein Rechtsklick auf einen Report öffnet ein Kontextmenü; der Punkt Entwurf kann genutzt werden, um den Report in den Entwurfsmodus zu versetzen. Es öffnet sich der ReportBuilder und der Report kann bearbeitet werden.
  • Im Ordner Benutzerdefinierte Auswertungen kann in der Reportliste ein Rechtsklick auf eine freie Fläche (oder einen bestehenden Report) getätigt werden. Das erscheinende Kontextmenü enthält u.a. den Eintrag Neu. Hiermit wird ein neuer Report erstellt, der nach eigenen Wünschen ausgebaut werden kann.
Templ info-blk.png
Nach dem Öffnen eines Reports (für die Druckansicht) kann es vorkommen, dass dieser trotz Überschriften oder Titeln leer bleibt. Dies ist darauf zurückzuführen, dass keine Datensätze der eigentlichen Suche vorhanden sind und folglich auch Überschriften, Titel etc. nicht ausgegeben werden.


Benutzerdefinierte Reports

Ein neuer Report kann wie folgt erstellt werden:

  • Im Ordner Benutzereigene Auswertungen (oder einem Unterordner davon) kann ein Rechtsklick im rechten Bereich des Fensters (der Reportliste) getätigt werden.
  • Im daraufhin erscheinenden Kontextmenü wird die Option Neu gewählt.
  • Es wird in der Folge ein neuer Report erstellt und im ReportBuilder (also im Entwurfsmodus) geöffnet.
  • Im Reiter Daten werden die für den Report benötigten Tabellen und Felder gewählt. Dies geschieht im Hauptmenü über Datei > Neu.
  • Im Reiter Entwurf können Layout und enthaltene Daten festgelegt werden.
  • Im Reiter Berechnungen können Berechnungen oder Logiken zu einzelnen Feldern hinterlegt werden.
  • Der Reiter Vorschau bildet eine Vorschau der aktuellen Konfiguration ab.
Templ info-blk.png
Achtung: Ein Wechsel in den Reiter Vorschau bildet alle Datensätze ab; eine eventuelle Suchfunktion wird hier nicht beachtet. Dadurch kann die Generierung der Vorschau etwas Zeit in Anspruch nehmen.

Das Erstellen und Anpassen von Reports ist nicht Bestandteil des e-vendo Supports. Gerne unterstützen wir Sie hierbei aber im Rahmen unseres Consultings.


Informationen für das Arbeiten im Entwurfsmodus eines Reports können Sie die Dokumentation des ReportBuilders nutzen. Ein deutschsprachiger Lehrgang findet sich in Textform hier und ein von uns erstelltes Webinar über die Grundfunktionen hier.


Ausgabe in eine Datei

Genau wie bei den Reports aus den verschiedenen Modulen können die Ergebnisse, die ein Report liefert, in eine Datei exportiert werden.

Dafür muss für den Report die Dateiausgabe eingerichtet werden.


Data Dictionary bilden

Alle verfügbaren Reports arbeiten auf der Grundlage des im Hintergrund verwalteten Data Dictionary. Hierbei handelt es sich um einen Cache, der eine Übersicht aller in der Datenbank verwendeten Tabellen und deren Felder beinhaltet.

Änderungen an der Datenbank können nicht immer automatisch in das Data Dictionary übernommen werden. Deshalb kann es notwendig werden, dass eine Aktualisierung des Data Dictionary manuell vorgenommen werden muss.

Das Data Dictionary muss neu erstellt werden, wenn neue Tabellen oder Felder nicht in den entsprechenden Auswahlfenstern zur Verfügung stehen oder wenn beim Öffnen eines Reports Meldungen nach folgendem Muster erscheinen:

TdaMetaCache.GetFields: unable to find table ARTIKEL in cache.

oder

TdaSQL.BuildSQL92JoinExpression: Join field not included in field list of data dictionary.


In einem solchen Fall ist es nötig, das Data Dictionary neu zu generieren. Dieser Prozess ist problemlos vom Nutzer durchführbar und dauert - je nach Datenbankgröße - etwa fünf bis zehn Minuten.

Der Ablauf zur Generierung des Data Dictionary ist dabei wie folgt:


Berichte-listen dd 00.png

Data Dictionary bilden

Zuerst muss im Modul Berichte & Listen (von beliebiger Stelle aus) im Hauptmenü der Punkt ReportBuilder aufgerufen werden.
Im erscheinenden Menü wird der Punkt DataDictionary bilden gewählt. Damit wird der Prozess gestartet.

Berichte-listen dd 01.png

Abfrage bestätigen

Wurde dies getan, kommt eine Abfrage zum Vorschein, die darauf hinweist, dass die Bildung des Data Dictionary einige Zeit in Anspruch nehmen kann.
Sie wird mit Ja bestätigt.

Berichte-listen dd 02.png

Data Dictionary

Daraufhin öffnet sich ein neues Fenster mit dem Titel Data Dictionary Builder. Dies ist das tatsächliche Data Dictionary.
Es beinhaltet drei Reiter, die ihre respektiven Daten aus der Datenbank enthalten:
Der Reiter Tables enthält eine Liste aller Tabellen, der Reiter Fields enthält alle in den Tabellen enthaltenen Datenbankfelder, und der Reiter Joins beinhaltet alle Verknüpfungen (Relationen) zwischen den Tabellen. Für das Data Dictionary sind nur die Tabellen und Felder relevant.
Daher wird zuerst in den Reiter Tables gewechselt.

Berichte-listen dd 03.png

Daten generieren

Mittels Rechtsklick an eine beliebige Stelle in der Liste im Reiter Tables wird das links sichtbares Kontextmenü hervorgerufen.
Hier muss der Eintrag Generate geklickt werden. Es werden dadurch alle Tabellen neu aus der Datenbank ausgelesen und, sofern sie hier fehlen, eingetragen.

Im Anschluss muss dieser Vorgang im Reiter Fields wiederholt werden. Im Reiter Joins ist keine Aktion notwendig.

Templ info-blk.png
Im Reiter Fields dauert der Vorgang bis zu zehn Minuten.

Ist dieser Vorgang beendet, kann das Fenster geschlossen werden. Im Anschluss sollte e-vendo neu gestartet werden.