zoomdata-chart-cli
The zoomdata-chart-cli is a tool designed to help you manage all aspects of the custom chart creation process in Zoomdata. With the CLI you create new custom charts, update existing ones, and import custom charts to other Zoomdata servers.
Installation
Requirements
- Node.js v10.0.0+
Install with npm
$ npm install -g zoomdata-chart-cli
Usage
Zoomdata CLI Environment Configuration
After installing zoomdata-chart-cli, you may want to use the following command to configure the default Zoomdata environment used by the CLI. While this is not a requirement, it greatly improves your CLI user experience because it sets the server URL and administrative credentials for you so you do not have to enter them with every CLI command.
$ zd-chart config
After entering this command, follow the prompts to store your default server configuration in an encrypted file. The CLI checks for the presence of this file if you omit the server or credentials when running a command.
Creating a Chart
To create a custom chart locally, run the following command:
$ zd-chart init <path/to/chart>
Optionally, you can provide a type parameter. For example:
$ zd-chart init -t multi-group <path/to/chart>
For information about possible chart types, run the following command:
$ zd-chart help init
Installing dependencies and building the Chart
To install dependencies, run the following command at the root level of the newly created chart:
$ npm install
Then build the chart:
$ npm run build
Editing the Chart
Make sure you are in the chart’s folder and run the following edit command:
$ zd-chart edit
Alternatively, you can specify the path to the chart in the edit command. For example:
$ zd-chart edit -d <path/to/chart>
After running the edit command, follow the prompts to update the:
- Controls
- Name
- Variables
- Visibility
Rebuild the chart:
$ npm run build
Pushing the Chart to the Server
To push the chart to the server, run the following command:
$ zd-chart push
Removing the Chart from the Server
To remove the chart from the server, run the following command:
$ zd-chart rm
After running the command you will be prompted to select the chart name and confirm its deletion.
Listing All Charts
To list all charts stored on the server, run the following command:
$ zd-chart ls
Getting Help
Access the CLI help by running the following command:
$ zd-chart help
Get help for a specific command by running the following command:
$ zd-chart help <command_name>
Support
Compatibility table
Zoomdata Server | zoomdata-chart-cli |
---|---|
<3.2.0 |
3.0.0 |
[3.2.0…5.9.0] |
<=4.1.x |
[5.9.1…7.8.x] |
<=5.x.x |
>=7.9.0 |
>=6.x.x |
For more information visit Zoomdata's developer zone