Rekenen en Vergelijkingen: verschil tussen versies

Uit ZaaksysteemWiki
Ga naar: navigatie, zoeken
(Rekentekens)
(Voorbeelden)
Regel 73: Regel 73:
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
!Vul waarde in met formule
+
!width="450px"|Vul waarde in met formule
!Magicstrings
+
!width="450px"|Magicstrings
!zttscript
+
!width="450px"|zttscript
 
|-  
 
|-  
 
|
 
|

Versie van 23 nov 2015 om 12:50

Algemeen

Rekenen en vergelijkingen met waarden van Kenmerken kunnen op meerdere plekken in het systeem gebruikt worden, namelijk:

Constanten

De volgende constanten kunnen gebruikt worden bij het rekenen of vergelijken:

Simpele notatie Complexe notatie Waarde
:pi constant("pi") 3.141592653...

Rekenen

Met formules kan de output aangepast worden door te rekenen met de kenmerkwaarde(n):

  • Met elk type kenmerk kan gerekend worden, zolang de waarde een correct getal is
  • Waardes die geen getal zijn worden als 0 geïnterpreteerd
  • Delen door 0 geeft geen output

Rekentekens

De rekentekens die gebruikt kunnen worden zijn:

Naam Teken Voorbeeld Output Volgorde
haakjes () 6 * ( 2 + 2 ) 24 Als eerste
keer/maal * 6 * 2 12 Na haakjes
Van links naar rechts
gedeeld door / 6 / 2 3
plus + 6 + 2 8 Na keer/gedeeld door
Van links naar rechts
min - 6 - 2 4

Voorbeelden

Vul waarde in met formule Magicstrings zttscript

5 + 4 / (3 - attribute.voorbeeld_kenmerk) * attribute.example_kenmerk
5 + 4 / (3 - 1) * 7
5 + 4 / 2 * 7
5 + 2 * 7
5 + 14
19

[[ voorbeeld_kenmerk + 6 / 3 * example_kenmerk ]]
[[ 4 + 6 / 3 * 2 ]]
[[ 4 + 2 * 2]]
[[ 4 + 4 ]]
[[ 8 ]]
8

show_when { voorbeeld_kenmerk == 6 * (5 - example_kenmerk) }
show_when { 3 == 6 * (5 - 2) }
show_when { 3 == 6 * 3 }
show_when { 3 == 18 }
show_when { niet waar }
don't show

Afronding

De output wordt alsvolgt afgerond:

Formule Output formule Output in valutakenmerk Output in overige kenmerken
6 / 3 2 2,00 2.00
5 / 3 1.6666666667 1,67 1.67

Tip: Gebruik eventueel Kenmerkformatting om de getallen af te ronden op gehele waarden.

Vergelijken

Met vergelijkingen kan gecontroleerd wordt of een waarde aan een bepaalde conditie voldoet. De output is dan "1" als de conditie waar is en "" als de conditie niet waar is. In deze vergelijkingen kunnen ook berekeningen opgenomen worden.

Operators

De operators die gebruikt kunnen worden zijn:

Naam Teken Voorbeeld Antwoord
is gelijk aan == 2 + 2 == 4 Waar
is niet gelijk aan != 2 + 2 != 5 Waar
groter dan > 5 > 5 Niet waar
kleiner dan < 1 < 1.1 Waar
groter of gelijk aan >= 5 >= 5 Waar
kleiner of gelijk aan <= 1 <= 1.1 Waar
bevat tekst ~= "eks" in "tekst" Waar
komt voor in in 5 in [ 1, 2, 3, 4 ]

5 in array( 1, 2, 3, 4 )

Niet waar
Keuzekenmerken

'Meervoudige keuze'-kenmerken geven hun waarden terug in een Array, terwijl de andere kenmerktypen hun waarde teruggeven in String. Eenvoudig gezegd komt het er op neer dat [ "Keuze 2" ] niet gelijk is aan "Keuze 2", en daarom kan een vergelijking voor 'meervoudige keuze'-kenmerken enkel gedaan worden met de 'in'-operator.

Bijvoorbeeld: Een meervoudige keuze met de opties 'Keuze 1', 'Keuze 2', 'Keuze 3'. Wanneer een sjabloonsectie enkel getoond moet worden in geval van 'Keuze 2', dan is de formule hiervoor als volgt:

show_when { "Keuze 2" in voorbeeld_kenmerk }

Voorbeelden

Type Situatie en implementatie Voorbeeld
Rekenen in magicstrings Een zaaktype parkeervergunning, waarin vastgelegd wordt wat de prijs van het type vergunning is en het aantal bezoekersvergunningen dat additioneel aangeschaft wordt. In het sjabloon moet de prijs per onderdeel (parkeervergunning en bezoekersvergunning) uitgesplitst weergegeven worden, plus de totaalprijs.

Voor deze implementatie kan het rekenen in magicstrings gebruikt worden, door de prijzentabel alsvolgt op te stellen:

Onderdeel Prijs
Parkeervergunning [[ prijs_parkeervergunning ]]
Bezoekersvergunning [[ aantal_bezoekersvergunningen * 8 ]]
Totaalprijs [[ prijs_parkeervergunning + aantal_bezoekersvergunningen * 8 ]]
Voorbeeld rekenen in magicstring
Rekenen met regels Bovenstaande is niet geheel realistisch, want het is uiteraard veel wenselijker om de prijzen van de onderdelen in de zaak zelf vast te leggen, alsmede de totaalprijs.

Voor deze implementatie zijn kenmerken nodig om de prijs in op te slaan, en regels van het type 'Vul waarde in met formule' die de waarde er in plaatsen.

Kenmerken Regels
Parkeergebied Als 'Parkeergebied' is 'Centrum', dan Vul waarde in "24,00" (geen formule nodig)

Als 'Parkeergebied' is 'Schil', dan Vul waarde in "12,00" (geen formule nodig)
Als 'Parkeergebied' is <gevuld>, dan Vul waarde in met formule (kenmerk:Totaalprijs, waarde: "attribute.prijs_parkeervergunning + attribute.prijs_bezoekersvergunningen")

Prijs parkeervergunning
Bezoekersvergunningen Als 'Bezoekersvergunningen' = 'Ja', dan Vul waarde in met formule (kenmerk:Prijs bezoekersvergunningen, waarde: "attribute.aantal_bezoekersvergunningen * 8"
Aantal bezoekersvergunningen
Prijs bezoekersvergunningen
Totaalprijs
Voorbeeld rekenen met regels 1/3
Voorbeeld rekenen met regels 2/3
Voorbeeld rekenen met regels 3/3
Vergelijken met zttscript Een zaaktype parkeervergunning voor de volgende parkeergebieden: 'Centrum', 'Schil noord', 'Schil west', 'Schil zuid', 'Schil oost'. Voor de schilgebieden moet op het sjabloon een paragraaf voor waarden opgenomen worden.

Voor deze implementatie kan het beste een "niet gelijk aan"-vergelijking gebruikt worden:

show_when { parkeergebied != "Centrum" }

"Toon wanneer het kenmerk 'Parkeergebied' niet gelijk aan 'Centrum' is."

Let op: Voor dit voorbeeld geldt dat het veld ook getoond wordt wanneer het kenmerk 'Parkeergebied' geen waarde heeft (leeg is).

Voorbeeld vergelijken met zttscript
Rekenen in zttscript Een zaaktype 'Omgevingsvergunning' waarbij er geen administratiekosten gerekend worden wanneer de totale legeskosten boven de € 50,00 uitkomen.
show_when { prijs_bouwvergunning + prijs kapvergunning + prijs_printen > 50 }

"Toon wanneer alle prijs_kenmerken samen een waarde van groter dan vijftig hebben."

Let op: De auteur is zich bewust van het feit dat dit geen praktijkvoorbeeld is.

Voorbeeld rekeken in zttscript
Vergelijken in zttscript Een zaaktype 'Melding openbare ruimte' waarbij er afhankelijk van de categorie verschillende 'meervoudige keuze'-kenmerken met acties getoond wordt.
Kenmerk Opties
mor categorie Groen, Verlichting, Overlast
mor acties groen Opgeruimd, Teruggekoppeld, Schade verhaald
mor acties verlichting Gerepareerd, Teruggekoppeld, Schade verhaald
mor acties overlast Verholpen, Teruggekoppeld, Schade verhaald

Op het sjabloon moet dan een tekstveld getoond worden als in één van de actiekenmerken de waarde 'Schade verhaald' aangevinkt is.

show_when { "Schade verhaald" in [ mor_acties_groen, mor_acties_verlichting, mor_acties_overlast ] }

"Toon wanneer de waarde 'Schade verhaald' aanwezig is in mor_categorie_groen of mor_acties_verlichting of mor_acties_overlast."

Let op: Als de waarde in slechts één 'meervoudige keuze'-kenmerk opgezocht hoeft te worden dan zijn de [haakjes] niet nodig.

Voorbeeld rekeken in zttscript