Linking & Auto-Creating Test Cases

Linking Tests to Test Cases

Link your automated tests to existing TestPlanIt test cases by including case IDs in your test titles. By default, the reporter looks for case IDs in square brackets like [1234]:

describe('User Authentication', () => {
  it('[12345] should login with valid credentials', async () => {
    // This test links to TestPlanIt case #12345
    await LoginPage.login('[email protected]', 'password');
    await expect(DashboardPage.heading).toBeDisplayed();
  });

  it('[12346] [12347] should show error for invalid password', async () => {
    // This test links to BOTH case #12346 and #12347
    await LoginPage.login('[email protected]', 'wrongpassword');
    await expect(LoginPage.errorMessage).toHaveText('Invalid credentials');
  });

  it('should logout successfully', async () => {
    // No case ID - will be skipped unless autoCreateTestCases is enabled
    // With autoCreateTestCases: true, this links to or creates a case named "should logout successfully"
    await DashboardPage.logout();
  });
});

Custom Case ID Patterns

The caseIdPattern option accepts a regular expression to match case IDs in your test titles. The pattern must include a capturing group (\d+) to extract the numeric ID.

// wdio.conf.js
export const config = {
  reporters: [
    ['@testplanit/wdio-reporter', {
      domain: 'https://testplanit.example.com',
      apiToken: process.env.TESTPLANIT_API_TOKEN,
      projectId: 1,
      // Choose a pattern that matches your test naming convention:
      caseIdPattern: /C(\d+)/g,  // Matches: C12345
    }]
  ],
};

When No Case ID Is Found

If the pattern doesn't match any case ID in a test title, the behavior depends on the autoCreateTestCases setting:

autoCreateTestCases	Behavior
false (default)	The test result is skipped and not reported to TestPlanIt. A warning is logged if verbose is enabled.
true	The reporter looks up or creates a test case by matching on the test name and suite (className). See Auto-Creating Test Cases.

This means if you're using case IDs exclusively (without auto-creation), tests without valid case IDs in their titles won't appear in your TestPlanIt results.

Common Pattern Examples

Pattern	Matches	Example Test Title
/\[(\d+)\]/g (default)	[1234]	[1234] should load the page
/C(\d+)/g	C1234	C1234 should load the page
/TC-(\d+)/g	TC-1234	TC-1234 should load the page
/TEST-(\d+)/g	TEST-1234	TEST-1234 should load the page
/CASE-(\d+)/g	CASE-1234	CASE-1234 should load the page
/^(\d+)\s/g	Plain number at start	1234 should load the page
/#(\d+)/g	#1234	#1234 should load the page

Using Pattern as String

You can also pass the pattern as a string (useful for JSON config files):

// wdio.conf.js
export const config = {
  reporters: [
    ['@testplanit/wdio-reporter', {
      domain: 'https://testplanit.example.com',
      apiToken: process.env.TESTPLANIT_API_TOKEN,
      projectId: 1,
      caseIdPattern: 'TC-(\\d+)',  // Note: double backslash in strings
    }]
  ],
};

Auto-Creating Test Cases

Automatically create test cases in TestPlanIt for tests without case IDs:

// wdio.conf.js
export const config = {
  reporters: [
    ['@testplanit/wdio-reporter', {
      domain: 'https://testplanit.example.com',
      apiToken: process.env.TESTPLANIT_API_TOKEN,
      projectId: 1,
      autoCreateTestCases: true,
      parentFolderId: 10,     // Required: folder for new cases
      templateId: 1,          // Required: template for new cases
    }]
  ],
};

When autoCreateTestCases is enabled:

• Tests with case IDs still link to existing cases
• Tests without case IDs are looked up by name and suite (className)
• If a matching case is found, results are linked to it
• If no match is found, a new case is created in TestPlanIt
• The test title becomes the case name
• The suite name becomes the case's className for grouping

This means on first run, test cases are created automatically. On subsequent runs, the same test cases are reused based on matching name and suite.

Creating Folder Hierarchies

When you have nested Mocha suites (describe blocks), you can automatically create a matching folder structure in TestPlanIt:

// wdio.conf.js
export const config = {
  reporters: [
    ['@testplanit/wdio-reporter', {
      domain: 'https://testplanit.example.com',
      apiToken: process.env.TESTPLANIT_API_TOKEN,
      projectId: 1,
      autoCreateTestCases: true,
      parentFolderId: 10,          // Root folder for created hierarchy
      templateId: 1,
      createFolderHierarchy: true, // Enable folder hierarchy creation
    }]
  ],
};

With createFolderHierarchy enabled, nested describe blocks create nested folders:

// test/specs/login.spec.js
describe('Authentication', () => {           // Creates folder: "Authentication"
  describe('Login', () => {                  // Creates folder: "Authentication > Login"
    describe('@smoke', () => {               // Creates folder: "Authentication > Login > @smoke"
      it('should login with valid credentials', async () => {
        // Test case placed in "Authentication > Login > @smoke" folder
      });
    });
  });
});

This creates:

parentFolderId (e.g., "Automated Tests")
└── Authentication
    └── Login
        └── @smoke
            └── "should login with valid credentials" (test case)

Requirements:

• autoCreateTestCases must be true
• parentFolderId must be set (this becomes the root of the hierarchy)
• templateId must be set for new test cases

Folder paths are cached during the test run to avoid redundant API calls, making large test suites efficient.