IBM 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, you
must set the Adobe Reader preferences and the Rational Functional
Tester script assure values.
- Setting preferences for Adobe Reader 7.0
- Open Adobe Reader 7.0.
- Click .
- Click Next on Accessibility Setup Assistant
page.
- Select Fit page as the Default
display zoom in Screen 2 of 5, and
click Next.
- Clear Confirm before adding tags to documents in Screen
3 of 5, and click Next.
- 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 .
- Click Next.
- Select Display PDF documents in the web browser in Screen
5 of 5.
- Click Done.
- Click in Adobe Reader.
- Click the Page Display category and select Single
Page as the Default Page Layout,
and click OK.
- Setting preferences for Adobe Reader 8.0
- Open Adobe Reader 8.0.
- Click .
- Click Next twice.
- Clear Confirm before tagging documents in Screen
3 of 5 and click Next.
- 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.
- Click Next.
- Select Display PDF documents in the web browser in Screen
5 of 5.
- Click Done.
Note: 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
- Open Rational Functional Tester, and click .
- In the Preferences window, expand , and then click Script Assure.
- Click Advanced.
- 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:
- Create a registry key: HKEY_LOCAL_MACHINE\SOFTWARE\Rational Software\Rational
Test\8\Options.
- Create a new DWORD variable InvocationTimeout.
- For documents of 70 pages or more, specify the timeout value of 8*60*1000 milliseconds.
- Restart IBM Rational Functional Tester and restart
Adobe Reader.
- Perform the clicks on the PDF document till this message is generated:
"Ignoring the click on PDF document in document mode setting".
- 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.