Adobe PDF documents support

IBM Rational Functional Tester supports testing of Adobe PDF 7.0 and 8.0 read-only documents. You can test PDF documents that are displayed in a browser or in a stand-alone PDF Reader. A functional test script that is recorded for documents that are displayed in a stand-alone PDF Reader can be played back when the document is displayed in a browser and vice-versa.

The level of granularity that IBM Rational Functional Tester supports depends on the way the PDF document is designed. For example, if the entire page of a PDF document is designed to contain one text object only, the verification point highlighter captures only the page level contents and does not get contents inside the page.

The cross compatibility of testing PDF read-only documents is possible only for the document controls and not the reader controls. For example:

• Stand-alone reader and browser: A test script that is recorded on a PDF document that is opened in standalone reader can be played back on a PDF document opened in browser, provided that the script is recorded for document controls only.

• Reader 7.0 and Reader 8.0: A test script that is recorded on a PDF document that is opened in standalone Adobe Reader 7.0 can be played back on a PDF document opened in Adobe Reader 8.0, provided that the script is recorded for document controls only.

This version of IBM Rational Functional Tester includes support for testing PDF documents that contain these controls:

• Page
• Button
• Check box
• Toggle button
• Table
• Text box
• Form text
• Link
• Tree
• Combo box
• Graphics
• Document

Prerequisites: Before you start testing PDF documents, set the Adobe Reader preferences and the Rational Functional Tester script assure values.

• Setting preferences for Adobe Reader 7.0

  1. Open Adobe Reader 7.0.

  2. Click Help > Accessibility Setup Assistant.

  3. Click Next on Accessibility Setup Assistant page.

  4. Select Fit page as the Default display zoom in Screen 2 of 5, and click Next.

  5. Clear Confirm before adding tags to documents in Screen 3 of 5, and click Next.

  6. In Screen 4 of 5::

     • For Page mode setting, select Deliver currently visible pages.

     • For Document mode setting, select Deliver the entire document at once .

  7. Click Next.

  8. Select Display PDF documents in the web browser in Screen 5 of 5.

  9. Click Done.

  10. Click Edit > Preferences in Adobe Reader.

  11. Click the Page Display category and select Single Page as the Default Page Layout, and click OK.

• Setting preferences for Adobe Reader 8.0

  1. Open Adobe Reader 8.0.

  2. Click Help > Accessibility Setup Assistant.

  3. Click Next twice.

  4. Clear Confirm before tagging documents in Screen 3 of 5 and click Next.

  5. In Screen 4 of 5:

     • For Page mode setting, select Only read the currently visible pages in the Page vs Document field.

     • For Document mode setting, select Read the entire document at once in the Page vs Document field.

  6. Click Next.

  7. Select Display PDF documents in the web browser in Screen 5 of 5.

  8. Click Done.

     Verify that Click to show one page at a time button at the top tool bar of the Adobe Reader is selected for recording and playing back.

• Setting the IBM Rational Functional Tester script assure values

  1. Open Rational Functional Tester , and click Window > Preferences.

  2. In the Preferences window, expand Functional Test > Playback, and then click Script Assure.

  3. Click Advanced.

  4. Specify these values on the Script Assure page:

     • Maximum acceptable recognition score: 5000

     • Last chance recognition score: 10000

     • Ambiguous recognition scores difference threshold: 1000

     • Warn if accepted score is greater than: 5000

Notes:

• When you open a new document in Adobe Reader, click the PDF document once after the recorder starts. This click is required for the reader to process the document.

• Only document verification point is supported in the document mode setting. A verification point can be taken after the mandatory click in the document. Any clicks on the PDF document in document mode setting while recording are ignored and no code is generated.

• Use the Page mode setting for larger documents.

• To take data verification point on a large document in Document mode, follow these steps:

  1. Create a registry key: HKEY_LOCAL_MACHINE\SOFTWARE\Rational Software\Rational Test\8\Options.

  2. Create a new DWORD variable InvocationTimeout.

  3. For documents of 70 pages or more, specify the timeout value of 8*60*1000 milliseconds.

  4. Restart IBM Rational Functional Tester and restart Adobe Reader.

  5. Perform the clicks on the PDF document till this message is generated: "Ignoring the click on PDF document in document mode setting".

  6. Take the data verification point.

• If a particular control in the PDF document spans over two or more lines, the highlight rectangle covers all the lines in that control location. Other controls might fall in the highlight rectangle. But when verification point is taken on the control that spans over two or more lines, the other controls that fall within the screen rectangle is not considered.

• You might not be able to test the PDF documents correctly if the font of the letters in the PDF document is not available or installed in the computer.