The Image Tester is a semi-codeless stand-alone solution with which you can perform visual validations for PDF files.
With Image Tester, the visual validation process is divided into two sections:
1. Organize the PDF files (user's responsibility).
It is necessary to organize the PDF files in the following hierarchy:
Batch -> Test -> Step
Batch:
Batch is used to gathering multiple tests together. This will be a folder containing the tests which you want to gather under the same batch, and the batch name will be the name of that folder.
Test:
This will be a folder containing the PDF files which you want to validate, each file is a test, and the test name will be the name of that file.
Steps/Pages:
These are the pages of the PDF file, and the steps names will be the index of the pages.
2. Visual validating the PDF files with Image Tester.
After creating the folders hierarchy, download the Image Tester tool (attached).
Next, specify which tests/steps you wish to visually validate:
- Open your CMD/Terminal and go to the ImageTester.jar location
- To run a test, execute the following command:
Java -jar ImageTester.jar -k <YOUR_API_KEY> -f <BATCH_FOLDER_FULL_PATH>
- For optional parameters see the following list or execute Java -jar ImageTester.jar
Optional Parameters:
-f [path]- A path to target folder or file-a [app-name]- Set the application name under directoryTest; default = ImageTester-p [http://proxy{,user,pass}]- Set proxy and optional username + password-s [server]- Set Applitools server url-ml [match-level]- Set the comparison level, one from Strict/Content/Layout; Default = Strict-br [branch]- Set the branch-pb [parent-branch]- Set the parent branch-bn [baseline]- Set custom baseline name-vs [WidthxHeight]- Set the viewport size identifier-lf [log-file]- Set log fine name to enable logging-os [osname]- Set custom os-ap [browser name]- Set browser or equivalent hosting application name-th [number]- Specify max. concurrent workers (Threads). default= 3-fn [testName]- Force all test names to be specific name. This will force all tests to be matched with a single baseline.-fb [batchName]- Set unified flat batch to contain all the discovered tests regardless their hierarchy.-sq [sequenceName]- Set batch sequenceName for unified insights in applitools' dashboard.-as- Set automatic save on failures-st- Split steps to individual tests-id- Ignore displacement of shifting elements.
For Documents (PDFs) only:
-di [dpi]- Set the quality of the conversion on PDF files-sp [pages]- Comma separated page numbers to include in PDF testing (ie: 1,2,5,7); Default all included-pp [password]- The password if the PDF files protected-pn- Preserve original directory test names when specifying pages
Note: Same as the fully coded solution, the first run will create your baseline, and from the second run, it will check for mismatches.
The Image Tester can also be used for validation of image files. Click HERE to learn how.
