[PDFBOX-5470] PDActionEmbeddedGoTo does not accept a Destination with a page number or string

• Type: Bug
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 2.0.26
• Fix Version/s: 2.0.27, 3.0.0 PDFBox
• Component/s: AcroForm
• Assignee: Tilman Hausherr
• Reporter: Gilad Denneboom
• Created: 03/Jul/22 09:50
• Updated: 29/Sep/22 17:57
• Resolved: 06/Jul/22 03:43

Description

According to Table 202 of the PDF 32000-1:2008 specs, the P key under the Target Directory of an Embedded Go-To Action is an "integer or byte string", with the following description "If the value is an integer, it specifies the page number (zero-based) in the current document containing the file attachment annotation. If the value is a string, it specifies a named destination in the current document that provides the page number of the file attachment annotation."

However, the current implementation of PDActionEmbeddedGoTo does not accept using the setPageNumber command by itself when setting the Destination dictionary, and throws an IllegalArgumentException unless setPage is used to set the target page as a PDPage object, which is not specified in the documentation. Also, there doesn't seem to be a way to specify the target as a string, if a named destination is to be used.
This applies to both the Destination dictionary and the Target Directory, but when creating such a link in Acrobat the Target Directory does not contain a P value at all, only the Destination dictionary does, and in the form of a number. This should be possible to replicate using PDFBox.

 

Attached are a sample file with a pre-existing link and a PDF attachment, the code trying to set that link's action to open the attachment on page 3, and the resulting error message stack trace.

Issue Links

• relates to: PDFBOX-4117 Implement GoToE action-type