Creating Android or iOS test cases using Editor or Builder mode | Zoho QEngine Help

Creating mobile test cases using editor or builder mode

In a nutshell

Automated mobile test cases for Android and iOS can be created manually using Editor or Builder mode within Zoho QEngine's test case editor. Editor is a pro-code scripting mode that gives automation experts full control to write, customize, and reuse test logic directly as scripts. Builder is a visual, block-based interface where you construct test flows by dragging and dropping tasks, suited for those who want to build test cases without writing scripts. When switching between the two modes within the same test case, the existing script is converted automatically to match the selected mode.

1. Overview 

Zoho QEngine empowers users to streamline mobile application testing by enabling them to create efficient test scripts tailored to their Android and iOS testing needs. For a deeper understanding of how mobile testing works, refer to our Understand Mobile Testing document.

The platform offers dedicated testing environments for both Android and iOS applications. Equipped with a robust test editor, it provides two distinct modes: Editor mode for writing scripts manually and Builder mode for a simplified, visual approach. This flexibility ensures that users can write, manage, and refine their test cases with ease.

Another way of creating test steps is by using the recorder feature. Refer to the recorder document for more details.

2.  Writing a test case    

Before writing your test cases, ensure that a test case is created. Once done, switch the platform to either Android or iOS, based on your testing needs.



Then, select one of the two available modes: Editor or Builder mode.

2.1.  Editor mode  

Editor mode appears by default. Follow these steps to learn how to write test cases in this mode:
  1. Use the auto-complete feature to create your test cases—either by double-clicking tasks or dragging and dropping them from the task panel into the editor. Alternatively, you can type the test steps manually using the tasks.


  1. After adding the required task, provide the relevant parameters for them. The parameters can contain the following:
    • Elements: Locators for the elements that are interacted with can be set in two ways. The first method is to manually hard-code the locators. To do that, select the desired locator type, and the editor automatically fills in the correct format for that type. After inspecting the mobile application with the mobile inspector, you can copy the locator values.

      For example, to use the locator inside theTap task, from the dropdown, choose classname as the type of locator. Insert the class value with the format that auto-filled: tap("classname:XCUIElementTypeCell")

      Alternatively, testers can leverage the auto-complete feature by typing "ui." to access the list of created elements.

      Additionally, the Refer Elements option allows users to copy, edit, and create new elements. To copy or edit existing elements, select the page name and hover over the copy or edit icons for the required element. To create new elements, click +Add.

    • Variables: To access the variables created, start typing in the format "$<variable>". This way, you can view the list of all global and environment variables in addition to the system variables that are present by default.


    • Functions: The format of a function in a parameter should follow the format:

      <module_linkname>.<function_linkname>(<parameters>).

      where,
      <module_linkname> is the link name of the module under which the function is placed;
      <function_linkname> is the link name of the function to be invoked;
      <parameters> is the input values to be passed, if any.
      Notes
      Notes
        • Only functions that return a value can be used as parameters.
        • Function arguments aren't mandatory. You can also add them later by editing the test case details of that function. Learn more
    • Files: Files are supported only for selected tasks. To access saved files, type in the format "files.<filename>".

  1. Click Save to save all changes or edits to the test case.

2.2.  Builder mode  

To start writing in Builder mode, follow the steps below:

  1. Click Builder Mode.


  1. Drag and drop the required tasks from the task panel on the left to the editor.
  2. After adding the task, you need to provide the relevant parameters. Click the argument placeholder on the right. The set expression pop-up contains an input field and provides the option to select the required elements, variables, files, or functions. The parameters can contain:
    • Elements: Parameters for the interacted-with elements are defined by selecting locators directly from the element option. Simply choose the element name from the dropdown menu, and the locator automatically populates the input field in the format: "ui.ZWatch.Add_Cart".



      Alternatively, parameters can be defined manually by specifying the locators. Use the mobile inspector to inspect the application and retrieve the locator values. Paste the copied values into the appropriate fields, ensuring they adhere to the correct format for the selected locator type. For example, if the locator type is "class name", the format followed inside a task like tap would appear as: "classname:XCUIElementTypeCell".

      Additionally, the Refer Elements option allows users to copy, edit, and create new elements. To copy or edit existing elements, select the webpage or application page name, and hover over the copy or edit icons for the required element. To create new elements, click +Add.



    • Variables: The Variables section includes a list of all global and environment variables, in addition to system variables that are present by default. Select the required variable or type in the format "$<variable>" inside the input field.
    • Functions: Function can only be used as a parameter by using the call function task inside the required task. Call function is a dropdown in the case of Builder mode. Select the desired function from the saved list of functions.
    • Files: Uploaded files are accessible from the Files section. Select the required file from the saved list of files.
 

After applying the required parameters, click Done. To save the changes or edits to the test case, click Save.



You’ve now learned how to create test cases using both modes! To preview their real-time execution, ensure the agent is installed and your preferred devices are properly configured and connected.

After testing the real-time behavior of your test cases, you can include them in a test suite and test plan. This enables you to evaluate their interactions with other functionalities and facilitates scheduled testing for more thorough assessment.

3.  Related Links  

4. What's Next

Next steps
Previous steps
Next steps
Once you’ve written or refined your test cases using Editor or Builder mode, the next step is to execute and analyze them. Head over to the live preview document to learn how to run your test cases and gain valuable insights through detailed reports.
Previous steps
Before diving into writing or refining test cases, it’s essential to familiarize yourself with creating a test case. Refer to the test case recorder document to learn how to create test cases effectively.
 





        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


                                    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

                                                                                                                                • Understand Mobile Testing

                                                                                                                                  In a nutshell Zoho QEngine provides dedicated testing environments for both Android and iOS, each designed to handle the platform-specific devices, screen sizes, and app interactions unique to that ecosystem. Test cases can be created using the ...
                                                                                                                                • Configuring your iOS device in Zoho QEngine

                                                                                                                                  What does this page cover This page covers how to configure physical iOS devices and simulators for use with Zoho QEngine, including setting up Xcode, the local agent, and meeting Apple's code signing requirements, so they can be used to create and ...
                                                                                                                                • Understanding Builder and Editor mode

                                                                                                                                  In a nutshell The test editor offers two distinct modes to create test cases, Editor and Builder, designed so you can choose between scripting and task blocks based on your preference and level of expertise. Editor is a pro-code scripting mode for ...
                                                                                                                                • Creating mobile test cases using recorder

                                                                                                                                  In a nutshell Zoho QEngine's recorder captures your physical interactions within a mobile application and converts them into automation test scripts automatically, without requiring you to write scripts manually. It is accessed from the test case ...
                                                                                                                                • Test Cases

                                                                                                                                  In a nutshell Test cases are steps with defined inputs and expected outcomes, used to validate whether an application behaves as expected. Each test case is created within a module and can be written using the recorder, builder, or editor mode to ...
                                                                                                                                  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