Step 3: Execute a Bridge Message

Message module is used to test/execute a task in bridge, to do so:

1. In Qntrl, navigate to(settings) >> Advanced >> Bridge >> select Messages.

2. In the message list page that loads, click the New Message button.

3. In the New Message window, enter the following details.      
   

1.  Name: Enter a unique name for the message, so that it can be reused by different bridges when required.
   
2.  Bridge: Select the bridge you would like to test/execute from the dropdown list.
   
3. Module: Select one of the modules from the dropdown list. The task related to the selected module alone will be executed through this Message. Task Engine and DB Engine modules will be associated by default whilecreating a bridge.
   
1. Task Engine - To execute API tasks in third-party or internally hosted app
   
2. DB Engine - To perform SQL queries in a database hosted in a closed network
3. SSH Engine - To connect a remote Linux/Unix machine and to execute required commands
4. PowerShell Engine - To connect a remote Windows machine and to execute required commands
5. File Management - To transfer files from one location to another
6. AD Engine - Connects and performs secured operations in Active Directory
4. Type: Select the Message type:
   
1. Synchronous - Executes tasks in the same request and provides a response
   
2. Asynchronous - Executes tasks in the background
5. Request Data: The instructions to be executed by the bridge have to be given here in JSON format. Based on the module chosen, the key value parameters will change. To learn more about request data format and parameters check Bridge Modules.
   
6. Response: If the type is Synchronous, the response to the request will be displayed under this tab.

4. Once all the details are filled, click Execute.

      

After successfully executing a message, you can review the response (for synchronous message types) and find a server call entry in the Message list of your Bridge agent by following these steps:

1. Navigate to  (settings) >> Advanced >> Bridge >> select Bridge. 
   
2. Hover your cursor over the bridge name, then click on the action menu, , and select Open Agent.
   
3. This will direct you to the bridge agent login page. Log in with your username and password.
   
4. Navigate to the Messages section in the Header bar. On the message list page, use the dropdown menu to choose the messages you wish to access from the list.