Skip to content

Commit

Permalink
Revamped Test Cases section in documentation (#325)
Browse files Browse the repository at this point in the history 
Revamped Test Cases section in documentation since there was more duplicate content.
  • Loading branch information
@bharathk08
bharathk08 authored Nov 17, 2023
1 parent 57b11ff commit d48cf08
Show file tree
Hide file tree
Showing 17 changed files with 747 additions and 52 deletions.
123 changes: 104 additions & 19 deletions src/pages/docs/elements/android-apps/create-manually.md
View file
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Create Elements [Manually]"
metadesc: "Element path plays an important role in dynamic websites. Learn how to create elements manually for a android apps in Testsigma."
metadesc: "Element path plays an important role in dynamic websites. Learn how to create elements manually for a android apps in Testsigma application"
noindex: false
order: 6.34
page_id: "Create Elements [Manually]"
Expand All @@ -12,34 +12,35 @@ contextual_links:
name: "Introduction"
url: "#introduction"
- type: link
name: "Pre-requisites"
url: "#pre-requisites"
name: "Prerequisites"
url: "#prerequisites"
- type: link
name: "How to create elements manually for an android project in Testsigma"
url: "#how-to-create-elements-manually-for-an-android-project-in-testsigma"

---

name: "Creating Elements"
url: "#creating-elements"
- type: link
name: "Creating Element While Adding Test Steps"
url: "#creating-element-while-adding-test-steps"
- type: link
name: "Updating an Element"
url: "#updating-an-element"
- type: link
name: "Updating Multiple Elements"
url: "#updating-multiple-elements"
---
##**Introduction**
In this document, we will discuss how to create elements manually for your android project in Testsigma i.e. without the use of a mobile test recorder.

<br>

---
##**Pre-requisites**
1. You should have an android project in Testsigma. See [creating a project](https://testsigma.com/docs/projects/overview/).

<br>

**Navigation**
In this document, we will discuss how to create elements manually for your android project in Testsigma i.e. without the use of a mobile test recorder.

**Test Development > Elements**
---

<br>
## **Prerequisites**
- You should have an android project in Testsigma. See [creating a project](https://testsigma.com/docs/projects/overview/).

---
##**How to create elements manually for an android project in Testsigma**

## **Creating Elements**
1. Go to your android project, then go to Test Development > Elements.
2. On the ‘All Elements’ page that appears, click on the create button on the top right:

Expand All @@ -66,3 +67,87 @@ Here are the fields that you will see:<br>
<br>

6. Once you have added all the details, click on the ‘Create’ button and the element you created will be added to the project.


---

## **Creating Element While Adding Test Steps**
1. Create a test case or go to a pre-existing test case.
2. Add a test step to the test case that contains an element. The language for the test step should contain an element. Some examples of such steps for an android application are shown in the screenshot below:

![the various Action test steps for android application in Testsigma](https://docs.testsigma.com/images/create-a-new-element/the-various-Actions-test-steps-android-testsigma.png)

3. Let’s say we add a step ‘Tap on element’ to our test case:

![Element specific test step test case page for android project in Testsigma](https://docs.testsigma.com/images/create-a-new-element/the-element-specific-test-step-test-case-page-android-testsigma.png)

4. On the step, click on the green text ‘element’, a layover will appear containing the elements in the project like this:

![Elements layover over a test case page for android project in Testsigma](https://docs.testsigma.com/images/create-a-new-element/the-elements-layover-over-test-case-page-android-testsigma.png)

5. Here, to create an element that is not in the list, start typing a new name for the element, the option “NEW” will appear like this:

![add new element with a new name on test case page for android project in Testsigma](https://docs.testsigma.com/images/create-a-new-element/add-new-element-with--new-name-test-case-page-android-testsigma.png)

6. Click on the ‘NEW’ button highlighted in the last step. ‘Create Element’ form will open up as shown in the screenshot below:

![create element form on test case page for android project in Testsigma](https://docs.testsigma.com/images/create-a-new-element/the-create-element-form-on-test-case-page-android-testsigma.png)

7. Create the element either manually or via element Test recorder. In this document, we will cover how to create elements ‘manually’. You can also [capture elements via Test recorder](https://testsigma.com/docs/elements/android-apps/capture-single-element/). For now, select the radio button ‘Manually’.

8. You will see the form options as shown in the screenshot below:

![create element form in Testsigma for an android project with Manually radio button selected ](https://docs.testsigma.com/images/create-a-new-element/create-element-manually-android-testsigma.png)

&emsp;

Here are the fields that you will see:
1. **Name**: Enter the name you want to give your element.
2. **Screen Name**: Mention the screen that your element resides on.
3. **Element Type**: There are 5 types of identifier types supported in Testsigma. This field is a drop-down list and you can select any one of them: XPATH, ID, Name, Class Name, or Accessibility ID
4. **Enter Value**: Enter the value here that is in correspondence with the Identifier Type you selected

![element type dropdown values on the create element form for android project in Testsigma](https://docs.testsigma.com/images/create-a-new-element/element-type-dropdown-value-create-an-element-android-testsigma.png)

9. Once you have added all the details, click on the ‘Create’ button. The green text ‘element’ will be replaced in the test step you were creating.

You can now continue adding the test step for your android project.

---

## **Updating an Element**

1. Select your project and then navigate to **Test Development > Elements**
2. **All Elements** page will appear. This contains all the elements that you have created for the selected android project, like this:

![all elements page to update elements for android project in Testsigma](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/test-cases/create-steps-nl/android-apps/update-elements/all-elements-page-update-elements-android-testsigma.png)

3. Scroll or filter to find the element you want to update.
4. Hover over the element and click on the **Edit** that appears. The button is also highlighted in the screenshot below:

![edit button for an element in all elements page for android project in Testsigma](https://docs.testsigma.com/images/update-elements/edit-button-for-an-element-in-all-elements-android-testsigma.png)

5. The Edit Element layover will appear:

![edit element page to update elements for android project in Testsigma](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/test-cases/create-steps-nl/android-apps/update-elements/edit-element-page-update-elements-android-testsigma.png)

There is a radio button that lets you choose between **Manually** or **Element Inspector**. When **Manually** is selected, you can make the changes you need to make in this element on the form and click on **Update** to finalize the changes. For the Test recorder approach, see how to [update elements using Test recorder](https://testsigma.com/docs/test-cases/create-steps-recorder/android-apps/update-elements/).

---

## **Updating Multiple Elements**

1. Select your android project and then navigate to **Test Development > Elements**
2. On the top right, there is an option to export the elements in excel format:

![export button on all elements page to update elements for an android project Testsigma](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/test-cases/create-steps-nl/android-apps/update-elements/export-button-all-elements-page-update-elements-android-testsigma.png)

3. In the excel sheet, update the required fields for the required elements.
4. Click on **Import**. Select the excel sheet you updated in step 3 for import.

![import button on all elements page to update elements for an android project in Testsigma](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/test-cases/create-steps-nl/android-apps/update-elements/import-button-all-elements-page-update-elements-android-testsigma.png)

With import, the edits done in step 3 will be visible in the corresponding elements in your android project in Testsigma.


---
118 changes: 104 additions & 14 deletions src/pages/docs/elements/ios-apps/create-manually.md
View file
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "Create Elements [Manually]"
metadesc: "Element path plays an important role in dynamic websites. Learn how to create elements manually for a iOS Applications in Testsigma."
metadesc: "Element path plays an important role in dynamic websites. Learn how to create elements manually for a iOS Applications in Testsigma application"
noindex: false
order: 6.44
page_id: "Create Elements [Manually]"
Expand All @@ -15,31 +15,35 @@ contextual_links:
name: "Pre-requisites"
url: "#pre-requisites"
- type: link
name: "How to create elements manually for an iOS project in Testsigma"
url: "#how-to-create-elements-manually-for-an-ios-project-in-testsigma"
name: "Creating Elements"
url: "#creating-elements"
- type: link
name: "Creating Element While Adding Test Steps"
url: "#creating-element-while-adding-test-steps"
- type: link
name: "Updating an Element"
url: "#updating-an-element"
- type: link
name: "Updating Multiple Elements"
url: "#updating-multiple-elements"

---


---
In this document, we will discuss how to create elements manually for your iOS project in Testsigma i.e. without the use of a Test recorder.

<br>

---
##**Pre-requisites**
You should have an iOS project in Testsigma. See [creating a project](https://testsigma.com/docs/projects/overview/).
In this document, we will discuss how to create elements manually for your iOS project in Testsigma i.e. without the use of a Test recorder.

<br>

**Navigation**

**Test Development > Elements**
---

<br>
## **Prerequisites**
You should have an iOS project in Testsigma. See [creating a project](https://testsigma.com/docs/projects/overview/).

---
##**How to create elements manually for an iOS project in Testsigma**

## **Creating Elements**

1. Go to your iOS project, then go to Test Development > Elements.
2. On the ‘All Elements’ page that appears, click on the create button on the top right:
Expand All @@ -65,4 +69,90 @@ Here are the fields that you will see:<br>

6. Once you have added all the details, click on the ‘Create’ button and the element you created will be added to the project.

---

## **Creating Element While Adding Test Steps**

1. Create a test case or go to a pre-existing test case.

2. Add a test step to the test case that contains an element. The language for the test step should contain an element. Some examples of such steps for an iOS application are shown in the screenshot below:

![the various Action test steps for iOS application in Testsigma](https://docs.testsigma.com/images/create-a-new-element/the-various-Actions-test-steps-ios-testsigma.png)

3. Let’s say we added the step ‘Tap on element’ to our test case:

![Element specific test step test case page for iOS project in Testsigma](https://docs.testsigma.com/images/create-a-new-element/the-element-specific-test-step-test-case-page-ios-testsigma.png)

4. On the step, click on the green text ‘element’, a layover will appear containing the elements in the project like this:

![Elements layover over a test case page for iOS project in Testsigma](https://docs.testsigma.com/images/create-a-new-element/the-elements-layover-over-test-case-page-ios-testsigma.png)

5. Here, to create an element that is not in the list, start typing a new name for the element, the option “NEW” will appear like this:

![add new element with a new name on test case page for iOS project in Testsigma](https://docs.testsigma.com/images/create-a-new-element/add-new-element-with--new-name-test-case-page-ios-testsigma.png)

6. Click on the ‘NEW’ button highlighted in the last step. ‘Create Element’ form will open up as shown in the screenshot below:

![create element form on test case page for iOS project in Testsigma](https://docs.testsigma.com/images/create-a-new-element/the-create-element-form-on-test-case-page-ios-testsigma.png)

7. Create the element either manually or via element inspector. In this document, we will cover how to create elements ‘manually’. You can also [capture elements via Test recorder](https://testsigma.com/docs/elements/ios-apps/capture-single-element/). For now, select the radio button ‘Manually’.

8. You will see the form options as shown in the screenshot below:

![create element form in Testsigma for an iOS project with Manually radio button selected ](https://docs.testsigma.com/images/create-a-new-element/create-element-manually-ios-testsigma.png)

Here are the fields that you will see:

**Name**: Enter the name you want to give your element.

**Screen Name**: Mention the screen that your element resides on.

**Element Type**: There are 5 types of identifier types supported in Testsigma. This field is a drop-down list and you can select any one of them: XPATH, ID, Name, Class Name, or Accessibility ID

**Enter Value**: Enter the value here that is in correspondence with the Identifier Type you selected.

![element type dropdown values on the create element form for iOS project in Testsigma](https://docs.testsigma.com/images/create-a-new-element/element-type-dropdown-value-create-an-element-ios-testsigma.png)

8. Once you have added all the details, click on the ‘Create’ button. The green text ‘element’ will be replaced in the test step you were creating.

You can now continue adding the test step for your iOS project.

---

## **Updating an Element**

1. Select your project and then navigate to **Test Development > Elements**.
2. **All Elements** page will appear. This contains all the elements that you have created for the selected iOS project, like this:

![all elements page to update elements for iOS project in Testsigma](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/test-cases/create-steps-nl/ios-apps/update-elements/all-elements-page-update-elements-ios-testsigma.png)

3. Scroll or filter to find the element you want to update.
4. Hover over the element and click on the **Edit**.

![edit button for an element in all elements page for iOS project in Testsigma](https://docs.testsigma.com/images/update-elements/edit-button-for-an-element-in-all-elements-ios-testsigma.png)

The Edit Element layover will appear:

![edit element page to update elements for iOS project in Testsigma](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/test-cases/create-steps-nl/ios-apps/update-elements/edit-element-page-update-elements-ios-testsigma.png)

There is a radio button that lets you choose between **Manually** or **Element Inspector**. When **Manually** is selected, you can make the changes you need to make in this element on the form and click on **Update** to finalize the changes. For Test recorder approach, see how to [update elements using Test recorder.](https://testsigma.com/docs/test-cases/create-steps-recorder/ios-apps/update-elements/)

&emsp;

---

## **Updating Multiple Elements**

1. Select your iOS project and then navigate to ‘Test Development > Elements’
2. On the top right, there is an option to export the elements in excel format:

![export button on all elements page to update elements for an iOS project Testsigma](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/test-cases/create-steps-nl/ios-apps/update-elements/export-button-all-elements-page-update-elements-ios-testsigma.png)

3. In the excel sheet, update the required fields for the required elements.
4. Click on the import button highlighted in the screenshot below. Select the excel sheet you updated in step 3 for import.

![import button on all elements page to update elements for an iOS project in Testsigma](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/test-cases/create-steps-nl/ios-apps/update-elements/import-button-all-elements-page-update-elements-ios-testsigma.png)

With import, the edits done in step 3 will be visible in the corresponding elements in your iOS project in Testsigma.

---
Loading

0 comments on commit d48cf08

Please sign in to comment.