myCMDB Anwenderhandbuch

Über den Navigator können Auswertungen erstellt und in zwei verschiedenen Formaten ausgegeben werden.

Zuerst wird ein neuer Navigatorsatz angelegt.

Titel

Name der Auswertung. Unter diesem Namen Titel wird die Auswertung später z. B. in die Favoriten zum Aufruf eingebunden.

Öffentlich

Bei „Ja“ steht die Auswertung allen berechtigten User zum Aufruf zur Verfügung. Bei „Nein“ kann sie nur durch berechtigte Administratoren eingesehen werden.

SQL ohne Refid

Wenn über den Formularmanager SQL- Befehle eingegeben werden, die nicht die Refid des führenden Items beinhalten, muss diese Auswahl auf „Ja“ gesetzt werden. Wird der Formularmanager nicht benutzt oder beinhaltet das SQL- Statement die Refid des führenden Items, bleibt die Auswahl auf „Nein“ stehen.

Nach dem speichern kann über Zusatzfunktionen – Definition bearbeiten oder über den Button „Definition bearbeiten und Ergebnis anzeigen“ die Auswertung erstellt, angepasst oder ausgeführt werden.

Mit einem Klick auf den Button öffnet sich ein Popupfenster. Darin kann man nun zu Beginn das Basisitem für die Auswertung festlegen. Hierbei kann auf alle Itemtypen und myCMDB- Views zugegriffen werden.

Nach der Auswahl eines Items öffnet sich rechts im Fenster ein Selektionsbereich, ein Bereich für die Sortierung und die Diagrammfunktion, sowie einige Buttons zum Speichern, den Formularmanager und die Ausgabe. Während der Erstellung einer Auswertung sind die Buttons „Ergebnis prüfen“ und „Definition speichern“ von Interesse. Mit „Ergebnis prüfen“ kann jede Veränderung geprüft werden. Ist die Prüfung erfolgreich sollte der Fortschritt über „Definition speichern“ zwischengespeichert werden. Die weiteren Funktionen dieses Bereiches werden weiter unten beschrieben.

Ebenso nach der Auswahl des Basisitems erscheinen daneben zwei Checkboxen und darunter eine neue Auswahl „Verbindung“. Würde man sich jetzt das Ergebnis anzeigen lassen, würde der gesamte Bestand nicht in Einzelfeldern, sondern der Itemident der einzelnen Datenzeilen ausgegeben werden.

Hakt man die erste Checkbox („Anzeige Felder“ im Tooltip) an, bekommt man unter der Auswahlliste für das Basisitem eine Auswahl mit allen möglichen Feldern des Items oder der View. Daraus kann man nun die benötigten Felder in der gewünschten Reihenfolge auswählen. Nach jeder Feldauswahl erscheint darunter wieder die Auswahlliste zur Auswahl eines weiteren Feldes.

Per Default werden als Ergebnis immer nur aktive oder geplante Items angezeigt. Will man auch die beendeten Items angezeigt bekommen, hakt man zu diesem Item die zweite Checkbox an.

Nachdem die gewünschten Felder zum Basisitem ausgewählt wurden, kann man aus der Auswahl „Verbindung“ ein mit dem Basisitem verbundenes Item dazu lesen. In der Auswahl sind nur Itemtypen oder Views aufgelistet, die per Verbindungsdefinition mit dem Basisitem verbunden werden können.

Unter dem neu gewählten Item erscheint eine weitere Auswahl „Verbindung“. Links davon kommt eine weitere Checkbox (inner join) hinzu. Hakt man diese an, werden nur noch die Daten des übergeordneten Items (hier des Bestandes) angezeigt, die auch eine Verbindung mit dem untergeordneten Item (hier der Person) haben.

Durch Anhaken der jetzt mittleren Checkbox neben der Person, bekommt man wieder die Feldauswahl dazu angezeigt. Ansonsten wird der Itemident des Verbundenen Items in einer Spalte im Ergebnis ausgegeben.

Wählt man jetzt aus der leeren Auswahlliste „Verbindung“ ein weiteres Item aus, handelt es sich dabei um eine Verbindung zum Basisitem (hier Bestand) und nicht um eine Verbindung zu dem darüber gewählten Item (hier Person). Will man ein mit dem zuletzt gewählten Item (hier Person) verbundenes Item hinzulesen, klickt man auf das Plus- Icon vor Verbindung. Damit öffnet man eine neue Verbindungsebene die jetzt von diesem Item (hier Person) ausgeht.

Zu diesem Item kann nun wieder wie oben beschrieben eine Feldauswahl vorgenommen werden.

Insgesamt haben wir nun drei Verbindungsebenen definiert. Ebene 1 ist immer das Basisitem (hier Bestand). Ebene 2 (hier Person) sind alle Verbindungen mit dem Basisitem. Ebene 3 (hier Kommunikation) sind alle Verbindungen mit einem Item aus Ebene 2. Eine Ebene 4 würden nun Verbindungen zu Items der Ebene 3 (hier Kommunikation) enthalten. Dazu müsste man auf das Plus vor Verbindung des Items der Ebene 3 klicken. Soll ein weiteres verbundenes Item zu einem Item der Eben 2 dazu gelesen werden, wählt man dies aus der Auswahlliste „+-- Verbindung“ aus. Soll ein weiteres verbundenes Item zum Basisitem dazu gelesen werden, wählt man dies direkt aus der untersten Auswahlliste „Verbindung“ aus.

Mit einem Klick auf den Button „Ergebnis prüfen“ bekommt man die ersten 100 Zeilen der Auswertung im unteren Bereich des Popupfensters angezeigt

Hier kann man nun noch die Spaltenüberschriften und die Spaltenreihenfolge bearbeiten. Zum Ändern des Spaltennamens überschreibt man einfach den vorhandenen Namen. Um die Spaltenreihenfolge zu ändern, schiebt man eine Spaltenüberschrift einfach per Drag & Drop an die gewünschte Position. Mit einem Klick auf den Button „Definition speichern“ wird die Änderung übernommen.

Über den Selektionsbereich können Selektionen auf alle Felder der verwendeten Items definiert werden. Bei den Selektionsfeldern stehen dabei nicht nur die angezeigten Felder zur Verfügung. Es kann auf alle Felder des gewählten Items zugegriffen werden

Aus der Auswahlliste unter Selektion wählt man den gewünschten Itemtyp aus. Nach der Auswahl erscheint rechts davon eine neue Auswahlliste mit den Feldern des Items. Dort wählt man das gewünschte Feld aus. Es erscheint nun rechts davon eine Auswahlliste mit dem für die Selektion gewünschten Operanten. Nachdem dieser ausgewählt wurde erscheint rechts davon ein Eingabefeld, in das man den Selektionsbegriff eingeben kann.

Die meisten Operanten sind selbsterklärend. Auf einige Besonderheiten wird hier eingegangen:

wie / nicht wie:

Hier kann eine Suche mit Wildcards initiiert werden. Als Platzhalter fungiert der Asterisk (*) für beliebig viele Zeichen.

Bsp. für die Suche wie: Die Suche „A*“ gibt alle Datensätze aus, die mit einem „A“ beginnen. Die Suche „*haus*“ gibt alle Datensätze aus, die die Zeichenkette „haus“ beinhalten. Die Suche „nicht wie“ kehrt die Suchergebnisse um.

Innerhalb:

Dieser Operant wird i. d. R. für die Suche in Datumsfelder verwendet. Er entspricht einer Suche „>= A <= B“ Die Werte A und B weren mit Komma getrennt in das Suchfeld eingegeben. So gibt z. B. die Selektion auf das Datumsfeld „Beginn“ mit „01.01.2021,31.01.2021“ alle Daten aus die zwischen dem 01.01.2021 00:00:00 und dem 31.01.2021 00:00:00 beginnen.

Enthalten in:

Hiermit können mehrere gleich- Selektionen mit einer logischen oder- Verknüpfung aneinandergereiht. Die Selektionsmerkmale werden mit Komma getrennt in das Suchfeld eingetragen. So zeigt z. B. die Eingabe von „Notebook,Desktop“ für das Feld Typ alle Notebooks und Desktops an.

leer / nicht leer:

Bei der Auswahl eines der beiden Operanten werden alle Datensätze angezeigt, deren Feldinhalt leer (NULL) bzw. nicht leer (not NULL) ist. Wird bei diesen Operanten in das Eingabefeld dahinter ein Wert eingetragen, wird dieser nicht berücksichtigt.

Über die Auswahlfelder unter „Sortierung“ kein eine aufsteigend, hierarchische Sortierung über maximal sechs Datenfelder vorgenommen werden. Als Datenfelder stehen die zuvor definierten Felder der einzelnen Itemtypen oder Views zur Verfügung.

Aus der Auswahlliste unter Selektion wählt man den gewünschten Itemtyp aus. Nach der Auswahl erscheint rechts davon eine neue Auswahlliste mit den Feldern des Items. Dort wählt man das gewünschte Feld aus. Es erscheint nun rechts davon eine Auswahlliste mit dem für die Selektion gewünschten Operanten. Nachdem dieser ausgewählt wurde erscheint rechts davon ein Eingabefeld, in das man den Selektionsbegriff eingeben kann.

Die meisten Operanten sind selbsterklärend. Auf einige Besonderheiten wird hier eingegangen:

wie / nicht wie:

Hier kann eine Suche mit Wildcards initiiert werden. Als Platzhalter fungiert der Asterisk (*) für beliebig viele Zeichen.

Bsp. für die Suche wie: Die Suche „A*“ gibt alle Datensätze aus, die mit einem „A“ beginnen. Die Suche „*haus*“ gibt alle Datensätze aus, die die Zeichenkette „haus“ beinhalten. Die Suche „nicht wie“ kehrt die Suchergebnisse um.

Innerhalb:

Dieser Operant wird i. d. R. für die Suche in Datumsfelder verwendet. Er entspricht einer Suche „>= A <= B“ Die Werte A und B weren mit Komma getrennt in das Suchfeld eingegeben. So gibt z. B. die Selektion auf das Datumsfeld „Beginn“ mit „01.01.2021,31.01.2021“ alle Daten aus die zwischen dem 01.01.2021 00:00:00 und dem 31.01.2021 00:00:00 beginnen.

Enthalten in:

Hiermit können mehrere gleich- Selektionen mit einer logischen oder- Verknüpfung aneinandergereiht. Die Selektionsmerkmale werden mit Komma getrennt in das Suchfeld eingetragen. So zeigt z. B. die Eingabe von „Notebook,Desktop“ für das Feld Typ alle Notebooks und Desktops an.

leer / nicht leer:

Bei der Auswahl eines der beiden Operanten werden alle Datensätze angezeigt, deren Feldinhalt leer (NULL) bzw. nicht leer (not NULL) ist. Wird bei diesen Operanten in das Eingabefeld dahinter ein Wert eingetragen, wird dieser nicht berücksichtigt.

Über die Auswahlfelder unter „Sortierung“ kein eine aufsteigend, hierarchische Sortierung über maximal sechs Datenfelder vorgenommen werden. Als Datenfelder stehen die zuvor definierten Felder der einzelnen Itemtypen oder Views zur Verfügung.

Unter Diagramm kann ein Diagramm aufgrund maximal drei Merkmalen erstellt werden. Zuerst werden die Ausgabefelder festgelegt. Zur Auswahl stehen alle zuvor definierten Felder der einzelnen Itemtpen oder Views. Unter Format wird das Diagrammformat festgelegt. Es kann zwischen Balken, Linie, Kreis und Tacho unterschieden werden. Sind mehrere Datenfelder ausgewählt, werden diese bei einem Liniendiagramm als einzelne Linie Dargestellt. Bei allen anderen Diagramarten werden die Werte zusammengefasst. Unter Datum kann ein Datumsfeld ausgewählt werden. Hakt man die Checkbox „nur Grafik erstellen“ an, wird bei einem Klick auf „Ergebnis prüfen“ nur eine Grafik erstellt. Ohne diese Checkbox werden auch die ersten 100 Zeilen auch tabellarisch auf dem Bildschirm ausgegeben. Die Grafik kann über einen Link unter der Ergebniszeile aufgerufen werden.

Um das Gesamtergebnis auszugeben, klickt man auf den Button „komplett (csv) ausgeben“ oder „komplett (csv + pdf) ausgeben“. Es werden die entsprechenden Dateien generiert und können wie die Grafik über einen Link unter der Ergebniszeile aufgerufen werden. Wurde zu der Auswertung ein Formular über den Formulareditor erstellt, kann dieses mit einem Klick auf den Button „Formular (pdf) ausgeben“ generiert und über einen Link unter der Ergebniszeile aufgerufen werden.