Custom Function: Create_Job

Custom Function: Create_Job

  • This custom function can be used to create a new job in any layout.

  • It can also be configured to carry forward necessary field values from the former job to the latter.  

Business Scenario

  • Helen is the head of Procurement Management in her organization. Once the purchase cost of a material is approved by Helen, a new job can be created automatically to initiate the procurement process by triggering this custom function. 

  • The approved cost (custom field) can be included in the new job created.  

Steps to configure the custom function

Before executing this custom function, you will have to configure the arguments, add custom field values (if required), and authorizate connections. Follow the below steps to configure the function. 

1. Configure the Arguments 


First, configure  Argument Values for all the parameters used in the custom function. You can either use the Custom Value or choose a Layout Field from the dropdown. Layout fields capture dynamic values from job fields corresponding to the custom function.   



  • orgName : Specify your organization’s name. This will be available in Orchestly’s URL (orchestly.zoho.com/blueprint/<orgName>/<module>).

  • jobTitle : Specify the title of the job. 

  • layoutID:  Specify the ID of the layout the job is to be created in. This will be available in the layout URL  (orchestly.zoho.com/blueprint /<orgName>/<layout>/<layoutID>).  

2. Add custom field values  


To provide values  for custom fields in the job, add the below syntax to the function.  This is optional and can be included only if there is a need to provide custom fields values. 

Syntax: 

paramMap.put("column_name of the custom field","value of the custom field"); 

The 'column_name of custom field' can be obtained using APIs: 
  1. Go to our  API Documentation.
  2. Navigate to the  Reference tab and select  Layouts  on the left panel. 
  3. Execute the  Get layout details function by clicking Try Now
  4. Choose your organization and configure the URL by entering the Layout ID. The Layout ID will be available in the Layout URL  (orchestly.zoho.com/blueprint/<orgName>/<layout>/<layoutID>). 
  5. Click  Execute
  6. Press Ctrl+F on your keyboard and search for your custom field name. You can find it listed as an alias_name
  7. Find the column_name linked to this custom field. It will be listed just above the alias_name

The  column_name  can be used in the syntax specified above to add custom field values.    


3. Provide authorization using Connections  


Connections helps you authenticate the API call for specific scopes of Orchestly and other internal Zoho applications used in the custom function.  
  1. Invoke  Connections to authorize your Orchestly account. 
    1. Click the  +Connections button in  Custom Functions. A new tab  will  open in your browser.  
    2. Click  Add Connection in the top-right corner. 
    3. Choose  Zoho Oauth from the Pick Your Service tab. 
    4. Enter a  Connection Name and choose the 'Orchestly.job.ALL' scope to connect.  
  2. After successful authentication,  add the connection details  to the invokeurl block of  the custom function. 
    1.   e.g: connection : <Connection-name>   

Once the above steps are configured, you are all set to execute the custom function. 



Create_Job is a part of Orchestly's pre-define custom functions available in Function Gallery. However, you can also write your own custom functions in Orchestly. 


    • Related Articles

    • Custom Function: Create_Ticket_in_Zoho_Desk

      Zoho Desk is customer service software which allows you to address customer concerns. This custom function can be used to post a job as a ticket in Zoho Desk.  Prerequisites  Sign up for Zoho Desk and create a department. The ticket will be created ...
    • Custom Function: Post_Messages_to_Zoho_Cliq_Channel

      This custom function can be used to post predefined messages to existing Zoho Cliq channels.  Prerequisites   Sign up for Zoho Cliq and create a channel with the required users. Only the members of this channel will receive messages.  ...
    • Custom Function: Post_and_Update_Comments_in_Zoho_Desk

      Zoho Desk is a customer service software which allows you to address customer concerns. This custom function can be used to add or update comments in Zoho Desk whenever they are added or updated in Orchestly.  The comments will be added to the ...
    • Custom Functions

      Zoho Recruit Custom functions help you to update data in related Recruit modules or third-party applications by executing simple program scripts. When a record matches the workflow criteria, workflow engine automatically triggers the custom ...
    • Custom Schedules

      Schedules are automated user-defined actions, which can be performed through custom functions either at a particular time or on a recurring basis. You can now schedule a custom function to be executed automatically on a daily, weekly, or ...