Custom Function: Move_Job_to_other_Stage

• This custom function can be used to move a job to any stage in the blueprint automatically.
  

• Jobs can be moved to previous stages or upcoming stages. 
  

Business Scenario

Mark, the head of Marketing, reviews all the marketing articles in his organization. If Mark rejects an article, the job can automatically be moved back to any of the previous stages and assigned to the designated user using this custom function.  

Steps to configure the custom function

Before executing this custom function, you will have to configure the arguments 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 specify a 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>). 
  

• jobID : Choose the  Job ID  Layout Field here. You can also specify the ID of the job. This will be available in the Job URL ( orchestly.zoho.com/blueprint/<org-name>/<module>/<jobID>).
  

• toStageName:  Specify the stage to move the job.
  

2. 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.

• Click the  +Connections button in  Custom Functions . A new tab will open in your browser. 
  

• Click  Add Connection in the top-right corner.
  

• Choose  Zoho Oauth on the  Pick Your Service tab.
  

• Enter a  Connection Name and choose the 'Orchestly.stage.READ' and 'Orchestly.job.ALL' scopes to connect. 
  

2.   After successful authentication, include the connection details in the response block of the custom function.                    


       e.g: connection: <Connection-name>

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

Move_Job_to_other_Stage  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: Move_Job_to_other_Blueprint

  This custom function can be used to move a job to any blueprint created using the same layout, automatically.  Business Scenario In a food processing business, once the food items are packed and ready to be shipped in the Manufacturing Blueprint, the ...

• 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 ...

• Custom Function: Computing_Field_Values

  This custom function can be used to add two values and save the return value in a custom field.  The sum will be dynamically updated in the custom field after this function is executed.  Business Scenario Helen is the head of Procurement ...

• Job Status Categories

  Introduction As you may already know, every job opening record in Zoho Recruit has a status associated with it. These statuses indicate what stage the job openings are in, so recruiters can better track their hiring process.   In Zoho Recruit, Job ...

• Working with Job Openings

  Introduction In any organization, Job Openings are the most important records to generate real revenue for the organization. In a typical organization, all candidates have to undergo a complete recruitment cycle, which starts with sourcing the ...