Skip to main content

MaskInput How To's

How to's for the MaskInput guide.

How to Enable Data Entry?​

How Is Data Entry Enabled in the MaskInput Object?​

The MaskInput object is a special input control that allows users to enter data in a specific format.
However, there is a mandatory prerequisite for data entry to be possible in this object.

Mandatory Required Setting​

The Mask property must be filled.

If the Mask field is not defined:

  • The user cannot enter any data
  • Keyboard input is blocked
  • The object behaves as if it is inactive

Step-by-Step: Enabling Data Entry in MaskInput​

Add the MaskInput Object to the Form​

  1. Open the form design screen
  2. Go to the Toolbox panel
  3. Locate the MaskInput object
  4. Add it to the form using drag / drop

Define the Mask Value​

  1. Select the MaskInput object
  2. The Property Viewer panel opens on the right
  3. I

How to Use MaskInput?​

How to Use MaskInput​

The MaskInput object ensures that the user can enter data only according to the defined mask (mask pattern) format.
This prevents invalid data entry at the form design level.

Step 1 – Adding the MaskInput Object to the Form​

  1. Drag and drop the MaskInput object onto the form from the Toolbox.
  2. When the object is selected, the
    • General
    • Label
    • Behavior
    • Appearance
    • Events tabs appear in the panel on the right.

Step 2 – Defining the Mask (Format)​

One of the most important settings of the MaskInput is the Mask / Format Pattern.

Example masks:

Use CaseMask Example
Phone(999) 999 99 99
National ID99999999999
IBANTR99 9999 9999 9999 9999 9999 99
License PlateAA-9999
  • The 9 character in the mask represents numeric input only.

Step 3 – Defining an Event​

The following events can be used on the MaskInput object:

  • On Value Changed – Triggered when the user changes the value.

These events allow additional validation or dynamic operations to be performed.

Step 4 – Using with Other Objects Inside the Form​

After input is entered, MaskInput can:

  • Fill other fields,
  • Display warnings,
  • Serve as a control point within a workflow.

What Is MaskInput?​

What Is MaskInput?​

MaskInput is a form object that forces end-users to enter data in a predefined pattern or format.
It is especially useful for fields where the number of characters or the input structure is fixed, such as:

  • National ID Number
  • Phone Number
  • IBAN
  • Tax Number
  • Plate, Code, Barcode, and other formatted values

With this object, users cannot enter an incorrect number of characters or values that do not match the required format, ensuring higher data entry quality.

How to Add MaskInput to a Form​

  1. Open the form in the designer within the development interface and display the Toolbox panel.
  2. Locate the MaskInput object in the list.
  3. Drag and drop it onto the form.
  4. When the object is selected, the Property Viewer panel on the right displays the “General” and “Events” tabs.

What Does MaskInput Provide?​

  • Prevents format errors at the moment of entry.
  • Improves data consistency and integrity.
  • Enhances the user experience.
  • Ensures standardization of input fields in forms.

How to Use Client Enabled?​

What is Client Enabled?​

Client Enabled is a property that defines whether a form control is active (enabled) on the client side when the form is first loaded.
If it is set to True, the control is immediately usable by the user.
If it is set to False, the control is disabled and cannot be interacted with until a specific condition or rule activates it.

This property is especially useful for controlling the user’s interaction flow and applying dynamic behaviors using the Rule Manager.

What Does It Do?​

The property allows developers to:

  • Control when a form control becomes interactive.
  • Prevent users from entering or changing data until prerequisites are met.
  • Dynamically enable or disable controls based on user input or logic.

Example Scenario — Conditional Activation​

Scenario:
A form contains a checkbox called “I Accept Terms” and a text field called “Signature.”
The goal is to make the “Signature” field inactive until the user checks “I Accept Terms.”

Steps to Implement:​

  1. Select the “Signature” field in the form editor.

  2. In the Properties panel, find the Client Enabled field.

  3. Set the value to False — the field will now be disabled by default when the form loads.

  4. Open the Rule Manager.

  5. Add a new rule:

    Condition:

Action:

  1. Save and publish the form.

Result:​

  • When the form loads, the “Signature” field is disabled.
  • Once the user checks “I Accept Terms,” the field automatically becomes active and editable.

Behavior Summary​

Property StateDescription
TrueThe control is active and ready for user interaction when the form loads.
FalseThe control is disabled at load time and can be enabled dynamically via rules or code.

Notes & Best Practices​

  • Use the Client Enabled property to manage client-side interactivity without requiring server actions.
  • Combine it with Rule Manager to define when and how controls become active.
  • Remember: if server enablement is disabled, the client cannot enable the control even if Client Enabled is set to True.
  • By default, this property is set to True (active).

Summary​

Client Enabled improves form usability by letting developers control when and how users interact with form controls.
It is essential for creating responsive, condition-based form experiences where user actions dynamically change the form’s state.