1                     Themenübersicht

Mit der Anwendung „Berichte“ können Sie Berichte ansehen oder verwalten.

Berichte werden nach dem Berichtstyp unterschieden. In der Anwendung können Sie sich Berichte unabhängig vom Berichtstyp ansehen. Verwalten können Sie allerdings nur Berichte vom Typ „Systemobjekt“. Berichte vom Typ „Entwicklungsobjekt“ können Sie dagegen nur in der Anwendung „Entwicklungsobjekte“ verwalten, die in Entwicklungssystemen zur Verfügung steht.

2                     Zielgruppe

Benutzer, die Berichte erstellen.

3                     Begriffsbestimmung

Belegdokumente

Die Ausgabe eines Beleges auf ein Ausgabegerät, wie zum Beispiel einem Drucker, oder in eine Datei erzeugt ein Belegdokument. Das Belegdokument kann archiviert oder zum Beispiel als Fax oder per E-Mail an einen Partner übermittelt werden.

Berichte

Mit einem Bericht lassen sich Daten, die in Semiramis erfasst sind, in übersichtlicher Form ausgeben. Ein Bericht lässt sich beliebig oft und auf Basis der aktuell vorhandenen Daten ausgeben.

Berichte werden in Berichts- und Belegdokumente unterschieden. Berichte vom Dokumenttyp „Berichtsdokument“ können auf Basis von beliebigen Daten aus Semiramis erstellt werden. Sie besitzen im Allgemeinen die Form einer Liste und können in der Anwendung „Berichtsdokumente ausgeben“ ausgegeben werden. Belegdokumente können in den jeweiligen fachlichen Anwendungen, in denen Belege entstehen, ausgegeben werden. Sie beinhalten im Allgemeinen nur die Daten zu einem einzelnen Beleg.

Berichte können als System- oder als Entwicklungsobjekt angelegt werden. Ein Bericht als Entwicklungsobjekt hat den Vorteil, dass er in einem Entwicklungssystem verändert, versionisiert abgelegt und als Softwareaktualisierung in andere Systeme übertragen werden kann. Um Berichte auch in Nicht-Entwicklungssystem erstellen und verändern zu können bietet die Anwendung „Berichte“ die Möglichkeit sie als Systemobjekt anzulegen. Systemobjekte können nicht in andere Systeme transportiert werden.

Berichte enthalten ein oder mehrere Berichts-Dateien, die das Layout eines Berichts bestimmen.

Berichtsdatei

Mit einer Berichts-Datei wird das Aussehen des zu erzeugenden Berichtsdokuments festgelegt. Dazu werden die Berichts-Dateien in Crystal Reports bearbeitet. Berichts-Dateien können sprachabhängig oder sprachunabhängig sein.

Berichtsdokument

Die Ausgabe eines Berichts auf ein Ausgabegerät, wie einem Drucker, oder in eine Datei erzeugt ein Berichtsdokument oder ein Belegdokument. Das Berichtsdokument enthält eine Liste von Objekten, beispielsweise eine Liste von Adressen. Ein Belegdokument umfasst stets ein Objekt, beispielsweise einen Vertriebsauftrag. Die Dokumente können archiviert oder zum Beispiel als Fax oder per E-Mail an einen Partner übermittelt werden.

4                     Konventionen

4.1               Standardparameter

Folgende Namen von Berichtsparametern sind vordefiniert bzw. für spätere Erweiterungen reserviert:

• SystemVariables
• SystemValues
• TextConstants
• TextValues
• Parameter, die mit „Report“ beginnen

Diese Namen sind als Konstanten an der Klasse „com.cisag.pgm.services.out­put.Cis­Attributes“ definiert

4.2               Namen von Berichts-Dateien

Wenn beim Exportieren Berichts-Dateien im Knowledge Store abgelegt werden, dann erhalten Sie Dateinamen, die einem bestimmten Muster entsprechen. Die Dateinamen dürfen nicht verändert werden, ansonsten ist das Importieren der Berichts-Dateien nicht möglich.

Das Muster für Dateinamen ist wie folgt:

• Der Dateiname beginnt mit dem Namen des Berichts. Der Namensraum bei Berichten vom Berichtstyp „Entwicklungsobjekt“ wird dabei nicht mit angegeben.
• Falls es sich um einen sprachabhängigen Bericht handelt, folgt ein Unterstrich „_“ und das Kürzel der Sprache.
• Der Dateiname endet mit der Dateiendung „.rpt“.

5                     Anwendungsbeschreibung

Die Anwendung „Berichte“ dient der Erfassung von Berichten vom Typ „Systemobjekt“. Sie besteht aus einem Identifi­kations- und einem Arbeitsbereich. Die Bearbeitung der Berichts-Dateien erfolgt dabei extern durch das Designwerkzeug „Crystal Reports“.

5.1               Identifikationsbereich

Der Identifikationsbereich enthält die Felder, die den Bericht eindeutig identifizieren, sowie weitere allgemeingültige Daten. Die Felder im Einzelnen:

5.2               Arbeitsbereich

5.2.1          Karteireiter Parameter

Unter diesem Karteireiter werden die Parameter für den Bericht angezeigt. Die vorhandenen Parameter ergeben sich aus den Parameterfeldern einer Berichts-Datei. Die Anzeige der Parameter wird beim Importieren der Berichts-Dateien aktualisiert. In der Anwendung „Berichte“ ist es nicht möglich, direkt Parameter hinzuzufügen oder zu löschen.

Sind auf dem Karteireiter Dateien mehrere Berichts-Dateien definiert, so bestimmt – wenn vorhanden – die sprachunabhängige Berichts-Datei, ansonsten die Berichts-Datei in der Originalsprache des Berichtes die Parameter. Alle Berichts-Dateien eines Berichtes müssen die gleichen Parameterfelder enthalten. Auch müssen die Datentypen der Parameterfelder in allen Berichts-Dateien gleich sein.

5.2.2          Karteireiter Dateien

Unter dem Karteireiter werden alle Berichts-Dateien aufgeführt, die für den Bericht vorhanden sind. Vor dem Exportieren oder Importieren der Berichts-Dateien müssen die Berichts-Dateien in diesem Karteireiter definiert werden. Für sprachabhängige Berichts-Dateien geben Sie dabei jeweils die Sprache an.

Bei der Neuanlage eines Berichtes hat dieser standardmäßig eine sprachunabhängige Berichts-Datei. Auf dem Karteireiter Dateien können für weitere Sprachen Dateien definiert und bestehende Dateien zur Löschung markiert werden.

Über der Liste der Berichts-Dateien gibt es folgende Buttons:

• Neu:

Legt eine neue Berichts-Datei an. In der Liste erscheint eine neue Zeile, in der Sie angeben können, ob die Berichts-Datei sprachabhängig ist und, wenn ja, für welche Sprache sie verwendet werden soll. Bei der neu erzeugten Berichts-Datei handelt es sich um eine Vorlage, die Sie exportieren und dann mit Crystal Reports bearbeiten können.

• Duplizieren:

Dupliziert die markierte Berichts-Datei.

• Löschen:

Löscht die markierte Berichts-Datei.

Die Spalten der Liste im Einzelnen:

5.2.3          Karteireiter Texte

Um bei der Erstellung von mehrsprachigen Berichten nicht für jede Sprache eine eigene Berichts-Datei erstellen zu müssen, können in Berichten symbolische Textkonstanten verwendet werden. Damit ist es auch möglich, Berichte mithilfe des Redaktionscockpits bzw. mithilfe der Anwendung Berichte zu übersetzen. Die Textkonstanten erfüllen die gleiche Funktion wie die Einträge von Stringtabellen, d.h. ihre Übersetzung wird zur Laufzeit bestimmt. In der Berichts-Datei kann während der Ausgabe des Berichtes mithilfe von Crystal-Reports-Benutzerfunktionen die Übersetzung zu einer Textkonstante abgefragt werden.

Hinweis:
Textkonstanten können sowohl beim Design von sprachabhängigen als auch beim Design von sprachunabhängigen Berichten verwendet werden. Damit ist es beispielsweise möglich, für eine Sprache eine eigene Berichts-Datei mit alternativem Layout zu gestalten und dennoch alle enthaltene Texte außerhalb von Crystal Reports zu verwalten und zu übersetzen.

Über der Anzeige der Texte gibt es folgende Buttons:

• Neu:

Fügt eine neue Textkonstante hinzu.

• Übersetzung hinzufügen:
• Fügt zur markierten Konstante einen Text in einer weiteren Sprache hinzu.Ausgewählte Übersetzungen duplizieren: Dupliziert die markierte Zeile mit der Konstanten und allen Übersetzungen.
• Einträge in andere Sprache duplizieren:

Dupliziert alle Einträge einer Sprache in eine andere Sprache. Es erscheint ein Fenster, in dem Sie die Sprache der zu duplizierenden Einträge und die Sprache, die den duplizierten Einträgen zugeordnet werden soll, angeben können.

• Markierte Sprachen:

Zeigt nur noch die Übersetzungen in der markierten Sprache an. Übersetzungen in den anderen Sprachen werden ausgeblendet. Nochmaliges Drücken des Buttons zeigt wieder alle Übersetzungen an.

• Löschen:

Löscht eine Übersetzung, wenn Sie die Übersetzung markiert haben. Löscht eine Konstante mit all ihren Übersetzungen, wenn Sie die Konstante markiert haben.

Die Liste der Konstanten und Übersetzungen enthält folgende Spalten:

5.2.4          Karteireiter Direkthilfe

Unter diesem Karteireiter wird die Direkthilfe zu dem geladenen Bericht angezeigt. Bei Berichten, die Sie bearbeiten können, können Sie hier die Direkthilfe in mehreren Sprachen erfassen. Die Direkthilfe wird beispielsweise in der Anwendung „Berichtsdokumente ausgeben“ angezeigt, um eine Hilfestellung für die Verwender des Berichts zu bieten.

Es gibt folgende Buttons:

• Fügt eine Direkthilfe für den Bericht hinzu. Für jede Sprache kann maximal eine Direkthilfe angelegt werden.
• Löscht die markierte Direkthilfe.

Die Direkthilfen werden in folgenden Spalten angezeigt:

5.2.5          Karteireiter Datenquellen

Unter diesem Karteireiter können Sie die in den bereits importierten Berichts-Dateien verwendeten Objekte bzw. Tabellen einer ODBC-Datenquellen ansehen.

Handelt es sich bei den ODBC-Datenquellen um die den Semiramis-Datenbanken entsprechenden symbolischen Namen “Semiramis OLTP”, “Semiramis OLAP”, “Semiramis Repository” oder “Semiramis Configuration”, wird zusätzlich zum Tabellennamen das zugehörige Business Object bzw. der zugehörige OQL-View angezeigt.

Die Spalten im Einzelnen:

5.3               Customizing

Für die Anwendung „Berichte“ sind in der Anwendung „Custo­mizing“ keine Einstellungen fest­zulegen.

5.4               Berechtigungen

Semiramis arbeitet mit einem mehrstufigen Berechtigungskonzept. Fähigkeiten und Berechtigungen können generell auf verschiedenen Ebenen vergeben wer­den:

• Auf den Ebenen für Frameworks und Anwendungen vergeben Sie z. B. eine Berechtigung, mit der eine Anwendung geöffnet werden kann.
• Auf den Ebenen für Business Entitys vergeben Sie z. B. eine Berechtigung, mit der ein Bericht erzeugt werden kann. Die Entity-bezogenen Berechtigungen gelten anwendungs­über­greifend.

Für einige Anwendungen wurden spezielle Fähigkeiten entwickelt, die sich auf bestimmte Aktio­nen und Funk­tionen beziehen. Auch für diese Fähigkeiten können Berechtigungen vergeben werden. So kann z. B. für die spezielle Fähig­keit, eine Bestellung ausgeben zu können, eine Berech­tigung vergeben werden.

Das Berechtigungskonzept sowie die generellen anwendungsbezogenen und Entity-bezogenen Berechtigungen können Sie in der Technischen Dokumentation im Dokument Berechtigungen nachlesen.

Für Berechtigungsfestlegungen für die Anwendung „Berichte“ ist das folgende Business Entity relevant:

com.cisag.sys.repository.obj.Report

Spezielle Berechtigungen und Fähigkeiten sind für diese Anwendung nicht erforderlich.

5.5               Vorgehensweisen

Lesen Sie nachfolgend, wie Sie mit der Anwendung „Berichte“ arbeiten:

• Neuen Bericht anlegen
• Berichts-Datei für einen Bericht verändern

5.5.1          Neuen Bericht anlegen

1. Öffnen Sie die Anwendung „Berichte“.

• Eine Vorlage für die Berichts-Datei wird in Crystal Reports geöffnet. Evtl. müssen Sie das Öffnen der Datei bestätigen; Sie können sie alternativ auch zunächst speichern.

2. Bearbeiten Sie die Berichts-Datei in Crystal Reports.
3. Speichern Sie die Berichts-Datei. Beachten Sie dabei die Namenskonvention für Berichts-Dateien, die in Abschnitt 1 beschrieben sind.
4. Öffnen Sie den Knowledge Store per WebDAV und kopieren Sie die Berichts-Datei in den Knowledge Store.
5. Wechseln Sie wieder zur Anwendung „Berichte“.
6. Erzeugen Sie einen neuen Bericht durch Drücken des Button „Neu“ in der Standardsymbolleiste.
7. Geben Sie dem Bericht einen Namen und eine Bezeichnung.

Hinweis:
Der Name des Berichts und der Berichts-Datei müssen zusammen passen. Siehe Abschnitt „Namen von Berichts-Dateien“.

8. Wechseln Sie zum Karteireiter „Dateien“ und legen Sie fest, ob die Berichts-Datei sprachabhängig ist oder nicht, und falls ja, für welche Sprache sie gilt.
9. Importieren Sie die Berichts-Datei durch Drücken des Buttons „Berichts-Dateien importieren“ in der Standard-Symbolleiste.
10. Geben Sie bei Bedarf auf dem Karteireiter „Parameter“ die zu verwendenden Logischen Datentypen an.
11. Speichern Sie den Bericht.

5.5.2          Berichts-Datei für einen Bericht verändern

1. Öffnen Sie die Anwendung „Berichte“.
2. Laden Sie den Bericht, den Sie verändern möchten.
3. Drücken Sie den Button „Berichts-Dateien exportieren“ in der Standardsymbolleiste. Wählen Sie in dem nun erscheinenden Fenster den Ordner im Knowledge Store aus, in den Sie die Berichts-Dateien speichern möchten.

• Alle Berichts-Dateien des Berichts werden im Knowledge Store gespeichert.

4. Öffnen Sie den Knowledge Store per WebDAV und kopieren Sie die Berichts-Dateien in einen Ordner auf Ihrem Computer.
5. Öffnen Sie die Berichts-Datei, die Sie verändern möchten, in Crystal Reports. bearbeiten Sie die Berichts-Datei entsprechend Ihren Wünschen und speichern Sie sie wieder.
6. Kopieren Sie die Berichts-Dateien zurück in den Knowledge Store.
7. Wechseln Sie wieder zur Anwendung „Berichte“.
8. Drücken Sie den Button „Berichts-Dateien importieren“ in der Standard-Symbolleiste. Wählen Sie in dem nun erscheinenden Fenster den Ordner im Knowledge Store aus, in dem die Berichts-Dateien abgelegt sind.

• Im Karteireiter „Parameter“ wird die Anzeige der verwendeten Parameter aktualisiert.

9. Speichern Sie den Bericht.

5.6               Anwendungsbezogene Aktionen

Die folgenden anwendungsbezogenen Aktionen stehen in der Anwendung „Berichte“ zur Verfügung:

• Berichtsvorlage herunterladen
• Berichts-Dateien importieren
• Berichts-Dateien exportieren
• Alle prüfen

5.6.1          Berichtsvorlage herunterladen

Lädt eine Vorlage für den Bericht auf Ihren Computer. Nach Drücken des Buttons erscheint ein Fenster, in dem Sie angeben können, ob Sie die Vorlage öffnen oder speichern möchten. Die Berichtsvorlage können Sie verwenden, um die Berichts-Datei für Ihren Bericht zu erstellen.

Hinweis:
Es wird mit Semiramis eine Standard-Berichtsvorlage ausgeliefert. Diese enthält unter anderem viele benutzerdefinierte Funktionen, die das Erstellen von Semiramis konformen Berichten ermöglichen. Details hierzu finden Sie in der Dokumentation „Berichte entwickeln“. Es ist nicht möglich eigene Vorlagen über diese Aktion zur Verfügung zu stellen. Wenn sie kunden- oder systemspezifische Vorlagen erstellen und verwenden möchten, so sollten sie diese direkt auf einem Windows-Netzlaufwerk für die entsprechenden Mitarbeiter zugänglich speichern. Da die aktuellen Versionen von Crystal Report ausschließlich direkt auf einem Windows-Dateisystem arbeiten können, ist diese die effektivste Vorgehensweise. Sofern zukünftige Versionen von Crystal Report auch direkt den WebDAV-Zugriff ermöglichen, können die Vorlagen (wie ja auch die fertigen Berichte) direkt im Knowledge Store von Semiramis abgelegt werden.

5.6.2          Berichts-Dateien importieren

Importiert Berichts-Dateien vom Knowledge Store ins System. Nach Drücken des Buttons erscheint ein Fenster, in dem Sie den Ordner angeben können, aus dem Sie die Berichts-Dateien importieren möchten. Es werden alle im Bericht definierten Berichts-Dateien importiert.

5.6.3          Berichts-Dateien exportieren

Exportiert die Berichts-Dateien des Berichts in den Knowledge Store. Nach Drücken des Buttons erscheint ein Fenster, in dem Sie das Verzeichnis angeben können, in das Sie die Berichts-Dateien exportieren möchten.

5.6.4          Alle prüfen

Prüft alle im System vorhandenen Berichte auf Fehler. Hierzu zählt z.B. die Verwendung nicht mehr vorhandener Logischer Datentypen in den Berichtsparametern oder inkompatible Änderungen an einem in den Berichts-Dateien verwendeten Business Object. Solche Fehler können durch das Einspielen von Softwareaktualisierungen entstehen und verhindern unter Umständen die korrekte Ausgabe des Berichts. Der erste fehlerhafte Bericht wird geladen und die Fehler werden angezeigt. Beachten Sie, dass diese Aktion auch Berichte vom Berichtstyp „Entwicklungsobjekt“ prüft. Diese Berichte können Sie nicht in der Anwendung Berichte, sondern nur in der Anwendung Entwicklungsobjekte korrigieren.