HINWEIS: Berichte mit historischen Datenänderungen werten Datenänderungen aus, die sich in einer One Identity Manager History Database befinden. Ist die One Identity Manager History Database über eine Kennung im TimeTrace der -Datenbank eingebunden, muss die Anmeldung am Report Editor über einen Anwendungsserver erfolgen, für den diese Kennung in der Konfigurationsdatei (web.config) eingetragen ist. Ausführliche Informationen zur Verbindung zur One Identity Manager History Database über Anwendungsserver und die erforderliche Konfiguration finden Sie im One Identity Manager Administrationshandbuch für betriebsunterstützende Aufgaben.
Berichte erstellen und bearbeiten Sie im Programm Report Editor. Berichte werden in der Datenbanktabelle DialogReport abgelegt. Die Erstellung eines Berichtes beinhaltet die folgenden Schritte:
-
Definieren der Berichtseigenschaften, Datenquellen und Berichtsparameter
-
Entwerfen des Berichtsformulars mit dem Reportdesigner
Standardmäßig werden mit dem One Identity Manager bereits definierte Berichte mitgeliefert, die während einer Schemainstallation automatisch angepasst werden. Sind kundenspezifischen Anpassungen an den mitgelieferten Berichten erforderlich:
-
Erstellen Sie eine Kopie des Berichtes.
-
Bearbeiten Sie die benötigten Berichtseigenschaften.
-
Verwenden Sie im Weiteren die kundenspezifische Version des Berichtes.
Beim Einfügen oder Kopieren eines Berichtes wird zunächst der Eigenschaftendialog geöffnet, über welchen Sie die allgemeinen Daten zum Bericht, die notwendigen Datenquellen sowie eventuelle Parameter für die Berichtdefinition erfassen. Anschließend wird im Bearbeitungsbereich mit dem Reportdesigner eine neues Berichtsformular erstellt. Dieses bildet die Grundlage für den Entwurf des Berichtes. Über die Werkzeugpalette des Reportdesigners können Sie die gewünschten Steuerelemente auf dem Berichtsformular platzieren.
HINWEIS: Für den Entwurf der Berichte sollten Sie die Online-Hilfe zu StimulReport.Net der Firma Stimulsoft (www.stimulsoft.com) als Grundlage verwenden.
Um die einen neuen Bericht zu erstellen
Um einen Bericht zu kopieren
-
Wählen Sie im Report Editor den Bericht in der Berichtliste und wählen Sie den Kontextmenüeintrag Kopieren.
Es wird eine neuer Bericht erstellt und der Eigenschaftendialog zur Bearbeitung angezeigt. Die Eigenschaften des neuen Berichtes werden aus dem Originalbericht übernommen.
Um einen Bericht zu bearbeiten
-
Wählen Sie im Report Editor den Bericht in der Berichtliste und öffnen Sie den Bericht per Maus-Doppelklick oder über den Kontextmenüeintrag Bearbeiten.
Das Berichtsformular wird im Reportdesigner geöffnet.
-
Um den Eigenschaftendialog zu öffnen, wählen Sie anschließend den Menüeintrag Bericht > Bearbeiten.
Um die Berichtseigenschaften zu bearbeiten ohne den Bericht im Reportdesigner zu laden
HINWEIS: Nachdem Sie einen Bericht angepasst haben, können Sie ein Änderungskennzeichen festlegen, mit dem der Bericht gekennzeichnet wird. Diese Änderungskennzeichen werden im Database Transporter bei der Erstellung eines Kundentransportpaketes als Exportkriterium angeboten.
Detaillierte Informationen zum Thema
Um die allgemeinen Berichteigenschaften zu bearbeiten
-
Öffnen Sie den Bericht im Report Editor.
-
Wählen Sie im Eigenschaftendialog den Tabreiter Eigenschaften.
-
Bearbeiten Sie die allgemeinen Eigenschaften.
-
Speichern Sie die Änderungen.
Tabelle 149: Allgemeine Eigenschaften eines Berichtes
Bezeichnung |
Bezeichnung des Berichtes. Kennzeichnen Sie kundenspezifische Berichte mit dem Präfix CCC_. |
Anzeigename |
Anzeigename des Berichtes. Der Anzeigename steht bei der Erstellung eines Berichtes als ReportAlias zu Verfügung und kann beispielsweise zur Bildung des Berichttitels oder des Dateinamens beim Exportieren eines Berichtes im Webfrontend verwendet werden. Übersetzen Sie den eingegebenen Text über die Schaltfläche .
Der Anzeigename eines Berichtes kann Variablen enthalten, zulässig sind Systemvariablen sowie die Berichtsparameter. Die Übergabe der Variablen erfolgt mittels Prozentzeichen.
Beispiel:
Name des Berichtes %Variable% |
Max. Laufzeit [Sekunden] |
Maximale Anzahl Sekunden, die für die Generierung des Berichtes zur Verfügung stehen. Bei Überschreitung der Zeit wird die Generierung des Berichtes abgebrochen. |
Beschreibung |
Beschreibung des Berichtes. Übersetzen Sie den eingegebenen Text über die Schaltfläche . |
Filterkriterium |
Filterkriterium für die Anzeige der Berichte im Webfrontends. |
Basistabelle |
Basistabelle des Berichtes. |
Kategorie |
Kategorie dient zur Klassifizierung von Berichten. Zulässige Werte sind die Kategorien Common, Mail, Attestation und Dashboard. |
Präprozessorbedingung |
Berichte können Sie mit einer Präprozessorbedingung versehen. Damit ist ein Bericht nur verfügbar, wenn die Präprozessorbedingung erfüllt ist. |
Benutzerdefinierte Felder > Freies Feld Nr. 01 ... Freies Feld Nr. 10 |
Zusätzliche unternehmensspezifische Informationen. Die Anzeigenamen, Formate und Bildungsregeln für die Eingabefelder können Sie mit dem Designer an Ihre Anforderungen anpassen. |
Erweiterte Eigenschaften > Bericht |
UID, unter welcher der Bericht in der Datenbank abgelegt ist. |
Verwandte Themen
Für jeden Bericht müssen Sie eine Datenquelle erstellen aus der die darzustellenden Daten des Berichtes ausgelesen werden. In der Regel genügt eine Datenquelle für einen Bericht, Sie können aber mehrere Datenquellen pro Bericht definieren. Während der Bearbeitung einer Datenquelle können Sie das resultierende Ergebnis prüfen.
Um eine Datenquelle zu bearbeiten
-
Öffnen Sie den Bericht im Report Editor.
-
Wählen Sie im Eigenschaftendialog den Tabreiter Datenquelle.
-
Wählen Sie in der Liste Vorhandene Datenquellen die Datenquelle.
- ODER -
Klicken Sie die Schaltfläche Hinzufügen.
Eine neue Datenquelle wird erstellt.
-
Bearbeiten Sie die Eigenschaften der Datenquelle.
-
Speichern Sie die Änderungen.
Um eine Datenabfrage zu testen
-
Öffnen Sie den Bericht im Report Editor.
-
Wählen Sie im Eigenschaftendialog den Tabreiter Datenquelle.
-
Wählen Sie in der Liste Vorhandene Datenquellen die Datenquelle.
-
Klicken Sie die Schaltfläche neben der Auswahlliste Abfragemodul.
Das Ergebnis einer Datenquelle wird in einem separaten Dialogfenster geöffnet.
HINWEIS: Beim Kopieren der Datenabfrage in die Zwischenablage wird eine Datenbankabfrage in SQL Syntax generiert, die Sie mit einem geeigneten Programm zur Ausführung von SQL Abfragen in der Datenbank ausführen können. Um die Datenabfrage zu kopieren, verwenden Sie die Schaltfläche neben der Auswahlliste Abfragemodul.
Um eine Datenquelle zu löschen
-
Öffnen Sie den Bericht im Report Editor.
-
Wählen Sie im Eigenschaftendialog den Tabreiter Datenquelle.
-
Wählen Sie in der Liste Vorhandene Datenquellen die Datenquelle.
-
Klicken Sie die Schaltfläche Löschen.
-
Speichern Sie die Änderungen.
Detaillierte Informationen zum Thema
Verwandte Themen
Datenabfragen mit dem Abfragemodul SQL erfolgen ohne Überprüfung der Zugriffsberechtigungen der Benutzer direkt auf der Datenbank. Das bedeutet, hat ein Benutzer auf eine der verwendeten Spalten keine Berechtigungen, wird die Spalte im Bericht trotzdem angezeigt.
Tabelle 150: Eigenschaften für Datenquelle SQL
Bezeichnung |
Bezeichnung der Datenquelle. |
Beschreibung |
Beschreibung der Datenquelle. |
Max. Zeilen |
Maximale Anzahl von Ergebniszeilen dieser Abfrage.
HINWEIS: Es wird maximal diese Anzahl an Ergebnissen ermittelt und im Bericht angezeigt auch wenn die Anzahl überschritten werden sollte. Im Standard wird keine Fehlermeldung oder Hinweismeldung ausgegeben. Eventuelle Meldungen müssen im Bericht kundenspezifisch implementiert werden. |
Übergeordnete Abfrage |
Wird nicht verwendet. |
Abfragemodul |
Wählen Sie das Abfragemodul SQL. |
Abfrage |
Vollständige Datenbankabfrage in SQL-Syntax. Die Abfrage muss alle Spalten enthalten, die im Bericht verwendet werden. In der Abfrage können Sie SQL Parameter verwenden. Diese Parameter müssen Sie anschließend auf dem Tabreiter Parameter zum Bericht hinzufügen.
Syntax für Parameter:
@<Parametername>
Syntax für Parameter vom Datentyp Date und einem Wertebereich (Zeitraum von bis):
@<Parametername>Start
@<Parametername>End
Beispiel für die Verwendung in der SQL-Abfrage:
and StartDate between @<Parametername>Start and @<Parametername>End |
Beispiel:
Die Abfrage soll die Personen (Tablle Person) liefern die einer Abteilung zugeordnet sind. Die Abteilung (UID_Department) wird über den Objektschlüssel (XObjektKey) ermittelt. Dieser wird als Parameter an den Bericht übergeben. Abgefragt werden Vorname (Firstname) und Nachname (Lastname) der Person sowie der Name der Abteilung (Departmentname).
Select Firstname, Lastname, Departmentname
from person join Department
on person.uid_Department = department.uid_Department
where Department.XObjectKey = @ObjectKeyBase
Verwandte Themen