Add functions to a Dynamic Document

Add functions

You can add arithmetic functions into a section. For example, you may want to include a function that calculates the price after a discount for a certain item.

In some cases, you can insert aggregate functions that calculate the sum total when there are multiple instances of the same function. For example, if you have a function called item_price that is used in more than one instance, you can insert an aggregate function that will calculate the total of all the item_price functions.

Limitations to using functions

The type of functions you can add to a section depends on what type of section you are adding them to. Sections that are bound to a Form behave differently to unbound sections. Binding a section of a Dynamic Document to a Form is used when building a visual cart. The following table summarizes the type of functions you can add to a section and what those functions can include:

Add a regular function

To add a regular function to a Dynamic Document:

1. In the toolbar of the relevant section, click the Add Function button.
   
   

2. In the dialog box that opens, click Create New.
   
   
   The Create Function window appears.

3. Enter the name of your function, for example item_price.

4. In the function box, enter the function itself.

   • In bound sections, you can use the add function button or the add attribute button to include attributes and functions that are used in this section.

     

   • In unbound sections, you can use the add function button or the add aggregate function button to include functions and aggregate functions from anywhere in the document.

     

   For example, you can write the following function to calculate the price after a discount, that includes 2 attributes.

   @document.price - @document.discount

5. Click Save to save the new function.

6. Click Save to save the new function .

7. To add the new function into the section, click the Add Function button again and select the function you just created.
   
   

8. To edit or delete the function, click the relevant buttons next to the selected function.

Add an aggregate function

1. Click the Add Aggregate Function button.
   
   

2. In the dialog box that opens, click Create New.
   
   

3. In the Create Aggregate Function dialog box, in the title box, enter the name of your aggregate function.

4. In the function box, enter the function itself.
   You can use the add function button to insert a function from anywhere in the document.
   
   

   For example, you can write the following aggregate function to calculate the total of all the item_price functions:

   item_price + 0

5. Click Save.

6. To add the new aggregate function into the section, click the Add Aggregate Function button again and select the function you just created.
   
   

7. To edit or delete the aggregate function, click the relevant buttons next to the selected aggregate function.