Erstellung von Parametern für Ihre Dashboards

Erstellen Sie Parameter, die Sie in allen Widgets mit einer AQL-oder generischen API-Datenquelle wie Time Period und Time Valueverwenden können. Die Verwendung gängiger Parameter und Standardwerte kann die Zeit reduzieren, die zum Erstellen oder Bearbeiten einzelner Abfragen für Ihre Widgets benötigt wird.

Vorbereitende Schritte

Parameter werden innerhalb der geschweiften Klammern angezeigt, wie im folgenden AQL-Beispiel:

Da geschweifte Klammern auch in einer AQL-Anweisung innerhalb einer Zeichenfolge in Anführungszeichen (ein Zeichenfolgenliteral zwischen Anführungszeichen) verwendet werden, müssen Sie einen umgekehrten Schrägstrich (\) als Escape-Zeichen vor der öffnenden geschweiften Klammer innerhalb einer Zeichenkette in Anführungszeichen verwenden. Diese Syntax stellt sicher, dass die Zeichenkette nicht als Parameter interpretiert wird und keine falschen Abfrageergebnisse verursacht. Wenn Sie einen umgekehrten Schrägstrich in einer Zeichenkette in Anführungszeichen haben, fügen Sie einen zusätzlichen umgekehrten Schrägstrich als Escape-Zeichen hinzu.

1. Klicken Sie in einem Dashboard, das AQL-basierte oder generische API-basierte Widgets wie das Dashboard Ereignisse und Datenflussmesswerte enthält, auf das Dashboardmenü (Weitere Optionen > Parameter verwalten).
   Im Fenster Parameterwerte verwalten werden die Parameter angezeigt, die bereits in Ihrem Arbeitsbereich erstellt wurden. Wenn Parameter über Standardwerte verfügen, werden sie in der Spalte Standardwert aufgelistet. Die Spalte Anzahl der Vorkommen gibt die Anzahl der Widgets an, die jeden Parameter verwenden. Fahren Sie mit der Maus über die Zahl, um zu sehen, welche Widgets den Parameter verwenden.
2. Klicken Sie zum Festlegen eines Standardwerts für einen Parameter auf das Symbol Weitere Optionen , geben Sie den Standardwert in das Feld ein und klicken Sie anschließend auf Speichern.
   Hinweise:

   • Diese Aktion legt den Standardwert für jedes Widget fest, das den Parameter verwendet, und die Karte Parameter wird automatisch aktualisiert. Alternativ können Sie einen Wert für den Parameter in bestimmten Widgets hinzufügen.
   • Wenn Sie den Standardwert für einen Parameter ändern, ändern Sie den Wert überall dort, wo der Parameter in Ihrem Arbeitsbereich verwendet wird, außer in erweiterten oder angehefteten Dashboards und Widgets. Wenn Sie den Wert nicht als Standardwert festlegen, gilt die aktualisierte Änderung nur für die aktuelle Sitzung. Wenn Sie den Wert jedoch als Standardwert festlegen, verwendet der aktuelle Sitzungswert diesen Wert ebenfalls.
   • Der vordefinierte Parameter SYSTEM:username gibt den Benutzernamen des angemeldeten Benutzers zurück. Systemparameter sind schreibgeschützt und Sie können den Standardwert nicht ändern.
   • Der vordefinierte Parameter SYSTEM:timerange stellt den Zeitselektorwert dar.
3. Zum Hinzufügen eines Parameters zu Ihrem Arbeitsbereich klicken Sie auf Hinzufügen, geben Sie dem Parameter einen Namen und einen Standardwert und klicken Sie anschließend auf Speichern.
4. Bevor Sie einen Parameter löschen, überprüfen Sie, dass er zu keinem Widgets gehört, indem Sie den Mauszeiger über die Nummer bewegen, um die Namen der Widgets anzuzeigen, die den Parameter verwenden. Nachdem Sie den Parameter aus diesen Widgets entfernt haben, können Sie auf Löschen klicken.
5. Klicken Sie auf Zurück zum Dashboard , um zur Hauptansicht zurückzukehren und Ihre Arbeit fortzusetzen.