The Visualization API provides a unified way to visualize data across the Pentaho suite (e.g. Analyzer, PDI, CDF).
Essentially, it is a set of abstractions that enables safe, isolated operation between applications, visualizations and business logic.
The Data API ensures seamless integration with data sources in the Pentaho platform, as well as with other client-side component frameworks.
The Type API provides to visualizations out-of-the-box features such as class inheritance, metadata support, configuration, validation and serialization.
The Core APIs provide to visualizations features such as localization, theming and services registration and consumption.
A set of stock visualizations is included, covering the most common chart types. Based on the CCC charting library, they’re customizable and extensible to fit your organization’s desired look and feel.
If you want to know more about the specifics of how Analyzer exposes the Visualization API, read Analyzer and the Visualization API.
The following sections will guide you through the complete process of creating a custom visualization for the Pentaho platform, from developing it, to deploying it to Pentaho products and to configuring it.
Creating a visualization
Creating a visualization boils down to creating:
Modelclass — which identifies the visualization and defines it in terms of its data requirements, such as the visual degrees of freedom it has (e.g. X position, color and size) and any major options that affect its rendering, — and
The Create a Custom Visualization walk-through shows you how to develop these and how to create an OSGi artifact containing the visualization, so that it can be deployed to a Pentaho product.
If you prefer, you can skip the walk-through and get the final Pentaho Web Project, and build it. First make sure that you have git and npm installed.
Deploying the visualization
To deploy the visualization to a Pentaho product (Pentaho Server or PDI),
copy the tgz file you just built into its
See OSGi Artifacts Deployment if you need more information.
If everything went well, you should now see your visualization being offered in Analyzer and PDI, as well as be able to use it in a CDE dashboard:
Your Bar/D3 visualization in Analyzer, showing off the menu and placeholder icon:
Your Bar/D3 visualization in Analyzer, rendering:
Your Bar/D3 visualization in PDI, showing off the menu and placeholder icon:
Your Bar/D3 visualization in PDI, rendering:
Your Bar/D3 visualization in CDE:
You can get the following dashboard from the
8.1branch, at the location:
Configuring the visualization
A visualization can be configured by third-parties using configuration rules in external configuration files. These configurations are merged with any default configuration that is included with the visualization.
See Configuring a Visualization for more details.