Dashbuilder Runtime Embedded Mode

Dashbuilder Runtime (DB) allows you to run your dashboards in a cloud-ready web application. Since jBPM 7.40 users can access their dashboards by logging directly into DB or they can bring dashboards to their application by using the improved embedded mode.

With embedded mode Dashbuilder Runtime can be part of users’ own application. The REST API also allows users to upload dashboards directly into Dashbuilder and navigate through the existing dashboards.

In this article we discuss Dashbuilder embedded mode and the REST API that can be used to retrieve dashboards information.

Embedding dashboards

Every dashboard in DB page can be accessed in embedded mode using the URL format:

${DB_URL}?standalone&perspective=${PG_NAME}

Where:

  • DB_URL: The URL where Dashbuilder Runtime is running;
  • PG_NAME: The dashboard page name

in Multi mode you just need to additionally provide the import name:

${DB_URL}?standalone&perspective=${PG_NAME}&import=${IMPORT}

Here’s a sample URL:

http://localhost:8280/?import=population&perspective=Countries%20Population&standalone

A dashboard running in embedded mode

REST API

The integration with third part application is improved by DB REST API:

  • GET /api: Provides server information: Runtime Mode and list of available models. Sample
  • POST /api/dashboard/: Received a POST ZIP with dashboards and register it for use (upload). You must send a form param called “selectedFile” with the file contents. It returns the dashboard id.

curl -u ‘admin:admin’ -F ‘selectedFile=@/home/wsiqueir/Downloads/new_dashboard.zip’ http://localhost:8280/rest/api/dashboard

Sample request to upload a dashboard

  • GET /api/dashboard/{id}: Retrieves information about the dashboard {id}
Sample response for a dashboard details

Javascript Client Library

It is possible to wrap the REST calls using a Javascript library published in npm: dashbuilder-js/api. With this you can use dashboards directly in your application. See examples in dashbuilder-js repository.

Using dashboards from a Javascript application

Conclusion

Dashbuilder Runtime can be seamlessly integrated with existing applications. In jBPM 7.43 we also added support to integrate your own components inside DB and in the next article we will discuss how this can be done.


Dashbuilder Runtime Embedded Mode was originally published in kie-tooling on Medium, where people are continuing the conversation by highlighting and responding to this story.

This post was original published on here.
0 0 vote
Article Rating
Subscribe
Notify of
guest
0 Comments
Inline Feedbacks
View all comments