Report Manager: Häufige Fragen und Probleme

Report erstellen

Über den Abfrage-Editor (empfohlen)

1. Navigieren Sie zu Extras > Report Manager > Reports > Neu
2. Titel und Kategorie angeben (Pflichtfelder)
3. Ausgabe-Attribute wählen — diese erscheinen als Spalten im Ergebnis
4. Bedingungen definieren — Attribut, Operator und Wert festlegen
5. Mit "Prüfen" den Report testen (zeigt maximal 25 Ergebnisse)
6. Speichern

Weitere Bedingungen über den +-Button hinzufügen. Verknüpfung mit UND oder ODER möglich.

Über den SQL-Editor

Für komplexere Anfragen steht der SQL-Editor zur Verfügung. Wichtig:

• Die erste Spalte muss immer die Objekt-ID sein: SELECT obj_main.isys_obj__id AS '__id__' ...
• Nach dem Wechsel zum SQL-Editor ist der Abfrage-Editor für diesen Report nicht mehr verfügbar

Empfehlung: Vor dem Wechsel zum SQL-Editor den Report duplizieren. So bleibt das Original im Abfrage-Editor bearbeitbar.

Abfrage-Editor vs. SQL-Editor

Verschachtelte Konditionen (UND/ODER)

Im Report Manager werden Bedingungen über graue Blöcke gruppiert:

• Jeder graue Block entspricht einer Klammer
• Bedingungen innerhalb eines Blocks werden gemeinsam ausgewertet
• Beispiel: (A UND B) ODER C — A und B sind in einem Block, C steht außerhalb

Berechtigungen

Der Report Manager hat ein eigenes Rechtemodell, das unabhängig von den CMDB-Berechtigungen funktioniert. Wichtig zu wissen:

• Wer einen Report ausführen darf, sieht alle Ergebnisobjekte — auch solche, auf die der Benutzer in der CMDB keinen Zugriff hat
• Die CMDB-Objektrechte werden im Report Manager nicht angewendet
• Der Zugriff wird über Report-Kategorien gesteuert: Unter Verwaltung > Berechtigungen > Report Manager kann festgelegt werden, welche Benutzer oder Gruppen Zugriff auf bestimmte Report-Kategorien haben

Verfügbare Report Manager Rechte:

Empfehlung: Sensitive Reports in eigene Kategorien verschieben und den Zugriff über die Kategorie-Berechtigungen einschränken.

Export-Formate

Reports können in folgenden Formaten exportiert werden:

• CSV — für Tabellenkalkulationen (Excel, LibreOffice)
• PDF — für Druckausgabe
• XML — für Datenaustausch
• TXT — Klartextausgabe

Häufige Probleme

Bericht ist leer trotz vorhandener Daten

Mögliche Ursachen:

• Geltungsbereich nicht zugewiesen: Für ISMS-/Suite-Berichte müssen Assets dem Geltungsbereich zugeordnet sein (Assetmanagement > Geltungsbereiche)
• Falsches Attribut: Die Kondition filtert auf ein falsches Attribut oder einen nicht existierenden Wert
• Leere Verknüpfungen: Die Option "Objekte mit leeren Verknüpfungen anzeigen" ist deaktiviert und Objekte ohne die abgefragte Beziehung werden ausgeblendet

Sortierung nach bestimmten Spalten nicht möglich

Einige Attribute (z.B. CMDB-Status, berechnete Felder) unterstützen keine Sortierung in der Datenbank-Abfrage.

Workaround: Report als CSV exportieren und in Excel/LibreOffice sortieren. Alternativ das SQL manuell um eine ORDER BY-Klausel erweitern.

SQL-Fehler beim Ausführen eines Reports

Symptom: You have an error in your SQL syntax...

Ursache: Änderungen an benutzerdefinierten Kategorien oder gelöschte Dialog-Werte nach Erstellung des Reports.

Lösung: Unter Verwaltung > Systemtools > Cache / Datenbank die Reports aktualisieren. Dies sollte auch nach jedem i-doit-Update durchgeführt werden.

Report über doppelte Seriennummern

Dies ist über den Abfrage-Editor nicht möglich. Verwenden Sie einen SQL-Report:

SELECT obj.isys_obj__title AS 'Objekttitel',
       model.isys_catg_model_list__serial AS 'Seriennummer'
FROM isys_obj obj
INNER JOIN isys_catg_model_list model
  ON obj.isys_obj__id = model.isys_catg_model_list__isys_obj__id
WHERE model.isys_catg_model_list__serial IN (
    SELECT isys_catg_model_list__serial
    FROM isys_catg_model_list
    WHERE isys_catg_model_list__serial IS NOT NULL
      AND isys_catg_model_list__serial != ''
    GROUP BY isys_catg_model_list__serial
    HAVING COUNT(*) > 1
)
ORDER BY model.isys_catg_model_list__serial;

Automatisierung

Reports per Cronjob exportieren

# Täglicher Export um 07:00 Uhr (Montag–Freitag), Report-ID 111
0 7 * * 1-5 /usr/bin/php /var/www/html/console.php report-export \
    -u admin -p admin \
    --reportId 111 \
    --exportPath /home/reports/

Report-Ergebnisse per E-Mail versenden

Über Verwaltung > Add-ons > Benachrichtigungen können reportbasierte Benachrichtigungen eingerichtet werden:

1. Neue Benachrichtigung vom Typ "Reportbasierte Benachrichtigung" erstellen
2. Den gewünschten Report als Domäne auswählen
3. Empfänger festlegen (Personen, Gruppen oder Kontakte mit bestimmter Rolle)
4. Schwellwert konfigurieren — ab wie vielen Ergebnissen die Benachrichtigung ausgelöst wird
5. Intervall festlegen (täglich, wöchentlich, monatlich)

Wichtig: Benachrichtigungen werden nur versendet, wenn der folgende CLI-Befehl regelmäßig per Cronjob ausgeführt wird:

sudo -u www-data php /var/www/html/console.php notifications-send \
    --user admin --password admin --tenantId 1

Ohne diesen Cronjob werden keine E-Mails versendet.

Eskalationsstufen

Durch mehrere Benachrichtigungen mit unterschiedlichen Schwellwerten und Empfängerkreisen lassen sich Eskalationsstufen abbilden:

• 90 Tage vorher: Information an das Management
• 60 Tage vorher: Information an die Teamleitung
• 30 Tage vorher: Information an den zuständigen Administrator

Objektgruppen aus Reports

Report-Ergebnisse können als Objektgruppen weiterverwendet werden:

• Statisch: Objekte aus dem Report-Ergebnis einmalig einer Objektgruppe zuweisen
• Dynamisch: Report-basierte Objektgruppe, die sich bei jeder Ausführung automatisch aktualisiert

Ausführliche Dokumentation: Report Manager | Benachrichtigungen