WSO2 Dashboard Server (DS) is a gadget container that allows users to create dashboards via the Dashboard Designer, which is a web application. The Dashboard Designer provides the capability to customize dashboard layouts, add pages to a dashboard, configure inter-gadget communication based on the Pub-Sub mechanism, add dashboard banners, and much more.
The Dashboard Server also provides a programming model based on the OpenSocial specification that allows users to write customized gadgets, which are a sharable UI component, based on their own requirements. As DS allows the users to create each gadget as an isolated unit, gadgets can be developed in parallel.
When a dashboard editor creates or updates a dashboard via the Dashboard Designer, the data is stored in the original registry space that is allocated for the dashboard. However, when a dashboard viewer personalizes a dashboard, the data is stored in the space allocated to that particular user in the registry. Thereby, enabling per-user dashboard customization; while, also preserving the dashboard editors preferences.
The following diagram illustrates the high level architecture of DS:
At the core of WSO2 Dashboard Server lies the WSO2 Carbon Server, which is based on the WSO2 Carbon Kernel, and the WSO2 Carbon Dashboard platform, which is packaged with Jaggery and Apache Shindig to support the Dashboard Designer application. As the Dashboard Server is based on the WSO2 Carbon Kernel, all the features provided by the Kernel (e.g., user management, resource management, etc.) are available in DS. In addition, DS also supports Single Sign-On, which can be enabled for internal or external identity providers, so that users can access the Dashboard Designer and also communicate with third party APIs, used by various gadgets, provided the third-party APIs have a mechanism to validate the OAuth token with DS.
The following diagram illustrates the low level architecture of DS:
The various components that make-up the Dashboard Server architecture are explained as follows:
APIs and Pages:
The Dashboard Server includes the following three routers: API router, page router and tenant router
The tenant router filters all the incoming requests to the Dashboard Designer, by analyzes the request URL context, and redirects those requests to either the API or page router, which are routers in DS used to differentiate the incoming API requests and page requests.