The custom chart API provides developers with an interface to create interactive charts that integrate with the native Zoomdata chart controls. To get started with the custom chart API, you need to install the Zoomdata Chart CLI. The chart cli is designed to help you manage all aspects of the custom chart creation process in Zoomdata. Additionally, you need to use the credentials of a Zoomdata user with ADMIN role when configuring the chart cli.
For more detailed step-by-step instructions on getting started, visit the custom chart tutorial.
Install Zoomdata's Custom Chart CLI
npm install zoomdata-chart-cli -g
Using the Zoomdata Custom Chart CLI
- Configure the CLI.
- Create a new custom chart.
zd-chart create- Follow the prompts and select the
zd-chart edit— On the chart selection prompt, select the newly created chart. When presented with a list of options, select
- Enable the custom chart for a source by navigating to the Sources page
/zoomdata/admin.html#sourcesand selecting a source. Switch to the
Charts->Customtab and ensure the custom chart's checkbox is checked.
- Create a new dashboard with your blank custom chart. You should see a chart widget with a single
- You are now ready to continue building out your custom chart.
Adding custom chart packages
zd-chart add <name> <filepath.zip> adds the specified custom chart to the Zoomdata server.
Work through the tutorial
It walks you through building a custom chart from scratch. Go to the tutorial.