Datenabfrage über ein Objekt
Datenabfragen mit dem Abfragemodul Objekt erfolgen über die Objektschicht und somit unter vollständiger Berücksichtigung der Zugriffsrechte des Benutzers.
Tabelle 154: Eigenschaften für Datenquelle Objekt
Bezeichnung |
Bezeichnung der Datenquelle. |
Beschreibung |
Beschreibung der Datenquelle. |
Max. Zeilen |
Maximale Anzahl von Ergebniszeilen dieser Abfrage. Bei Überschreitung der Anzahl wird die Berichtserstellung abgebrochen. |
Übergeordnete Abfrage |
In einer übergeordneten Abfrage werden Einschränkungen der Datensätze getroffen, die an die nachfolgenden Abfragen weitergegeben werden, zum Beispiel alle Personen einer Abteilung. Parameter, die in der übergeordneten Abfrage definiert werden, sind auch in den nachfolgenden Abfragen verfügbar. |
Abfragemodul |
Wählen Sie das Abfragemodul Objekt. |
Tabelle |
Tabelle, aus der die Objekte ermittelt werden. |
Spalten |
Spalten der Tabelle, die im Bericht verwendet werden.
Einige Spalten werden immer in die Berichtdefinition übernommen und müssen hier nicht explizit angegeben werden. Dazu gehören:
- die Primärschlüsselspalten der Tabelle
- alle Spalten, die im Anzeigemuster der Tabelle verwendet werden
- Dummy-Spalten (_Display und _DisplayLong), die das Anzeigemuster der Tabelle liefern
- Für Fremdschlüsselspalten und Spalten mit einer Liste definierter Werte oder mehrsprachiger Eingabe, wird eine zusätzliche Spalte für den Anzeigewert erstellt (<Spalte>_Display).
|
Fremdschlüssel auflösen |
Setzen Sie diese Option, wenn in der <Spalte>_Display statt der UID der Anzeigewert des referenzierten Objektes zurückgegeben werden soll. |
Bedingung |
Bedingung zum Einschränken der Datensätze, die über die Tabelle geliefert werden. Die Bedingung formulieren Sie als gültige Where-Klausel für Datenbankabfragen. In der Bedingung 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 Spalten einer übergeordneten Abfrage:
@<Bezeichnung der übergeordneten Abfrage>.<Spalte der übergeordneten Abfrage> |
Sortierung |
Spalten der Tabelle, nach denen die Datenabfrage sortiert wird. |
Verwandte Themen
Datenabfrage über die Historie eines Einzelobjektes
Datenabfragen mit dem Abfragemodul Historie eines Einzelobjektes verwenden Sie um Berichte mit historische Verläufen über ein Einzelobjekt, beispielsweise eine einzelne Person, zu erstellen.
Tabelle 155: Eigenschaften für Datenquelle Historie eines Einzelobjektes
Bezeichnung |
Bezeichnung der Datenquelle. |
Beschreibung |
Beschreibung der Datenquelle. |
Max. Zeilen |
Maximale Anzahl von Ergebniszeilen dieser Abfrage. Bei Überschreitung der Anzahl wird die Berichtserstellung abgebrochen. |
Übergeordnete Abfrage |
In einer übergeordneten Abfrage werden Einschränkungen der Datensätze getroffen, die an die nachfolgenden Abfragen weitergegeben werden, zum Beispiel alle Personen einer Abteilung. Parameter, die in der übergeordneten Abfrage definiert werden, sind auch in den nachfolgenden Abfragen verfügbar. |
Abfragemodul |
Wählen Sie das Abfragemodul Historie eines Einzelobjektes. |
Objektschlüssel |
Der Objektschlüssel kann direkt oder per Parameter abgefragt werden. Parameter müssen Sie anschließend auf dem Tabreiter Parameter zum Bericht hinzufügen. Spalten einer übergeordneten Abfrage werden nach folgender Syntax angegeben:
<Name der übergeordneten Abfrage>.<Spalte der übergeordneten Abfrage> |
Min. Datum oder Zeitraum |
Mit dem minimalen Datum legen Sie den Zeitpunkt fest, ab dem die historischen Daten ermittelt werden. Sie können das Datum direkt oder über einen den Parameter festlegen. Per Parameter wird das minimale Datum aller betroffenen Einträge in den verbundenen History Database-Datenbanken ermittelt. Parameter müssen Sie anschließend auf dem Tabreiter Parameter zum Bericht hinzufügen. |
Spalten |
Spalten, für welche die Änderungen ermittelt werden. |
Fremdschlüssel auflösen |
Setzen Sie diese Option, wenn statt der UID der Anzeigewert des referenzierten Objektes zurückgegeben werden soll. |
Die Datenabfrage liefert folgende Spalten.
Tabelle 156: Spalten der Datenabfrage für die Historie eines Einzelobjektes
ChangeID |
Eindeutige Kennung (UID) der Aufzeichnung. |
ObjectKey |
Objektschlüssel der Aufzeichnung. |
ObjectUID |
Eindeutige Kennung (UID) des geänderten Objektes. |
User |
Name des Benutzers, der die Änderung veranlasst hat. |
ChangeTime |
Zeitpunkt der Änderung. |
ChangeType |
Änderungstyp (Insert, Update, Delete). |
Columnname |
Name der Spalte, deren Wert sich geändert hat. |
ColumnDisplay |
Anzeigename der Spalte, deren Wert sich geändert hat. |
OldValue |
Alter Wert der Spalte. |
OldValueDisplay |
Anzeigewert des alten Wertes. Nur wenn die Option Fremdschlüssel auflösen gesetzt ist. |
NewValue |
Neuer Wert der Spalte. |
NewValueDisplay |
Anzeigewert des neuen Wertes. Nur wenn die Option Fremdschlüssel auflösen gesetzt ist. |
Verwandte Themen
Datenabfrage über die Historie mehrerer Objekte
Datenabfragen mit dem Abfragemodul Historie mehrerer Objekte verwenden Sie um Berichte mit historische Verläufen über mehrere Objekte zu erstellen, die über ein zusätzliches Kriterium weiter eingeschränkt werden, beispielsweise alle Personen mit dem Nachnamen "Müller".
Tabelle 157: Eigenschaften für Datenquelle Historie mehrerer Objekte
Bezeichnung |
Bezeichnung der Datenquelle. |
Beschreibung |
Beschreibung der Datenquelle. |
Max. Zeilen |
Maximale Anzahl von Ergebniszeilen dieser Abfrage. Bei Überschreitung der Anzahl wird die Berichtserstellung abgebrochen. |
Übergeordnete Abfrage |
Wird nicht verwendet. |
Abfragemodul |
Wählen Sie das Abfragemodul Historie mehrerer Objekte. |
Tabelle |
Tabelle, aus der die Objekte ermittelt werden. |
Min. Datum oder Zeitraum |
Mit dem minimalen Datum legen Sie den Zeitpunkt fest, ab dem die historischen Daten ermittelt werden. Sie können das Datum direkt oder über einen den Parameter festlegen. Per Parameter wird das minimale Datum aller betroffenen Einträge in den verbundenen History Database-Datenbanken ermittelt. Parameter müssen Sie anschließend auf dem Tabreiter Parameter zum Bericht hinzufügen. |
Spalten |
Spalten, für welche die Änderungen ermittelt werden. |
Kriterien |
Spalte, der Tabelle und Wert, über die die ermittelten Objekte weiter eingeschränkt werden. Der Wert kann direkt oder als Parameter abgefragt werden. Parameter müssen Sie anschließend auf dem Tabreiter Parameter zum Bericht hinzufügen. |
Die Datenabfrage liefert folgende Spalten.
Tabelle 158: Spalten der Datenabfrage für die Historie eines Einzelobjektes
ChangeID |
Eindeutige Kennung (UID) der Aufzeichnung. |
ObjectKey |
Objektschlüssel der Aufzeichnung. |
ObjectUID |
Eindeutige Kennung (UID) des geänderten Objektes. |
User |
Name des Benutzers, der die Änderung veranlasst hat. |
ChangeTime |
Zeitpunkt der Änderung. |
ChangeType |
Änderungstyp (Insert, Update, Delete). |
Columnname |
Name der Spalte, deren Wert sich geändert hat. |
ColumnDisplay |
Anzeigename der Spalte, deren Wert sich geändert hat. |
OldValue |
Alter Wert der Spalte. |
OldValueDisplay |
Anzeigewert des alten Wertes. Nur wenn die Option Fremdschlüssel auflösen gesetzt ist. |
NewValue |
Neuer Wert der Spalte. |
NewValueDisplay |
Anzeigewert des neuen Wertes. Nur wenn die Option Fremdschlüssel auflösen gesetzt ist. |
Beispiel
Es soll die Historie aller Personen mit dem Nachnamen Müller erstellt werden. Die Berichtdaten können folgendermaßen definiert werden:
Tabelle: |
Person |
Min. Datum: |
MinDate |
Kriterien: Spalte |
Lastname |
Kriterien: Wert |
Müller |
Verwandte Themen
Datenabfrage über historische Zuordnungen
Datenabfragen mit dem Abfragemodul Historische Zuordnungen verwenden Sie um Berichte mit historische Verläufen von Zuweisungen zu Objekten, beispielsweise alle Rollenmitgliedschaften einer Person, zu erstellen. Das Abfragemodul wird sowohl für Abfragen über Fremdschlüssel-Beziehungen als auch über Zuweisungstabellen (M:N-Tabellen) und Child-Beziehungen eingesetzt.
Tabelle 159: Eigenschaften für Datenquelle Historische Zuordnungen
Bezeichnung |
Bezeichnung der Datenquelle. |
Beschreibung |
Beschreibung der Datenquelle. |
Max. Zeilen |
Maximale Anzahl von Ergebniszeilen dieser Abfrage. Bei Überschreitung der Anzahl wird die Berichtserstellung abgebrochen. |
Übergeordnete Abfrage |
In einer übergeordneten Abfrage werden Einschränkungen der Datensätze getroffen, die an die nachfolgenden Abfragen weitergegeben werden, zum Beispiel alle Personen einer Abteilung. Parameter, die in der übergeordneten Abfrage definiert werden, sind auch in den nachfolgenden Abfragen verfügbar. |
Abfragemodul |
Wählen Sie das Abfragemodul Historische Zuordnungen. |
Zuordnungsrichtung |
Zuordnungen, die im Bericht verwendet werden sollen. Zulässig sind die Werte Zuweisungen (CR & MN) und Referenzierte Objekte (FK). |
Tabelle |
Tabelle, über welche die Zuweisung erfolgt ist. |
Min. Datum oder Zeitraum |
Mit dem minimalen Datum legen Sie den Zeitpunkt fest, ab dem die historischen Daten ermittelt werden. Sie können das Datum direkt oder über einen den Parameter festlegen. Per Parameter wird das minimale Datum aller betroffenen Einträge in den verbundenen History Database-Datenbanken ermittelt. Parameter müssen Sie anschließend auf dem Tabreiter Parameter zum Bericht hinzufügen. |
Auswahlspalte |
Spalte der Tabelle, über die auf das Basisobjekt verwiesen wird. |
Auswahlwert |
Wert der Auswahlspalte kann direkt oder per Parameter abgefragt werden. Parameter müssen Sie anschließend auf dem Tabreiter Parameter zum Bericht hinzufügen. Spalten einer übergeordneten Abfrage werden nach folgender Syntax angegeben:
<Name der übergeordneten Abfrage>.<Spalte der übergeordneten Abfrage> |
Abzufragender Fremdschlüssel |
Fremdschlüsselspalte, um historische Zuordnungen zu erhalten. |
Deaktivierungsspalte |
Einige Tabellen enthalten Spalten mit denen ein Objekt deaktiviert werden kann, beispielsweise die Spalte AccountDisabled in der Tabelle ADSAccount. Geben Sie diese Spalten an, wenn im Bericht die Deaktivierung einer Zuweisung als Löschen und die Aktivierung als Einfügen aufgeführt werden soll. |
Zusätzliche Objektspalten |
Spalten der Tabelle, die zusätzlich im Bericht verfügbar sein sollen. |
Zusätzliche Kriterien |
Spalte, der Tabelle und Wert, zur weiteren Einschränkung des Basisobjektes. |
Die Datenabfrage liefert folgende Spalten.
Tabelle 160: Spalten der Datenabfrage über historische Zuordnungen
BaseKey |
Objektschlüssel des Basisobjektes der Zuweisung. |
BaseUID |
Eindeutige Kennung des Basisobjektes. |
ObjectKey |
Objektschlüssel der Zuweisung. |
DestinationKey |
Objektschlüssel des Zielobjektes der Zuweisung. |
DestinationUID |
Eindeutige Kennung des Zielobjektes. |
Display |
Anzeigewert des Zielobjektes. |
CreationUser |
Nutzer der die Zuweisung erstellt hat. |
CreationTime |
Zeitpunkt der Zuweisung. |
DeletionUser |
Nutzer, der die Zuweisung gelöscht hat. |
DeletionTime |
Zeitpunkt des Löschens. |
Type |
Nähere Spezifizierung der Zuweisung, beispielsweise Name der Zuweisungstabelle oder Zielsystemtyp. |
Origin |
Bitmaske zur Abbildung der Art der Zuweisung. |
OriginDisplay |
Anzeigename der Bitmaske zur Abbildung der Art der Zuweisung. |
Verwandte Themen