Bereitstellen und Anpassen der Berichtsfunktion

Siehe auch: Kapitel Grundlagen und Bedienung Berichte und Datenblätter drucken

Attention

Achtung: Das Anpassen und Bereitstellen von Berichten sowie das Definieren und Parametrisieren der Suchfelder für die Konfiguration von Berichten im Reportmanager erfordert Kenntnisse des Datenmodells von PisaSales und sollte vorzugsweise von Administratoren mit Customizingkenntnissen durchgeführt werden.

Menü Administration/...

Administra­tion/Berichte/...

Erläuterung, Verwendung

Berichte-Verwal­tung

Übersicht über Standard- und kundenspezifische Berichte

Berichtssuchgrup­pen

Zum Gruppieren von Suchbedingungen

Berichtstypen

Typen der Berichte in PisaSales mit Piktogramm

Berichtszeitaus­wahl

Zur Darstellung Stunden, Tage, Wochen usw. bei Anpassung Berichtszeiträumen

Vorlagenstatus

Verwaltung der Status für Dokument-Vorlagen, wie z.B. In Bearbeitung, Freigegeben, ...

Vorlagenele­mente

Elemente die in der Vorlagenverwaltung regelmäßig verwendet werden. Importfunktion an der Liste.

Berichtsfarben

 

Reportobjekte

Auswahlmenü in der Vorlagenverwaltung "Für Objekt". Als Wert sind die Tabellen einge­tragen, die von der Vorlage verwendet werden.

Reporthandler

- Preview-Handler für Generierung von Reports und Bearbeiten in einem Reportpreview.
- Checkin-Handler für Nachprogrammierung Office 2007-Kopplung (bei Verwendung bereits angepasster Preview-Handler)

Reportwerkzeuge

Auflistung der in PisaSales verwendeten Reportwerkzeuge mit Implementierungsklasse

Vorlagenbereiche

Verwaltung der Bereiche zum strukturierten Ablegen von Vorlagen (Bereich/Thema)

Im Administrationsbereich steht die Berichtsverwaltung bereit (Menü Administration/Berichte). Admi­nistratoren und Berichtsentwickler erhalten eine vollständige Übersicht über Standard- und kundenspe­zifische Berichte (Windward-Reports, Crystal Reports, CSV-Export, Excel-Export) mit folgenden Steuerungsmöglichkeiten:

  • Bereitstellung der Berichte für Masken
  • Berichtsstatus (Anzeigen, Inaktiv, Ungültig)
  • Select- und NoSelect-Berichtsausgabe
  • Parametrisierung der Berichtsausgabe (analog zur früheren Berichtsfunktion PSA_GEN_RPT_...)
  • Definition von Suchfeldern für jeden einzelnen Bericht zur Konfiguration durch den Anwender.
  • Journal für Änderungsverfolgung und Upgradesicherheit

Liste Berichtsverwaltung

Feldtitel

Anmerkungen

Bild/Typ

Berichtstyp: Windward-Reports, Crystal Reports, CSV-Export, Excel-Export

Name

Berichtsname: Wird in der Berichtsliste des Reportmanagers angezeigt.

Objekt (Ident)

Frei zu vergebender Objektname. Er stellt die Verbindung zur Maske her (über INI-Tag).

Siehe weiter unten:  Bericht an der Maske zur Verfügung stellen

Objekteinschränkung

Einschränkung des Objektes auf Datensätze mit einer bestimmten Prozess-Id (in Pro­zessdefinition).

Siehe weiter unten:  Weitere Optionen

Beschreibung

Wird in der Berichtsliste des Reportmanagers als zusätzliche Information für den Anwender im Feld Beschreibung angezeigt.

Status

Steuert, ob der Bericht in der Berichtsliste des Berichtsmanagers ausgegeben wird oder nicht. [Anzeigen, Inaktiv, Ungültig]

Siehe weiter unten:  Weitere Optionen

DS selektiert
DS unselektiert

Steuert, ob der Bericht Daten aus dem selektierten oder aus allen Datensätzen der Maske enthält.

Siehe weiter unten:  Weitere Optionen

Berichtsname

Vorlagen-ID. Stellt die Verbindung zur Vorlagenverwaltung her.

Spalten im gelben Bereich

Parameter der bisher verwendeten Berichtsfunktion PSA_GEN_RPT_...

Parameter

Parameter, die zusätzlich an die Reportengine übergeben und am Reportmanager mit ausgewertet werden.

Basisbeziehung

Assoziations-Name, falls der Bericht seine Daten aus einer anderen Datenklasse bezieht, als der Bericht der Kopf-Maske.

Siehe weiter unten: Weitere Optionen

Suchbedingungen übernehmen

Steuert, ob eine Suchbedingung auf der Maske übernommen werden soll.

Siehe weiter unten: Weitere Optionen

Dialog

Folgedialog des Reportmanagers (Customizing).

Siehe weiter unten: Weitere Optionen

Aufnahme von Berichten in die Berichtsverwaltung

Interne und erst recht kundenspezifische Berichte müssen in der PisaSales Vorlagenverwaltung als eine vollständige Berichtsvorlage mit XML-Loader und Layout existieren.

  • Legen Sie einen neuen Berichtsdatensatz in der Liste Berichtsverwaltung an, Name und Beschreibung vergeben.
  • Vergeben Sie einen Objekt-Name (Ident). Der Identifier ist frei zu vergeben und stellt die Verbindung zur Maske her.
  • In der Spalte Berichtsname tragen Sie die Vorlagen-ID des Berichtes aus der Vorlagenverwaltung ein.
  • In die folgenden gelben Spalten tragen Sie die Parameter der bisher verwendeten Berichtsfunktion PSA_GEN_RPT_... ein.
  • Setzen Sie den Status auf Anzeigen, um den Bericht im Reportgenerator anzuzeigen.

Bericht an der Maske zur Verfügung stellen

Erst wenn der Bericht an der Maske zur Verfügung steht, wird er in der Berichtsliste des Reportmanagers angezeigt und kann vom Anwender ausgewählt werden.

Das in der Vorlagenverwaltung verwendete Feld Startdialog wird durch folgende Zuordnung an der Maske ersetzt.

INI-Tag mit der Methode "PSA_INI_RPT_MNG" an der Maske eintragen und Parameter "OBJ_NAM:=Objekt-Name" vergeben (siehe Standardliste Datenobjekt PSC_TAG).

Hinweis: Wird seit Einführung des Reportmanagers und Abkündigung von Standard-Funktionen zur Berichtsgenerierung in der Funktionsleiste nicht mehr benutzt.

Weitere Optionen

Objekteinschränkung

In Übersichtslisten, wie z.B. in der Vertriebsvorgangsübersicht PSA_PRO_SAL_ESL, können verschie­dene Objekte (z.B. Geschäftschancen, Angebote, Aufträge) dargestellt werden. In diesem Fall muss gesichert werden, dass z.B. am selektierten Angebotsdatensatz kein Auftragsbericht erzeugt wird.

Um dies zu realisieren, muss in der Spalte Objekteinschränkung die Prozess-ID eingetragen werden, z.B. PSA_PRO_QUO, für die der Bericht gilt. Zusätzlich muss im Parameter des INI-Tags an der Maske genau das Feld in der Form OBJ_FLD:=Feldname übergeben werden, welches die Objekteinschränkung als Suchbedingung aufnehmen soll, z.B. OBJ_FLD:=SAP_IDN.

Select- und NoSelect-Berichte

Die meisten Berichte werden am selektierten Datensatz ausgeführt (Checkbox in der Spalte DS selek­tiert gesetzt). Für Berichte über alle Datensätze der Maske ist zusätzlich oder alternativ die Checkbox in der Spalte DS unselektiert zu setzen.

Basisbeziehung (nur für Berichte vom Typ CSV-Export)

Für Berichte, die ihre Daten aus einer anderen Datenklasse beziehen, als der Kopf-Maske (z.B. ein Kontaktbericht am Vorgangsformular), muss in der Spalte Basisbeziehung der Name der entsprechen­den Assoziation eingetragen werden, die an der Datenklasse der Maske definiert ist.

Das Flag "Suchbedingungen übernehmen" steuert, ob eine Suchbedingung auf der Maske übernom­men werden soll oder nicht.

Folgedialog des Reportmanager definieren (Customizing)

Wird kundenspezifisch am Reportmanager ein Folgedialog für die Abfrage weiterer Berichtsoptionen benötigt, kann in der Spalte "Dialog" ein entsprechender Dialogname angegeben werden. Der Dialog öffnet nach Auswahl des Berichts und Bestätigung des Reportmanager mit "Ausführen".

Standardberichte ausblenden und durch kundenspezifische Berichte ersetzen

Berichtsdatensätze in der Berichtsverwaltung können überladen werden. Dafür ist der Status des Standard-Berichts auf Inaktiv zu setzen und der kundenspezifische Bericht auf Anzeigen. Die Überla­dung ist im Journal verfolgbar und wird beim Upgrade berücksichtigt.

Berichtsverfügbarkeit und aktive Untermasken

Für Masken mit Untermasken kann über die Umgebungsvariable PSA_RPT_MNG_CAL_TOP global gesteuert werden, ob bei aktiver Untermaske im Reportmanager die Berichte der Untermaske (ent­sprechend INI-Tag) oder die Berichte der Kopf-Maske (entsprechend INI-Tag) angeboten werden sol­len.

Definition der Suchfelder für die Berichtskonfiguration durch den Anwender

Die Definition der Suchfelder erfolgt in der Unterliste Suchbedingungen. Die Suchfelder werden zur Lauf­zeit generiert und im Reportmanager im Bereich Suchbedingungen dargestellt.

Hinweis: Wenn im Reportmanager bei allen Reports mit mehreren Suchbedingungen im Abschnitt "Suchbedingungen" der Scrollbalken fehlt, dann ist mit hoher Wahrscheinlichkeit der Wert der Variable PSC_CFR_SCL_DLG auf "n" gesetzt, und man kommt an die unteren Bedingungen ggf. nicht mehr ran. Ändern Sie in diesem Fall den Wert der Variable für die entsprechenden Benutzer bzw. Gruppen auf "y".

Loader: Makro für die Exportsprache

Um für Berichte eine dynamische Suchbedingung zu realisieren, die abhängig von der Vorlagenspra­che ist und die aktuelle Exportsprache abfragt, kann im Loader $EXP_LNG genutzt werden. Das Makro mapped auf die Exportsprache.

Bedeutung der Felder in der Unterliste Suchbedingungen:

Feldti­tel

Anmerkungen

Abfrage

Aktiviert die interaktive Abfrage der Suchbedingung im Berichtsdialog. Mit einem deaktivierten Flag lassen sich statische Suchbedingungen "versteckt" definieren, die immer ausgeführt werden.

Position

Reihenfolge der Darstellung der Suchfelder im Reportmanager

Gruppe

Gruppiert Suchbedingungen. Die Suchfelder werden im Reportmanager als Block dargestellt und erhalten den Gruppennamen als Überschrift. Die Administrationsliste der Gruppennamen wird über das Menü Administration/Berichte/Berichtssuchgruppen aufgerufen.

Objekt

Name der Datenklasse (für Berichtstyp "CSV-Export") oder externer Name der Exportklasse im XML-Loader (für Berichtstyp "Windward-Report").

Feldtitel

Erscheint als Titel vor den Suchfeldern im Reportmanager

Feld­name

Qualifizierter Name des Feldes in der Datenklasse, auf dem die Suche ausgeführt werden soll. Der Eintrag SELECT erzeugt eine Checkbox, in der Anwender die gesamte Gruppe aus- bzw. abwählen können. Typ muss ‚L' sein. Der SELECT-Eintrag soll stets der erste Eintrag der Gruppe sein.

Typ

D -> Erzeugt zwei Felder zur Eingabe einer Zeitspanne von - bis Kalenderauswahl ( ">=Datum/Zeit & <=Datum/Zeit")

F/I -> Erzeugt zwei Felder zur Eingabe einer Wertespanne. Die Suchbedingungen können Operato­ren enthalten. Die Suchbedingung wird nicht automatisch qualifiziert.

L -> Erzeugt eine Checkbox mit drei Zuständen.

S -> Erzeugt ein Feld zur Eingabe einer Suchbedingung. Die Suchbedingung kann Operatoren enthal­ten. Die Suchbedingung wird nicht automatisch qualifiziert.

Wert

Belegt das Suchfeld mit einer Suchbedingung vor.

Auswahl

Name des Selektors am Suchfeld. Der Selektor muss existieren und darf keine Parameter enthalten, die andere Felder ansprechen.