Data from PDF Extension Library
The Data from PDF Extension Library adds the Data from PDF custom activity. It reads an inbound binary PDF message, pulls useful PDF content into JSON, identifies simple Label: value fields where possible, and returns the JSON response to the workflow.
The activity extracts selectable text across PDF document layouts. For scanned image-only PDFs, use OCR before this activity.
Download IntegrationSoup.DataFromPdfActivities.msi
Using It In A Workflow
- Run the MSI on the Integration Soup server.
- Restart the Integration Soup Host Service so the server loads the new activity.
- Add Data from PDF after the step that supplies the PDF.
- Pass the PDF as the activity message using a binary message. Binary PDF content is normally represented as base64 text inside Integration Soup.
- Run the workflow once with a representative PDF.
- Open the workflow logs and copy the activity response JSON.
- Use the response JSON in following transformers. You can create mappings from the Data from PDF response, or type JSON paths manually.
- In the version 5 browser, paste the representative JSON into the activity's Response Message sample below the binary input template. For other designers, use the JSON mapping steps below.
Why The First Run Matters
The JSON response structure depends on the PDF. A representative response gives the designer the field names and nested values to offer when you create mappings.
The JSON from the first run shows the actual structure produced by your PDF. Use a representative PDF that contains all fields you expect to bind. If different PDF layouts produce different fields, use a sample that contains the widest useful structure.
Getting A Binding Tree
In the version 5 browser response sample editor, paste a representative response from the logs into Data from PDF. The sample provides the field tree for designing bindings. At runtime, each PDF supplies its own extracted values.
Designers Without A Response Sample Editor
You can enter JSON paths directly in transformer mappings. To create a binding tree in a designer without a response sample editor, add a Run Code activity immediately after Data from PDF and use it as a JSON pass-through sample step.
- Add a Run Code activity after Data from PDF.
- Replace the default C# code with this pass-through line:
CurrentActivity.ResponseMessage.SetText(CurrentActivity.Message.Text); - Change the Run Code message type to JSON.
- In the Message Template, delete the default content.
- Right-click inside the Message Template textbox, choose Insert Activity Message, then select the Data from PDF Response message.
- Click the Response Message textbox so the editor opens, then paste the JSON copied from the workflow logs.
- Save the Run Code activity.
- In later activities, bind from the Run Code response message to get the full JSON binding tree.
What The Activity Returns
The JSON response includes document details, detected label-value fields, full text, per-page text, and line information that can help when checking the result. The detected fields are best-effort and come from visible text patterns such as Invoice Number: 12345.
If text appears after a blank label but does not have its own label, the activity keeps it under generic names such as unlabeledAfterAcc, unlabeledAfterAccLine1, and unlabeledBlock1Line1. The same pattern is used for other labels. These names describe where the text was found, not what the text means.
Requirements And Notes
Microsoft .NET Framework 4.8 or later is required. Setup stops with a prerequisite message if it is missing. Install the .NET Framework 4.8 Runtime, restart Windows if requested, and run setup again. Version 4.8.1 also satisfies the requirement.
- The activity expects a PDF in the inbound binary message.
- The PDF must contain selectable text. Scanned PDFs need OCR first.
- If a PDF has unusual layout, inspect the
textandpagessections in the response JSON.
- Extension Library Directory
- HTML to PDF
- RTF to PDF
- Azure Activities
- AWS Activities
- Encryption Activities
- SFTP Activities
- ZIP Activities
- Validate HL7 Transformer
- HL7 Value Transformers
- Data from PDF