Advanced condition editor

The editor does not require entering the prefix "js:" and it will not display it in conditions. The prefix will be automatically added in the source when the changes are saved.

Introduction

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

• syntax highlighting,
• displaying variable and field name hints while editing conditions,
• displaying eximee API hints while editing conditions.

Figure 1. Example conditions in the component properties palette

Occurrences

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

• visibility condition,
• activity condition,
• requirement condition.

Figure 2. Advanced condition editor - editing the visibility condition

Syntax hints

The editor suggests eximee API elements and frequently used JS methods to the user. Editor hints can be seen by clicking the Ctrl + Space key combination. This will expand the list of elements, among which the following can be seen:

Standard JS methods and fields:

• parseInt()
• parseFloat()
• .length
• size
• empty

API provided by eximee:

• getValue()
• getData()
• isVisible()
• getStatementValue()

Figure 3. Advanced condition editor - expanded list with syntax hints

Additionally, the hints will include the components' MIDs (with their IDs in parentheses) and the names of session variables present in the application.

Figure 4. Advanced condition editor - view of hints for components located in the artifact

Figure 5. Advanced condition editor - view of filtered component hints

Example conditions

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