Advanced condition editor

The editor does not require providing the prefix "js:" and will not display it in conditions. The prefix will be appended in the source automatically when saving changes.

Introduction

The advanced condition editor is a special editor designed to streamline the work of the form designer. It is equipped with the following features:

• syntax highlighting,

• displaying suggestions for variable and field names while editing conditions,

• displaying eximee API suggestions while editing conditions.

Illustration 1. Example conditions in the component properties palette

Places of occurrence

Three component attributes in Eximee Designer use this editor. They are:

• visibility condition,

• activity condition,

• requiredness condition.

Illustration 2. Advanced condition editor - editing the visibility condition

Syntax suggestions

The editor suggests eximee API elements and commonly used JS methods to the user. Editor suggestions can be seen by pressing Ctrl + Space. This will expand a list of items from which you can see the following:

Standard JS methods and fields:

• parseInt()

• parseFloat()

• .length

• size

• empty

API provided by eximee:

• getValue()

• getData()

• isVisible()

• getStatementValue()

Illustration 3. Advanced condition editor - expanded list with syntax suggestions

Additionally, MID of components (with their ID in parentheses) and names of session variables used on the form will appear in the suggestions.

Illustration 4. Advanced condition editor - view of suggestions for components located in the artifact

Illustration 5. Advanced condition editor - view of suggestions for filtered components

Condition examples

// integer comparison of a TextField type field
parseInt(getValue("GesTextField3"))>5
  
// floating-point comparison of a TextField type field
parseFloat(getValue("GesTextField5"))<200.001
  
// logical value comparison (equal) of a CheckBox type field
getValue("GesCheckbox1")=="true"
 
// logical value comparison (not equal) of a CheckBox type field
getValue("GesCheckbox1")!="true"
 
// text value comparison of a RadioGroup type field
getValue("GesRadioGroup1")=="audi"
  
// check if a value, e.g. a session variable, is not empty
!!getValue("nazwiskoZew")
  
// check if a value, e.g. a session variable, is empty
!getValue("nazwiskoZew")
  
// check whether the statement with mid oswiadczenie1 in the component with id GesStatementPopup1 has been accepted
getStatementItem("GesStatementPopup1","oswiadczenie1") == "true"
  
// check whether the statement with mid zdrowotne in the component with id GesStatementFlat5 (located in a composite component) has been accepted
getStatementItem("@GesStatementFlat5","zdrowotne")=="false"
 
 
// requiredness condition for a field if others are empty
!!!(getValue("@GesTextField13")||getValue("@GesTextField8"))
 
 
// check values of comboboxes
getValue("@GesCombobox1")!=2&&getValue("@GesCombobox1")>0
 
 
// check if TextField is visible
isVisible("@GesTextField1")=="true"
 
 
// check whether the number of characters in TextField equals 10
getValue("GesTextField5").length==10