Self Healing in Zoho QEngine | Zoho QEngine Help

Self-healing in Zoho QEngine

In a nutshell
Self-healing in Zoho QEngine is an AI-driven mechanism that detects when element locators become invalid due to UI changes and suggests updated locators to keep test execution on track. When a locator no longer matches the updated element, QEngine analyzes the element on the page and proposes alternate locators. You can review and approve these suggestions from the self-healing logs, reducing the need for manual locator updates after application changes.

1.  Overview  

Self-healing is an AI-driven mechanism that automatically identifies and repairs broken or obsolete locators in test cases, making the automation testing process more resilient and efficient. Locators are identifiers such as IDs, class names, XPath, or CSS selectors used to find elements on a webpage, like buttons or forms. When UI changes occur, like updates or redesigns, locators can break, leading to test failures. Self-healing adapts to these changes, reducing the manual effort to update locators and lowering test execution time.
 
When implementing self-healing locators, it is crucial to establish effective locator strategies and priorities. These strategies help the self-healing mechanism prioritize the use of stable and unique locators. In Zoho QEngine, elements and their locators are stored centrally, and their priority can be influenced by the order in which they are set. During test execution, if a locator fails, the self-healing feature suggests alternate saved locators for that element, which helps maintain test continuity and reduce flaky or unstable tests. After each test run, any locator adjustments made by the self-healing mechanism are available in self-healing logs for review.

2. Enabling Self-healing Mechanism

To enable self-healing mechanism, follow the steps below:
  1. Navigate to Settings > Preferences.
  2. Toggle on Self-Healing.


Once enabled, the elements referenced in the test cases will automatically self-heal if obsolete locators are detected.

3. Self-healing in Live Preview

The self-healing mechanism continuously monitors the website or application for changes in the structure or attributes of elements. This is done during test execution, and may also be performed in a test plan. When changes are detected, the self-healing mechanism dynamically adjusts the locators to match the modified elements.
 
Let's understand how the self-healing mechanism works with the execution of a test case. Consider an example with a recorded web test case. Here, the interacted elements of the website are captured and stored automatically in the Elements page.

3.1 Self-healing Logs

In the live preview, the broken locators will be self-healed with a proposed locator in the logs, represented in green. To complete the self-healing process, you need to confirm the proposed locators. The preview contains Self-Healing logs apart from the Logs and Console Log.

 

 

3.2. Steps for Self-Heal Approval 

The self-healing logs will contain a list of proposed locators. By default, these locators will be in the Pending status.

 

   

To approve the proposed locators:
  1. Select the locators you wish to approve and click Approve.

  1. Here, you will be prompted with the list of selected proposed locators to confirm your approval. To continue with the approval, click Proceed.

 

Upon confirmation, the proposed locator is prioritized for that element. The updated order takes effect from the next execution and is reflected on the Elements page, where locators are stored. Until the request is approved, the proposed changes remain in a pending state unless further modifications are made to the element's locators.
Alternatively, you can click the Approve icon { } corresponding to each proposed locator to approve individual locators.

 

Notes
Note: Using the filter option, you can see the list of locators: All, Approved, and Pending.

4.  Self-Healing Mechanism in Test Plan  

The self-healing mechanism can be initiated for test cases within test plans. Let's see how the AI-driven mechanism works for test plans.
 
To self-heal the test cases that are part of a test plan. Follow the steps below:
  1. Navigate to the Results page.
  2. The test cases with self-healing {} icon differentiates other test cases from the self-healed test cases.

     
  1. Click on the self-heal icon to view the list of proposed locators for that corresponding test plan.

 

 

Alternatively, you can view the test plan results and select the test case that has the self-heal icon.
 

 

  1. Select the locators that need to be approved and click Approve. Alternatively, click the Approve icon { } beside the Status section to individually approve the proposed locators. 

  1. The status of the test case will change from Pending to Approved once the approval is confirmed with the selected proposed locators.

Notes
Note: The broken locator will be replaced with the proposed locator only upon your approval. This change prioritizes the proposed locator over the existing one. Learn more about locators

5.  Related Links  

6. What's Next?

Next Steps
Previous Steps
Next Steps
Now with the self-healing enabled, users can confidently test their cases, knowing locators will automatically adjust. They can also add these tests to broader test plans, ensuring smoother execution and reduced manual intervention.
Previous Steps
Before using the self-healing feature, users must ensure it is enabled in the Preferences section. Without it, they would manually manage and update locators whenever failures occurred, requiring frequent checks and adjustments.
 







        Create. Review. Publish.

        Write, edit, collaborate on, and publish documents to different content management platforms.

        Get Started Now


          Access your files securely from anywhere

            Zoho CRM Training Programs

            Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.

            Zoho CRM Training
              Redefine the way you work
              with Zoho Workplace

                Zoho DataPrep Personalized Demo

                If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.

                Zoho CRM Training

                  Create, share, and deliver

                  beautiful slides from anywhere.

                  Get Started Now


                    Zoho Sign now offers specialized one-on-one training for both administrators and developers.

                    BOOK A SESSION







                                Quick LinksWorkflow AutomationData Collection
                                Web FormsEnterpriseOnline Data Collection Tool
                                Embeddable FormsBankingBegin Data Collection
                                Interactive FormsWorkplaceData Collection App
                                CRM FormsCustomer ServiceAccessible Forms
                                Digital FormsMarketingForms for Small Business
                                HTML FormsEducationForms for Enterprise
                                Contact FormsE-commerceForms for any business
                                Lead Generation FormsHealthcareForms for Startups
                                Wordpress FormsCustomer onboardingForms for Small Business
                                No Code FormsConstructionRSVP tool for holidays
                                Free FormsTravelFeatures for Order Forms
                                Prefill FormsNon-Profit

                                Intake FormsLegal
                                Mobile App
                                Form DesignerHR
                                Mobile Forms
                                Card FormsFoodOffline Forms
                                Assign FormsPhotographyMobile Forms Features
                                Translate FormsReal EstateKiosk in Mobile Forms
                                Electronic Forms
                                Drag & drop form builder

                                Notification Emails for FormsAlternativesSecurity & Compliance
                                Holiday FormsGoogle Forms alternative GDPR
                                Form to PDFJotform alternativeHIPAA Forms
                                Email FormsFormstack alternativeEncrypted Forms

                                Wufoo alternativeSecure Forms

                                TypeformWCAG

                                  Zoho FSM Video Tutorials


                                        All-in-one knowledge management and training platform for your employees and customers.

                                                  Create. Review. Publish.

                                                  Write, edit, collaborate on, and publish documents to different content management platforms.

                                                  Get Started Now




                                                                    You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.




                                                                        Manage your brands on social media


                                                                          • Desk Community Learning Series


                                                                          • Digest


                                                                          • Functions


                                                                          • Meetups


                                                                          • Kbase


                                                                          • Resources


                                                                          • Glossary


                                                                          • Desk Marketplace


                                                                          • MVP Corner


                                                                          • Word of the Day


                                                                          • Ask the Experts


                                                                            Zoho Sheet Resources

                                                                             

                                                                                Zoho Forms Resources


                                                                                  Secure your business
                                                                                  communication with Zoho Mail


                                                                                  Mail on the move with
                                                                                  Zoho Mail mobile application

                                                                                    Stay on top of your schedule
                                                                                    at all times


                                                                                    Carry your calendar with you
                                                                                    Anytime, anywhere




                                                                                          Zoho Sign Resources

                                                                                            Sign, Paperless!

                                                                                            Sign and send business documents on the go!

                                                                                            Get Started Now




                                                                                                    Zoho TeamInbox Resources





                                                                                                              Zoho DataPrep Demo

                                                                                                              Get a personalized demo or POC

                                                                                                              REGISTER NOW


                                                                                                                Design. Discuss. Deliver.

                                                                                                                Create visually engaging stories with Zoho Show.

                                                                                                                Get Started Now








                                                                                                                                    • Related Articles

                                                                                                                                    • Converting manual test cases to automation scripts using Zia

                                                                                                                                      In a nutshell Zia's manual-to-automation capability converts your manual test case into a ready-to-run automation script without writing any code. It maps each step to the corresponding UI element on the target page, validates them live in your ...
                                                                                                                                    • Manual testing in Zoho QEngine

                                                                                                                                      In a nutshell Manual testing is one of the core testing types supported in Zoho QEngine, allowing teams to create, organize, and track test cases with ease. 1. Overview Manual testing is one of the supported testing types in Zoho QEngine. It helps ...
                                                                                                                                    • Configuring Zia for Zoho QEngine

                                                                                                                                      What does this page cover Learn how to configure an AI model for Zia, Zoho QEngine's AI assistant, to enable capabilities such as generating manual test cases and test data. This page explains how to set up Zoho GenAI or connect external AI models ...
                                                                                                                                    • Create manual test cases using Zia

                                                                                                                                      In a nutshell Zia transforms natural language prompts into AI-generated test scenarios with clear steps and expected outcomes, streamlining QA efforts. Using the capabilities of NLP and LLM technology, it suggests relevant test cases to simplify ...
                                                                                                                                    • Introduction to Zoho QEngine

                                                                                                                                      In a nutshell Zoho QEngine is a unified test automation platform for your entire testing lifecycle. From test creation and management to execution and reporting, everything lives in one workspace. It supports cross-platform testing across web, ...
                                                                                                                                      Wherever you are is as good as
                                                                                                                                      your workplace

                                                                                                                                        Resources

                                                                                                                                        Videos

                                                                                                                                        Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                                                                                                        eBooks

                                                                                                                                        Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                                                                                                        Webinars

                                                                                                                                        Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                                                                                                        CRM Tips

                                                                                                                                        Make the most of Zoho CRM with these useful tips.



                                                                                                                                          Zoho Show Resources