Troubleshooting the Bold BI^® Custom Widget Rendering Issues in Embedding

Issue

When you render the dashboard that contains custom widgets in your embedding application, you may encounter issues where the custom widget does not render properly, often resulting in an empty widget display and console errors.

Reason for the Issue

The primary reason for custom widgets not rendering correctly is typically related to the failure to download the necessary CSS and JavaScript (JS) files required for rendering. The rendering process for custom widgets relies on downloading these files on-demand, and if they are not retrieved successfully, the widget will not display as intended.

The console error mentioned above indicates that the required dependency files have not been downloaded properly. You can confirm this using another method: open the Network tab in your browser’s developer tools to monitor the specific download requests for the dependency files. This can help identify whether the files are being requested correctly and if any errors occur during the download process.

Solution

The most likely reason for this issue is an incorrect request URL to download the dependency files for the custom widget.

For example, if you have referenced the Bold BI^® server URL in your application with an unwanted space, that space will also be included in the request URL:

An error will occur while attempting to download the file due to this unwanted space in the URL, as illustrated below:

To resolve this, ensure that the Bold BI^® server URL is specified correctly in your embedding application, paying close attention to avoid any extra spaces or characters. Such discrepancies can prevent the proper downloading of dependency files.