Skip to content

Commit

Permalink
Merge remote-tracking branch 'origin/dev' into doc-270
Browse files Browse the repository at this point in the history
  • Loading branch information
Santhosh-testsigma committed Dec 12, 2023
2 parents c05423f + 479cf54 commit d1b9194
Show file tree
Hide file tree
Showing 17 changed files with 344 additions and 351 deletions.
57 changes: 24 additions & 33 deletions src/pages/docs/addons/ocr-extraction.md
Original file line number Diff line number Diff line change
@@ -1,75 +1,66 @@
---
title: "How to create OCR Text Extraction Addon"
metadesc: "This article discusses how to create an addon for OCR text extraction for Testsigma app | OCR Text Extraction addon will help you to extract texts from images"
title: "Create OCR Text Extraction Addon"
page_title: "Create OCR Text Extraction Addon: Enhanced Test Automation"
metadesc: "Create OCR Text Extraction Addon seamlessly with our step-by-step guide. Extract text from pages, images, and elements effortlessly. Enhance your testing."
noindex: false
order: 17.81
page_id: "Create a OCR Text Extraction Addon in Testsigma"
warning: false
contextual_links:
- type: section
name: "Contents"
- type: link
name: "Prerequisites"
url: "#prerequisites"
- type: link
name: "Update the Action Code"
url: "#update-the-action-code"
- type: link
name: "Overview of the method to extract text"
url: "#overview-of-the-method-to-extract-text"
name: "OCR Code Update"
url: "#ocr-code-update"
- type: link
name: "Using OCR Addon in a Test case"
url: "#using-ocr-addon-in-a-test-case"
---


---

In this article, we will discuss how to create an addon for OCR text extraction. The creation part for the addon is similar except we set a class that implements the OCR interface.
This guide will instruct you step-by-step on how to create an OCR Text Extraction Addon for Testsigma. You should set up a class that implements the OCR interface, update the action code, and use the addon in test cases.

---

## **Prerequisites**

- To know about the prerequisites for addons, refer to [prerequisites for creating an add-on](https://testsigma.com/docs/addons/pre-requisite-to-create-addon/).

- To know how to create an addon, refer to [create a Testsigma addon](https://testsigma.com/docs/addons/create/).
Before creating the OCR Text Extraction addon, ensure you have met the prerequisites for addon development. For more information, refer to the [Creating an Addon](https://testsigma.com/docs/addons/create/).

---

## **Update the Action Code**

1. Unzip the downloaded zip file and open the extracted folder in your favorite IDE as a Java module. This Java module contain the following template files which need to be updated:
![Folder](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/folder.png)

- **pom.xml:** Contains all your dependencies needed to code your functionality.

- **src folder:** Sample source java files with sample add-on functions.


2. From your IDE, import the downloaded Java module as Maven/Gradle.


3. The Template Java module contains all necessary dependencies required to develop an Addon. For OCR Text Extraction action, you can add the following to pom.xml.
1. Unzip the downloaded zip file and open the extracted folder in your preferred IDE as a Java module. ![Folder](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/folder.png)
2. Import the Java module as Maven/Gradle from your IDE.
3. Update the following template files:
- **pom.xml**: Contains dependencies for coding your functionality.
- **src folder**: Includes sample Java files with addon functions.
![OCR code update](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/ocr.png)

---

## **Overview of the method to extract text**

- ***extractTextFromPage():*** This method will extract text from an entire page.

- ***extractTextFromImage(OCRImage image):*** This method will extract text from a specified OCRImage object.
## **OCR Code Update**

- ***extractTextFromElement(Element element):*** This method will extract text from a specific Element object.
1. In the pom.xml file, add the necessary dependencies for OCR Text Extraction.
2. Update the following methods in the Java module:
- ***extractTextFromPage():*** Extracts text from an entire page.
- ***extractTextFromImage(OCRImage image):*** Extracts text from a specified OCRImage object.
- ***extractTextFromElement(Element element):*** Extracts text from a specific Element object.

[[info | **NOTE**:]]
| All three methods mentioned above will return a List of OCRTextPoint objects, which represent the location of the text within the source.
| All three methods return a List of OCRTextPoint objects, representing the text's location within the source.

---


## **Using OCR Addon in a Test case**

Once you publish the addon, the NLPs will be available in the application. Example NLP, 'Click on the ***Element*** by the text ***test-data***'.



Once the addon is published, NLPs become available in the application. Follow these GIF below to use the OCR addon in Test Cases: ![Addon GIF](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/ocr_text_extraction_addon.gif)

---
69 changes: 24 additions & 45 deletions src/pages/docs/desired-capabilities/incognito-mode.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,82 +10,61 @@ warning: false
contextual_links:
- type: section
name: "Contents"
- type: link
name: "Prerequisites"
url: "#prerequisites"
- type: link
name: "Desired Capabilities for Incognito or Private Browser"
url: "#desired-capabilities-for-incognito-or-private-browser"
- type: link
name: "Add Desired capabilities in Ad-hoc Run Screen"
url: "#add-desired-capabilities-in-ad-hoc-run-screen"
name: "Adding Desired Capabilities in Test Case"
url: "#adding-desired-capabilities-in-test-case"
- type: link
name: "Add Desired capabilities in Test Plan"
url: "#add-desired-capabilities-in-test-plan"
name: "Adding Desired Capabilities in Test Plan"
url: "#adding-desired-capabilities-in-test-plan"
---

---
Desired Capabilities are a set of properties used for customizing the Test Environment. The customization includes adding browser extensions to the automation sessions, setting the Geographical locations for the test machine, bypassing browser alerts, etc.

Desired capabilities have now been added to the browser's Incognito/Private tab to launch the new browser or not save details and run every time a new test case in browsers.
Desired Capabilities allow you to customise the test environment by adding browser extensions, setting geographical locations, and bypassing alerts. Testsigma enables you to run tests in Incognito/Private mode to ensure a clean testing space. This guide helps you easily configure your testing environment for this mode.

---

### **Prerequisites**
## **Prerequisites**

Before using the Incognito/Private Mode Browser Testing feature, you should understand the concepts of [Create Ad-hoc Runs](https://testsigma.com/docs/runs/adhoc-runs/), [Create Test Cases](https://testsigma.com/docs/test-cases/manage/add-edit-delete/#creating-a-test-case), and [Create Test Plans](https://testsigma.com/docs/test-management/test-plans/overview/). in Testsigma.
Before starting testing in Incognito/Private Mode, you must understand specific concepts, such as creating [Test Cases](https://testsigma.com/docs/test-cases/manage/add-edit-delete/) and [Test Plans](https://testsigma.com/docs/test-management/test-plans/overview/), managing [Ad-hoc runs](https://testsigma.com/docs/runs/adhoc-runs/) and [Test Machines](https://testsigma.com/docs/test-management/test-plans/manage-test-machines/) in Testsigma.

---

## **Desired Capabilities for Incognito or Private Browser**

Use the following Desired Capabilities to enable Incognito or Private mode:

|Capability - Key|Data Type|Value|Function|
|---|---|---|---|
|testsigma.privateBrowsing|Boolean|True|The selected browser will be launched in **incognito** or **private mode**|
|testsigma.privateBrowsing|Boolean|False|The selected browser will be launched in **Normal mode**|
|No Capability|Boolean|False|The selected browser will be launched in **Normal mode**|

[[info | NOTE:]]
| Desired Capabilities for Incognito/Private Tab Browsers Support **Google Chrome**, **Mozilla Firefox**, and **Microsoft Edge**.
| **Google Chrome**, **Mozilla Firefox**, and **Microsoft Edge** support the desired capabilities for Incognito/Private Tab Browsers.

---

## **Add Desired capabilities in Ad-hoc Run Screen**

1. Navigate to **Test Development** > **Test Cases**. Create a new project or open an existing project.
![Choose Project](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/testcase_dc.png)

2. Click **Run** after adding the test steps.
![Run test case](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/run_testcase_dc.png)

3. The **Ad-hoc Run** screen will appear; select **Test Lab** and **Test Machines**. Click on **Desired Capabilities (Optional)**.
![Enable Desired Capabilities](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/ad_hoc_run_e_dc.png)

4. Enter **testsigma.privateBrowsing** in the key, select data type **Boolean** from the drop-down list, and enter **true** for the value in the Desired Capabilities field. Click **Run Now**.
![Enter capabilities](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/capabilities_adhocrun_dc.png)
## **Adding Desired Capabilities in Test Case**

5. Test steps will be executed in the Incognito/Private tab.

Here is a quick GIF demonstrating the above workflow: ![gif for test case](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/dc_ad_hoc_run.gif)
1. Click **Run** in the top right corner of the screen on the Test Case details page.
2. In the **Ad-hoc Run** screen, you should select **Test Lab** and **Test Machine**. Then, you can click on **Desired Capabilities (Optional)**.
3. Enter **testsigma.privateBrowsing** in the key. Select **Boolean** as the data type and enter **true** for the value in the Desired Capabilities field.
4. Click **Run Now** to execute the Incognito/Private tab test steps. ![Add capabilities in Test Case](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/adding_ic_testcase.gif)

---

## **Add Desired capabilities in Test Plan**

1. Navigate to **Select project** > **Test Development** > **Test plan**.
![Choose Test plan](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/testplan_dc.png)

2. Click an existing test plan and click **Edit** in the top right corner.
![Edit in test plan](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/testplanedit_dc.png)

3. On the **Edit test plan** page, navigate to the **Test devices & suites** tab. Add test suites to the test plan and Click **Add Machine Device**.
![Edit test plan](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/edittestplan_dc.png)

4. On the screen, an **Add Machine/Device** overlay will appear. Enter the machine's **name**, select **Lab** from the drop-down list, and then select **Machines**. Click on **Desired Capabilities (Optional)**.
![Enable DC in test plan](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/desired_capabilities_testplan_dc.png)

5. Enter **testsigma.privateBrowsing** in the key, select data type **Boolean** from the drop-down list, and enter **true** for the value in the Desired Capabilities field. Click **Create**.
![Enter Capabilities in field](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/desired_capabilities_field_testplan_dc.png)

6. To update the test plan, click **Next** > **Update**.
## **Adding Desired Capabilities in Test Plan**

Here is a quick GIF demonstrating the above workflow: ![Test Plan Gif](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/overview/dcd_ad_testplan.gif)
1. Navigate to the **Test Machines & Suites Selection** tab on the **Create** or **Edit Test Plan** page.
2. Clicking **Add Machine**/**Device** allows you to add a test machine. You can edit existing machines by clicking **Test Machine Settings**.
3. On the **Add** or **Edit test machine/device** profile screen, enter the **machine's name**, select a **lab**, and select a **machine** from the drop-down list. Click on **Desired Capabilities (Optional)**.
4. Enter **testsigma.privateBrowsing** in the key. Select **Boolean** as the data type and enter **true** for the value in the Desired Capabilities field. Then click **Create**/ **Update** profile to save the configuration.
5. Click **Create/Update** to save and update the test plan. ![Add capabilities in Test Plan](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/adding_ic_testplan.gif)

---
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: "How to enter non-text keys in Test Cases?"
metadesc: "You can use non-text keys from keyboard in your test cases in Testsigma Application | Learn how to use non-text keys from keyboard in your test cases"
title: "Entering Non-Text Keys in Test Cases"
page_title: "Efficiently enter Non-Text Keys in Test Cases for Testing"
metadesc: "Learn how to simulate non-text key inputs seamlessly in your test cases, ensuring precise testing outcomes. Explore the guide for effective testing strategies."
noindex: false
order: 24.2
page_id: "Enter non-text keys in Test Cases"
Expand All @@ -9,15 +10,20 @@ contextual_links:
- type: section
name: "Contents"
- type: link
name: "Keys and Values"
url: "#keys-and-values"
name: "Keys and Corresponding Values"
url: "#keys-and-corresponding-values"
---
<br>

Simulating the pressing of non-text keys such as backspace, enter, control, tab, arrow keys, function keys, and others is a common requirement during testing. Refer to the table below and use the corresponding values for each key in your test cases.
---

Testing applications requires simulating non-text keys' input on an everyday basis. This includes replicating actions like pressing backspace, enter, control, tab, arrow keys, and function keys. To accomplish this in Testsigma, you should follow the guide below and include the specified values for each key in your test cases.

---

## **Keys and Corresponding Values**

Use NLPs in your test cases to input non-text values. For example, utilise the NLP **Press Test Data key** and substitute the values for **Test Data**. Consult the table below for the mapping of keys to their corresponding values. ![Enter non-text vaules in Test Cases](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/entering-non-text-keys.gif)

## **Keys and Values**
|**Keyboard’s Key**|**Values**|
|---|---|
|Arrow Key – Down|ARROW\_DOWN|
Expand Down Expand Up @@ -51,11 +57,5 @@ Simulating the pressing of non-text keys such as backspace, enter, control, tab,
|Function Key F11|F11|
|Function Key F12|F12|


Refer to the sample GIF below to understand how to use Non-text keys in Test Cases.
![GIF](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/nontext.gif)




---

2 changes: 1 addition & 1 deletion src/pages/docs/integrations/test-labs/browserstack.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Integrate Testsigma with BrowserStack"
metadesc: "BrowserStack integration lets you execute your Testsigma tests on BrowserStack. Learn how to integrate the BrowserStack Cloud Test Execution Platform with Testsigma"
noindex: false
order: 16.41
order: 16.42
page_id: "Integrate Testsigma with BrowserStack"
warning: false
contextual_links:
Expand Down
71 changes: 71 additions & 0 deletions src/pages/docs/integrations/test-labs/integrate-test-labs.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,71 @@
---
title: "Integrations with Test Labs"
pagetitle: "Unlock Seamless Test Lab Integration for Cloud Testing"
metadesc: "Start integrating with test labs to run tests on cloud devices effortlessly. Explore easy steps and prerequisites for successful integration."
noindex: false
order: 16.41
page_id: "integrate-test-lab-with-Testsigma"
warning: false
contextual_links:
- type: section
name: "Contents"
- type: link
name: "Prerequisites"
url: "#prerequisites"
- type: link
name: "Integrating Testsigma with Test Lab"
url: "#integrating-testsigma-with-test-lab"
- type: link
name: "Manage Integrated Test Lab"
url: "#manage-integrated-test-lab"
- type: link
name: "Perform Test Run for Integrated Test Lab"
url: "#Perform Test Run for Integrated Test Lab"
---

---

Testsigma integrates with various test labs, allowing you to run your tests on cloud devices. This guide will walk you through the steps to integrate Testsigma with popular test labs like BrowserStack, SauceLabs, LambdaTest, and Kobiton.

---

## **Prerequisites**

Before connecting Testsigma with other labs, ensure you know about the various types of [Test Labs](https://testsigma.com/docs/test-management/test-plans/supported-test-lab-types/) in Testsigma. Additionally, gather the necessary information for integration:
- **BrowserStack**: Username and API Key from BrowserStack.
- **SauceLabs**: Username and API Key from SauceLabs.
- **LambdaTest**: Username and API Key from LambdaTest.
- **Kobiton**: Username/Email and API Key from Kobiton.

---

## **Integrating Testsigma with Test Lab**

To enable Test Lab, follow these steps by providing credentials and integrating other Test Labs in Testsigma.

1. Navigate to **Settings** > **Integrations** > **Test Lab** tab.
2. Click the **toggle** to enable the test lab integration with your Testsigma account. A popup screen will display the details for the selected Test Lab.
3. Enter the **Username/Email** and **API Key** of your **Test Lab** in the provided fields. Confirm your **API Key** by entering the respective fields on the pop-up screen.
4. Click the **Save & Enable** button to complete the integration setup. ![Integrate Test Labs](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/integrate_testlab.gif)

---

## **Manage Integrated Test Lab**

Effectively manage your integrated test labs in Testsigma by updating credentials or deleting integrated labs:

1. Navigate to **Settings** > **Integrations** > **Test Lab** tab.
2. Click **Manage** to open the popup screen with details for the enabled test lab.
3. Change the **Username** and **API Key** to update the credentials for the test lab. Save the changes by clicking **Update Details**.
4. Click on **Delete Credentials** to remove the integration. A confirmation pop-up will appear. Enter **DELETE** to confirm the deletion, then click **I understand, delete & disable plugin**. ![Manage Integrated Test Labs](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/manage_testlabs.gif)

[[info | NOTE:]]
| If you try to delete a Test Lab connected to execution, the application will show a warning to stop the deletion and disable the test lab. You need to remove the Test Lab from the linked execution before attempting to delete it again.

---

## **Perform Test Run for Integrated Test Lab**

Select the **Test Lab Type** as an integrated test lab when running a test in **Ad-hoc Runs** for a Test Case or **Test Machine** for a Test Plan to execute a test run. ![Perform Integrated Test Lab](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/perform_integratedtestlab.gif)

---
2 changes: 1 addition & 1 deletion src/pages/docs/integrations/test-labs/kobiton.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Integrate Testsigma with Kobiton"
metadesc: "Kobiton integration lets you execute your Testsigma tests on BrowserStack. Learn how to integrate the Kobiton Test Execution Platform with Testsigma"
noindex: false
order: 16.44
order: 16.45
page_id: "Integrate Testsigma with Kobiton"
warning: false
contextual_links:
Expand Down
2 changes: 1 addition & 1 deletion src/pages/docs/integrations/test-labs/lambdatest.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Integrate Testsigma with LambdaTest"
metadesc: "LambdaTest integration lets you execute your Testsigma tests on BrowserStack. Learn how to integrate the LambdaTest Test Execution Platform with Testsigma"
noindex: false
order: 16.43
order: 16.44
page_id: "Integrate Testsigma with LambdaTest"
warning: false
contextual_links:
Expand Down
2 changes: 1 addition & 1 deletion src/pages/docs/integrations/test-labs/sauce-labs.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: "Integrate Testsigma with SauceLabs"
metadesc: "SauceLabs integration lets you execute your Testsigma tests on BrowserStack. Learn how to integrate the SauceLabs Test Execution Platform with Testsigma"
noindex: false
order: 16.42
order: 16.44
page_id: "Integrate Testsigma with SauceLabs"
warning: false
contextual_links:
Expand Down
Loading

0 comments on commit d1b9194

Please sign in to comment.