FAQ

What does the name ReportBro mean?

The name comes from REPORTing in a BROwser, the designer is a javascript library and can thus be included in any web application and run in your browser. Of course Bro is also a slang word and has a second meaning: your best friend when it comes to reporting!

Which browsers are supported?

The latest version of ReportBro is compatible with
- Firefox 53+
- Chrome 58+
- Safari 9+
- Microsoft Edge 14+
- Opera 46+

Which web frameworks are supported?

All Python frameworks are supported since ReportBro Lib is a standalone Python package. We provide fully working demo applications for Flask, Django and web2py. If you're using a different web framework you can still look at these demos to see how ReportBro can be integrated in a web application.

I have bought a commercial license, now what?

Once we can verify the payment you will receive an email including the license and support contact. In the meanwhile, of course, you can start becoming familiar with ReportBro.

How long is my commercial license valid?

You can use the current release and any version released within 1 year after your purchase. These releases can be used as long as you want, there are no time restrictions.

Can I use ReportBro in my console application?

Yes! First you need to create your report template. To get started you can make a simple html page including ReportBro Designer and initialize it with menuShowDebug to true. This adds a button in the Designer menu bar to print your report template to the Javascript console. Copy the report template from the console output in your Browser and save it in a file (or a database). Install reportbro-lib in your Python environment so you can use the lib in your program. Together with your previously saved report template you can now generate PDF and xlsx files in your Python app.

Why can't I see images and buttons in ReportBro Designer in Firefox?

ReportBro uses icon fonts instead of images and due to Firefox's strict origin policy they cannot be loaded when running a demo on your local machine (from ../dist/iconfonts). In your Firefox browser go to about:config and make sure security.fileuri.strict_origin_policy is set to false.

Why is there no PDF preview in Microsoft Edge?

In case of using a report server on localhost you have to enable loopback first with CheckNetIsolation LoopbackExempt -a -n=Microsoft.MicrosoftEdge_8wekyb3d8bbwe
see also https://stackoverflow.com/questions/30334289/cant-open-localhost-in-microsoft-edge-project-spartan-in-windows-10-preview#30334398

What if my server application is not written in Python? Can I still use ReportBro?

The best solution is to create an own application which is only responsible for generating reports. This application could be similar to the demo application but without any templates and views to view and edit the data. The app should connect to the same database as your main application so it can directly query all necessary data for the reports.

Run the python application on a different port (e.g. 8100) and every time you show a report you just link to this application (e.g. http://localhost:8100/albums/album/report to get the albums report in the demo app). Alternatively you can also use a web request to get the report in case you need it server-side (e.g. to store the pdf in the db or to merge multiple PDFs).

If the reports can only be accessed with authentication you either have to implement authentication on the report server as well or you do not allow direct access of the reports from outside and instead only allow access from your main application (where you can fetch them with a web request).

Can I use ReportBro lib with .Net?

You could try to run the lib with IronPython. However, we don't have experience using it and cannot ensure its practicability.

Alternatively you can run a separate report server with a Python web framework which is only responsible for generating your reports. See question above.

How can I add additional fonts?

Additional fonts must be added in ReportBro Designer and in ReportBro Lib. To set additional fonts in the Designer you must specify the additionalFonts property when initializing the ReportBro instance. An example of an additional font can be found in the certificate demo.

On the server the same font must be added as additional_fonts

Does ReportBro support Chinese language?

Yes, you need to use a font which supports all your characters you want to print. The standard fonts do not include Chinese characters.

See question above how you can include additional fonts. Make sure the text elements in ReportBro Designer which displays Chinese characters uses your additional font so the text can be printed.

Why doesn't ReportBro support Khmer, Tai, Arabic languages and Right-to-left printing?

In some languages there is no 1:1 mapping between unicode codepoints (text content) and font glyphs, e.g. there can be multiple codepoints rendered as a single glyph. The fpdf library which we use for pdf rendering does not support this. Therefore, also ReportBro doesn't support such languages for the time being.