PDF Add-in (tech preview)

Use the UFT PDF Add-in to test interactive PDF documents open in Adobe Acrobat Pro.

Note: The documents you test must be displayed in Single Page View. (In Acrobat: View > Page Display > Single Page View).

General Information

Add-in Type

This is a Windows-based add-in. Much of its functionality is the same as other Windows-based add-ins.

Supported Environments

For details on supported Adobe Acrobat Pro versions, see the PDF Add-in section of the Unified Functional Testing Product Availability Matrix.


Configure the Reading options in Adobe Acrobat Pro in one of the following ways:

  • In the Adobe Acrobat Pro dialog box that opens when you first use UFT to record or spy on a PDF document:

    In Reading Order, select Infer reading order from document

    In Reading Mode Options, select Read the currently visible pages only

    Select Do not show this dialog again to avoid seeing it each time you use UFT to test PDF documents.

    Tip: If the dialog box does not open, set the Reading options in Adobe Acrobat Pro, using Edit > Preferences.

  • In Adobe Acrobat Pro, select Edit > Preferences, and then choose the Reading category.

    In Reading Order, select Infer reading order from document

    In Page vs Document, select Only read the currently visible pages

    Clear the Confirm before tagging documents option to prevent the Adobe Acrobat Pro dialog box from opening each time you use UFT to test PDF documents.

Important Information

UFT recognizes PDF documents with different names as different test objects.

If your test saves a file with a different name, subsequent test steps must use a different test object for the file. You can do this in one of the following ways:

  • Add another test object to the object repository

  • Use a programmatic description for the test object, which uses the new file name.

    For example:

    PDFApplication("name:=NewFileName.pdf - Adobe Acrobat").GoToPage 5

Test Object Methods and Properties

The PDF Add-in provides test objects, methods, and properties that can be used when testing interactive PDF documents. For details, see the PDF section of the UFT Object Model Reference for GUI Testing.

Known issues Known Issues - PDF Add-in


Opening Your Application

You can open your PDF document before or after opening UFT.

A test can open the document during a run, using the SystemUtil.Run method.

  • If Adobe Acrobat Pro is configured as the default application for PDF files, call SystemUtil.Run with the PDF file name.
  • Otherwise, call the method with Adobe Acrobat Pro as the application to run, and with the file it should open.


Configuration Options

Use the Windows Applications pane.
(Tools > Options > GUI Testing tab >Windows Applications node)

Record and Run Settings

Use the Windows Applications tab.
(Record > Record and Run Settings

If you select the Record and Run only on radio button in the Record and Run Settings dialog box, the settings also apply to (limit) the applications that are recognized for Object Spy and other pointing hand operations.

Custom Active Screen Capture Settings

Use the Windows applications section.
(Tools > Options > GUI Testing tab > Active Screen node > Custom Level)

Application Area Additional Settings

Use the Applications pane.
In the application area, select Additional Settings > Applications in the sidebar.