Business Scenario

Helen is the head of Procurement Management at her organization. Once the individual purchase cost of all the materials is approved by Helen, the total cost can be calculated and saved by executing this function. 

1. Configure the Arguments 

 

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

• param1 : Either enter a value here or map a custom field. 
  

• param2 : Either enter a value here or map a custom field. 
  

• jobID : Choose the  Card ID  Form Field here. You can also specify the ID of the card. This will be available in the Card URL ( core.qntrl.com/blueprint/ <org-name>/<job>/<jobID>).
  

2. Add custom field values

Syntax:

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

1.   Click the hyperlink to visit 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. This will be available in the Form URL ( core.qntrl.com/blueprint /<org-name>/<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. 

3. Provide authorization using Connections

1.   Invoke Connections to authorize your Qntrl account. 

• Click  +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.job.ALL' scope to connect. 
  

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

      e.g: connection: "<Connection-name>"