Charts

Visualise your data

Whilst there are a variety of chart types, all charts have some common properties:

  • Title
  • Provider
  • Label Column
  • Data Column(s)
  • Width & Height
  • Margin
  • Custom CSS
  • Conditions

Providing Data

Charts allow you to visualise data from a Data Provider, which can have data sources such as:

  • Budibase DBBudibase DB - The internal data source provided by Budibase. Any data you store on it is stored directly on your Budibase instance.
  • REST Queries
  • Custom Queries

Displaying Data

The data displayed in your chart will be determined by the label and data columns.

Label Column Provides the name of each categorical variable.
Data Column(s) Provides the value or range of values for each label.

🚧

Data Column Type

Data columns must be numeric

Generating the Chart Schema

For table data sources, the available options for the label and data columns will match the columns of the table.

Data from REST Queries on the other hand, will likely need to be transformed to be suitable for use in charts.

In particular, your Transformer and SchemaSchema - A blueprint of how your data should be constructed. should align with the following:

Naturally you would replace the strings and numbers with response data from your API.

Many Data Columns

Most chart types can make use of more than one value column. Thus, additional value fields would be needed in your schema.

For example, you may want to display the change in average temperature between seasons for each country:

📘

Undetermined Number of Labels

If you do not know ahead of time how many labels or data columns you will be displaying, then you will need to use JavaScript to loop over your API data.

Have a look at this tutorial for more insight.


Did this page help you?