Same as the Testsigma API key mentioned above.| +|**Request Body Type (JSON)**| Raw | +|**Payload**|
{
"name": "<Unique Agent Name>",
"agentType": "TRANSIENT",
"externalConfig": {
"url": "http://localhost:4444",
"authenticationEnabled": true,
"userName": "root",
"password": "root",
"type": "SELENIUM",
"browserList": ["Chrome", "Safari"]
}
}|
+|**Response Body Type (JSON)**|{
"id": 9,
"uniqueId": "a3cceab7-5bc9-41d1-a905-e54e0a23c677",
"jwtApiKey": "<Unique JWT Token>",
"agentVersion": null,
"createdById": 2,
"updatedById": 2,
"createdDate": 1719222650559,
"updatedDate": 1719222650559,
"system": {
"title": "Dynamic Agent",
"id": 21,
"protocol": "http",
"port": null,
"httpsPort": null,
"ipAddress": "127.0.0.1",
"hostName": null,
"osType": null,
"osVersion": null,
"systemType": 4
},
"browserList": [],
"currentAgentVersion": "5.9.0",
"status": "REGISTERED",
"isActive": false
}|
+
+Here’s a quick GIF demonstrating how to create a Dynamic Agent through API with the above mentioned endpoint.
+
+
+
+---
+
+## **Start Dynamic Agent Using jwtApiKey**
+
+Open the terminal in the **Testsigma Agent directory** and use the following command to start the **Dynamic Agent**:
+
+> **For Mac/Linux**
+>
+><agent_dir>./start.sh --TS_ACTIVATION_KEY=<JWT_KEY>
+
+
+> **For Windows**
+>
+><agent_dir>./start.bat --TS_ACTIVATION_KEY=<JWT_KEY>
+
+Where <JWT_KEY> is **jwtApiKey** from the above response.
+
+Here’s a quick GIF demonstrating how to start Dynamic Agent using jwtApiKey with the above command.
+
+
+
+---
+
+## **Start the Private Grid Hub & Web Nodes**
+
+To start the **Private Grid Hub**, open the **Terminal** at **Private Grid** folder and use the following command:
+
+java -jar selenium-server-4.13.0.jar hub
+
+Once the **Private Grid** starts, open http://localhost:4444
+
+To start the Web Nodes, open the new tab on the same Terminal and use the following command:
+
+java -jar selenium-server-4.13.0.jar node --config node.json --selenium-manager true
+
+Once the command runs, the registered **Nodes** will be added to the **Private Grid**.
+
+Here’s a quick GIF demonstrating the steps to start the Private Grid Hub and add Web Nodes.
+
+
+---
+
+## **Execute Tests in Private Grid using REST API**
+
+Use the following **Endpoint** to execute the Testsigma’s test plan in **Private Grid** using REST API.
+
+|**Request Type**|**POST**|
+|---|---|
+|**Endpoint**| https://app.testsigma.com/api/v1/execution_results |
+|**Authorization**| Bearer ****
Same as the Testsigma API key mentioned above.|
+|**Request Body Type (JSON)**| Raw |
+|**Payload**| {
"executionId" : <Test Plan Exe ID>,
"testDevices" : [
{
"title" : "Dynamic Machine",
"targetMachine" : 27,
"browser" : "CHROME",
"executionLabType" : "Hybrid",
"suiteIds" : [<Suite IDs>],
"isHeadless" : false,
"runTestSuitesInParallel": true,
"runTestCasesInParallel": true,
"createSessionAtCaseLevel": true
}
]
}
|
+|**Sample Response Body (JSON)**|{
"id": 581,
"execution": null,
"executionId": 346,
"startTime": 1719400027825,
"endTime": null,
"duration": null,
"result": "QUEUED",
"status": "STATUS\_CREATED",
"message": "Test Plan execution message",
"executedBy": 29,
"buildNo": null,
"environmentId": null,
"totalCount": null,
"failedCount": null,
"passedCount": null,
"stoppedCount": null,
"notExecutedCount": null,
"queuedCount": null,
"runningCount": null,
"visualTestResult": null,
"environment": null,
"childResult": null,
"reRunParentId": null,
"triggeredType": "API",
"totalRunningCount": 0,
"executionDetails": {
"page\_timeout": 30,
"element\_timeout": 30,
"recovery\_action": "Run\_Next\_Testcase",
"on\_aborted\_action": "Reuse\_Session",
"screenshot\_option": "ALL\_TYPES",
"screenshot\_mode": null,
"group\_prerequisite\_fail": "Abort",
"test\_case\_prerequisite\_fail": "Abort",
"test\_step\_prerequisite\_fail": "Run\_Next\_Testcase",
"global\_param\_name": null
},
"totalQueuedCount": 0,
"mobileInspectionId": null,
"environmentResultsDTO": [],
"executionResultConfig": null,
"isReRunEnabled": false,
"consolidatedResult": "QUEUED",
"consolidatedStatus": "STATUS\_CREATED",
"resultType": "ORIGINAL",
"consolidatedDuration": null,
"runTestCasesInParallel": false,
"runTestSuitesInParallel": false,
"scheduledId": null,
"testPlanHookResults": null,
"reRunType": null,
"consolidatedPlanTotalCount": null,
"consolidatedPlanFailedCount": null,
"consolidatedPlanPassedCount": null,
"consolidatedPlanStoppedCount": null,
"consolidatedPlanNotExecutedCount": null,
"consolidatedPlanQueuedCount": null,
"consolidatedPlanRunningCount": null,
"testDevicesNames": null,
"latestResult": null,
"testPlanResultMetric": null,
"activeExecutionResultCount": 0
}|
+
+Here’s a quick GIF demonstrating how to execute tests through a Dynamic Agent through API with the above mentioned endpoint.
+
+
+---
+
+## **Execute Tests in Private Grid from Application**
+
+### **a. Integrating Testsigma with Private Grid**
+
+1. From the left navigation bar, go to **Settings > Integrations** and choose the **Test Lab** tab.
+
+2. Enable the toggle on the **Private Grid** widget. A popup screen will display the details for the **Private Grid** lab.
+
+3. On **Private Grid** details,
+ - If there is authentication enabled in ngrok platform, select **Authentication Enabled** and enter **Username** and **Password**.
+ - Enter the **Private Hub URL** and select applications to use with your **Private Grid** framework.
+
+4. Click on **Add Details**.
+
+
+
+
+
+ ℹ️Fetching the Private Hub URL:
+
+Follow the steps below to set up ngrok on your device to fetch the Private Hub URL:
+
+
+ - Visit ngork website, create an account, go to Getting Started > Setup & Installation.
+ - Follow the instructions on the Setup & Installation page to set up ngrok.
+ - Once the installation is complete, enter the command ngrok http 4444 on the terminal.
+ - Copy the URL as shown in the image below and use this to integrate Testsigma with Private Grid.
+ 
+
+
+
+
+
+
+### **b. Execute Tests in Private Grid**
+
+1. For test case execution, select **Private Grid** as **Test Lab** on **Ad-hoc Run** overlay.
+
+ Here’s a quick GIF demonstrating how to execute a test case in Private Grid.
+ 
+
+2. For test plan execution, add **Private Grid** while creating test machine profiles for execution. You need to go to **Add Test Suites & Link Machine Profiles > Select test machine profiles > Add Machine** and add **Private Grid** as **Test Lab**.
+
+ Here’s a quick GIF demonstrating how to execute a test plan in Private Grid.
+
+ 
+
+---
\ No newline at end of file
diff --git a/src/pages/docs/runs/test-plans-on-local-devices.md b/src/pages/docs/runs/test-plans-on-local-devices.md
index 93d48a3d..c8401d4c 100644
--- a/src/pages/docs/runs/test-plans-on-local-devices.md
+++ b/src/pages/docs/runs/test-plans-on-local-devices.md
@@ -2,7 +2,7 @@
title: "Test Plan Local Executions"
metadesc: "Local execution is preferred for testing apps that are only available locally, for security purposes. How to perform test plan executions on local devices in Testsigma."
noindex: false
-order: 9.41
+order: 9.42
page_id: "Test Plan Local Executions"
warning: false
contextual_links:
diff --git a/src/pages/docs/salesforce-testing/connected-app.md b/src/pages/docs/salesforce-testing/connected-app.md
index 262cd822..20ff29e2 100644
--- a/src/pages/docs/salesforce-testing/connected-app.md
+++ b/src/pages/docs/salesforce-testing/connected-app.md
@@ -52,7 +52,7 @@ Creating a connected app is important to link external applications and the Sale
5. In the **API** section, select the **Enable OAuth Settings** checkbox to set **Callback URL** and **Selected OAuth Scopes**. The **Selected OAuth Scopes** are mandatory in the **Connected App** to connect & download the metadata.
- - Use this Callback URL: https://salesforce-callback.testsigma.com/authorize
+ - Use this Callback URL: https://salesforce-callback.testsigma.com/authorize/
diff --git a/src/pages/docs/salesforce-testing/metadata-connections.md b/src/pages/docs/salesforce-testing/metadata-connections.md
index cbea6d41..d203edb9 100644
--- a/src/pages/docs/salesforce-testing/metadata-connections.md
+++ b/src/pages/docs/salesforce-testing/metadata-connections.md
@@ -67,7 +67,7 @@ There are two ways to Authenticate:
- User name & Password: For User name & Password, enter Username, Password, Security token, Consumer key, and Consumer secret.
- OAuth: For OAuth, enter Username, Consumer key, and Consumer secret.
-
- Callback URL: https://salesforce-callback.testsigma.com/authorize
+ - Callback URL: Use the below mentioned Callback URL.
https://salesforce-callback.testsigma.com/authorize/
@@ -86,7 +86,7 @@ There are two ways to Authenticate:
- Wait until the sync is complete. This will take some time.
-1. Once Metadata sync is successful, you can create test cases by clicking **Create Test Case**.
+4. Once Metadata sync is successful, you can create test cases by clicking **Create Test Case**.
---