Freigeben über

Tipps und Beispiele

  • Artikel

Metrische Formel

Definieren Sie die Formel für die Metrik in einem textlichen Formular. Er kann aus vordefinierten Vorgängen bestehen.

Die einzelnen Vorgänge sind in zwei grundlegende Gruppen unterteilt:

  • Aggregationsvorgänge: Die Eingabe des Aggregationsvorgangs ist eine Reihe von Werten, für die der resultierende Wert berechnet wird (z. B. Durchschnitt, Maximum und mehr).

  • Skalare Operationen: Die Eingabe des skalaren Vorgangs ist ein oder mehrere Werte, für die der resultierende Wert berechnet wird (z. B. absoluter Wert der Zahl, Erhalt eines Teils der Steuer, und mehr).

Vorgänge können Konstanten verwenden, können mit unären oder binären Operatoren kombiniert werden (z.B. Addition, Subtraktion und mehr) oder verschachtelt werden.

Zu den skalaren Operationen gehören auch Vorgänge zur Ermittlung eines Wertes, der entweder direkt in Form eines Attributs oder in Form einer abgeleiteten Statistik (Ereignisdauer) vorliegt.

Einige Operatoren unterstützen auch die Angabe des Kontexts, für den der Vorgang ausgewertet wird. Dies ist wichtig für Aggregationsvorgänge, die Werte z. B. nur für eine bestimmte Aktivität oder für alle Aktivitäten oder Ereignisse aggregieren können. Der implizite Kontext, der sich aus dem metrischen Kontext oder dem Kontext des übergeordneten Vorgangs ergibt, wird ebenfalls unterstützt.

Eine metrische Formel kann einen der unterstützten Datentypen zurückgeben. Datentypen für bestimmte Formeln werden in diesem Artikel neben der Definition der Formelsyntax definiert.

Vorgänge der Aggregation

Aggregations Vorgänge sind die Grundlage jeder Metrik. Die am häufigsten verwendeten Aggregationsoperationen sind:

  • COUNT: Gibt die Anzahl der aggregierten Werte an (incl. COUNTIF, COUNTUNIQUE).
  • SUMME: Gibt die Summe der aggregierten Werte (incl. SUMIF) zurück.
  • AVG: Gibt den Durchschnitt der aggregierten Werte zurück.
  • MIN: Gibt das Minimum der aggregierten Werte zurück.
  • MAX: Gibt das Maximum der aggregierten Werte zurück.

Der freiwillige Parameter der Aggregation-Operationen ist der Kontext des Vorgangs und die skalare Operation zur Änderung des Eingabewerts. Die vollständige Liste der unterstützten Berechnungskontexte ist in Berechnungskontext beschrieben.

Skalare Vorgänge

Der Zweck skalarer Vorgänge besteht darin, einen Wert und seine Umwandlung in den gewünschten Zustand zu erhalten. Die derzeit unterstützten Vorgänge lassen sich in mehrere Typen unterteilen:

  • Mathematisch: Enthält Vorgänge zur Ermittlung des absoluten Wertes einer Zahl, Rundung und mehr.
  • Datum und Uhrzeit: Enthält Vorgänge in Zusammenhang mit einem Datum, darunter die Ermittlung eines Teils des Datums, das Zusammenzählen von Datumsangaben und mehr.
  • Zeichenfolge: Enthält Vorgänge in Zusammenhang mit Zeichenfolgendaten, darunter die Ermittlung von Teilzeichenfolgen, das Aufteilen von Zeichenfolgen und mehr.
  • Statistisch: Enthält Vorgänge zur Ermittlung verschiedener statistischer Werte wie Vorgangsanzahl, Vorgangswartezeiten und mehr.
  • Sonstiges: Enthält sonstige Vorgänge wie z. B. Vorgänge mit Zugriff auf Ereignisse, Vorgänge, abgeleitete Statistiken und mehr.

Attributname.

Wenn ein Attributname als Parameter für einen Vorgang verwendet wird, gibt es drei Möglichkeiten, wie Sie ihn referenzieren können:

  • Verwenden Sie den Attributnamen direkt (zum Beispiel Resource).

  • Verwenden Sie den GETVALUE("Attributname") Operator (z. B. GETVALUE("Resource")).

  • Verwenden Sie den verkürzten Attributnamen direkt (z. B. kann attribute "Resource ID" als ResourceID referenziert werden).

Das zweite Formular wird verwendet, wenn der Name des Attributs nicht der Benennungskonvention entspricht. Die Attributbenennungskonvention ist wie folgt definiert:

  • Der Attributname sollte mit einem Buchstaben oder einem Unterstrich beginnen.

  • Der Attributname darf nur Zeichen aus den folgenden Unicode-Standardklassen enthalten: Buchstabenzeichen (Lu, Ll, Lt, Lm, Lo oder Nl), Kombinationszeichen (Mn oder Mc), Dezimalziffernzeichen (Nd), Verbindungszeichen (Pc) oder Formatierungszeichen (Cf).

    Informationen zu den oben erwähnten Unicode-Zeichenklassen finden Sie in The Unicode Standard, Version 3.0, Abschnitt 4.5.

Das dritte Formular wird optional verwendet, wenn der Attributname die Namenskonvention erfüllt, aber auch Leerzeichen enthält. Anstatt das zweite Formular GETVALUE("attribute name") zu verwenden, können Sie die Leerzeichen entfernen und die verkürzte Version attributename verwenden. Beide Formulare sind gleichwertig.

Beispiele für VALIDe Attributnamen

  • DocumentCategory

  • DocCat

  • DocCat23

Beispiele für INVALIDE Attributnamen

  • Document.Category

  • Document Category

  • 23DocCat

Beispiele für metrische Formeln

Um die relative Dauer einer Aktivität in einer Zuordnung zu berechnen:

AVG (DURATION()) / AVG (VIEWCASES, DURATION())