Ein CMDB-Abfragetyp, der die Infrastruktur für CI-Klassen und optional Nicht-CMDB-Tabellen sowie die Beziehungen und Referenzen abfragt, die sie verbinden.
Vorbereitungen
Das Core UI-Plugin (com.glide.ui.ui16) muss aktiviert sein.
Erforderliche Rolle: cmdb_query_builder_read, um nur gespeicherte Abfragen anzuzeigen und auszuführen, und cmdb_query_builder (enthalten für itil, itil_admin und asset), um Abfragen zu erstellen und zu speichern, gespeicherte Abfragen zu ändern und Abfragen auszuführen.
Autorisierte Benutzer können eine von einem anderen Benutzer erstellte Abfrage aktualisieren und löschen.
Warum und wann dieser Vorgang ausgeführt wird
Erstellen Sie die Abfrage, indem Sie die CI-Klassen und Nicht-CMDB-Tabellen ziehen, die Sie in die Abfrage aufnehmen möchten. Dann werden sie als Knoten auf der Canvas abgelegt und Beziehungseigenschaften zwischen ihnen definiert. Sie können nach den Attributen eines beliebigen Knotens filtern, um die Ergebnisse auf einen bestimmten Satz von CIs dieser Klasse oder auf ein einzelnes bestimmtes CI einzugrenzen. Sie können auch die Eigenschaftsspalten auswählen, die in den Abfrageergebnissen angezeigt werden.
Während Sie schrittweise durch die Erstellung einer Abfrage geführt werden, werden Listenoptionen und andere Benutzeroberflächenelemente des CMDB-Abfragegenerators je nach Erfordernis Ihrer Auswahl dynamisch gefiltert.
Weitere Informationen zur Verwendung des Abfragegenerators finden Sie im Video „CMDB-Abfragegeneratorabfragen und -Berichte – Platform Analytics Academy ServiceNow Community “. Eine Schritt-für-Schritt-Anleitung zum Erstellen von CMDB-Abfragen im Abfragegenerator, einschließlich Abfragen mit Anwendungsservices, finden Sie unter Beispielabfragen.
Prozedur
-
Navigieren zu und klicken Sie auf CMDB-Abfragegenerator.
-
Führen Sie auf der Seite „ CMDB -Abfragegenerator“ einen der folgenden Schritte aus:
- Klicken Sie auf Neu erstellen. Geben Sie einen Namenein, wählen Sie CMDB-Abfrage als Abfragetypaus, und klicken Sie dann auf Erstellen.
- Klicken Sie auf ein Widget einer gespeicherten Abfrage, um mit dem Erstellen einer vorhandenen Abfrage fortzufahren. Gespeicherte Anfragen durchsuchen zuerst, falls nötig.
- Zeigen Sie auf die obere rechte Ecke eines gespeicherten Abfrage-Widgets, und klicken Sie auf das Symbol Abfrage duplizieren, um eine Kopie einer gespeicherten Abfrage zu bearbeiten. Der Standardname der neuen Abfrage enthält die Zeichenfolge 'copy'.
-
Auf der Canvas können Sie einen der folgenden Vorgänge ausführen:
- Fügen Sie der Abfrage CI-Klassen hinzu: Wählen Sie auf der Registerkarte CMDB-Klassen Klassen aus der Hierarchieliste aus, und ziehen Sie sie auf die Canvas.
Fügen Sie der Abfrage ein Anwendungsservice-CI hinzu: Wählen Sie auf der Registerkarte CMDB-Klassen die Anwendungsservice- Klasse aus der Hierarchieliste aus, und ziehen Sie sie auf die Canvas.
In den Eigenschaften des Anwendungsservice können Sie in der rechten Leiste Angehängte Knoten in Muster konvertieren auswählen, um Muster zwischen dem Anwendungsservice und anderen CMDB-Klassenknoten abzufragen. Bei der Abfrage eines Musters können die Knoten an beiden Enden der Musterverbindung eine beliebige Anzahl von Ebenen voneinander entfernt sein. Wenn Angehängte Knoten in Muster konvertieren nicht ausgewählt ist, stellt die Verbindung zwischen dem Anwendungsserviceknoten und anderen CMDB-Klassenknoten direkte Beziehungen dar.
- Fügen Sie der Abfrage Nicht-CMDB-Tabellen hinzu: Wählen Sie eine Tabelle aus der Liste Nicht-CMDB-Tabellen aus, und ziehen Sie sie auf die Canvas.
Hinweis: Eine Nicht-CMDB-Tabelle kann nicht der Startknoten in der Abfrage sein.
Fügen Sie Verbindungen (Beziehungen oder Muster für Anwendungsservices) zwischen zwei Knoten auf der Canvas hinzu:
- Klicken Sie beim ersten Knoten in der Verbindung auf das kleine Quadrat in der Mitte der rechten Seite.
- Klicken Sie auf dem zweiten Knoten in der Verbindung auf das kleine Quadrat in der Mitte der linken Seite, um die Verbindung herzustellen.
Tabelle : 1. Verbindungs-UI-Notationen
| Darstellung |
Beschreibung |
| Durchgezogene Linie |
Eine Beziehung in einer CMDB-Abfrage. |
| Rotes Sternchen in der Mitte der Verbindungslinie |
Informationen wie der Beziehungstyp fehlen, wodurch die Abfrage ungültig wird. |
| Ebenen:<n> Typen: oder ein<Reference type> Notation auf der Verbindungslinie |
Nach Bedarf: die Anzahl der Beziehungsebenen und die Anzahl der Beziehungstypen, die für die Verbindung enthalten sind. Oder ein Referenztyp für eine Beziehung, die einen Verweis darstellt. |
| Gestrichelte Linie |
Eine Musterverbindung zwischen einem Anwendungsserviceknoten und einem anderen Knoten. |
- Konfigurieren Sie in den Verbindungseigenschaften in der rechten Leiste die Beziehungseinstellungen (klicken Sie bei Bedarf auf die Verbindungslinie):
- Wählen Sie im Abschnitt „Beziehungsrichtung“ den übergeordneten Knoten aus (der untergeordnete Knoten wird automatisch angepasst).
- Legen Sie im Abschnitt „Beziehungsebenen“ die Ebene auf Beziehungen der ersten Ebene fest, wenn die CIs direkt verbunden sind. Oder bis zu Beziehungen der 2. Ebene, wenn die CIs entweder direkt oder indirekt über ein anderes CI verbunden sind.
Wählen Sie im Abschnitt „Beziehungstypen und zugehörige Elemente“ eine der beiden Optionen aus:
| Option |
Beschreibung |
| Keine Beziehungen |
Um eine Abfrage nach CIs ohne Beziehungsverbindung auszuwählen, z. B. Alle Tomcat WAR-CIs, die nicht mit einem Windows-Server verbunden sind. |
| Beziehungstypen hinzufügen |
Um spezifische oder beliebige Beziehungstypen auszuwählen. |
| Ein zugehöriges Element hinzufügen |
Um Abfragen nach zugehörigen CIs zwischen den Knoten durchzuführen. |
- Konfigurieren Sie die CI-Referenzspalte für eine Verbindung zu einer Nicht-CMDB-Tabelle: Wählen Sie in der rechten Leiste der Verbindungseigenschaften im Abschnitt „CI-Referenzspalte“ die Spalte mit einem Verweis auf ein CI aus der Liste CI-Referenzspalte verwenden aus. Wenn nur eine Option verfügbar ist, wird sie automatisch ausgewählt.
- Konfigurieren Sie das Muster zwischen einem Anwendungsserviceknoten, der mit der Option Angehängte Knoten in Muster konvertieren festgelegt ist, und einem Nicht-CMDB-Tabellenknoten: Wählen Sie Referenzfilter auf alle Knoten im Muster<table> anwenden aus, um die Abfrage auf das Anwendungsservice-CI selbst und die CIs anzuwenden innerhalb des Anwendungsservice.
- Filter einem Klassenknoten hinzufügen: Wenden Sie Filter an, um eine Klassenabfrage auf eine bestimmte Gruppe von CIs oder eine einzige spezifische CI einzugrenzen.
- Zeigen Sie auf den Knoten, dem Sie einen Filter hinzufügen möchten, und klicken Sie dann auf das Symbol Filter anwenden, das über dem Knoten angezeigt wird.
- Fügen Sie im Abschnitt Filter das Attribut und die zugehörigen Listenbedingungenhinzu.
- Schließen Sie den Abschnitt Filter.
Fügen Sie beispielsweise einen Filter für den Datenbankspeicherort hinzu, um Datenbanken in Seattle abzufragen.
Klicken Sie in der rechten Leiste auf Angewendete Filter, um alle Filter für jeden Knoten auf der Canvas anzuzeigen.
- Fügen Sie der Abfrage And/Or-Operatoren hinzu:
- Verbinden Sie einen Knoten mit zwei anderen Knoten.
- Klicken Sie auf das Feld Und, das in der Verbindungslinie angezeigt wird, um zwischen den Operatoren Und/Oder zu wechseln.
Beispielsweise ist C1 Tomcat WAR, C2 Linux-Server und C3 Windows-Server. Führen Sie eine Abfrage nach
allen Tomcat WAR-CIs durch, die entweder mit einem Linux-Server oder einem Windows-Server verbunden sind.
- Fügen Sie Eigenschaftsspalten für einen Knoten hinzu, die in den Abfrageergebnissen angezeigt werden sollen:
Hinweis: Für eine Beziehung enthalten die Abfrageergebnisse die Spalten parent, childund type. Sie können keine anderen Spalten aus der Tabelle [cmdb_rel_ci] hinzufügen.
- Klicken Sie im rechten Bereich auf Eigenschaften.
- Klicken Sie ein- oder zweimal auf einen Knoten, damit der Abschnitt „Berichtsspalten“ in der rechten Leiste angezeigt wird, und klicken Sie dann auf Spalten hinzufügen.
- Wählen Sie die Eigenschaften aus, und klicken Sie dann außerhalb der Eigenschaftenliste, um sie zu schließen.
- Erstellen Sie eine kombinierte Abfrage, indem Sie eine Service-Mapping-Abfrage in eine CMDB-Abfrage integrieren:
- Klicken Sie beim Erstellen einer CMDB-Abfrage in der linken Leiste auf Gespeicherte Serviceabfragen.
- Wählen Sie eine Service-Mapping-Abfrage, und ziehen Sie sie dann auf die Canvas.
Diese Abfrage gibt alle CIs zurück, die die CMDB-Abfrage erfüllen und in den von der
Service-Mapping-Abfrage zurückgegebenen Services enthalten sind.
- Fügen Sie ein Such-Tag hinzu, das dann als Suchkriterium für gespeicherte Abfragen verwendet werden kann:
- Klicken Sie oben auf der Canvas auf das Symbol Tags hinzufügen.
- Klicken Sie auf Tag hinzufügen, und geben Sie im Dialogfeld „ Abfrage-Tags “ eine oder mehrere Tag-Zeichenfolgen ein.
- Klicken Sie erneut auf das Symbol Tags hinzufügen, um das Dialogfeld Abfrage-Tags zu schließen.
-
Klicken Sie auf Speichern.
Zeigen Sie auf der Registerkarte Gespeicherte Abfragen auf ein gespeichertes Abfrage-Widget, und klicken Sie auf Abfrageinformationen. Abfragedetails wie Abfragetyp, Datum der letzten Aktualisierung, mit der Abfrage verknüpfte CMDB-Gruppen und Abfragezeitpläne werden angezeigt.
Nächste Maßnahme
Klicken Sie auf Ausführen.
Nur die ersten 100 Ergebnisse der Abfrage werden im Ergebnisbereich angezeigt.
- Klicken Sie auf Weitere Ergebnisse laden, um den nächsten Satz von 100 Ergebnissen anzuzeigen.
- Klicken Sie auf Alle Ergebnisse laden, um die restlichen Abfrageergebnisse anzuzeigen, bis zu der in der Systemeigenschaft glide.cmdb.query.max_results_limit angegebenen Anzahl (standardmäßig 10.000).
Klicken Sie auf ein CI, um das CI-Formular zu öffnen, und klicken Sie im CI-Formular auf Dashboard, um die CI-Integrität im CI- Dashboard anzuzeigen.
Hinweis:
- Stellen Sie sicher, dass die Eigenschaft glide.security.use_csrf_token auf „true“ festgelegt ist, damit alle Ergebnisse angezeigt werden können.
- Wenn Ebene auf Bis zu Beziehungen 2. Ebenefestgelegt ist, wird der Beziehungstyp nicht in den Abfrageergebnissen angezeigt.
- Wenn eine Abfrage ausgeführt wird, warten Sie, bis die Abfrage abgeschlossen ist oder eine Zeitüberschreitung auftritt, bevor Sie eine andere Abfrage öffnen oder ausführen.
- Einstellungendes Abfragegenerators ändern: Klicken Sie auf das
Symbol (Einstellungen), um das Dialogfeld Einstellungen des Abfragegenerators zu öffnen.
- Kopieren und teilen Sie die URL der gespeicherten Abfrage für Benutzer, die auf den CMDB-Abfragegenerator zugreifen können. Wenn Sie die freigegebene URL in ein neues Internetbrowser-Fenster eingeben, wird die gespeicherte Abfrage direkt im CMDB-Abfragegenerator geöffnet.
- Erstellen Sie Berichte im CMDB-Abfragegeneratoran.
- Erstellen Sie einen Zeitplan, um die Abfrage zu einem späteren Zeitpunkt auszuführen und die Ergebnisse per E-Mail an interessierte Parteien zu senden.
- Abfrageergebnisse exportieren:
Klicken Sie auf das Kontextmenü der Abfrageergebnisse und wählen Sie Exportieren aus. Auch wenn die Schaltfläche Weitere Ergebnisse laden sichtbar ist und darauf hinweist, dass zusätzliche Abfrageergebnisse vorhanden sind, werden nur die sichtbaren Ergebnisse exportiert.
- Exportieren und importieren Sie eine CMDB-Abfrage , um eine Abfragedefinition zwischen Instanzen zu portieren.
- Füllen Sie eine CMDB-Gruppe mit der gespeicherten Abfrage aus.
- Löschen Sie eine CMDB-Abfragean.