Using Custom Functions in Schedules  

1. Go to Setup > Developer Space > Custom Functions > Scheduled Functions. (You can alternately write the custom function while creating a schedule.)
   
2. Click New Custom Function.
   
3. Provide a name and description for your custom function.
   
4. Write the custom function on the Deluge Script Editor and then save the function.
   

 
Test Execution of Scripts   

If you make any API calls (by using zoho.sdp.invokeurl or invokeurl) while testing the custom function, the API will be invoked. Make sure you don't invoke an API that might result in unintended consequences.  

Debugging Tip   

Sample  

1. 
   
2. /*Provide the email address to be notified*/
3. toEmail = "<email address>";
4. /*Enter how many days before the change request's scheduled start must the notification be triggered*/
5. reminder = "<number of days>";
6. /*Provide the name of the portal in which you want to execute the custom function*/
7. portalName = "<portal name>";
8. /*Gets the current system time*/
9. currentTime = zoho.currenttime.tolong();
10. /*Determines the one-day window based on which the change requests must be fetched*/
11. reminderValueEnd = currentTime + reminder.toNumber() * 86400000;
12. reminderValueStart = reminderValueEnd - 86400000;
13. /*Constructs criteria to fetch change requests*/
14. changeParameter = {"input_data":{"list_info":{"row_count":"1","start_index":1,"search_criteria":{{"field":"scheduled_start_time.value","condition":"gte","value":reminderValueStart},{"field":"scheduled_start_time.value","condition":"lt","value":reminderValueEnd,"logical_operator":"and"}},"sort_field":"scheduled_start_time","sort_order":"asc"}}};
15. /*Makes an API call to get the change requests that fulfill the specified criteria*/
16. response = zoho.sdp.invokeurl
17. [
18.     url :"/app/" + portalName + "/api/v3/changes"
19.     type :GET
20.     parameters:changeParameter
21. ];
22. /*Gets the change requests from the response of the API called*/
23. changes = response.get("changes");
24. /*Checks if there is at least 1 change request in the response of the API called.*/
25. if(!changes.isEmpty())
26. {
27.     /*Contructs the change request ID to send in the email*/
28.     scheduledChangeId = changes.get(0).get("display_id").get("display_value") + "<br><br>";
29.     /*Constructs 'Description' for the email*/
30.     mailDescription = "The following change request will start in " + reminder + " days.<br><br>" + scheduledChangeId + "<br><br>This is an automated message. Please don't reply to this email.";
31.     /*Constructs 'Subject' for the email*/
32.     mailSubject = "Reminder for change request in ServiceDeskPlus Cloud";
33.     /*Makes an API call to send the email*/
34.     mailResponse = zoho.sdp.invokeurl
35.     [
36.         url :"/app/" + portalName + "/api/v3/changes/" + changes.get(0).get("id") + "/notifications"
37.         type :POST
38.         parameters:{"input_data":{"notification":{"to":{toEmail},"subject":mailSubject,"description":mailDescription,"type":"SEND_MAIL_ONLY"}}}
39.     ];
40. }
41. return Map();