Custom Function: Create_Job | Online Help | Qntrl

Custom Function: Create_Job

  • This custom function can be used to create a new card in any board.

  • It can also be configured to carry forward necessary field values from the former card 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 card 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 card created.   

You can also create repetitive cards automatically using Create_Job custom function. 

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 Form Field from the dropdown. Form fields capture dynamic values from card fields corresponding to the custom function.   



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

  • jobTitle : Specify the title of the card. 

  • layoutID:  Specify the ID of the form the card is to be created in. This will be available in the form URL  ( core.qntrl.com/blueprint /<orgName>/<layout>/<layoutID>).  

2. Add custom field values  


To provide values  for custom fields in the card, 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  Forms  on the left panel. 
    3. Execute the  Get form details function by clicking  Try Now . 
    4. Choose your organization and configure the URL by entering the Form ID. The Form ID will be available in the Form URL  ( core.qntrl.com/blueprint/ <orgName>/<layout>/<formID>). 
    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  Qntrl  and other internal Zoho applications used in the custom function.  
    1. Invoke  Connections to authorize your Qntrl account. 
      1. Click the  +Connections button in  Custom Functions . Or navigate to Connections under Advanced.
      2. Click  Create 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 Qntrl's pre-define custom functions available in Function Gallery . However, you can also write your own custom functions in Qntrl .  


    • 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 card as a ticket in Zoho Desk. Prerequisites Sign up for Zoho Desk and create a department. The ticket will be created in ...

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

    • Custom Function: Move_Job_to_other_Stage

      This custom function can be used to move a card to any stage in the blueprint automatically. Cards can be moved to previous stages or upcoming stages. Business Scenario Mark, the head of Marketing, reviews all the marketing articles in his ...

    • Custom Function: Move_Job_to_other_Blueprint

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

    • Create Cards

      A user can create cards in a board if they are added to the board and granted the create card permission in that board. To create cards in a board : Navigate to the Boards tab. Click the respective board under My Boards . Click New Card . Enter the ...

    You are currently viewing the help articles of Qntrl 3.0. If you are still using our older version and require guidance with it, Click here.