Delen via

Tips en voorbeelden

  • Artikel

Metrische formule

Definieer de metrische formule in een tekstformulier. De formule kan bestaan uit vooraf gedefinieerde bewerkingen.

De afzonderlijke bewerkingen zijn onderverdeeld in twee basisgroepen:

  • Aggregatiebewerkingen: de invoer voor de aggregatiebewerking bestaat uit een reeks waarden waarvoor de resulterende waarde wordt berekend (bijvoorbeeld gemiddeld, maximum en meer).

  • Scalaire bewerkingen: de invoer voor de scalaire bewerking bestaat uit een of meer waarden waarvoor de resulterende waarde wordt berekend (bijvoorbeeld de absolute waarde van het getal, het verkrijgen van een deel van de belasting en meer).

Bewerkingen kunnen constanten gebruiken, kunnen worden gecombineerd met unaire of binaire operatoren (bijvoorbeeld optellen, aftrekken en meer) of worden genest.

Scalaire bewerkingen omvatten ook bewerkingen om een waarde te verkrijgen, ofwel direct beschikbaar in de vorm van een kenmerk of in de vorm van afgeleide statistieken (gebeurtenisduur).

Sommige bewerkingen ondersteunen ook het specificeren van de context waarvoor de bewerking wordt geëvalueerd. Dit is belangrijk voor aggregatiebewerkingen die waarden kunnen aggregeren, bijvoorbeeld alleen voor een specifieke activiteit of voor alle activiteiten of gebeurtenissen. De impliciete context die voortvloeit uit de metrische context of de bovenliggende bewerkingscontext wordt ook ondersteund.

Een metrische formule kan een van de ondersteunde gegevenstypen retourneren. Gegevenstypen voor specifieke formules worden in dit artikel gedefinieerd naast de definitie voor de formulesyntaxis.

Aggregatiebewerkingen

Aggregatiebewerkingen zijn de basis van elke meetwaarde. Dit zijn de meest gebruikte aggregatiebewerkingen:

  • COUNT: retourneert het aantal geaggregeerde waarden (incl. COUNTIF, COUNTUNIQUE).
  • SUM: retourneert de som van de geaggregeerde waarden (incl. SUMIF).
  • AVG: retourneert het gemiddelde van de geaggregeerde waarden.
  • MIN: retourneert het minimum van de geaggregeerde waarden.
  • MAX: retourneert het maximum van de geaggregeerde waarden.

De vrijwillige parameter van de aggregatiebewerkingen is de bewerkingscontext en de scalaire bewerking voor wijziging van de invoerwaarde. De volledige lijst met ondersteunde berekeningscontexten wordt beschreven in Berekeningscontext.

Scalaire bewerkingen

Het doel van scalaire bewerkingen is om één waarde en de transformatie ervan in de gewenste status te plaatsen. Momenteel ondersteunde bewerkingen kunnen worden onderverdeeld in verschillende typen:

  • Wiskundig: omvat bewerkingen om de absolute waarde te krijgen van een getal, afronding, enzovoort.
  • Datum en tijd: omvat bewerkingen om met de datum te werken, bijvoorbeeld een deel van de datum ophalen, datums optellen, enzovoort.
  • Tekenreeks:: omvat bewerkingen om met tekenreeksgegevens te werken, zoals het krijgen van een subtekenreeks, het splitsen van tekenreeksen, enzovoort.
  • Statistisch: omvat bewerkingen om verschillende statistieken te krijgen, zoals het aantal uitvoeringen, de wachttijd voor uitvoeringen, enzovoort.
  • Overig: omvat andere bewerkingen, bijvoorbeeld bewerkingen om toegang te krijgen tot gebeurtenis-, uitvoerings- en afgeleide statistieken, enzovoort.

Kenmerknamen

Als een kenmerknaam wordt gebruikt als parameter voor de bewerking, zijn er drie manieren om ernaar te verwijzen:

  • Gebruik de kenmerknaam rechtstreeks (bijvoorbeeld Resource).

  • Gebruik de bewerking GETVALUE("kenmerknaam") (bijvoorbeeld GETVALUE("Resource")).

  • Gebruik de verkorte kenmerknaam rechtstreeks (er kan bijvoorbeeld naar attribute "Resource ID" worden verwezen als ResourceID).

De tweede vorm wordt gebruikt wanneer de kenmerknaam niet voldoet aan de naamgevingsconventie. De naamgevingsconventie voor kenmerken is als volgt gedefinieerd:

  • De kenmerknaam moet beginnen met een letter of een onderstrepingsteken.

  • De kenmerknaam mag alleen tekens bevatten uit de volgende Unicode-standaardklassen: letterteken (Lu, Ll, Lt, Lm, Lo of Nl), combinatieteken (Mn of Mc), decimaal cijferteken (Nd), verbindend teken (Pc ) of opmaakteken (Cf).

    Zie De Unicode Standard, versie 3.0 in sectie 4.5 voor meer informatie over de hierboven genoemde Unicode-tekenklassen.

De derde vorm wordt optioneel gebruikt wanneer de kenmerknaam voldoet aan de naamgevingsconventie, maar ook spaties bevat. In plaats van het tweede vorm GETVALUE("attribute name") te gebruiken, is het mogelijk om spaties te verwijderen en de verkorte versie te gebruiken, attributename. Beide vormen zijn gelijkwaardig.

Voorbeelden van GELDIGE kenmerknamen

  • DocumentCategory

  • DocCat

  • DocCat23

Voorbeelden van ONGELDIGE kenmerknamen

  • Document.Category

  • Document Category

  • 23DocCat

Voorbeelden van metrische formules

Zo berekent u de relatieve duur van een activiteit in een overzicht:

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