Business Scenario

Ideal Users

1. Recruit Administrators who set up workflow rules for Users
   
2. Programmers with REST API and Deluge Script skills

Availability

Profile Permission Required: Users with the Manage Workflow permission can access this feature.

Set Up Custom Functions

1. Create a custom function.
   
2. Associate custom function to a workflow rule.
   
3. Test custom functions integration.
   

1. Go to Setup > Automation > Actions > Custom Function.
   
2. In the Workflow Custom Functions page, click Configure Custom Function.
   
3. Select a function from Gallery, existing function or write a new one using Deluge Script.
   
   
4. Click Save.
   

1. Click Setup > Automation > Actions > Rules.
   
2. In the Workflow Rules page, click the Create Rule.
   
3. In the Create New Rule tab, specify workflow rule parameters.
   
4. Select Custom Function, under Instant Actions.
   
5. Now select the custom function to be triggered.
   
6. Click Save.
   

1. Add test data in Zoho Recruit according to your workflow rule criteria.
   
2. Check for the data received from Zoho Recruit via custom function, in your application.
   
3. Modify your custom function code in Zoho Recruit, if data is not received or if there is a data mismatch.
   
4. Continue this test until you obtain the required data from Zoho Recruit to your Application.

1. id: Choose "Candidate Id" column from the list of fields. 
   
2. phone: Choose "Phone" column from the list of fields. 
   
3. email: Choose "Email" column from the list of fields. 
   
4. title: Choose "Job Title" column from the list of fields. 
   
5. skillset: Choose "Skill set" column from the list of fields. 
   
6. resume: Choose "Is Attachment Present" column from the list of fields. 
   
7. authtoken: (Custom Value) Provide the authentication token required to access your Zoho Recruit account using an API call
   

Deluge Script for the above-mentioned scenario

if (phone.length() == 0 && email.length() == 0 && title.length() == 0 && skillSet.length() == 0 && resume == "false") {

    status = "Junk Candidate";

} else if (phone.length() == 0 || email.length() == 0) {

    status = "Unqualified";

} else if (title.length() == 0 && skillSet.length() == 0 || resume == "false") {

    status = "Rejected";

} else {

    status = "Waiting-for-Evaluation";

}

updateMap = Map();

updateMap.put("candidateStatus", status);

updateMap.put("authtoken", authtoken);

updateMap.put("candidateIds", id.toString());

updateMap.put("scope", "recruitapi");

updateMap.put("version", "2");

response = postUrl("http://recruit.zoho.com/recruit/private/json/Candidates/changeStatus%22,updateMap);

1. Log in to Zoho Recruit.
   
2. Setup > Automation > Actions > Rules > Create Rule.
   You can create a new rule by specifying Module and Rule Name.
   
3. Click Next.
   
4. Choose when you want to execute this rule. Now select Create or Edit option under execute based on a record action.
   
5. Click Next.
   
6. Choose to which records you want to execute the rule. Select Records Matching the condition option and set the criteria.
   
7. Click Next.
   
8. Now choose Custom Function as Instant action.
   
9. In the Call Custom Function pop-up, Click on +New Deluge to create or add Custom function.
   
10. Click on the Gallery to use the pre-defined Custom Function.
    
    
11. Click on Configure given against the Custom Function name- Screen Candidates.
    
12. Edit the Title, Description and Deluge Script as per your requirements.
    
    
13. Click on Edit Parameters and map the arguments by choosing from the dropdown list.
    
    
14. Click on Save.
    
15. As you finish editing your function, click on Save Script before saving the function.
    
16. Click Save and Proceed and you will be taken to the Workflow page with Custom function added to the flow you have created.
      
17. The Custom Function created will be run when you create or edit any candidate record.
    

Error Codes

HTTP Status Codes

1. 400 Bad Request - Often missing a required parameter.
   
2. 401 Unauthorized - No valid API key provided.
   
3. 402 Request Failed - Parameters were valid but request failed.
   
4. 404 Not Found - The requested item doesn't exist.
   
5. 500, 502, 503, 504 Server errors - Error in the third-party application.
   
6. Error Code 1 - Temporarily not able to connect to the API server. Check API server logs, firewalls settings for requests sent from Recruit.
   

Custom Errors

1. Internal process failure - When the custom function is not executed due to errors in processing of the script.
   
2. Day limit reached - When the company has reached the maximum limit for the day.
   
3. Deluge Script - When the execution of workflow triggers fail due to errors in Deluge Script.