Creator Help

Update Records in Zoho Recruit

 Overview

The zoho.recruit.updateRecord() task can be executed to update existing record in any of the supported modules of Zoho Recruit. By placing it in the required form actions block of Zoho Creator, the process of updating records in Zoho Recruit can easily be automated as per requirement. Lets say you have a Zoho Creator form which can be used to edit details of a recruited candidate. To simultaneously edit the same details in our Zoho Recruit’s "Candidates" module, you can execute zoho.recruit.updateRecord() task in the “On Success” form actions block. This will update the specified records in Zoho Recruit whenever the Zoho Creator form is edited and submitted with candidate’s details. Further details on how to execute this task are explained below.

 Supported Modules

  • Candidates
  • Job Openings
  • Clients
  • Client Contacts

 Syntax

response = zoho.recruit.updateRecord(moduleName, id, dataMap)

where,
<response> - is the map variable returned by Zoho Recruit as response. 
<moduleName> - name of module in Zoho Recruit where the records will be updated. (mandatory)
<id> - is the ID of the record in Zoho recruit, that is to be updated. (mandatory)
<dataMap> - map variable that holds the key,value pairs. The map key is the label name as specified in Zoho Recruit module and the map value is the field value as submitted in the ZC form. For example, "First Name" : input.First_Name . Here, "First Name" is the the label name as specified in Zoho Recruit module and input.First_Name refers to the value specified in the First_Name field in the Zoho Creator form. (mandatory)

 Example

Following is a sample script that can be added in a Zoho Creator form to edit an existing record in Zoho Recruit. Let's say we have a Creator form containing fields, "First Name", "Last Name", "Email" and "Work Phone" which holds a recruited candidate's details. You can add the following script to On Edit -> On Success block of the Creator Form so that whenever this form is edited, details existing in Zoho Recruit's specified module are also edited accordingly. In this case, the module is "Candidates". When the following script gets executed, the email value as updated in this Form, gets updated in the specified record of Zoho Recruit.

response = zoho.recruit.updateRecord("Candidates", "1687000000106001", "Email" : input.Email);

where,
response - is the map variable returned by Zoho Recruit as response. 
Candidates - name of module in Zoho Recruit where the record will be updated.
1687000000106001 is the ID of the record which needs to be updated.
"Email" is the field name which needs to be updated.

 Response

Response returned by Zoho Recruit as map:

{"message":"Record(s) updated successfully","Created Time":"2015-09-16 16:29:33","Modified By":"john","Id":"1687000000106001","Modified Time":"2015-11-19 18:09:28","Created By":"deepika.p"}

Share this post : FacebookTwitter

Still can't find what you're looking for?

Write to us: support@zohocreator.com