Maeris logo
Sign In

Introduction to the Notebook

The Notebook is your central workspace in Maeris for organizing, managing, and executing all your UI test cases. Think of it as your command center for test automation.

What is the Notebook?

The Notebook is Maeris's test management interface where you can create, organize, run, and monitor all your UI test cases. It provides a structured way to manage your testing workflow, from initial test creation to analyzing results.

Key Features

  • Test Organization: Group and organize tests by feature, module, or priority
  • Test Management: Create, edit, duplicate, and delete test cases
  • Test Execution: Run individual tests or entire test suites
  • Result Tracking: View detailed results, screenshots, and execution history
  • Collaboration: Share tests with your team and track changes

Understanding the Notebook Interface

Test List View

The main area displays all your test cases in a list or grid format. You can see test names, status, last run information, and quick actions.

Test Management Modal

The modal interface for creating and editing test cases. Here you can define test steps, configure settings, and set up test parameters.

Test Information Panel

Detailed view showing test configuration, execution history, and results. Access this by clicking on a test case.

Action Toolbar

Quick actions for running tests, creating new tests, filtering, and organizing your test suite.

Organizing Your Tests

Best Practices for Organization

  • Group by Feature: Organize tests based on application features or modules

    Example: Login Tests, Checkout Tests, User Profile Tests

  • Use Descriptive Names: Name your tests clearly to indicate what they verify

    Example: "User Login with Valid Credentials" instead of "Test 1"

  • Tag Your Tests: Use tags to categorize tests by priority, type, or environment

    Example: @smoke, @regression, @critical

  • Maintain Test Hierarchy: Structure tests in a logical order that matches your application flow

Test Lifecycle in the Notebook

  1. Create: Use the Test Management Modal to create a new test case

    Define test steps, selectors, and expected outcomes

  2. Configure: Set up test settings, timeouts, and execution parameters

    Configure browser, environment, and test data

  3. Run: Execute the test individually or as part of a test suite

    Monitor execution in real-time or review results afterward

  4. Review: Analyze test results, screenshots, and execution details

    Identify failures, review logs, and understand test behavior

  5. Maintain: Update tests as your application evolves

    Fix broken tests, update selectors, and improve test coverage

Key Notebook Features

Bulk Operations

Select multiple tests and perform bulk actions like running, deleting, or organizing.

Search and Filter

Quickly find tests using search functionality and filter by status, tags, or date.

Test Duplication

Duplicate existing tests to create variations or similar test scenarios.

Execution History

View complete execution history for each test with detailed results and trends.

Next Steps

Now that you understand the Notebook, start creating your tests: