Zoho Sprints comes with the capability for you to create custom functions and automate your business process.
A Custom Function is composed of a group of deluge statements that are combined to perform a certain task. This function can be invoked within an application whenever that particular task needs to be performed. Using functions, you can create modules of deluge scripts that can be used in multiple instances. Multiple functions can come together to perform a string of tasks.
Another important aspect is that functions can help your application interact with third party services, allowing you to update data in two separate applications with the script in one application. Zoho Sprints offers two types of functions:
Automation and
Standalone functions.
Benefits of using custom functions
- Custom function is an efficient and time-saving method to perform repetitive tasks.
- A chunk of deluge scripts with the aim of executing a particular task are encapsulated and implemented at multiple events, making it a reusable entity.
- It allows you to automate certain processes like calling a webhook, sending notifications, or performing an action at the trigger of an event.
- The modular nature of the code makes it easier to manage and use them.
- Deluge comes with built-in functions to make scripting easier.
- Sprints provides a list of pre-built functions that allows you to execute a few default tasks.
- Enable Sprints to interact with third party services using a secure authentication mechanism.
Gallery functions
Gallery functions are predefined functions that are provided to enable you to start automating certain tasks. These are templates that you can start tweaking to suit your requirement and create a function. These provide solutions to specific use cases that are likely to come up during the course of your project in Sprints.
The following are the prebuilt functions:
Update Release status when an item is reopened or closed
This function is used to update the release status as Closed when all work items associated with that release are closed or to update the release status as Open when any of the associated work items are reopened.
Module: Item
Trigger Event: Item Closed, Item Reopened
Close parent item if all its subitems are closed
This function is used in the case of a parent item with multiple subitems. Executing this function will close the parent item when all its subitems are closed.
Module: Item
Trigger Event: Item Closed
Update Epic status when an item is reopened or closed
This function is used to archive an epic when all the work items associated with that epic are closed or to activate an archived epic when any of the associated work items are reopened.
Module: Item
Trigger Event: Item Closed, Item Reopened
Add status update note on linked items
This function is used to add item notes on all the linked items when an item's status is updated. Work items can be linked with one another. When the status of a work item is updated, that update can be added as an item note in the work items that are linked to it. This way, the web of work items remains up to date automatically.
Module: Item
Trigger Event: Item Updated, Item Closed, Item Reopened
This function is used to automate email notifications to the email addresses of the users tagged in a comment.
Module: Item Comments, Sprint Comments, Meeting Comments
Trigger Event: Item Comment Add, Item Comment Update, ItemComment Delete, Sprint Comment Add, Sprint Comment Update,
Sprint Comment Delete, Meeting Comment Add, Meeting Comment Update, and Meeting Comment Delete
Post a message on Slack Channel
This function enables you to integrate Sprints with Slack, an external office communication service. You could have messages posted on Slack at the trigger of events like closing a work item, reopening a work item, starting a sprint, and more. So when an event is triggered, you can notify your team on Slack channel that is meant for your sprint team.
Module: All modules
Trigger Event: All events
Integrating with other services requires you to create a connection. Learn more.
- Create a connection for the Slack service with the scopes "chat:write:bot".
- Find 'slackconnection' & replace it with the connection name you've provided.
- Configure valid slack channel ID in "channelId" custom parameters on the left side.
- Switch off Use Credentials of Login User while creating the connection.
Post a message on Cliq Channel
This function enables you to integrate Sprints with Cliq, another Zoho service which is an office communication system. You could have messages posted on Cliq at the trigger of events like closing a work item, reopening a work item, starting a sprint, and more. So when an event is triggered, you can notify your team on Cliq channel meant for your sprint team.
Module: All modules
Trigger Event: All events
Integrating with other services requires you to create a connection. Learn more.
- Create a connection for the ZohoCliq service with the scopes "ZohoCliq.Webhooks.CREATE".
- Find 'cliqconnection' & replace it with the connection name you've provided.
- Configure valid Cliq channel name in "channelUniqueName" custom parameters on the left side.
- Switch off Use Credentials of Login User while creating the connection.
Points to remember
- A maximum of 20 parameters can be included while creating a function.
- A maximum of 15 custom parameters can be included while creating a function.
- A function can be disabled or enabled.
- The name of the function cannot be modified once created.
- When a function execution fails continuously for 15 times, a Function Disable Alert email will be sent to the team owner and to those who created and updated the function.
- A function will not be executed if it is disabled.
- Connections enable integration with other services. To create a connection, go to Automation and select Connections.
- A function can be manually executed but the parameter value will only be passed with 'null' value.
- Functions that are executed will be recorded under Function Logs.
- Function logs that are older than a month will be permanently deleted.
- You can try to execute a failed function thrice.
- You cannot execute a function that was already executed successfully.