The Image Update Panels
The Image Update panels help you manage, modify, and work with previously existing images during and after runtime. The panels are triggered when an image or text search is unsuccessful. When a search failure occurs, depending on the settings selected, you either see the Image Update panel, or the Auto Update panel.
The Image Update panel is shown during runtime at the time of search failure. It allows you to change existing image search settings, capture new images, create collections, or replace previously existing images in order to remedy the search failure before continuing the script run. The Auto Update panel displays following a script run where an image search failure occurred, and Eggplant Functional found a remedy, modifying the search settings in order to find a match. Those changes can be saved automatically to your script and assets.
Menu options used to enable the Image Update panel also apply to the OCR Update Panel.
See the Image Diagnostics section on The Image Viewer page for information about image search settings and selecting diagnostic searches.
Enabling the Image Update Panel
The Image Update panel lets you work with image diagnostics and fix image searches when an image is not found during a script run. Depending on the selected settings, this panel also appears when multiple instances of an image are found that were not anticipated by the script, and can also trigger the Auto Update functionality, allowing you to save any changes made to images during the script run.
The Image Update panel appears at runtime when you choose the Guided Update (Show Panel) option. If Auto Update (Log Changes) is selected, then the Auto Update panel displays following the script run. Run menu options control both the Image Update panel and the OCR Update panel.
You can enable the Image Update panel and related Auto Update panel functionality on the main menu by adjusting the options shown in the Run > Image Update menu.
The Image Update panel menu, found under Run > Image Update
Eggplant Functional allows you to enable both Auto Update and Validate Successful Image Searches at the same time. Doing so forces your system to run Auto Update on every search and can cause your scripts to run very slowly.
Your choices when using the Image Update menu are as follows.
When an Image or Text Is Not Found
-
Update Off (Throw Exception): Eggplant Functional throws an exception and the script fails when an image or optical character recognition (OCR) search does not return a match. The Image Update functionality is not used.
-
Guided Update (Show Panel): This option opens the Image Update panel during runtime when an image search fails, so that you can adjust settings to find an appropriate match. This option lets you use the Image Update panel interactively, which gives the most complete control over text matches. This method is best for attended script runs. This option was formerly called Show Panel (Manual Update).
-
Auto Update (Log Changes): Eggplant Functional logs a warning, and then runs various diagnostics to find the image or text that wasn't found. If it finds the image with the new settings, it logs which settings were used, and then continues the script run using those new settings. If you select Auto Apply from the Asset Healing section in the Run preferences panel, remedies are applied and saved to the script. This changes the image search settings for future script runs, and affects any other tests using that image.
New FeatureAutomatic Asset Healing is available starting in Eggplant Functional 21.0.0.
If Identify Remedy is selected, but NOT Auto Apply, changes made during the script run apply to the current script only. When a script run ends, the Auto Update panel appears, and you can then decide which of the changes you want to save. Applying these changes modifies the image search settings for future script runs, and affects any other tests using that image. When applying changes, check your test to see where the image is used, as changes saved to the image search settings might conflict with your script.
For more on using the Auto Update panel, see Using the Auto Update Panel.