An API to assist developers in integrating AI/BI dashboards into their applications ([AWS](https://docs.databricks.com/en/dashboards/embed.html), [Azure](https://learn.microsoft.com/en-us/azure/databricks/dashboards/embed), [GCP](https://docs.gcp.databric
npm install @databricks/aibi-clientAn API to assist developers in integrating AI/BI dashboards into their applications (AWS, Azure, GCP).
``ts
const dashboard = new DatabricksDashboard({
workspaceId: '1234567890123456',
instanceUrl: 'https://my-databricks-instance.com',
container: document.getElementById('dashboard-container'),
dashboardId: 'abcdedf123456',
pageId: 'ab12cd34',
token: tokenThatCanBeSeenByViewers,
});
dashboard.initialize();
`
To support long-running dashboard, you can pass a getNewToken function that automatically refreshes the token when it is close to expiration.
`ts`
const dashboard = new DatabricksDashboard({
// ...other required options
getNewToken: async () => {
// Return a string literal token value to the API
},
});
You can configure the embedded dashboard's color scheme using the colorScheme option.
The colorScheme option maps to the CSS color-scheme property, which allows the embedded dashboard to respect or override the user's light or dark preference.
`ts`
const dashboard = new DatabricksDashboard({
// ...other required options
colorScheme: 'light dark', // or "light", or "dark"
});
You can navigate between dashboards or pages without reloading the iframe using the navigate() method. This provides a smooth transition for users switching between different dashboards.
`ts
const dashboard = new DatabricksDashboard({
// ...other required options
});
dashboard.initialize();
// Navigate to a different dashboard
await dashboard.navigate({ dashboardId: 'xyz789' });
// Navigate to a specific page within a dashboard
await dashboard.navigate({ dashboardId: 'xyz789', pageId: 'page123' });
`
Important Notes:
- The navigate()` method can only be called after the dashboard has been initialized and loaded
- The method will throw an error if called before the dashboard is ready or after it has been destroyed