How to deploy PhantomJS WebKit manually in Bold Reports®
Bold Reports® uses PhantomJS, a headless WebKit script written in JavaScript, for image and PDF export in reports and schedules.
What is PhantomJS and why does Bold Reports® need it?
PhantomJS is the executable that Bold Reports® needs to achieve image and PDF export features in reports and schedules. Without it, the image and PDF export options in reports and schedules are no longer available.
PhantomJS is free and open-source software that may be licensed under the MIT, BSD, LGPL or GPL, or other similar licenses. It contains third-party code. It is your decision if you choose to download PhantomJS, but you must accept all of its terms and conditions if you want to use it with Syncfusion®’s products.
How do I download PhantomJS?
To download and install the PhantomJS application for Bold Reports®, you must accept the terms of the LICENSE and Third-Party documents. Then, download PhantomJS for Windows, Linux, and Azure App Service.
How do I install PhantomJS in Bold Reports®?
After the download completes, extract the zip file. Then, copy the PhantomJS application from the following extracted location:
| Operating System | Extracted Location |
|---|---|
| Windows | {Extracted Location}\PhantomJS-2.1.1-windows\bin |
| Linux | {Extracted Location}\phantomjs-2.1.1-linux-x86_64\bin |
| Azure App Service | {Extracted Location}\phantomjs-2.0.0-windows\bin |
Place the PhantomJS executable file in the following location:
{Deployed Location}\BoldServices\app_data\reporting\exporthelpers
Example:
C:\BoldServices\app_data\reporting\exporthelpers\phantomjs.exe
Note: If you are using Bold Reports® version 5.4 or later, install the Chromium package instead of PhantomJS.
Frequently asked questions
Which Bold Reports® versions should use Chromium instead of PhantomJS?
If you use Bold Reports® version 5.4 or later, install the Chromium package instead of PhantomJS.
What happens if PhantomJS is not installed?
Without PhantomJS, the image and PDF export options in Bold Reports® reports and schedules are not available.