search_testartifact

Edit online

Searches IBM Engineering Test Management test artifacts using artifact schemas and resource guides with advanced filtering capabilities.

Purpose

This tool performs advanced searches for test artifacts in IBM Engineering Test Management. It supports filtering by standard fields, custom attributes, categories, and linked artifacts, returning matching artifacts with pagination information. Use this tool when you need to find test artifacts matching specific criteria, filter by custom attributes or categories, search for artifacts linked to other test artifacts, or retrieve specific properties from matching artifacts.

Tags: QM | Read | Advanced

Supported artifact types and resources

Following artifact types are supported:
  • TestPlan
  • TestCase
  • TestSuite
  • TestScript
  • TestCaseExecutionRecord
  • TestCaseResult
  • TestSuiteExecutionRecord
  • TestSuiteResult
Read the following MCP resources to get information on filters and property guides:
  • qm://docs/search/filters
  • qm://docs/search/properties

Input parameters

Parameter Type Required Description Example
project_area_uuid string Yes The project area UUID that identifies which project to search _stJVgGfqEd24KMoDcFLfcQ
artifact_type string Yes Type of test artifact. Must be one of the supported artifact type TestCase
filters object No Standard filters for artifact fields. {"state": "Approved"}
customAttributeFilters array No Custom attribute filters. {"type": "str","customAttributeUUID": "_3iK_0E3YEfG1BNHwlQN_WQ","value": "Critical","operator": "contains"}
categoryFilters array No Category filters. Each filter contains categoryItemId (category UUID from schema) and categoryValueItemId (list of category value UUIDs) [{"categoryItemId": "_cat1", "categoryValueItemId": ["_val1"]}]
linkFilters object No Link filters for filtering by related artifacts. Format: {"ArtifactType": [webId1, webId2]}. {"TestScript": [150, 151]}
properties array No Fields to include in response. If no property is provided, it returns basic properties such as name, id, owner, state and modified. ["title", "state", "owner"]
Note: In the Opt In project area, the default configuration (stream) is automatically selected when retrieving data.

Output schema

Field Type Description
artifacts array Information about the test artifacts based on the filters applied.
metadata object Information about counts of artifacts and pagination.

Common use cases

  • Finding test cases by state, owner, or modification date
  • Searching for test artifacts with specific custom attribute values
  • Filtering test cases by category classifications
  • Locating test cases linked to specific test scripts or test plans
  • Retrieving test execution records for specific test cases
  • Building test reports with filtered artifact data
  • Identifying test artifacts requiring review or update
  • Analyzing test coverage by filtering linked artifacts