Hoe gebruik ik de Formula Editor?

De Formula editor is een tool binnen Grades  die je kunt gebruiken om formules te maken voor Formula Grade Items of voor de Formula Grading System. 

Bekijk hier een video over de Formula Editor.

Hoe werkt de Formula Editor?

Gebruik de Formula Editor om een formule te definiëren die de waarde van een grade item berekent op basis van andere grade items. Wanneer je een formule maakt moet je aangeven welke grade items je in de formule wilt opnemen en de relaties daartussen. Een voorbeeld van een eenvoudige formule is een formule die de som van een aantal grade items berekent. Een meer gecompliceerde formule is een formule die de minimum- of maximumwaarde uit een reeks grade items laat vallen.

De Formula Editor is beschikbaar op de pagina New Item, Edit Item for Formula items, Edit Calculated Final Grade, Edit Adjusted Final Grade en voor de Formula grading system.

Open de Formula Editor

  1. op de Manage Grades pagina, klik op de naam van een formula grade item die wilt bereiken.
  2. Klik op Edit Using the Formula Editor.
Belangrijkste Grades Formula Editor onderdelen

1. Formulegebied

Het formulegebied is waar de formuletekst wordt weergegeven. Het gelijkteken (=) aan het begin van de formule kan niet worden verwijderd. Een cursor geeft je positie in de formule aan. Klik in het formulegebied om de cursor te plaatsen.


2. Cursor plaatsing

De cursorplaatsingspictogrammen worden gebruikt om de cursor vooruit en achteruit in de formule te verplaatsen. Je kunt de cursor ook verplaatsen door met je muis op de nieuwe locatie te klikken. Er zijn vier mogelijkheden:

  •  Verplaats de cursor naar het begin van de formule.
  •  Verplaats de cursor naar het einde van de formule.
  •  Verplaats de cursor één element terug.
  •  Verplaats de cursor één element vooruit.

3. Grade item parameters

Gebruik de Grade Item drop-down list om te zien welke grade items je als parameter in je formule kunt invoegen. Je kan Numeric, Pass/Fail, Selectbox, en Formula type grade items invoegen. Je kunt niet verwijzen naar het formula grade item dat je definieert (dit vermijdt een soort kringverwijzing of loop) of een eindcijfer.

Gebruik de Grade Item Value drop-down list om de waarden te bekijken die zijn gekoppeld aan de grade item dat je in de formule wilt gebruiken. Er zijn drie mogelijkheden:

  • Points Received: The grade the user achieved. E.g., 7 (out of 10 points).
  • Max Points: Het maximum aantal punten wat beschikbaar is voor de grade item. E.g., 10 points.
  • Percent: Het percentage dat de student heeft behaald. E.g., 70%.

Klik op Insert om de geselecteerde  grade parameter in de formule in te voegen.

Voeg een grade item parameter in een formula toe

  1. Selecteer een Grade Item.
  2. Selecteer de Grade Item Value die je wilt gebruiken in de berekening.
  3. Klik op Insert.


  • Voor de weighted system worden Category and Grade item weights genegeerd in de berekeningen van de formule.
  • Dropped grade items en bonus grade items worden op dezelfde manier berekend als andere grade items.

4. Functies

De Function drop-down list bevat een lijst met functies die je in je berekeningsformule kunt gebruiken::

  • MAX Berekent de maximale (grootste) waarde in een reeks waarden.
  • MIN Berekent de minimum (kleinste) waarde in een reeks waarden.
  • SUM Berekent de som (totaal) van een reeks waarden.
  • AVG Berekent het gemiddelde voor een set waarden door alle waarden op te tellen en te delen door het totale aantal waarden.
  • IF Werkt als een Boolean statement die de waarde retourneert die is ingesteld als true of als false. Je moet de voorwaarde (Boolean statement), true (then) waarde, en false (else)  waarde definiëren.If function example
  • NOT Werkt als een Boolean statement die de waarde retourneert die is ingesteld als true als de voorwaarde onwaar is en als onwaar als de voorwaarde waar is.

    Not function example

  • Je kunt functies in functies insluiten.
  • De Start, Next Term, en End opties worden gebruikt om elementen van een functie te definiëren:
    • Start: Start de functie die is geselecteerd in de Function drop-down list met een haakje open ({).
    • Next Term: Voegt een komma toe om grade items of onderdelen van een Boolean statement te scheiden.
    • End: Eindigt de functie met een haakje sluiten (}).

Voeg een functie in een formule toe.

  1. Selecteer een Function
  2. Klik op Start.
  3. Vul een parameter in.
  4. Klik op Next Term om nog een parameter toe te voegen of gebruik de numerieke toetsen en operators om een voorwaarde te definiëren.
  5. Klik op End als je klaar bent met het toevoegen van parameters en voorwaarden.

5. Numerieke toetsen en operators

Het rechtergedeelte van de formule-editor bevat een aantal operatoren en een numeriek toetsenbord om je formule samen te stellen. Deze operators worden meestal gebruikt in combinatie met ten minste één Grade Item.


6. Backspace en Clear

De Backspace en Clear opties kun je delen van je formule verwijderen om wijzigingen aan te brengen.

  • Backspace verwijdert het element links van de cursor.
  • Clear verwijdert de hele formule.

7. Cancel

De knop Cancel verlaat de Formule-editor zonder de wijzigingen op te slaan.


8. Insert

De knop Insert valideert de formule en past deze toe op het Grade Item of het eindcijfer waaraan je werkt. Als de formule ongeldig is, ontvang je een foutmelding en gaat de cursor naar het punt in de formule dat de fout heeft veroorzaakt. Het fouttype wordt in rood weergegeven boven de formule. 


9. Validate

De optie Validate controleert of de formule overeenkomt met de grammatica van de standaardformule. Als de formule geldig is, wordt een bevestigingsbericht weergegeven. Als de formule ongeldig is, ontvang je een foutmelding en gaat de cursor naar het punt in de formule dat de fout heeft veroorzaakt. Het fouttype wordt in rood weergegeven boven de formule. Zie Mogelijk foutmeldingen voor een lijst met mogelijke fouten.


10. Preview

Met de optie Preview kun je controleren hoe jouw formule de cijfers berekent voor de eerste tien gebruikers in de user list. Klik op Close als je klaar bent met het bekijken van de cijfers. Als je formule ongeldig is, kun je geen voorbeelden van cijfers bekijken.


Mogelijk foutmeldingen

Hieronder volgen enkele fouten die je kunt tegenkomen bij het gebruik van de formule-editor:


Foutmelding

Omschrijving

Voorbeeld 

Correctie

Unexpected [token_type]

Bijvoorbeeld, Unexpected operator

De formule bevat een functiecomponent op een onverwachte locatie

= 5=/1 

= (5+1)2 

Corrigeer de formule

= 5/1
= (5+1)*2

Unbalanced parentheses

De formule bevat een haakje openen of sluiten zonder een bijbehorend haakje

= 5+1)

verwijder haakje

= 5+ 1

Missing end of function

De formule bevat een niet-gesloten functie

= SUM{[Item1.Points], [Item2.Points]

Sluit de functie (voeg gekruld haakje toe, voeg het einde toe)



SUM{[Item1.Points], [Item2.Points]}

Unexpected function end

De formule bevat een sluithaakje voor een functie die geen betrekking heeft op een functie

= [Item1.Points]/2}

Verwijder gekruld haakje

= [Item1.Points]/2

Invalid number of operator parameters

De formule bevat een ongeldig aantal operatorparameters

= [Item1.Points] +

Voeg parameters toe of verwijder operator

= [Item1.Points] + [Item2.Points]

Invalid number of function parameters

De formule bevat een ongeldig aantal functieparameters

= SUM{}

= IF{[Item1.Points]<2,5}

Vul het juiste aantal parameters.
For SUM, at least 2
For IF, at least 3

Numeric value expected

Een Boolean statement of operator is ingevoerd in plaats van een numerieke waarde

= IF{5<2,1 OR 1,4}

= SUM{1 = 2,3,4}

Corrigeer parameters.

= IF {BOOLEAN, TRUE, FALSE}

= SUM {only numeric values...}

Boolean value expected

Een Boolean statement is niet ingevoerd voor een voorwaarde

= IF {MIN{4,5},100,0}

= NOT{4}

Vul Boolean in.
= IF {MIN{4,5} > 5, 100, 0}

Invalid terminal

De formule bevat een onjuist gebruikte terminal

= [Item1.Points] + 3.2.5

Verwijder de fouten.
= [Item1.Points] + 3.2
Example grade formulas

Scenario 1: Geef gebruikers die meer dan 75% hebben behaald op alle grade items in een categorie 100% voor de categorie.

= IF {MIN{[Week1.Percent],[Week2.Percent],[Week3.Percent]} < 75, 0, 100}


Scenario 2: Laat de laagste twee cijfers vallen in een set van drie cijfers

= SUM{[G1.PointsReceived],[G2.Points Received], [G3Points Received]} - MIN{[G1.PointsReceived],[G2.Points Received]} - IF{MIN{[G2.Points Received], [G3Points Received]} = MIN{[G1.PointsReceived],[G2.Points Received]}, MIN{[G1.PointsReceived],[G3.Points Received]}, MIN {[G2.PointsReceived],[G3.Points Received]}}


Scenario 3: Gebruikers die minder dan 6 ontvangen voor hun tussentijdse of eindexamen slagen niet.

= IF {MIN{[Midterm.Points Received],[Final.Points Received]} < 60, 0, SUM {[A1.Points Received],[A2.Points Received],[G1.Points Received],[G2.Points Received],[Midterm.Points Received],[Final.Points Received]}}


Video: Grades Formula Editor