Creating a New Chart

Use the Chart Designer to create a new chart

A chart is a control that graphically displays data from a datasource. To create the chart, create a metadata file and add it to the chart control following these steps:

  1. In the main menu of the Form Designer, select Designers > New Chart.
  2. In the wizard, enter a name for the metadata, for example, and click Confirm.
    The metadata file is created under the view folder in the Project Explorer.
    chart_metadata
  3. Bind data to the control.
    1. Go to the Properties panel and select the dataSource icon.
    2. In the data binding catalog, select the data source, and click Confirm.

      appbuilder_sl_select_databinding

      The Data Source is added to the dataSource property for the chart.

  4. Configure the chart control.
    1. In the Properties panel, click type to select the chart type, for example Column.
    2. In the Properties panel, specify the control properties for the chart.
      chart_properties
      Note: Important notes for configuring chart properties:
      • The category and value properties are required properties that must be set. The series property is optional.
      • Sorting – AppBuilder's charting feature requires its data to be sorted by category column. If you set the categorySortOrder to None, then you need to make sure the date is pre-sorted by category. It doesn't matter how it is sorted (for example, alphabetically), as long as it is sorted.
      • Duplicated Data – AppBuilder's charting feature does not automatically aggregate data, and it expects that each row of data is unique based on category and series (if the series property is set). If there are rows in the data with the same category and series values, the duplicate row is removed, and the data is only displayed once on the Chart.
  5. Click Save to save your chart, and then click Return to exit the Chart Designer.
  6. Click Toolbox.
  7. Drag and drop the Chart control onto the form.
  8. In Properties, click the metadataFile icon.
  9. Under the view folder, select the <file_name>.mameta file and click Confirm.
    The chart appears on the form.
  10. Click Save.
Related tasks
Adding Controls to the Project
Creating a New SuperList
Related reference
Configuring Controls in the Project
Toolbox
Chart Designer