diff --git a/src/pages/docs/FAQs/web-apps/automating-captcha.md b/src/pages/docs/FAQs/web-apps/automating-captcha.md
index a5205e49..d8b1e52a 100644
--- a/src/pages/docs/FAQs/web-apps/automating-captcha.md
+++ b/src/pages/docs/FAQs/web-apps/automating-captcha.md
@@ -10,10 +10,10 @@ contextual_links:
name: "Contents"
- type: link
name: "1. Why is CAPTCHA used?"
- url: "#1-why-is-captcha-used?"
+ url: "#1-why-is-captcha-used"
- type: link
name: "2. Can I automate CAPTCHA testing in my test environment?"
- url: "#2-can-i-automate-captcha-testing-in-my-test-environment?"
+ url: "#2-can-i-automate-captcha-testing-in-my-test-environment"
---
---
diff --git a/src/pages/docs/FAQs/web-apps/why-chrome-extension.md b/src/pages/docs/FAQs/web-apps/why-chrome-extension.md
index 4f0b8a34..fe6991dd 100644
--- a/src/pages/docs/FAQs/web-apps/why-chrome-extension.md
+++ b/src/pages/docs/FAQs/web-apps/why-chrome-extension.md
@@ -28,7 +28,7 @@ With Testsigma’s Chrome Extension you capture these elements and record the us
---
-##**Security Disclaimer**
+## **Security Disclaimer**
* Testsigma Chrome Extension doesn’t track user browsing outside the application and does not collect private information such as IP address and passwords.
* We don’t modify the source code of your application.
diff --git a/src/pages/docs/agent/setup-on-kubernetes.md b/src/pages/docs/agent/setup-on-kubernetes.md
index bd359b9c..ab45fb98 100644
--- a/src/pages/docs/agent/setup-on-kubernetes.md
+++ b/src/pages/docs/agent/setup-on-kubernetes.md
@@ -438,6 +438,6 @@ kubectl -n testsigma delete pvc data-ts-agent-testsigma-agent-0
| Pod rejected on creation | The namespace enforces the `restricted` Pod Security Standard. The agent image requires `baseline`. |
| Browser crashes mid test | The browser needs more shared memory. Raise `browsers.chrome.shmSize` and its memory limit together. |
-For issues with agent startup or registration itself, see [Agent - Startup and Registration Errors](https://testsigma.com/docs/agent/troubleshooting/setup-issues/).
+For issues with agent startup or registration itself, see [Agent - Startup and Registration Errors](https://testsigma.com/docs/agent/troubleshooting/how-to-fix-setup-issues/).
---
diff --git a/src/pages/docs/agent/troubleshooting/how-to-fix-setup-issues.md b/src/pages/docs/agent/troubleshooting/how-to-fix-setup-issues.md
index 8e89e6c0..3b9c17f2 100644
--- a/src/pages/docs/agent/troubleshooting/how-to-fix-setup-issues.md
+++ b/src/pages/docs/agent/troubleshooting/how-to-fix-setup-issues.md
@@ -177,7 +177,7 @@ Follow the below steps to fix the issue.
2. Restart the Agent.
3. If the Agent is not updated, update the Agent. *For more information, refer to the [documentation on updating Agents](https://testsigma.com/docs/agent/update-agent-manually/)*.
-If the above troubleshooting steps does not resolve the issue, contact Testsigma support at [support@testsigma.com](mailto:support@testsigma.com) with the Agent logs files. *For more information on how to fetch agent logs refer to the [documentation on torubleshooting agent logs](https://testsigma.com/docs/agent/troubleshooting/logs/)*.
+If the above troubleshooting steps does not resolve the issue, contact Testsigma support at [support@testsigma.com](mailto:support@testsigma.com) with the Agent logs files. *For more information on how to fetch agent logs refer to the [documentation on troubleshooting agent logs](https://testsigma.com/docs/agent/troubleshooting/how-to-configure-agent-logs/)*.
---
diff --git a/src/pages/docs/agent/update-drivers-manually.md b/src/pages/docs/agent/update-drivers-manually.md
index 1c3f1870..076f3094 100644
--- a/src/pages/docs/agent/update-drivers-manually.md
+++ b/src/pages/docs/agent/update-drivers-manually.md
@@ -19,7 +19,7 @@ contextual_links:
url: "#adding-drivers-manually"
- type: link
name: "Additional steps for Mac or Linux"
- url: "#additional-steps-for-maclinux"
+ url: "#additional-steps-for-mac-or-linux"
---
diff --git a/src/pages/docs/ai-agents/analyzer.md b/src/pages/docs/ai-agents/analyzer.md
index 2c730b4e..57d9ba8e 100644
--- a/src/pages/docs/ai-agents/analyzer.md
+++ b/src/pages/docs/ai-agents/analyzer.md
@@ -43,44 +43,47 @@ The Analyzer Agent analyzes a failed test step and returns the error type, the r
2. Select the run that contains failed test steps.
-3. Open the test case with failures and select the failed test step.
+3. Click the test case with failures.
- The step header shows the error message. Click **Read more** to see the full message. The **Analysis** tab shows the error code, such as **#NO_SUCH_ELEMENT**, along with the **Visual Evidence** section.
+4. On the **Test Case Results** page, select the failed step.
-4. Click **Analyze with Agent** in the action bar at the bottom of the page.
- 
+ The **ANALYZER VERDICT** section on the step already shows a short analysis of the failure. Use the Analyzer Agent for suggested fixes you can apply, follow-up questions, and bug reports. For details on the verdict, refer to the [documentation on debugging test case failures](https://testsigma.com/docs/runs/debug-test-case-failures/).
-5. Review the analysis, which displays:
-
- - **Error Type**: The category of failure identified during execution, such as ELEMENT_NOT_FOUND.
- - **Root Cause**: An explanation of why the step failed, based on the error message and the captured evidence.
- - **Visual Evidence**: The screenshot captured at the time of execution. Click **Expand Images** to view it at full size, or the download icon to save it.
- - **Suggestions**: A numbered list of ways to resolve the failure.
+5. Click **Analyze with Agent** in the action bar at the bottom of the page.
+ 
+
+ The **Analyzer with Atto** panel opens and reads "Analyzing step failure..." while it runs.
+
+6. Review the analysis.
+ 
+
+ | **Section** | **What it shows** |
+ |---|---|
+ | **Error Type** | The failure type identified during execution |
+ | **Root Cause** | Why the step failed |
+ | **Visual Evidence** | Screenshots **At the time of Recording** and **At the time of Execution**. Only the execution screenshot appears when no recording screenshot exists. |
+ | **Suggestions** | Numbered fixes you can apply to the step |
[[info | **NOTE**:]]
| To ask a follow-up question about the failure, enter it in **Debug with Atto** and click **Analyze**.
-**Additional Information**: Responses are generated by Atto AI. Review the analysis before acting on it. Use the feedback icons or **Give Feedback** to tell us how useful it was.
-
---
## **Apply Fix Using Analyzer Agent**
-1. In the **Suggestions** list, select the suggestion you want to apply.
+1. In the **Suggestions** list, select one suggestion. **Apply Fix** stays disabled until you select one.
- [[info | **NOTE**:]]
- | You can select only one suggestion at a time.
+2. Click **Apply Fix**. Atto returns an **Add/Update Step** card.
-2. Click **Apply Fix**.
- 
+3. Click **Add/Update Step**.
+ 
+ In the step list, the updated step appears as an extra row below the original steps, marked with the Analyzer icon. The current result still shows the original step as failed, because the change applies from the next run.
- Atto generates the fix and returns an **Update Test Step** card explaining what it found, followed by the current version of the step and the proposed version.
+4. Re-run the test to confirm the fix.
+ - For a test plan run, click the run number in the breadcrumb to return to **Run Results**, then click **Rerun**.
+ - For a dry run, click **Re-Run** in the page header.
-3. Compare the two versions of the step.
-
-4. Click **Update Step** to apply the change.
-
-5. Rerun the test to validate the fix.
+ The next run uses the updated step.
---
@@ -98,6 +101,8 @@ The Analyzer Agent analyzes a failed test step and returns the error type, the r
[[info | **NOTE**:]]
| The fields displayed vary based on the selected bug tracking tool.
-**Additional Information**: If the tool returns no projects, check that the credentials configured for it have access to the projects you expect. For Jira, the panel reads "For given JIRA Credentials, the projects list is empty. Please make sure it has the right access to required projects on JIRA".
+>
Additional Information
+> +> If the tool returns no projects, check that the credentials configured for it have access to the projects you expect. For Jira, the panel reads "For given JIRA Credentials, the projects list is empty. Please make sure it has the right access to required projects on JIRA". --- diff --git a/src/pages/docs/api/examples/trigger-test-plan-wait-completion.md b/src/pages/docs/api/examples/trigger-test-plan-wait-completion.md index b7d880bb..1cb2d1dd 100644 --- a/src/pages/docs/api/examples/trigger-test-plan-wait-completion.md +++ b/src/pages/docs/api/examples/trigger-test-plan-wait-completion.md @@ -30,7 +30,7 @@ You should already be familiar with creating and running Test Plans. Refer to th | You need to authenticate these requests with your Testsigma API Key. To know more about obtaining API Keys, refer to the [documentation on generating API keys](https://testsigma.com/docs/configuration/api-keys/) --- -##**Checking the Test Run Results** +## **Checking the Test Run Results** The below steps give an overview of how the script given at the bottom of this page works: @@ -53,7 +53,7 @@ We can poll the Test Plan Execution Results API with this Run ID at regular inte We have provided the Powershell and Bash scripts for the same below. Please feel free to make changes as required and plug the same into your CI Pipeline. --- -##**Powershell script** +## **Powershell script** The Script triggers the executions and also waits until the Timeout(MAX\_WAIT\_TIME\_FOR\_SCRIPT\_TO\_EXIT) for the execution to complete. @@ -182,7 +182,7 @@ saveFinalResponseToAFile --- -##**Bash Script** +## **Bash Script** ```shell #!/bin/bash diff --git a/src/pages/docs/atto/generative-ai/byok/supported-llms/openai.md b/src/pages/docs/atto/generative-ai/byok/supported-llms/openai.md index 4645ef69..2313056b 100644 --- a/src/pages/docs/atto/generative-ai/byok/supported-llms/openai.md +++ b/src/pages/docs/atto/generative-ai/byok/supported-llms/openai.md @@ -14,7 +14,7 @@ contextual_links: url: "#prerequisites" - type: link name: "Steps to Get OpenAI Details" - url: "#Steps-to-get-openai-details" + url: "#steps-to-get-openai-details" --- --- diff --git a/src/pages/docs/atto/generative-ai/generate-tests/automate-test-cases.md b/src/pages/docs/atto/generative-ai/generate-tests/automate-test-cases.md index 0bc6267c..ddcf19ca 100644 --- a/src/pages/docs/atto/generative-ai/generate-tests/automate-test-cases.md +++ b/src/pages/docs/atto/generative-ai/generate-tests/automate-test-cases.md @@ -99,6 +99,6 @@ When you generate automated test cases, Atto checks for existing test cases. If [[info | **NOTE**:]] | - To learn about **Agentic Learning**, please refer to the [documentation on Generator Agent](https://testsigma.com/docs/ai-agents/generator/). -| - To understand the difference between **Run with Copilot** and **Agentic Learning**, please refer to the [documentation on Run with Copilot vs Agentic Learning](http://testsigma.com/docs/atto/generative-ai/copilot/agentic-learning-vs-copilot/). +| - To understand the difference between **Run with Copilot** and **Agentic Learning**, please refer to the [documentation on Run with Copilot vs Agentic Learning](https://testsigma.com/docs/atto/generative-ai/copilot/agentic-learning-vs-copilot/). --- diff --git a/src/pages/docs/atto/generative-ai/generate-tests/desktop.md b/src/pages/docs/atto/generative-ai/generate-tests/desktop.md index b238b352..fa4ecd97 100644 --- a/src/pages/docs/atto/generative-ai/generate-tests/desktop.md +++ b/src/pages/docs/atto/generative-ai/generate-tests/desktop.md @@ -82,6 +82,6 @@ Testsigma’s Gen AI capabilities help you streamline test case creation for Des [[info | **NOTE**:]] | - To learn about **Agentic Learning**, please refer to the [documentation on Generator Agent](https://testsigma.com/docs/ai-agents/generator/). -| - To understand the difference between **Run with Copilot** and **Agentic Learning**, please refer to the [documentation on Run with Copilot vs Agentic Learning](http://testsigma.com/docs/atto/generative-ai/copilot/agentic-learning-vs-copilot/). +| - To understand the difference between **Run with Copilot** and **Agentic Learning**, please refer to the [documentation on Run with Copilot vs Agentic Learning](https://testsigma.com/docs/atto/generative-ai/copilot/agentic-learning-vs-copilot/). --- diff --git a/src/pages/docs/atto/generative-ai/generate-tests/mobile-web.md b/src/pages/docs/atto/generative-ai/generate-tests/mobile-web.md index 627088a8..5db4703c 100644 --- a/src/pages/docs/atto/generative-ai/generate-tests/mobile-web.md +++ b/src/pages/docs/atto/generative-ai/generate-tests/mobile-web.md @@ -101,7 +101,7 @@ You can generate test cases for mobile web applications using Testsigma’s Gene [[info | **NOTE**:]] | - To learn about **Agentic Learning**, please refer to the [documentation on Generator Agent](https://testsigma.com/docs/ai-agents/generator/). -| - To understand the difference between **Run with Copilot** and **Agentic Learning**, please refer to the [documentation on Run with Copilot vs Agentic Learning](http://testsigma.com/docs/atto/generative-ai/copilot/agentic-learning-vs-copilot/). +| - To understand the difference between **Run with Copilot** and **Agentic Learning**, please refer to the [documentation on Run with Copilot vs Agentic Learning](https://testsigma.com/docs/atto/generative-ai/copilot/agentic-learning-vs-copilot/). --- \ No newline at end of file diff --git a/src/pages/docs/atto/generative-ai/generate-tests/mobile.md b/src/pages/docs/atto/generative-ai/generate-tests/mobile.md index 46a537f6..7c4a3ec8 100644 --- a/src/pages/docs/atto/generative-ai/generate-tests/mobile.md +++ b/src/pages/docs/atto/generative-ai/generate-tests/mobile.md @@ -98,7 +98,7 @@ You can generate test cases for android and iOS applications using Testsigma’s [[info | **NOTE**:]] | - To learn about **Agentic Learning**, please refer to the [documentation on Generator Agent](https://testsigma.com/docs/ai-agents/generator/). -| - To understand the difference between **Run with Copilot** and **Agentic Learning**, please refer to the [documentation on Run with Copilot vs Agentic Learning](http://testsigma.com/docs/atto/generative-ai/copilot/agentic-learning-vs-copilot/). +| - To understand the difference between **Run with Copilot** and **Agentic Learning**, please refer to the [documentation on Run with Copilot vs Agentic Learning](https://testsigma.com/docs/atto/generative-ai/copilot/agentic-learning-vs-copilot/). [[info | **NOTE**:]] | - To learn about **Agentic Learning**, please refer to the [documentation on Generator Agent in Testsigma](https://testsigma.com/docs/ai-agents/generator/). diff --git a/src/pages/docs/atto/generative-ai/generate-tests/salesforce.md b/src/pages/docs/atto/generative-ai/generate-tests/salesforce.md index 8386d483..305c007f 100644 --- a/src/pages/docs/atto/generative-ai/generate-tests/salesforce.md +++ b/src/pages/docs/atto/generative-ai/generate-tests/salesforce.md @@ -76,6 +76,6 @@ You can quickly generate test cases for Salesforce requirements in Testsigma usi [[info | **NOTE**:]] | - To learn about **Agentic Learning**, please refer to the [documentation on Generator Agent](https://testsigma.com/docs/ai-agents/generator/). -| - To understand the difference between **Run with Copilot** and **Agentic Learning**, please refer to the [documentation on Run with Copilot vs Agentic Learning](http://testsigma.com/docs/atto/generative-ai/copilot/agentic-learning-vs-copilot/). +| - To understand the difference between **Run with Copilot** and **Agentic Learning**, please refer to the [documentation on Run with Copilot vs Agentic Learning](https://testsigma.com/docs/atto/generative-ai/copilot/agentic-learning-vs-copilot/). --- \ No newline at end of file diff --git a/src/pages/docs/atto/generative-ai/generate-tests/web.md b/src/pages/docs/atto/generative-ai/generate-tests/web.md index 62c150d9..6ad1aafa 100644 --- a/src/pages/docs/atto/generative-ai/generate-tests/web.md +++ b/src/pages/docs/atto/generative-ai/generate-tests/web.md @@ -101,6 +101,6 @@ You can generate test cases for web and mobile web applications using Testsigma [[info | **NOTE**:]] | - To learn about **Agentic Learning**, please refer to the [documentation on Generator Agent](https://testsigma.com/docs/ai-agents/generator/). -| - To understand the difference between **Run with Copilot** and **Agentic Learning**, please refer to the [documentation on Run with Copilot vs Agentic Learning](http://testsigma.com/docs/atto/generative-ai/copilot/agentic-learning-vs-copilot/). +| - To understand the difference between **Run with Copilot** and **Agentic Learning**, please refer to the [documentation on Run with Copilot vs Agentic Learning](https://testsigma.com/docs/atto/generative-ai/copilot/agentic-learning-vs-copilot/). --- \ No newline at end of file diff --git a/src/pages/docs/atto/generative-ai/overview.md b/src/pages/docs/atto/generative-ai/overview.md index a6870605..305c95d9 100644 --- a/src/pages/docs/atto/generative-ai/overview.md +++ b/src/pages/docs/atto/generative-ai/overview.md @@ -14,7 +14,7 @@ contextual_links: url: "#prerequisites" - type: link name: "Testsigma Copiot Capabilities" - url: "#testsigma-copiot-capabilities" + url: "#testsigma-copilot-capabilities" - type: link name: "Generate Tests from Generative AI" url: "#generate-tests-from-generative-ai" diff --git a/src/pages/docs/auto-healing/auto-healing-insights.md b/src/pages/docs/auto-healing/auto-healing-insights.md index 91355acc..b400b89c 100644 --- a/src/pages/docs/auto-healing/auto-healing-insights.md +++ b/src/pages/docs/auto-healing/auto-healing-insights.md @@ -13,17 +13,11 @@ contextual_links: name: "Prerequisites" url: "#prerequisites" - type: link - name: "Identify Healed Steps in a Run" - url: "#identify-healed-steps-in-a-run" + name: "Review a Healed Step in Run Results" + url: "#review-a-healed-step-in-run-results" - type: link - name: "Review the Heal on the Analysis Tab" - url: "#review-the-heal-on-the-analysis-tab" -- type: link - name: "View Autoheal Details" - url: "#view-autoheal-details" -- type: link - name: "Read the Locator Trace" - url: "#read-the-locator-trace" + name: "Locators Tried" + url: "#locators-tried" - type: link name: "When a Heal Fails" url: "#when-a-heal-fails" @@ -46,65 +40,69 @@ Review how auto-healing behaved during a run to see which locator failed, what r --- -## **Identify Healed Steps in a Run** +## **Review a Healed Step in Run Results** -1. Open the test case results for the run. +When a saved locator fails during execution, Testsigma searches for the element and continues the run with a new locator. The step's status reads **Healed**, and the new locator is kept as a pending heal until you approve it. -2. Select the healed step. -  +1. On the **Test Case Results** page, select a step that shows the auto-heal icon. +  -[[info | **NOTE**:]] -| A healed step reports **Passed**, because the step completed. The run itself carries a **Healed** status in the run list, which distinguishes it from a run that passed without intervention. +2. Review the **Healed this step** card below the step header. +  ---- + The **Locator change** section shows two values: + - **Previous · recorded**: The saved locator that failed, shown struck through. + - **Current · applied**: The locator Testsigma used to continue the run. -## **Review the Heal on the Analysis Tab** + The count at the bottom of the card shows how many linked artifacts use this element. + -The **Analysis** tab shows a **Healed this step** card explaining what happened: "Existing locator failed during execution, and we've auto-healed it using AI. The element locator was updated with a new XPath to ensure your test continues to run smoothly." +3. Click **Locators tried** to see how Testsigma found the element. For details, refer to [Locators Tried](#locators-tried). -Choose one of the following: - -- Click **Approve as Primary** to make the healed locator the locator the test uses from now on. -- Click **Ignore** to leave the original locator in place. The heal still applied to this run only. +4. Click **Approve as Primary**. This will open **Autoheal Details** panel, showing the element name and the locator type used for the heal, such as **Autohealed using CSS Selector**. The failed locator appears struck through above the new one. -[[info | **NOTE**:]] -| In the **Visual Evidence** section, the current run panel carries a **Healed** badge, and the **Element** field has an edit icon for correcting the locator directly. +5. Click **Update**. The **Update Element** dialog opens. +  ---- +6. Review the test cases listed under **Linked to Test Cases**. Click the open icon next to a test case to view it in a new tab. -## **View Autoheal Details** +7. Click **Update** to update the element in all linked test cases. +  + The **Healed this step** card now shows **Approved**. -Open the **Autoheal Details** panel to see exactly which locator changed. -The panel shows: - -- The element that was healed, named at the top. -- The prompt "Do you want to update the autohealed element in all the linked test cases?" with **Update** and **Ignore** buttons. -- The healing method and how long it took, such as "Autohealed using CSS Selector" and "32s 912ms". -- The locator that failed, struck through, followed by the locator that replaced it. +--- -Click **Update** to apply the healed locator across every test case linked to the element, or **Ignore** to leave those test cases unchanged. +## **Locators Tried** -**Additional Information**: Use the feedback icons under "Is this autoheal helpful?" to tell us whether the heal was correct. The same feedback icons appear on the auto-healed banner above the step list. + ---- +The **Locators tried** panel lists each stage of the search in the order it runs. The panel header shows the step number, the number of stages, and how the element was found. -## **Read the Locator Trace** +| **Stage** | **What it does** | +|---|---| +| **Primary** | Tries the primary locator saved on the element. Every step starts here. | +| **Last Working** | Tries the locator that found the element in the previous run. It is kept on the element as a pending heal and is not part of the backup pool. | +| **Backup Pool** | Makes a single pass over the live screen to see which stored backup locators still resolve. No action is performed on the page at this stage. | +| **Relearn Screen** | Reads the screen as the app rendered it and writes new locators for the element. The result is kept as a pending heal and is tried first on the next run. | -Every auto-heal event records a locator trace: the full sequence the engine worked through to arrive at a heal, and whether that heal succeeded or failed. + -Use the trace to understand why a particular locator was chosen, or why no replacement could be found. +Each stage shows its outcome, such as **Did not match**, **Skipped**, or **Located**. Each locator in a stage shows: +- Its result, such as **NOT FOUND**, **AGREED**, or **NEW**. +- Its source and type, such as **smart-recorder · csspath**. +- Its role, such as **PRIMARY**, **LAST WORKING**, **ANCHOR**, or **CANDIDATE**. +- Its quality, **Good** or **Fragile**. -**Additional Information**: The locator trace is provided by the Auto Heal V2 architecture. +>Additional Information
+> +> A pending heal is not the element's primary locator. Testsigma tries it before searching again on later runs, but the primary locator changes only when you click **Approve as Primary**. --- ## **When a Heal Fails** -A heal attempt that fails gets the same root cause treatment as a failed step. Open the **Root cause** block on the **Analysis** tab and click **Explain this failure** to see why the engine could not resolve the element. - -[[info | **NOTE**:]] -| This requires Analyzer V2. Without it, a failed heal reports that it did not succeed, but no explanation is generated. +When auto-healing cannot find the element, the step fails. Select the failed step and review the **ERROR** and **ANALYZER VERDICT** sections to see why the element could not be resolved. For details, refer to the [documentation on debugging test case failures](https://testsigma.com/docs/runs/debug-test-case-failures/). --- @@ -112,7 +110,7 @@ A heal attempt that fails gets the same root cause treatment as a failed step. O If you would rather not accept the healed locator, you have two alternatives: -- **Update element** corrects the locator directly. In the **Visual Evidence** section, the **Element** field on the current run side carries an edit icon for this. +- **Update element** corrects the locator directly. - **Relearn step** re-captures the step so a fresh locator is recorded. --- diff --git a/src/pages/docs/continuous-integration/github-cicd.md b/src/pages/docs/continuous-integration/github-cicd.md index 1448fd19..a5d76a7b 100644 --- a/src/pages/docs/continuous-integration/github-cicd.md +++ b/src/pages/docs/continuous-integration/github-cicd.md @@ -9,7 +9,7 @@ contextual_links: name: "Contents" - type: link name: "Pre-requisites:" - url: "#pre-requisites" + url: "#prerequisites" - type: link name: "For Github CICD Integration" url: "#for-github-cicd-integration" diff --git a/src/pages/docs/continuous-integration/gitlab-cicd.md b/src/pages/docs/continuous-integration/gitlab-cicd.md index f231a673..e0fc92dc 100644 --- a/src/pages/docs/continuous-integration/gitlab-cicd.md +++ b/src/pages/docs/continuous-integration/gitlab-cicd.md @@ -10,10 +10,10 @@ contextual_links: name: "Contents" - type: link name: "Pre-requisites:" - url: "#pre-requisites" + url: "#prerequisites" - type: link name: "Steps to integrate GitLab with Testsigma" - url: "#steps-to-integrate-gitLab-with-testsigma" + url: "#steps-to-integrate-gitlab-with-testsigma" --- diff --git a/src/pages/docs/continuous-integration/jenkins.md b/src/pages/docs/continuous-integration/jenkins.md index 9bb799e1..913d3a24 100644 --- a/src/pages/docs/continuous-integration/jenkins.md +++ b/src/pages/docs/continuous-integration/jenkins.md @@ -37,7 +37,7 @@ Jenkins is an open-source automation server used for CI/CD and build automation. > Before you begin, ensure that you have: > - Reviewed the following documentation: > 1. [Generating API keys](https://testsigma.com/docs/configuration/api-keys/). -> 2. [Getting a test plan ID](https://s3.amazonaws.com/website-static-docs.testsigma.com/new_images/projects/Updated_Doc_Images/get-test-plan-id.png). +> 2. [Getting a test plan ID](https://testsigma.com/docs/continuous-integration/get-test-plan-details/). > - A working **Jenkins** server with administrative access. --- diff --git a/src/pages/docs/continuous-integration/shell-script.md b/src/pages/docs/continuous-integration/shell-script.md index 39962a54..c3e93fe3 100644 --- a/src/pages/docs/continuous-integration/shell-script.md +++ b/src/pages/docs/continuous-integration/shell-script.md @@ -10,7 +10,7 @@ contextual_links: name: "Contents" - type: link name: "Pre-requisites:" - url: "#pre-requisites" + url: "#prerequisites" - type: link name: "For Powershell Script" url: "#for-powershell-script" diff --git a/src/pages/docs/contributing/open-source-dev-environment-setup/macos-and-intellij-ce.md b/src/pages/docs/contributing/open-source-dev-environment-setup/macos-and-intellij-ce.md index e446ffb8..d760df31 100644 --- a/src/pages/docs/contributing/open-source-dev-environment-setup/macos-and-intellij-ce.md +++ b/src/pages/docs/contributing/open-source-dev-environment-setup/macos-and-intellij-ce.md @@ -11,7 +11,7 @@ contextual_links: name: "Contents" - type: link name: "Pre-Requisite" - url: "#pre-requisites" + url: "#prerequisites" - type: link name: "Pre-Requisite Software and Service Installation" url: "#pre-requisite-software-and-service-installation" diff --git a/src/pages/docs/contributing/open-source-dev-environment-setup/macos-and-intellij-ue.md b/src/pages/docs/contributing/open-source-dev-environment-setup/macos-and-intellij-ue.md index 420151f5..5f7df674 100644 --- a/src/pages/docs/contributing/open-source-dev-environment-setup/macos-and-intellij-ue.md +++ b/src/pages/docs/contributing/open-source-dev-environment-setup/macos-and-intellij-ue.md @@ -11,7 +11,7 @@ contextual_links: name: "Contents" - type: link name: "Pre-Requisite" - url: "#pre-requisites" + url: "#prerequisites" - type: link name: "Pre-Requisite Software and Service Installation" url: "#pre-requisite-software-and-service-installation" diff --git a/src/pages/docs/contributing/open-source-dev-environment-setup/windows-and-intelliJ-ue.md b/src/pages/docs/contributing/open-source-dev-environment-setup/windows-and-intelliJ-ue.md index 2fea664c..2ef7e68a 100644 --- a/src/pages/docs/contributing/open-source-dev-environment-setup/windows-and-intelliJ-ue.md +++ b/src/pages/docs/contributing/open-source-dev-environment-setup/windows-and-intelliJ-ue.md @@ -36,7 +36,7 @@ contextual_links:Additional Information
+> +> Network logs are captured only when they are switched on for the test machine, and they appear once the upload from the test machine finishes. Until then, the **Network** tab reads "No network log was recorded for this run". --- ## **Check Whether a Step Was Healed** -When auto-healing resolves a locator mid-run, a banner above the step list reports how many steps were healed, and the **Analysis** tab shows a **Healed this step** card with **Approve as Primary** and **Ignore**. +When auto-healing resolves a locator during the run, the step's status reads **Healed**, and the step shows the auto-heal icon in the step list. A banner above the step list shows how many steps were healed. -A healed step reports **Passed**, because the step completed. For the full workflow, refer to the [documentation on auto-healing insights](https://testsigma.com/docs/auto-healing/auto-healing-insights/). +Select the healed step to see the **Healed this step** card with the locator change and the **Approve as Primary** button. For the full workflow, refer to the [documentation on auto-healing insights](https://testsigma.com/docs/auto-healing/auto-healing-insights/). --- @@ -143,9 +174,7 @@ A healed step reports **Passed**, because the step completed. For the full workf Comparing a failing step against an earlier run shows what changed between them. There are two entry points: - Click **Compare Runs** in the page header to compare the whole test case across two runs, step by step. -- Click **Compare Steps** in the **Visual Evidence** section to compare the current step alone, using the screenshot and element source comparison modes. - -Comparison also spans the steps on either side of the failure, because the step that reports an error is often not the step that caused it. +- Click **Compare Steps** in the **THIS RUN** section to compare the current step alone. For both workflows, refer to the [documentation on test plan run results](https://testsigma.com/docs/reports/runs/drill-down-reports/). @@ -173,11 +202,10 @@ When an element causes a failure, check which other tests depend on it before yo Resolve the failure without leaving the results page. +- If the **ANALYZER VERDICT** section lists fix options, select one and click **Apply fix**. When the run left the recorded path, re-record the affected steps instead. - Click **Analyze with Agent** in the action bar to get the error type, the root cause, and a set of suggestions you can apply as a step update. - Click **Run using Copilot** in the action bar to rerun the test case interactively. -- Use **Update element** to correct a locator yourself. On the current run side of **Visual Evidence**, the **Element** field carries an edit icon for this. -- Use **Relearn step** to re-capture the step. -- Where auto-healing fired, approve or reject the healed element directly on the first screen. +- For a healed step, approve the new locator from the **Healed this step** card. For details, refer to the [documentation on auto-healing insights](https://testsigma.com/docs/auto-healing/auto-healing-insights/). --- diff --git a/src/pages/docs/runs/run-on-cloud-vendor-platforms.md b/src/pages/docs/runs/run-on-cloud-vendor-platforms.md index 75e22eb3..7f58413c 100644 --- a/src/pages/docs/runs/run-on-cloud-vendor-platforms.md +++ b/src/pages/docs/runs/run-on-cloud-vendor-platforms.md @@ -10,7 +10,7 @@ contextual_links: name: "Contents" - type: link name: "Pre-requisites" - url: "#pre-requisites" + url: "#prerequisites" - type: link name: "How to run test cases and test plans on cloud vendor platforms with Testsigma" url: "#how-to-run-test-cases-and-test-plans-on-cloud-vendor-platforms-with-testsigma" diff --git a/src/pages/docs/test-cases/create-test-steps/actions-and-options-manual/step-options.md b/src/pages/docs/test-cases/create-test-steps/actions-and-options-manual/step-options.md index b82f6a7e..d2b4ead9 100644 --- a/src/pages/docs/test-cases/create-test-steps/actions-and-options-manual/step-options.md +++ b/src/pages/docs/test-cases/create-test-steps/actions-and-options-manual/step-options.md @@ -11,7 +11,7 @@ contextual_links: name: "Contents" - type: link name: "Prerequesties" - url: "#prerequesties" + url: "#prerequisites" - type: link name: "Clear Step" url: "#clear-step" diff --git a/src/pages/docs/test-data/data-generators/numberfunctions-function-type.md b/src/pages/docs/test-data/data-generators/numberfunctions-function-type.md index acc3d155..4e9c97e1 100644 --- a/src/pages/docs/test-data/data-generators/numberfunctions-function-type.md +++ b/src/pages/docs/test-data/data-generators/numberfunctions-function-type.md @@ -17,7 +17,7 @@ contextual_links: url: "#selecting-numberfunctions-as-a-function-type-for-data-generator" - type: link name: "Custom Calculation" - url: "#custom-calculations" + url: "#custom-calculation" --- --- diff --git a/src/pages/docs/test-data/data-generators/phone-function-type.md b/src/pages/docs/test-data/data-generators/phone-function-type.md index dda44471..7d148a85 100644 --- a/src/pages/docs/test-data/data-generators/phone-function-type.md +++ b/src/pages/docs/test-data/data-generators/phone-function-type.md @@ -17,10 +17,10 @@ contextual_links: url: "#selecting-phone-number-as-a-function-type-for-data-generator" - type: link name: "Cell Phone" - url: "#cellphone" + url: "#cell-phone" - type: link name: "Phone Number" - url: "#phonenumber" + url: "#phone-number" --- --- diff --git a/src/pages/docs/test-data/types/parameter.md b/src/pages/docs/test-data/types/parameter.md index 3b739df8..f6645ce9 100644 --- a/src/pages/docs/test-data/types/parameter.md +++ b/src/pages/docs/test-data/types/parameter.md @@ -10,7 +10,7 @@ contextual_links: name: "Contents" - type: link name: "How to Use Parameters in a Test Case?" - url: "#how-to-use-parameters-in-a-test-case?" + url: "#how-to-use-parameters-in-a-test-case" --- --- diff --git a/src/pages/docs/test-plans/after-test.md b/src/pages/docs/test-plans/after-test.md index 30fe15aa..2928645e 100644 --- a/src/pages/docs/test-plans/after-test.md +++ b/src/pages/docs/test-plans/after-test.md @@ -11,7 +11,7 @@ contextual_links: name: "Contents" - type: link name: "After test in Test Cases" - url: "#after-test-in-test-cases" + url: "#aftertest-in-test-cases" - type: link name: "After test in Step groups" url: "#after-test-in-step-groups" diff --git a/src/pages/docs/test-plans/cross-browser-testing.md b/src/pages/docs/test-plans/cross-browser-testing.md index b2a23bd3..ed6924ba 100644 --- a/src/pages/docs/test-plans/cross-browser-testing.md +++ b/src/pages/docs/test-plans/cross-browser-testing.md @@ -37,13 +37,13 @@ Cross Browser Testing is testing web applications across multiple browsers to en ## **Steps to Enable Cross Browser Testing** -1. Navigate to **Test Machines & Suites Selection** under the **Create Test Plan** page. *For more information on creating a test plan, refer to the [documentation on creating test plans](https://testsigma.com/docs/test-management/test-plans/overview/)*. +1. Navigate to **Test Machines & Suites Selection** under the **Create Test Plan** page. *For more information on creating a test plan, refer to the [documentation on creating test plans](https://testsigma.com/docs/test-plans/overview/)*.  -2. Under the **Test machines & suites selection** tab, select the test suite for which you want to add the test machine for test execution. *For more information on adding test suites to a test plan, refer to the [documentation on adding test suites to a test plan](https://testsigma.com/docs/test-management/test-plans/manage-test-suites/)*. +2. Under the **Test machines & suites selection** tab, select the test suite for which you want to add the test machine for test execution. *For more information on adding test suites to a test plan, refer to the [documentation on adding test suites to a test plan](https://testsigma.com/docs/test-plans/manage-test-suites/)*.  -3. Once you have selected the test suites, select the test machines to run the corresponding test suite. *For more information on adding test machines to a test plan, refer to the [documentation on adding test machines to a test plan](https://testsigma.com/docs/test-management/test-plans/manage-test-machines/)*. +3. Once you have selected the test suites, select the test machines to run the corresponding test suite. *For more information on adding test machines to a test plan, refer to the [documentation on adding test machines to a test plan](https://testsigma.com/docs/test-plans/manage-test-machines/)*.  Note that, for *Cross Browser Testing*, test machines and test suites are selected separately. On execution, all the selected test suites are run on all selected test machines (in parallel or sequentially - depending on your selection). diff --git a/src/pages/docs/test-plans/distributed-testing.md b/src/pages/docs/test-plans/distributed-testing.md index 9fcbd6bd..543f15d1 100644 --- a/src/pages/docs/test-plans/distributed-testing.md +++ b/src/pages/docs/test-plans/distributed-testing.md @@ -35,7 +35,7 @@ Distributed testing is achieved in Testsigma by splitting up test plan execution >Prerequisites
> > Before you begin, ensure that you have referred to: -> 1. [Documentation on creating test plans](https://testsigma.com/docs/test-management/test-plans/overview/). +> 1. [Documentation on creating test plans](https://testsigma.com/docs/test-plans/overview/). > 2. [Documentation on creating test suites](https://testsigma.com/docs/test-suites/overview/). > 3. [Documentation on creating test machine](https://testsigma.com/docs/test-plans/manage-test-machines/). diff --git a/src/pages/docs/test-plans/manage-test-machines.md b/src/pages/docs/test-plans/manage-test-machines.md index 11b52a04..0758c155 100644 --- a/src/pages/docs/test-plans/manage-test-machines.md +++ b/src/pages/docs/test-plans/manage-test-machines.md @@ -17,6 +17,9 @@ contextual_links: - type: link name: "Adding a Test Machine From Edit Test Plan Page" url: "#adding-a-test-machine-from-edit-test-plan-page" +- type: link + name: "Setting Pre-Requisite Rerun Options for a Test Machine" + url: "#setting-pre-requisite-rerun-options-for-a-test-machine" - type: link name: "Delete test machine" url: "#delete-test-machine" @@ -94,6 +97,31 @@ Alternatively, you can also add new machines from the edit test plan page. --- +## **Setting Pre-Requisite Rerun Options for a Test Machine** + +Choose whether a prerequisite test machine runs again in full or only its failed iterations run when you rerun the test plan. + +1. In the **Add Test Suites & Link Machine Profiles** tab, click the **Link Machine to all suites**. This will oprn **Select test machine profiles** panel. + +[[info | NOTE:]] +| To link a test machine to a single test suite, click the test machine icon next to that test suite's name. + +2. Click the **Test machine settings** on the test machine profile you want to configure. This will open **Edit test machine/device profile** panel. + +3. From the **Pre-requisite test machine** list, select the prerequisite test machine. + +4. Click **Rerun options**. This will open **Pre-Requisite Rerun Options** dialog. +  + +5. Select **Always run Pre-Requisite** or **Only execute failed Pre-Requisite iteration(s)**. +  + +6. Click **Save**. + +7. Click **Update Profile**. + +--- + ## **Delete Test Machine** 1. Navigate to **Test Plan** and click on an existing test plan. diff --git a/src/pages/docs/test-plans/overview.md b/src/pages/docs/test-plans/overview.md index 1b525417..3187cfeb 100644 --- a/src/pages/docs/test-plans/overview.md +++ b/src/pages/docs/test-plans/overview.md @@ -86,7 +86,7 @@ In Testsigma, the Test Plan helps plan and organise software testing. The Test P - **Element Timeout**: Duration for which the test should wait for the element to load. - **Accessibility Testing**: Enable this option to verify that the application meets accessibility standards, ensuring equal access and usability for users with disabilities. It follows WCAG guidelines to maintain compliance. Once enabled, accessibility reports are generated and shared via notifications. You can also select the appropriate **WCAG Version & Conformance Level** based on your requirements. Note that this feature is currently supported only on **Safari** and **Firefox** browsers.  - **Recovery Actions**: Click **Recovery Actions** to open the recovery actions section and define what actions should happen.  - - **Post Plan Hook**: Select the Post Plan Hook and define actions or tasks to be performed once the test plan is executed and conditions are met (for more information, refer to [Post Plan Hook](https://testsigma.com/docs/test-management/test-plans/post-plan-hook/)).  + - **Post Plan Hook**: Select the Post Plan Hook and define actions or tasks to be performed once the test plan is executed and conditions are met (for more information, refer to [Post Plan Hook](https://testsigma.com/docs/test-plans/post-plan-hook/)).  --- diff --git a/src/pages/docs/test-suites/overview.md b/src/pages/docs/test-suites/overview.md index 3dd7b37b..79ef33d7 100644 --- a/src/pages/docs/test-suites/overview.md +++ b/src/pages/docs/test-suites/overview.md @@ -21,6 +21,9 @@ contextual_links: - type: link name: "Editing a Test Suite" url: "#editing-a-test-suite" +- type: link + name: "Setting Pre-Requisite Rerun Options" + url: "#setting-pre-requisite-rerun-options" - type: link name: "Deleting a Test Suite" url: "#deleting-a-test-suite" @@ -60,7 +63,7 @@ On the Test Suites List page, you will have the below options: 1. Navigate to **Test Suites** in the left-side navbar. Click the **Create Test Suite** button in the top right corner of the Test Suites List page. Provide below details to **Create Test Suite**: 2. **Name(Required)**: Enter the **title** of the Test Suite in the Name field on the Create Test Suite page. 3. **Description**: You can enable the toggle switch for the **Description** and provide a brief description explaining the test suite's purpose and scope. This will help your team members understand the objectives of the test suite. -4. **Pre-Requisite**: Specify any **Pre-Requisite** for executing the test suite, such as specific test data, system configurations, or test environment setup. +4. **Pre-Requisite**: Specify any **Pre-Requisite** for executing the test suite, such as specific test data, system configurations, or test environment setup. To control how the prerequisite behaves on test plan reruns, see [Setting Pre-Requisite Rerun Options](#setting-pre-requisite-rerun-options). 5. **Label**: You can assign a **Label** to the test suite. This will allow easier management of multiple test suites, as labels can be used for categorisation and filtering.  6. **Add/Remove Test Cases**: Click the **Add/Remove Test Cases** button to add or remove test cases from the Test Suite. An **Add/Remove Test Case** overlay will appear, allowing you to select test cases from the **Available Test Case** list by checking the box next to them or clicking the **+** icon to select individual test cases. @@ -96,6 +99,34 @@ On the Test Suites List page, you will have the below options:  7. Click **Activity** in the right-side navbar and view the **History** and **Comments** of test suite.  + +--- + +## **Setting Pre-Requisite Rerun Options** + +Choose whether a prerequisite test suite runs again in full or only its failed iterations run when you rerun the test plan. + +1. From the left navigation bar, navigate to **Test Suites**. + +2. Click **Create Test Suite** in the top-right corner. To update an existing test suite, click the **ellipsis** icon for the test suite and select **Edit**. + +3. From the **Pre-Requisite** list, select the prerequisite test suite. + +4. Click **Rerun options**. This will open **Pre-Requisite Rerun Options** dialog. +  + +5. Select one of the following options: + - **Always run Pre-Requisite**: Runs the prerequisite test suite again in full every time you rerun the test plan. + - **Only execute failed Pre-Requisite iteration(s)**: Runs only the prerequisite iterations that failed in the selected run. +  + +6. Click **Save**. + +7. Click **Create**. + +[[info | NOTE:]] +| Select **Always run Pre-Requisite** when the prerequisite generates runtime data, such as an order ID or a session token, that later test cases use. + --- ## **Deleting a Test Suite** diff --git a/src/templates/page.scss b/src/templates/page.scss index 3c3eca3c..99979c7c 100644 --- a/src/templates/page.scss +++ b/src/templates/page.scss @@ -435,6 +435,27 @@ blockquote:has(#prerequisites){ font-weight: 700; padding-left: 2rem; } + +blockquote:has(.additional-info){ + border: 1px solid #C1C7D0; + background: #FFFFFF; + color: #172B4D; + padding: 22px 20px 18px; + margin-top: 30px; + margin-bottom: 30px; + border-radius: 8px; + background-image: url("data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyMDAiIGhlaWdodD0iMjAwIiB2aWV3Qm94PSIwIDAgMjQgMjQiIGZpbGw9Im5vbmUiPjxjaXJjbGUgY3g9IjEyIiBjeT0iMTIiIHI9IjkiIHN0cm9rZT0iIzQyNTI2RSIgc3Ryb2tlLXdpZHRoPSIyIi8+PHBhdGggZmlsbD0iIzQyNTI2RSIgZD0iTTExIDE3aDJ2LTZoLTJ2NlptMS04cS40MjUgMCAuNzEzLS4yODhUMTMgOHEwLS40MjUtLjI4OC0uNzEzVDEyIDdxLS40MjUgMC0uNzEzLjI4OFQxMSA4cTAgLjQyNS4yODguNzEzVDEyIDlaIi8+PC9zdmc+"); + background-size: 1.5rem; + background-position: 1.5rem 2.1rem; + background-repeat: no-repeat; + > * { + padding-left: 2rem; + } +} +.additional-info{ + font-size: 22px; + font-weight: 700; +} .edit-button { padding-top: 40px; @media (min-width:992px) {