Prerequisite

Add a  Script

1. Navigate to (settings) >> CodeX >> click Scripts in the menu.
2. Click the New Script button.
3. Provide the following execution details:
   
1. Script Name: Enter a name for your server script.
   
2. Execution Location: Select the location where the script should run.
   
3. Execution Trigger: Specify when the script should be executed.
   
4. Form: Choose the form for which the script will be executed.
   
5. Advanced Options: Advanced Options enables you to configure the following restrictions:
   

• Memory in MB
• File Request Count
• Http Client Request Count
• Maximum File Size in MB
• SDK Call Count
• Logger level
• Execution timeout in ms
• Execution logs limit in characters

4. Code the script according to your business requirements.
5. Click the Publish button and confirm your action. You also have the option to save it as a draft and publish it later by clicking Save as Draft. 

An execution trigger can only be used twice for a particular form.

Edit a Script 

1. Navigate to (settings) >> CodeX >> click Scripts in the menu.
2. Select the codex script you wish to edit.
3. Make the necessary modifications.
4. Click the Publish button and confirm your changes.

Publish your scripts so that the updated versions can be executed effectively.

 

Set execution order for CodeX scripts    

1. Navigate to (settings) >> CodeX >> select Scripts in the menu.
2. Click the Set Execution Order button at the top right of the page.

3. Choose a Form for script execution and select the Execution Trigger for when it should be activated.
4. A list of scripts will be displayed based on your selections.
5. In the EXECUTION ORDER section arrange the scripts in the desired execution order.
6. Click Save. 

Filter Scripts   

1. Navigate to (settings) >> CodeX >> select Scripts in the menu.
2. Click on in the All Forms column and select a form from the displayed list.       

Enable or Disable Scripts   

1. Navigate to (settings) >> CodeX >> select Scripts in the menu.

 

Delete a Script 

1. Navigate to (settings) >> CodeX >> select Scripts in the menu.

2. Hover over the name of the script you want to delete, click mouse over action menu, , and select Delete.

Triggering Script Execution: Supported Modules

• Jobs
• Email in(card creation)
• Transition(Before, During, After)
• Circuit(via Function)
• Scheduler(via Function)

Jobs

1. On Load - This script runs when a form is first loaded in the Qntrl system as part of the page rendering process. It can be used to initialize variables, retrieve data, set default values, or apply dynamic behaviour to the user interface.
2. Before Create - Script runs just before a new record is created. It allows developers to validate input data, set default values, or run custom logic before the record is officially added to the system.
3. After Create - Executed after a new record is successfully created, this trigger is used for post-creation tasks like sending notifications, updating related records, or executing additional logic.
4. Before Update - This trigger runs before an existing record is updated. Developers can use it to validate or manipulate data before the changes are applied.
5. After Update - The script is triggered after a record is updated, allowing developers to perform actions or updates that should follow the modification of the record.
6. Before Delete - Script runs just before a record is deleted from the Ql system. It can be used for validation, cascading deletions, or any necessary logic before the record is permanently removed.
7. After Delete - Executed after a record is successfully deleted, this trigger is used to perform post-deletion tasks such as updating related records, logging events, or running any required custom logic.

Email In 

Transition 

Circuit 

CodeX scripts can be executed through functions defined in the system.

Scheduler