Document toolboxDocument toolbox

Header

Test Case Creation and Management

This document covers the prerequisites to add, update, and delete Test Cases in Qualitia Automation Studio (QAS).

📚Prerequisites

  1. User should have the QAS - Client installed.

  2. User should be assigned to an existing project.

  3. A test scenario should exist.

🔑Privileges

User should have the below privileges to:

  • Import Artifacts: Import test artifacts from another project.

  • Manage Custom Action: Add, edit, delete and develop custom actions.

  • Manage Objects: Control (add, edit, and delete) the objects within your testing environment.

  • Manage Scenarios: Control (add, edit, and delete) the scenarios within your test suites.

  • Synchronize Objects: Import and export objects from TSR (Desktop Projects Only).

  • Test Development: Create, update, and record test cases and tasks.

👁️View Test Cases

  1. Login to QAS - Client.

  2. Access Develop from left navigation to view Test Explorer screen.

    1. On the Explorer section, you can view existing Test Scenarios.

  3. Click the Expand option on a test scenario, where you can view all its test cases.

  4. Use the Search bar to search for existing test cases.

  5. Use Jump to Selection icon, if you have a long list of test cases and you want to scroll to the last scenario you were working on.

‍➕ Add Test Cases

  1. Login to QAS - Client.

  2. Access Develop from left navigation to view Test Explorer screen.

    1. On the Explorer section, you can view existing Test Scenarios.

  3. When no Test Cases exist for a scenario, you are prompted to Create Test Case in the Test Case viewer section.

  4. Hover over a test scenario and click + Create to start creating a new Test Case.

    1. You can also click + Create from the top left corner of the tabular section where you see the list of test case.  

  5. Clicking Create will open a Create Test Case window with the following fields: 

    1. Name: Enter an intuitive name for the test case that is easy to recognize.

      1. Maximum length permitted is 300 characters including spaces.

    2. Scenario:  This is a dropdown and a searchable field. You can search for a required scenario from the list of already present scenarios under which you want to add a Test Case

    3. Description: A brief description about the test case.

    4. Manual Test Case ID: Based on the naming conventions your organization follows, enter a unique manual test case ID.

      1. Note: If an ID already exists, you cannot use the same ID.

    5. If you intend to create multiple test cases, click the Create another Test case checkbox.

  6. Once completed, click Save to proceed; otherwise, click Discard

    1. Clicking Save adds a new test case to the given test scenario.

  7. Repeat steps from 4 through 6 for each additional test case you want to add.

Additional actions you can perform:

  • Expand All - Expand all the test scenarios.

  • Collapse All - Collapse all the test scenarios.

  • Refresh

    • If a new test case or scenario is added or updated a Red Dot is displayed near the Refresh button. If you want to apply the changes, click Refresh.

‍🧑‍💼Manage Test Cases

You can update and delete test cases for a given scenario.

 🔄Update

  1. Login to QAS - Client.

  2. Access Develop from left navigation to view Test Explorer screen.

    1. On the Explorer section, you can view existing Test Scenarios.

  3. Click the Expand option on a test scenario, where you can view all its test cases.

  4. By hovering mouse over a test case, you can view an Edit option.

  5. Click the Pencil icon.

    1. Alternatively, you can select a test case from the tabular section where you will see a list of test cases and click Pencil icon from the top left corner of the section to edit.

  6. Clicking the Pencil icon, a new window appears where you are prompted to update:

    1. Name: Update a name of the test case.

      1. Maximum length permitted is 300 characters including spaces.

    2. Scenario:  This is a dropdown and a searchable field. You can change or update the scenario from the list of already present scenarios if you don’t want to continue with the one under which the Test Case was initially created. 

    3. Description: A brief description of the test case.

    4. Manual Test Case ID. Based on the naming conventions your organization follows, provide a unique manual test case ID.

      1. Note: If an ID already exists, you cannot use the same ID.

  7. Click Save to update the test case; otherwise, click Discard

❌Delete

  1. Login to QAS - Client.

  2. Access Develop from left navigation to view Test Explorer screen.

    1. On the Explorer section, you can view existing Test Scenarios.

  3. Click the Expand option on a test scenario, where you can view all its test cases.

  4. You can select the test case from the tabular section and click the Bin icon to delete.

  5. Clicking Delete will open a new window titled Test Case Deletion with a message Are you sure you want to delete the Test Case?

  6. Click Yes, Delete to continue; otherwise, click Cancel.

  7. You will see a message Test Case deleted successfully.

Disable Screenshot at Step Level

QAS now allows you to disable the screenshot at test case step level. This feature has been introduced to reduce the execution time.

Follow the below-mentioned steps to disable the screenshot:

  1. Login to QAS - Client.

  2. Access Develop from left navigation to view Test Explorer screen.

    1. On the Explorer section, you can view existing Test Scenarios.

  3. Click the Expand option on a test scenario, where you can view all its test cases.

  4. Click the test case from the tabular section to open the Test Case Editor screen.

  5. Go to a test case/task and hover over the step, for which you want to disable the screenshot, to see the Settings icon.

  6. Click the Settings icon at the right corner to open Change Settings.

  7. Select Disable screenshot to disable the screenshot.

image-20240909-050319.png

The Disable screenshot settings can be updated only from the Test Case editor.

Disable Screenshot at Action Level

To disable screenshot for an action, follow the below steps:

  1. Go to Settings from left navigation.

  2. Click Execution Configuration under Local Profile.

  3. Select the action for which you want to disable the screenshot from Exclude Actions From Screenshot Capture field.

    image-20240909-053208.png
  4. For the selected action the screenshot will not get captured in the entire project, wherever the action is used in test case or task.

OR

  1. Access Execute from left navigation of your QAS - Client to view Test Suite Explorer screen.

  2. Go to the Execution Profile tab.

  3. Select the default profile and click the Pencil icon to open Edit Profiles window.

  4. On the Edit Profiles window, select the action for which you want to disable the screenshot from Exclude Actions From Screenshot Capture field.

You can search action and select it.

💡 Golden Nuggets: Best Practices for Test Scenario Management

When managing test cases in QAS, a strategic approach can improve efficiency and prevent issues down the line. Here are some best practices to consider:

  1. Break scenarios into test cases: Once you have defined scenarios, break them down into individual test cases that cover specific functionality or test conditions. Each test case should focus on testing a single aspect or behavior.
    Example: In an e-commerce application scenario called "Checkout Process," break it down into separate test cases such as "Add Item to Cart," "Apply Coupon Code," "Select Shipping Method," and "Place Order." Each test case focuses on testing a specific functionality within the overall checkout process.

  2. Create modular and reusable test cases: Design test cases in a modular and reusable manner. This means that test cases can be executed independently and reused in different scenarios or for cross-functional tests. Avoid duplicating test steps or data across multiple test case.
    Example: Create a reusable test case called "User Login." This test case covers the login functionality and can be reused across different scenarios that require user authentication. Avoid duplicating login steps in other test cases and instead reference the "User Login" test case.

  3. Define scenario-specific setup and teardown: If certain test cases within a scenario require specific setup steps or teardown activities, define them at the scenario level. This helps in maintaining consistency and ensures that necessary preconditions are set up before executing the test cases.
    Example: In a scenario related to file upload functionality, define the setup steps at the scenario level to ensure that the necessary preconditions are met. This could include actions such as creating test files in a specific directory or configuring the file upload settings before executing the related test cases.

  4. Use descriptive scenario and test case names: Provide clear and descriptive names for scenarios and test cases. Use naming conventions that indicate the purpose, functionality, or specific test condition being addressed. This makes it easier to locate and understand the tests.
    Example: Use clear and descriptive names such as "Product Search by Keyword" for a scenario and "Verify Search Results Displayed" for a test case. This naming convention makes it easier to understand the purpose and functionality being addressed without delving into the specific test steps.

  5. Use placeholders for test steps: Instead of providing specific test steps, use descriptive keywords or phrases that outline the intended actions. For example, use terms like "perform action A" or "verify result B" without going into implementation details.

  6. Focus on test objectives: Clearly state the objective or goal of the test case without specifying the exact steps to achieve it. For instance, mention the expected outcome or behavior you want to validate, rather than the specific actions to take.
    Example: State the objective as "Verify successful payment processing" instead of providing detailed steps on how to achieve it. This focuses on the expected outcome or behavior to be validated rather than prescribing the exact actions to take.

  7. Document test assumptions: If there are any assumptions related to the test case, explicitly state them in a separate section. Assumptions can include prerequisites, specific system states, or test environment conditions. By doing so, you keep the test steps independent of these contextual factors.
    Example: In a test case, explicitly state assumptions such as "Assumes a valid user account already exists" or "Requires a stable internet connection." This clarifies the preconditions or contextual factors without embedding them within the test steps.

  8. Exclude specific test data: Avoid including specific test data or examples within the test cases. Instead, indicate the type or characteristics of the data required without providing actual values. This allows for flexibility in selecting appropriate test data during execution.

  9. Refer to external sources: If there are external resources, documents, or specifications to be used during the test, mention them without embedding the actual content. This approach maintains the test case's independence from specific reference materials.

  10. Separate test configuration details: Keep any configuration or setup details separate from the test case itself. If there are specific configurations required for the test, refer to them without providing the actual configuration values or steps.

  11. Regular Reviews: Conduct regular reviews of test cases and usage to optimize test scenario management.


🔧 Got a problem? Let’s fix!

  • Not able to understand what a tabular section for a test case is?

    • Let’s try to understand. Once you go to the Test Explorer and expand scenario, you will see a list of test cases on the right side of the Test Explorer. This screen is nothing but the tabular section. Here, you can select a test case and edit or delete it.

  • Struggling to find a delete option for test cases?

    • Once you go to the Test Explorer and expand scenario, you will see a list of test cases on the tabular section. Select a test case from the list and you will see an active Bin icon on the top left corner of the screen. Click on the Bin icon to delete the test case. The delete option will be inactive until you select a test case.

📞📚 Here to Help: Support and Resources

If you have questions that are not addressed in the documentation, you may raise them in the Qualitia Community.

 


 

Footer