Textparameterkriterien

Wenn eine Abfrage von vielen Parametern abhängt, wird die Abfrage so lange angehalten, bis jeder einzelne Parameter aufgelöst wurde. Ein Parameter kann mitunter eine einfache Abfrage enthalten, die eine Zeichenfolge verkettet oder eine bedingte Auswertung durchführt. Diese Abfragen führen aber dennoch Netzwerkaufrufe an Dienste durch, die diese grundlegenden Vorgänge ausführen. Dadurch wird mehr Zeit benötigt, um einen Parameter in einen Wert aufzulösen. Dies führt zu langen Ladezeiten für komplexe Arbeitsmappen.

Mit Kriterientextparametern können Sie eine Reihe von Kriterien auf der Grundlage zuvor festgelegter Parameter definieren. Diese werden dann ausgewertet, um einen dynamischen Wert zu erhalten. Der Hauptvorteil der Verwendung von Kriterienparametern besteht darin, dass Kriterienparameter Werte auflösen können und einfache bedingte Vorgänge durchgeführt werden können, ohne dass ein Netzwerkaufruf erforderlich ist. Im folgenden Beispiel handelt es sich um einen Anwendungsfall mit Kriterienparametern.

Beispiel

Bedenken Sie folgende konditionale Abfrage:

Screenshot: die konditionale Abfrage.

let metric = dynamic({Counter});
print tostring((metric.object == 'Network Adapter' and (metric.counter == 'Bytes Received/sec' or metric.counter == 'Bytes Sent/sec')) or (metric.object == 'Network' and (metric.counter == 'Total Bytes Received' or metric.counter == 'Total Bytes Transmitted')))

Wenn der Benutzer sich auf das Objekt metric.counter konzentriert, sollte der Wert des Parameters isNetworkCounter grundsätzlich TRUE lauten, wenn der Parameter Counter den Wert Bytes Received/sec, Bytes Sent/sec, Total Bytes Received oder Total Bytes Transmitted aufweist.

Dies kann wie folgt in einen Kriterientextparameter übersetzt werden:

Screenshot: Kriterienbeispiel.

In der obigen Abbildung werden die Bedingungen von oben nach unten ausgewertet, und der Wert des Parameters isNetworkCounter nimmt den Wert derjenigen Bedingung an, die zuerst als TRUE ausgewertet wird. Alle Bedingungen bis auf die Standardbedingung (die else-Bedingung) können neu angeordnet werden, um das gewünschte Ergebnis zu erhalten.

Einrichten von Kriterien

  1. Beginnen Sie mit einer Arbeitsmappe mit mindestens einem vorhandenen Parameter im Bearbeitungsmodus.

    1. Wählen Sie Parameter hinzufügen>Parameter hinzufügen aus.
    2. Geben Sie im anschließend angezeigten Bereich für den neuen Parameter Folgendes ein:
      • Name des Parameters: rand
      • Typ des Parameters: Text
      • Erforderlich: checked
      • Daten abrufen aus: Query
      • Geben Sie print rand(0-1) im Abfrage-Editor ein. Dieser Parameter gibt einen Wert zwischen 0 und 1 aus.
    3. Wählen Sie Speichern aus, um den Parameter zu erstellen.

    Hinweis

    Der erste Parameter in der Arbeitsmappe zeigt die Registerkarte Kriterien nicht an.

    Screenshot: der erste Parameter.

  2. Wählen Sie in der Tabelle mit dem Parameter rand die Option Parameter hinzufügen aus.

  3. Geben Sie im daraufhin angezeigten Bereich für den neuen Parameter Folgendes ein:

    • Name des Parameters: randCriteria
    • Typ des Parameters: Text
    • Erforderlich: checked
    • Daten ausrufen aus: Criteria
  4. Ein Raster wird angezeigt. Wählen Sie Bearbeiten neben dem leeren Textfeld aus, um das Formular Kriterieneinstellungen zu öffnen. Eine Beschreibung der einzelnen Felder finden Sie im Formular Kriterieneinstellungen.

    Screenshot: das Formular Kriterieneinstellungen.

  5. Geben Sie die folgenden Daten ein, um die ersten Kriterien aufzufüllen, und wählen Sie dann OK aus:

    • Erster Operand: rand
    • Operator: >
    • Wert von: Static Value
    • Zweiter Operand: 0.25
    • Wert von: Static Value
    • Ergebnis ist: is over 0.25

    Screenshot: das ausgefüllte Formular Kriterieneinstellungen.

  6. Wählen Sie Bearbeiten neben der Bedingung Click edit to specify a result for the default condition aus, um die Standardbedingung zu bearbeiten.

    Hinweis

    Bei der Standardbedingung sollten mit Ausnahme der letzten Felder Value from und Result is alle Einstellungen deaktiviert sein.

  7. Geben Sie die unten aufgeführten Daten ein, um die Standardbedingung aufzufüllen, und wählen Sie dann OK aus.

    • Wert aus: statistischer Wert
    • Ergebnis ist: 0,25 oder darunter

    Screenshot: das ausgefüllte Standardformular Kriterieneinstellungen.

  8. Speichern Sie den Parameter.

  9. Klicken Sie in der Arbeitsmappe auf die Schaltfläche „Aktualisieren“, um den Parameter randCriteria in Aktion zu sehen. Der Wert basiert auf dem Wert von rand.

Formular Kriterieneinstellungen

Formularfelder BESCHREIBUNG
Erster Operand Dies ist eine Dropdownliste mit Namen von Parametern, die bereits erstellt wurden. Der Wert des Parameters wird auf der linken Seite des Vergleichs verwendet.
Betreiber Der Operator wird verwendet, um den ersten und den zweiten Operanden zu vergleichen. Es kann sich um eine numerische Auswertung oder um eine Zeichenfolgenauswertung handeln. Der Operator is empty deaktiviert Second operand, da nur First operand benötigt wird.
Wert aus Wenn Sie diese Option auf Parameter festlegen, wird eine Dropdownliste mit bereits erstellten Parametern angezeigt. Der Wert dieses Parameters wird auf der rechten Seite des Vergleichs verwendet.
Wenn Sie diese Option auf Static Value festlegen, wird ein Textfeld angezeigt, in das der Autor einen Wert für die rechte Seite des Vergleichs eingeben kann.
Zweiter Operand Es handelt sich entweder um ein Dropdownmenü mit erstellten Parametern oder um ein Textfeld, abhängig von der obigen Auswahl für Value from.
Wert aus Wenn Sie diese Option auf Parameter festlegen, wird eine Dropdownliste mit bereits erstellten Parametern angezeigt. Der Wert dieses Parameters wird für den Rückgabewert des aktuellen Parameters verwendet.
Bei Festlegung auf Static Value:
- Ein Textfeld wird angezeigt, in dem Sie einen Wert für das Ergebnis eingeben können.
- Sie können zudem andere Parameter dereferenzieren, indem Sie geschweifte Klammern um den Parameternamen verwenden.
- Es ist möglich, mehrere Parameter zu verketten und eine benutzerdefinierte Zeichenfolge zu erstellen, zum Beispiel: „{paramA}, {paramB}, und eine Zeichenfolge.“

Bei Festlegung auf Expression:
- Es wird ein Textfeld angezeigt, in das der Autor einen mathematischen Ausdruck eingeben kann, der als Ergebnis ausgewertet wird.
- Wie im Fall von Static Value können auch in diesem Textfeld mehrere Parameter dereferenziert werden.
- Wenn der Parameterwert, auf den im Textfeld verwiesen wird, keine Zahl ist, wird er als Wert 0 behandelt.
Ergebnis ist Es handelt sich entweder um ein Dropdownmenü mit erstellten Parametern oder um ein Textfeld, abhängig von der obigen Auswahl für Value from. Das Textfeld wird als Endergebnis für dieses Formular mit Kriterieneinstellungen ausgewertet.