Functions
In a nutshell
Functions are reusable test cases built for actions that repeat across multiple test cases. A function is created once and called using its link name or the call function task, as many times as needed within the same test case or across different ones. Passing different arguments each time it is called lets the same function handle varying input scenarios without requiring duplicate steps.
Functions are reusable test cases built for actions that repeat across multiple test cases. A function is created once and called using its link name or the call function task, as many times as needed within the same test case or across different ones. Passing different arguments each time it is called lets the same function handle varying input scenarios without requiring duplicate steps.
Overview
Functions are test cases that can be reused for a specific task and can be called multiple times throughout a test case with or without different arguments. For example, take the case of an ecommerce shop. Test cases like Add to Cart are common actions inside their web services and mobile applications. These test cases are repeated actions and can be listed under the functions category.
Functions can be referred to in test cases using its Link Name or using the task call function.
Create Function
Creating a function is similar to a creating a test case. To do so:
- Click Create Test Case.
- Enter the test case details, such as Name, Link Name, and Module to which it needs to be added. Additionally, providing a Description offers a better overview of the test case, but is not mandatory.
The link name will be unique for each function and will be auto-filled by default, similar to the test case name. They should be descriptive and accurately reflect the purpose of the function. For example, if your test case name is Contact Us, the link name would be contact_us by default. However, they can be edited as per the following conditions:
- Select the Mark test case as a function checkbox below the description to convert the test case into a function.
Note: If the test case isn't marked a function, then it's considered as a regular test case.
- Mention the return type of the function. This specifies the data type of the value that the function will return after its execution. For example, if we create a function to greet every user inside an ecommerce site, then the function is a void type, as it doesn't have a return statement. It will simply print a greeting message for every user. However, if the function was created to sum the total price of a product and the price value are integer data types, then the function is an integer type as it gives an integer sum in return.
- Specify the arguments, if any. The arguments of a function are the input values passed when it is called inside a test case or another function, which the function can use to perform its operations. For example, an ecommerce function to show featured products doesn't take arguments but displays products, while a function calculating the total price takes quantity and price per unit arguments and returns the total cost.
Note: The fields return type and specify arguments will only be enabled once you check the box to make the test case a function.
- Once the required details are filled, click Create.
Using functions
- To use functions in a test case or an existing function inside builder mode, simply call the function using the Call Function task. Drag-and-drop the call function task from the task panel to the editor. The right panel for the arguments will have a drop-down menu. Choose the module from the drop-down menu to select the desired function.
- For editor mode, simply refer to it inside using the format: <module_link name>.<function_link name>(arguments);
Parameter | Description |
module_link_name | Link name of the module in which the function has been defined |
function_link name | Name of the function to be invoked |
arguments | Parameters of the function, if any |
For example, if the module name is Shopping and the test case name is Add to Cart, in this case will be shopping.add_to_cart();
Let's look at an example to understand how functions are used inside test cases. Take the case of the Add to Cart function of the website Zylker Watches. The tester created a new function to handle the Add to Cart functionality in an ecommerce web application, in order to implement the function inside the test case Buy a Product.
- The test case belongs to the Shopping module. The Add to Cart function is called inside the Buy a Product test case. This automatically adds the function's script in the test case, as displayed below:
Understanding the use of functions is crucial. Now that we have learned how to create functions, the next step is to learn how to use them. Choose between recorder, or editor and builder mode to write the functions. Execute and analyze the functions with the preview run options: Web, Android, and iOS, for more reliable and reusable function scripts.
Related Links
In a nutshell
Functions are reusable test cases built for actions that repeat across multiple test cases. A function is created once and called using its link name or the call function task, as many times as needed, within the same test case or across different ones. Passing different arguments each time it is called lets the same function handle varying input scenarios without requiring duplicate step.
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 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 Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
Centralize Knowledge. Transform Learning.
All-in-one knowledge management and training platform for your employees and customers.
New to Zoho Writer?
Create. Review. Publish.
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Zoho Marketing Plus?
Everything you need to run your marketing
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.
New to Zoho Survey?
Zoho Sheet Resources
Zoho Forms Resources
New to Zoho Sign?
Zoho Sign Resources
Sign, Paperless!
New to Zoho TeamInbox?
Zoho TeamInbox Resources
New to Zoho ZeptoMail?
Design. Discuss. Deliver.
New to Zoho Workerly?
New to Zoho Recruit?
New to Zoho CRM?
New to Zoho Projects?
New to Zoho Sprints?
New to Zoho Assist?
New to Bigin?
Related Articles
File Functions
1. In a nutshell Zoho QEngine provides built-in file functions that allow you to retrieve data and validate files within test scripts. 1.1 Availability These functions are available for : Files retrieved using the invoke URL method Files saved ...isFile()
1. Overview The isFile() function checks whether the input is a valid file object. It returns a boolean value (true or false) based on whether the specified input can be treated as a file. This is especially useful before performing further file ...getFilecontent()
1. Overview The getFilecontent() function returns the content stored in the specified input file. It is commonly used in test cases to validate file data, read values for further logic, or check against expected content. 2. Syntax <variable> = ...getFileSize()
1. Overview The getFileSize() function returns the size of the specified file in bytes. This is useful for validating if a file has been completely downloaded, meets expected size criteria, or to perform conditional logic based on file size. 2. ...getFileName()
1. Overview The getFileName() function returns the name of the specified input file, including its extension. This is useful for validating file naming conventions or confirming that the expected file has been retrieved or downloaded. 2. Syntax ...
New to Zoho LandingPage?
Zoho LandingPage Resources