Skip to main content

ScatterChart How To's

How to's for the ScatterChart guide.

What Is ScatterChart?​

What Is ScatterChart?​

ScatterChart is a chart object that displays results obtained from a data source on a form as points with (x, y) coordinates.
It is especially preferred for analyzing relationships, distributions, or correlations between two variables.

Instead of examining large amounts of data in tabular form, it makes it possible to visually interpret data distribution.

What Is It Used For?​

  • Analyzing the relationship between two numerical values
  • Observing data density and distribution
  • Identifying outlier values
  • Comparing performance, measurement, or statistical data

Typical Use Cases​

  • Relationship between sales amount and number of customers
  • Performance score versus time distribution
  • Comparison of measurement results
  • Statistical analysis and reporting screens

Key Features​

  • Point-based data visualization
  • Data fields mapped to X and Y axes
  • Summarized visualization for large data sets
  • Suitable for use in dashboards together with other chart types

Notes​

  • ScatterChart is generally used with numeric data fields.
  • It is not suitable for categorical data visualization.
  • It works with a data source and does not support manual data entry.

How to Use ScatterChart?​

How to Use ScatterChart?​

The following steps explain how to use the ScatterChart object on a form.

Add the ScatterChart Object to the Form​

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

Define the Data Source​

  1. Click the ScatterChart object
  2. Open the Properties panel
  3. Select an appropriate data source from the DataSource field
  4. Make sure the query result of the data source contains fields suitable for charting

Add ScatterChart Items (ScatterChart Types)​

  1. Click the ScatterChart Items field
  2. Click the Add button
  3. Select the chart type you want to use:
    • Bar ScatterChart
    • Line ScatterChart
    • Area ScatterChart
    • Pie ScatterChart
    • Scatter ScatterChart
    • Spline ScatterChart

Note: Pie ScatterChart cannot be used together with other chart types.

Map the Fields​

After adding a chart:

  • Argument Field → Category field
  • Value Field → Numeric value field
  • Color → ScatterChart color

Map these fields according to your data source.

Configure Visual Settings​

  • Customize colors
  • Configure axes (X / Y)
  • If needed, change axes using the Rotate Enabled option
  • Enable the Data Loading feature during loading

Save and Test​

  1. After completing the configuration, click Save
  2. Run the form
  3. Verify that the chart visualizes the data correctly

Usage Tips​

  • For large data sets, Data Loading and Cache Settings are recommended
  • On dashboard screens, Pie ScatterChart is ideal for summaries, while Bar/Line ScatterCharts are suitable for details
  • Consider performance when increasing the number of charts

How to Use ScatterChart?​

How to Use ScatterChart?​

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

Add the ScatterChart Object to the Form​

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

Define the Data Source​

  1. Click the ScatterChart object
  2. Open the Property Viewer panel on the right
  3. Select an appropriate data source from the DataSource field

ScatterChart works only with data coming from a data source.

Map the Chart Fields​

  • Argument Field (X Axis):
    Select the data field to be displayed on the horizontal axis

  • Value Field (Y Axis):
    Select the data field to be displayed on the vertical axis

With this mapping, each record is displayed as a point on the chart.

Configure Visual Settings (Optional)​

  • Point color
  • Point size
  • Chart title
  • Axis titles

These settings are used to improve chart readability.

Save and Run the Form​

  1. Save the form
  2. Build and publish the project
  3. Open the form in the web interface and verify that the ScatterChart displays the data correctly

Example Scenario​

On a performance analysis screen:

  • X Axis: Working time
  • Y Axis: Performance score

With this setup, the performance distribution of employees can be visually analyzed.

Notes​

  • It is recommended that data fields be numeric
  • Filtering can be applied for performance in large data sets
  • ScatterChart can be used together with LineChart or BarChart

What Is ScatterChart?​

What Is ScatterChart?​

ScatterChart is a form object used to represent results obtained from a data source using graphical visuals (bar, line, pie, etc.) on a form.
With this object, end users can access information more quickly through meaningful and summarized visuals instead of raw tabular data.

The ScatterChart object is especially preferred in:

  • Reporting screens
  • Dashboard designs
  • Decision support systems

What Is It Used For?​

  • Summarizing large data sets
  • Easily displaying trends and comparisons
  • Helping users understand data at a glance
  • Making numerical data easier to interpret through visualization

Key Features​

  • Support for multiple chart types (Bar, Line, Area, Pie, Scatter, etc.)
  • Ability to connect to data sources
  • Color, axis, and format customizations
  • Dynamic and interactive charts
  • A structure compatible with dashboards and reporting screens

Where Is It Used?​

  • Sales reports
  • Performance indicators
  • Process statistics
  • User behavior analytics
  • Management dashboards

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.