Initializing help system before first use

Advanced Expressions

In addition to accessing the available global objects, you can make use of any standard JavaScript syntax and globals provided by the Xpress Insight API, such as insight and jquery. For more on the Xpress Insight API see Insight REST API.

It is common to define your global functions within script blocks or external script files and use them in expressions. The following example shows an inline script block that defines the add(a,b) global function. It is called by the expression and passes MyInteger and AnotherInteger from the model. The span contents contain the result of the function call.

Code editor
<script>
function add(a, b) {
    return a + b;
    }
</script>
<span vdl-text="=add(scenario.entities.MyInteger.value,
                     scenario.entities.AnotherInteger.value)">
</span>

For more complex functions it is best practice to place them in a separate file for import. The path for the included file is always relative to the client_resources folder:

Code editor
<script src="math-functions.js"></script>
<span vdl-text="=add(scenario.entities.MyInteger.value,
                     scenario.entities.AnotherInteger.value)">
</span>