HTML to PDF Extension Library

Create PDF documents from HTML inside an Integration Soup workflow.

The HTML to PDF Extension Library adds the Convert HTML to PDF activity. Use it when your workflow produces letters, reports, forms, or other styled HTML that should be turned into a PDF inside Integration Soup.

Download IntegrationSoup.HtmlToPdfActivities.msi

Using It In A Workflow

1. Run the MSI on the server machine where Integration Soup is installed.
2. Restart the Integration Soup service if it is not restarted automatically.
3. Open the Workflow Designer and add the Convert HTML to PDF activity after the step that prepares your HTML.
4. Open the activity message template and place the HTML you want to convert there. In most workflows you will right click and choose Insert Activity Message or Insert Variable so the HTML comes from an earlier step.
5. Use the response message from this activity wherever you need the generated PDF next.

What To Place In The Parameters

This activity does not have extra parameter fields. Everything it needs comes from the activity message.

What To Place In The Activity Message

Place the HTML markup you want converted into the activity message. A complete HTML document is best, but a simple fragment will also work. For example, the message can contain <html><body><h1>Discharge Summary</h1><p>...</p></body></html>.

If the HTML is already built earlier in the workflow, insert that earlier activity message so the converter always uses the latest content.

Requirements

  • Install Chrome or Edge on the Integration Soup server.
  • Chrome is the recommended choice if the service runs under a Windows service account.
  • If needed, set HTMLTOPDF_BROWSER_PATH to choose the exact browser executable to use.

What The Activity Returns

The response message is a binary message containing the PDF. Inside Integration Soup that binary content is represented as base64 text, so later steps should use the response message from Convert HTML to PDF rather than the original HTML.

Typical Uses

  • Producing referral letters, discharge summaries, certificates, and reports.
  • Converting generated HTML into a format that can be emailed or archived.
  • Creating a PDF version of a document before passing it to another workflow step.
Extension Library Directory Helpful Links

Download HL7 Soup and Integration Host

Return to the Tutorials Directory