Automate your issues workflow using Custom Functions.
What Is a Custom Function?
A custom function is a piece of code that can be used for automating a process. You can write your own function in Deluge and call it from one or more business rules. It is similar to the built-in functions in Javascript like DATE, CONCAT, REPLACE,
etc. In Zoho Projects, you can update the issue fields automatically
using business rules. With the help of custom functions, you can
automate a notification, call a webhook, or perform logic right after a
business rule is triggered.
Business Scenarios
- When an issue is escalated, its project manager can be notified via an SMS, an email or a Zoho Chat using custom functions.
- When an issue's severity is updated, a relevant comment can be added to the issue via a custom function.
- Integration can be done with Zoho Apps and third party apps in a custom function.
Add a Custom Function
- Click in the top navigation bar.
- Navigate to Issue Settings and click Automation.
- Select Custom Functions from the left panel.
- Click New Custom Function in the upper-right corner of the page.
- Enter a Function Name and a Description.
- Set the Arguments.
- Type in your code in the Deluge script editor or drag and drop the
parameters available in the left panel of the editor and customize them.
- Click Save.
Helen wants to notify a set of users in her project about the change
of issue owner for a specific issue upon escalation. She might have to
send the notification very often to the same set of users on this
subject in the future as well. So, Helen decides to create a custom
function and get it called through one of the business rules. This is
how her custom function will look.
Associate a Custom Function With a Business Rule
- Click in the top navigation bar.
- Navigate to Issue Settings and click Automation.
- Select Business Rules from the left panel.
- Select a rule and navigate to Rule details -> Criteria -> Actions.
- In Actions, click Call Custom Function.
- Click the plus icon to create a new custom function or click the chain icon to call an existing function from the business rule.
- Click Save Rule.
Learn More about configuring business rules.
Execute a Custom Function
- Navigate to Issue Settings->Automation->Custom Functions.
- Click the function that you would like to execute. Here, Helen tries to execute the function "Send_Mail".
- Click Save and Execute at the bottom.
- Enter the Issue ID (i.e, the argument).
- Click Execute.
Test Custom Function Integration
- Add test data in Zoho Projects that match your business rule criteria.
- Check for updates received from Zoho Projects in your application via a notification triggered through your custom function.
- If there is an error, modify your custom function in Zoho Projects and retest.
- Continue testing until you get the correct output. Here, John
Marsh, Victor Young, and Lin Brenn receive a notification from Helen on
the change in issue ownership.