Skip to main content

FormMetaData How To's

How to's for the FormMetaData guide.

How to Use FormMetadata?​

How to Use FormMetadata?​

The following steps should be followed to add and configure the FormMetadata object on a form.

Add the FormMetadata Object to the Form​

  1. Open the form design screen.
  2. Go to the Toolbox panel.
  3. Locate the FormMetadata object.
  4. Drag and drop the object onto the form.

Select the Metadata Information to Display​

  1. Click the FormMetadata object.
  2. The Properties panel opens on the right side.
  3. From the Select Meta Data Type field, select the information to be displayed:
    • Form Caption
    • Project Caption

Build and Publish the Project​

  1. Use the Run option from the top menu.
  2. Make sure the project is built and published successfully.

Verify in the Web Interface​

  1. Log in to the web interface using your username and password.
  2. Open the relevant form.
  3. Confirm that the selected metadata information is automatically displayed on the form.

Tips​

  • When used together with the Header object, more meaningful title areas can be created.
  • In multilingual projects, caption information automatically changes based on the language.
  • It is recommended to use FormMetadata instead of a static Label.

Summary​

  • FormMetadata displays title information retrieved from the system
  • Does not require manual updates
  • Creates dynamic titles based on the form and project

What is FormMetadata?​

What Is FormMetadata?​

FormMetadata is a form object used to automatically display the caption (title) information of a form or the project it belongs to on the web interface.

With this object:

  • Form title
  • Project title

can be reflected on the form dynamically from the system, without being entered manually.

The FormMetadata object is especially preferred in scenarios such as:

  • Commonly used forms
  • Cases where different titles need to be displayed based on the project
  • Situations where system information is required instead of static text

Key Features​

  • Automatically displays the form or project title
  • Does not require user interaction
  • Metadata information is retrieved from the system
  • Works similarly to a Label but has a dynamic structure

Usage Scenarios​

  • Displaying the form name automatically as a title
  • Showing the same form with different titles in different projects
  • Dynamically presenting project information in the header area

Notes​

  • FormMetadata is a read-only object.
  • It cannot be edited by the user.
  • The information to be displayed is selected from the properties panel.

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.