When we originally released the Muhimbi PDF Converter for SharePoint On-Premises and Online and PDF Converter API and Server Platform, our assumption was that the majority of our customers wanted to convert MS-Office content such as Word, Excel, InfoPath, Visio and PowerPoint to PDF. Although that is certainly a common use case, we were surprised by the number of people wanting to convert HTML content, specifically SharePoint pages such as Wikis, publishing pages, Nintex Forms, and the ‘properties page’ for List and Document Library items.
Although this worked very well for a long time, some of our back-end logic leverages Internet Explorer’s internal rendering engine, which has been causing more and more issues over the years while Microsoft – for good reasons – made some fundamental changes to IE’s internal workings. As a result, when using a ‘pre-8.3 release of the converter, you may find that particularly HTML5 pages (e.g. SP2013 and later) are rendered as bitmaps and ‘overflow CSS’ elements are cut-off.
Original SharePoint Web page (left), converted to PDF using the Screen Media type (middle) and the Print Media type (right)
The key features are as follows:
- Support for Print and Screen CSS media types to optimise output for Print / PDF Conversion.
- Available to all client technology including Nintex Workflow, Nintex Forms, SharePoint Designer, Flow, Logic Apps, REST & Web Services API as well as the SharePoint User interface.
- Enabled by default, with the option to switch back to the legacy HTML Converter using our API or config file.
- The MSG and EML Converter uses the new engine by default for HTML based emails.
- Support for converting SharePoint Online URLs.
- Improved error reporting, including authentication related issues.
- Modify the ‘View Port’ size to allow responsive web content to output the appropriate version (e.g. mobile or desktop version)
We support it all, Nintex Workflow 2007, 2010, 2013 and 2016
SharePoint Designer Workflows are supported as well ranging from SP2007-2016, including Workflow Manager
Please keep in mind that HTML is not the best format for print or PDF Conversion purposes. Although our new HTML Converter is much improved, it is not magic. Depending on your exact needs / system settings you may need to experiment with the various settings. Our support desk staff is very experienced, so contact us if you have any questions or require assistance.
Some points to take into account:
When converting SharePoint content, it is recommended to disabled the ‘Minimal Download Strategy’ SharePoint Feature as it really gets in the way. (See this article for details). If this is not an option then set the conversion delay (see below) to 1000 (milliseconds).
The Conversion Services will need to authenticate against the page you are looking to convert. The HTML Converter fits in with Windows’ standard security model, so you may need to tweak the server’s internet settings as per this Knowledge Base article. Naturally you have to make sure that the account the Conversion Service runs under has the appropriate privileges to read the page that is being converted.
The converter has no knowledge of the current user’s browser session. If the user has modified the page (e.g. collapsed / opened certain sections) or has made changes to the page without saving, then the converter will not reflect these changes. When converting HTML to PDF, the Converter requests the specified URL from scratch using the credentials of the account the Conversion Service runs under.
Any questions or comments? Leave a message below or contact our friendly support desk, we love to help.
Labels: Articles, HTML, pdf, PDF Converter, PDF Converter Services