PDFSharp extension for O11
This release grows the PDFSharp extension in the PDF Tools application from 15 to 31 actions. It keeps every existing action's signature and key, so apps that use it keep working after a dependency refresh.
Item
Value
Package
PDF Tools.oap (application PDF Tools)
Extension
PDFSharp, key n0mIhV1doUS6I5GZFWCHAw, generation 35
Built
2026-11-04
Platform
OutSystems 11, .NET Framework 4.8, 64-bit Windows servers
Actions
31: 15 existing, 16 new
Structures
6: Fields, BinaryData, InspectorInfo, ExtractedImage, and new PageText and Bookmark
Libraries: the old PDFsharp 1.50 and MigraDoc binaries are replaced by PDFsharp 6.2.4 (MIT), PdfPig (Apache-2.0) for text, and PDFtoImage with PDFium (MIT) for rendering. The logic is the same code as the ODC external library PDF_Tools, so O11 and ODC behave the same.
Sixteen actions are new. Page lists accept ranges such as 1,4-6, and an empty list means all pages. Optional numeric inputs left at 0 use the default shown.
1,4-6
Action
What it does
Inputs → output
ExtractTextFromPDF
Returns the text of each page. Scanned pages without a text layer return empty text (no OCR).
PDFBinary, PageNumberList → Pages (PageText list)
AddTextWatermark
Writes text such as CONFIDENTIAL across the middle of pages
PDFBinary, Text, PageNumberList, FontSize (60), Color (#808080), Angle (45), Opacity (30) → ResultPDF
AddTextStamp
Writes text at a position, such as an approval stamp
PDFBinary, Text, XPosition, YPosition, PageNumberList, FontSize (12), Color, IsBold, Opacity (100) → ResultPDF
AddPageNumbers
Numbers every page; {page} and {total} in the format are replaced
PDFBinary, Format ("Page {page} of {total}"), Position (BottomCenter), FontSize (10), StartNumber (1), Margin (30) → ResultPDF
AddHeaderFooter
Writes a centred header and footer
PDFBinary, HeaderText, FooterText, PageNumberList, FontSize (10), Margin (30) → ResultPDF
DecryptPDF
Removes the password and restrictions; needs the owner password
PDFBinary, Password → ResultPDF
ExtractPages
Keeps only the listed pages, in their original order
PDFBinary, PageNumberList → ResultPDF
InsertPDFAt
Inserts all pages of a second PDF before a given page
PDFBinary, InsertPDF, Position → ResultPDF
RemovePages
Removes several pages at once; at least one page must remain
FlattenForm
Turns form fields into page content, so values can't be changed
PDFBinary → ResultPDF
SetPDFMetadata
Sets title, author, subject, keywords and creator; empty keeps a value, a single space clears it
PDFBinary, Title, Author, Subject, Keywords, Creator → ResultPDF
ImagesToPDF
Creates one page per PNG or JPEG image
Images (BinaryData list), PageSize (Fit, A4 or Letter), Margin (36) → ResultPDF
CompressPDF
Compresses content and drops unused objects, without losing quality
RenderPageToImage
Renders a page as a PNG, for previews and thumbnails
PDFBinary, PageNumber, DPI (96, range 10–300), Password → Image
GetBookmarks
Returns the bookmarks with page and nesting level
PDFBinary → Bookmarks (Bookmark list)
AddBookmarks
Adds bookmarks, optionally replacing existing ones
PDFBinary, Bookmarks, ReplaceExisting → ResultPDF
Tip: FormFields_SetValues followed by FlattenForm gives a filled form that can't be edited.
The 15 existing actions keep their names and parameters but were rewritten. Rows marked behaviour change can return a different result for the same inputs.
Change
FormFields_SetValues
Fix: radio buttons and list boxes no longer crash. Checkboxes accept Yes, Off, true or false, so FormFields_Get output can be fed straight back. Fields that are already read-only can be refilled.
Behaviour change: combo, list and radio values must match an option exactly (case is ignored); a partial match such as "Ban" for Banana now raises an error instead of picking a wrong option. isOutputReadOnly = False keeps the PDF's own locks instead of unlocking every field. Read-only now also reaches nested fields.
FormFields_Get
Fix: lists nested fields and fields whose widget is a separate object, which were skipped. A PDF without a form returns an empty list instead of crashing. Values no longer carry over between fields.
ReorderPDFPages
Behaviour change: accepts any order: 1,1,2 repeats page 1 and 3,1 leaves page 2 out.
RotatePDF
Behaviour change: an empty page list rotates all pages, as documented; it used to do nothing. An angle other than 90, 180 or 270 raises an error instead of being ignored.
PDFDownloadURL
Behaviour change: failures raise an error naming the site and HTTP status, instead of returning an empty file. https:// is added when the URL has no scheme. Sends User-Agent and Accept headers, which some sites require.
AddImageToPDFs
Opacity is written into the PDF directly, without System.Drawing. The image is stored once, however many pages it is placed on.
ExtractImagesFromPDF
JPEG images are returned unchanged; others (RGB, grey, CMYK, palette) come back as PNG with their transparency. Unsupported formats are skipped.
PDFInspector
Fix: IsEncrypted is now true for PDFs that only have permission restrictions. A PDF that needs a password returns IsEncrypted and FileSizeInBytes only.
EncryptPDFWithPassword
Also blocks annotations, page assembly and full-quality printing.
MergePDFs
An empty list raises an error. A bad file is named by its position, such as "PDF 2".
RemovePageFromPDF
Removing the only page raises an error.
All page-list inputs
Behaviour change: a page that doesn't exist, or a value like 1,x, raises an error instead of being skipped silently.
GetNumberOfPagesFromPDF, SplitPDF and AppendPageToPDF work as before on the new library.
This is an update of the existing PDFSharp extension, not a new one: modules that reference it only need a dependency refresh.
Check
Result
Extension key
Unchanged (n0mIhV1doUS6I5GZFWCHAw)
Keys of the 15 existing actions
Unchanged, including PDFInspector (jC3VjkN0pESel4XbRoFaUQ), checked against the server
Parameter names, types and order
Unchanged, for example PDF_FileIn, Doc_Binaries, Page_Number, PDF_Output, NumberofPages
FormFields_SetValues.isOutputReadOnly
Still optional, default True
Structures Fields, BinaryData, InspectorInfo, ExtractedImage
Unchanged
ExtractImagesFromPDF output
Named Images in this build; PDFToolsDemo's reference showed Images2. Check expressions that use it after the refresh
The compatibility risk is in behaviour, not signatures: review callers of the rows marked behaviour change above, especially code that relied on errors being ignored.
This component provides advanced server-side PDF manipulation for OutSystems 11 Reactive Apps, powered by the PDFSharp and MigraDoc libraries. All operations work with binary data and run within the OutSystems Integration Studio context.
Rotates specific pages in a PDF.
PDFBinary
PageNumberList
Angle
ResultPDF
Encrypts a PDF with a user password.
Password
Combines multiple PDFs into a single output.
Doc_Binaries
PDF_Output
SplitPDF
Splits a PDF into individual pages.
Pages
Removes a specific page by index.
PageNumber
AppendPageToPDF
Appends a new page (binary PDF) to an existing file.
Page
GetNumberOfPagesFromPDF
Returns the number of pages in a given PDF.
PageCount
Extracts field names, values, and types from a fillable PDF.
FieldsRecord
Name
Type
Fills field values into a fillable PDF.
FieldList
IsOutputReadOnly
Downloads a PDF from a public URL.
PDFURL
Adds an image (e.g., signature, logo, watermark) to specified pages with custom size, position, and opacity.
Extracts metadata such as title, author, PDF version, number of pages, encryption status, etc.
Output Structure: InspectorInfo
InspectorInfo
Title, Author, Subject, Keywords
Creator, Producer
PDFVersion
IsEncrypted
FileSizeInBytes
Reorders pages in a PDF based on a custom comma-separated list.
"3,1,2"
Extracts embedded image content from a PDF and returns them by page.
Output Structure: ExtractedImageRecord
ExtractedImageRecord
Image (Binary)
Image
Page (Integer)