Il existe une version française de notre site web. Vous pouvez la consulter si vous le souhaitez.
15Sep, 2016
0Comments

Understanding and using the Calculation field

Automate your calculations with the Calculation element.

Presentation of the Calculation field.

Insert a calculation field and access its features: Go to the element options by clicking on the pencil.

Calculation field with Kizeo Forms

Several options are available to you under the Properties tab:

  • Define how many digits after the decimal point will be included in your results.

Numbers after the decimal point

 

  • Define the type of results in your calculation: number or time.

calculation display mode

 

  • By checking the Editable entry box, you can change the results of your calculation. For example, if you want to round the results.

calculation modifiable entry

 

Under the Calculation tab, you will define the fields to calculate.

tuto-image-border

The Calculation tool has several functions.

Simple calculation

Consider the following example: You want the price for an order to be automatically calculated.

In the back-office.

Example: Start by inserting an Input field and go to its properties:
Rename it according to the needs of your form and choose the type that you need. In our example, the Entry field will be called “Price” and will be a “decimal number” type.

input field digital decimal

 

  • Insert as many Input fields as necessary to make your calculation and set the properties of these fields.
  • Then insert your Calculation field and go into its options.
  • Add the “Price” field in the ‘formula of calculation’.

Add a calculation field

 

Note : To define what multiplication is, you must enter ” * ” on the keyboard. Calculation signs are performed manually on the keyboard.

  • Multiply with another field, like “Quantity” as shown here.

multiply multiple fields

Once completed, confirm and save your form.

On the mobile.

Example of calculation diplayed on a mobile device

Sum of a table

In the back-office.

Consider the example of an employee time sheet.

  • Create your time sheet form: A table with a list of participants and a numeric entry field where you specify the number of hours worked.

/!\ ATTENTION /!\ Specify clearly the “numeric” type.

create your time sheet form: A table with a list of participants and a numeric entry field

 

  • Add an external Calculation field to the table.

Add an external Calculation field to the table.

 

  • Define the field: According to the example, the field will make the sum of the “Hours worked” column.

The sum of hours worked

 

  • Confirm and save your form.

On the mobile.

example of an employee time sheet on the mobile application

Use the calculation field as a 'Reference' field

This feature enables it to work from the outset with a Referential list, but we would prefer to use the Reference element, which was developed expressly for this feature.

For those who already work with Referential lists and Calculation fields, this feature still works..

Idea: With the Referential and Calculation elements, you have the option to create a proper purchase order form. In order to obtain an identical document to your current purchase orders, you can create a Word template. Refer to the “purchase order” example, which is located in our forms library.

The uniq Number

The Uniq Number allows you to create a random line. As an example, we will use the Uniq number to create the P.O number of your Purchase Order.

Configuration.

  • Add a Calculation field and go in its option, ‘calculation’ tab.
  • In the drop-down menu, select ‘Uniq number’.

uiq number

 

/!\ Don’t forget to confirm your settings and save your form.

On the mobile device.

the uniq number

the ItemRefNum

The ItemRefNum makes data reading easier. It is similar to the Reference field. It reads information contained in a given column. It is usually linked to an NFC Tag or an Input Field.

To discover how to configure your NCF tag, do not hesitate to check our tutorial!

Conditional operators

You can condition your calculations through different operators:

List of operators

Arithmetic operators:

  • + : addition and concatenation of text
  • – : substraction
  • / : division
  • * : multiplication
  • % : modulo or remainder of Euclidean division

Comparison operators:

  • < : lesser than
  • <= : Less than or equal to
  • > : greater than
  • >= : greater than or equal to
  • == : equality
  • ! = : inequality
  • === : strict equality
  • !== : strict inequality

Logical operators:

  • && : logical operator AND
  • || : logical operator OR
  • ! : negation
  • ? : ternary operator. It is written in the form: ((condition)? Value_if_true: value_if_false)

Bitwise operators:

  • & : AND “bitwise”
  • | : OR “bitwise”

Examples:

Perform a calculation according to a checkbox

In order to perform a different calculation according to a checkbox, you can use the following formula:

  • Check box? my calculation or my text if my box is checked: my calculation or my text if my box is not checked.

In the example below, we want to apply a 5% discount if our box is checked.

In the example below, we want to apply a 5% discount if our box is checked.

 

For this, we test whether our apply 5% discount? box is checked or not. The deduction will be applied if the box is checked.

conditional calcuation for checkbox

 

Give a value in a calculation if an element is selected in a list

In order to give a value in our calculation when an element is selected in a list, we use the following formula:

  • List == value code A? Value if true: Value if false

In the example below, we applied it to our calculation to offer VAT if New Customer is selected.

At first, we assign a code to our list, of the form code: list. This code will of course not be visible on the mobile device.

list with labels

 

We then test if our new client has been selected.

calculation based on list

 

Warning: if you add text, remember to remove the + which is generated automatically.

Perform operations with conditions - example: average

In the example below, we want to achieve a grade average of 0 to 10 and not to consider an item that is not applicable.

In the example below, we want to achieve a grade average of 0 to 10 and not to consider an item that is not applicable.
In our Slider elements, we select the type Text and we add our different notes, for the Not applicable, we give it a code, -1:

0
1
2
3
4
5
6
7
8
9
10
-1:Not applicable

In our Calculation element, we test whether the non-applicable element is entered or not. For this we use the following formulas:

  • my_slider == -1?0:my_slider <- so, if Not applicable is selected, its value in the calculation will be equal to 0, otherwise the chosen value will be taken into account. This operation will allow us to know the selected note.
  • my_slider == -1?0:1<- thus, if Not applicable is selected, the value taken into account during the computation will be equal to 0; otherwise, it will be equal to 1. This formula will be used for the division to know how many items have been entered.

By repeating the first calculation for each slider element and then dividing by the second, we get the calculation below:

Slider calcuation

 

Display a result if a field is equal to another field

In order to display a result when a field is equal to another field, we use the following formula:

  • Element A == element B? Value if identical: Value if different

In the example below, we applied it to two input fields to check if the email addresses are identical.

calculation identical and different example

 

Warning: if you add text, remember to remove the + which is generated automatically.

Using two conditions - example: display a result if a field is greater than, less than, or equal to another field

If you want to combine several conditions, you can use the following formula:

  • Our first condition? Value if true: Our second condition? Value if true: Value if false

If the first condition is false, we test the second, etc., until we reach the “Value if false”

In the example below, we test our A value and B value to find out if A is greater than, less than or equal to B. We use the following formulas:

  • Element A <element B? Value if true: Value if false
  • Element A> element B? Value if true: Value if false

Combined, we get the operation below:

value equal to greater than or lesser than

 

Warning: if you add text, remember to remove the + which is generated automatically.

OR Function (||)

To perform a calculation if a box is checked or if an item is entered, you can use this formula:

  • Our first condition || Our second condition? Value if true: Value if false

At first, we will test the first condition, if it turns out wrong, we will test the second, so on.

In the example below, we test our input field. If it contains 0, 2, 4, 6, 8 or 10, then Even will appear, otherwise it will be Odd.

Odd or even calculation

 

Warning: if you add text, remember to remove the + which is generated automatically.

Note: we could also have used the percentage (%) to perform this operation. The Percentage allows to display the rest during a division. Thus, if the number is even, the division will not have any remainder and the calculation will be equal to 0.

Odd or even % calculation

 

AND Function (&&)

To perform a calculation if a box is checked and an item is entered, you can use this formula:

  • Our first condition && Our second condition? Value if true: Value if false

In the example below, we wish:

  • Make a reduction of 10 € if the box New customer is checked
  • Add a 10% or 20% VAT if the respective boxes are checked.

Calculation of VAT
Thus, we test respectively:

  • If the box New customer is checked
  • If the box New customer and VAT 10% are ticked
  • If the box New customer and VAT 20% are ticked
  • If the 10% VAT box is checked
  • If the VAT 20% box is checked,

VAT calculation

 

Warning: if you add text, remember to remove the + which is generated automatically.

Do not hesitate to comment on this article!
All your questions, comments and suggestions are most welcome!

Post a comment

Your email address will not be published. Required fields are marked *