Transfer How To's

How to's for the Transfer guide.

What Is Transfer?

What Is Transfer?

Transfer is a form object that displays items coming from a data source or added manually by the developer
in two separate columns: source and target.

Users can select one or more items listed in the source column and move them to the target column
using the arrow buttons.

Likewise, items in the target column can be selected again and moved back to the source column.
This structure allows users to manage their selections easily.

Key Features

• Dual-column structure (Source / Target)
• Single or multiple selection support
• Data source–based or static usage
• Ability to revert selections
• User-friendly, visual selection experience

When Is It Used?

The Transfer object is especially preferred in the following scenarios:

• User assignment (user → project, role → user)
• Permission / authorization selection
• Group–member matching
• Category–product association
• Scenarios requiring multiple data selection

Notes

• Source and target lists can be defined with independent titles.
• The Transfer object is ideal for scenarios that require multiple selection.
• For large data sets, it is recommended to use it together with a Lookup or filtering-supported structure.

---

How to Use Transfer?

Transfer – How to Use It?

A Transfer displays values—either retrieved from a data source or manually added by the developer—in a list format,
allowing the user to make single or multiple selections.

It is commonly used in form design for selection lists, category lists, multi-assignment screens, and similar scenarios.

How to Add a Transfer to a Form?

1. Open the form design screen and navigate to the Toolbox panel.
2. Find the Transfer component among the available objects.
3. Drag and drop it onto the form.
4. When the object is selected, the Property Viewer panel displays:
   • General ( Label , Data Source , Behavior , Appearance)`
   • Events
     sections for configuration.

How to Add Data to a Transfer?

Listing Data from a Data Source

A Transfer can be bound to a DataSource:

1. Open the DataSource property.
2. Select the desired data provider (e.g., SQL query, API data, database table).
3. Configure Name and Value fields to determine:
   • The label shown to the user
   • The underlying value used in the form

Adding Manual (Static) Data

If you prefer not to use a data source, static items can be added:

1. Click the … (ellipsis) button in the Items property.
2. In the pop-up window, click Add.
3. For each item, provide:
   • Value
   • Title
   • Selected
4. Save your changes.

Enabling Single or Multiple Selection

By default, a Transfer uses single-selection mode.

To enable multiple selection:

• Set the Allow Select All property to Enabled.

When enabled:

• The user can select multiple rows at once.
• It is useful for mass-assignment or bulk-operation scenarios.

---

Bind Transfer to DataSource?

How to Use Transfer with a DataSource?

A Transfer can be bound to a DataSource, allowing it to automatically display records from the selected data provider in list form.

Steps

Add the Transfer to the form

Toolbox → Transfer → Drag & Drop

Locate the DataSource field in the Property Viewer

This field determines which data source will populate the Transfer.

Select the DataSource

Choose the appropriate data source from the dropdown list.

Save and run the form

The Transfer will automatically load the records from the selected data source.

Notes

• If the data source is dynamic, the Transfer may update automatically.
• When dealing with large datasets or when filtering is needed, Lookup may be a better option.

---

What is Transfer?

What Is a Transfer?

A Transfer is a form object that displays values—either retrieved from a data source or manually added by the developer—in a list format.
The user can select one or multiple items from this list.

Transfer is especially ideal for situations where:

• Multiple selections may be required
• The number of options is too high for a ComboBox
• A wide and clear list should be presented to the user

Features

• Supports both single selection and multiple selection
• Can be populated automatically from a DataSource
• Supports manual item entry
• All settings can be configured from the Property Viewer in the development interface

How to Add It to a Form?

1. Open the form design screen.
2. In the Toolbox panel, locate the Transfer component.
3. Drag and drop it onto the form.
4. Click the object and configure its settings from the General / Events tabs.

Notes

• If multiple selection is required, the SelectionMode property must be enabled.
• For large data lists, Transfer provides a more user-friendly experience compared to ComboBox.
• Ensure proper field mapping when using a data source.

---

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:

6. 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 State	Description
True	The control is active and ready for user interaction when the form loads.
False	The 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.