tm results

CLI Reference > Workflows and Documents Commands > tm results

tm results

displays test results for test cases

Synopsis

tm results [--fields=field1[:width1],field2[:width2]...] [--fieldsDelim=value][--relatedToItemID=value] [--[no]sortAscending][--[no]showSharedResults] [--[no]lastResult] [--sortField=field]--verdictFilter=value --filter=value [--suiteID=value][--sessionID=value] [--caseID=value] [--height=value] [--width=value][--x=value] [--y=value] [--hostname=value] [--filter=value] [--port=value][--password=value] [--user=value] [(-?|--usage)] [(-g|--gui)][(-F value|--selectionFile=value)] [--quiet] [--settingsUI=[gui|default]][--status=[none|gui|default]] [(-N|--no)] [(-Y|--yes)] [--[no]batch][--cwd=value] [--forceConfirm=[yes|no]] caseID|sessionID:caseID|versionedCaseID|versionedSuiteID:versionedCaseID|sessionID:versionedSuiteID:versionedCaseID...

Description

This command displays test results for test cases in a list format. You can specify which test result field values display. Attachments and related items display as a comma separated list of attachment names and related item IDs.

For example:

tm results --fields=State:case --sessionID=25 --filter="(testresult[TMDSAMPLEFIELD_Float1]=20.001)" --hostname=localhost --port=7001 --user=test1 --password=xx xxxxxx

The test session item type and the test case item type must be visible to you in order for you to view the test results.

Options

This command takes the universal options available to PTC RV&S commands, as well as some general options. See the options reference page for descriptions.

• --fields=field1[:width1],field2[:width2]...

the test result fields, and their respective widths, to be displayed. Fields can be any of caseID, result, annotation, hasAttachment, hasRelatedItem, hasStepResult, modifiedDate, modifiedUser, sessionID, sharedCaseID, verdict, verdictIcon, verdictType, or verdictTypeIcon.

◦ Use commas to specify more than one field.

◦ TestCase and TestSession item fields need to be annotated respectively, for example, State:case, Summary:session.

• --fieldsDelim=value

the string to be used as a delimiter between the fields in the display.

• --relatedToItemID=value

displays test results that are related to the specified item. If you use this option, do not specify test results using the --sessionID, --caseID, or --suiteID option or sessionID:caseID.

• --verdictFilter=value

filters the results based on their verdict, for example, passed or failed.

• --sortField=fieldspecifies the field to sort results by, for example, result. You can sort by any of the following fields: caseID, result, annotation, hasAttachment, hasRelatedItem, hasStepResult, modifiedDate, modifiedUser, sessionID, sharedCaseID, verdictIcon, verdictType, or verdictTypeIcon.The ability to sort by Item fields, for example, Test Case and Test Session is not currently supported.

• --[no]sortAscending

specifies whether to sort the specified sort field in ascending or descending order.

• --[no]showSharedResults

if viewing results for a test case that is related to multiple test group documents, specifies whether to include results entered against the group.

• --[no]lastResult

if viewing results for multiple tet sessions, specifies whether to only show the latest result.

• --filter=value

specifies a string for the filtering of test results.

The filter must be in the following format:

<rule>is defined as ( <filtergroup>)

(<filtergroup> and <filtergroup> and ...)

(<filtergroup> or <filtergroup> or ...)

( (<filter>) and (<filter>) and ...)

( (<filter>) or (<filter>) or ...)

where

<filter> is defined as disabled (<filter>)

<filter> is defined as not (<filter>)

<filter> is defined as <testresult[ID].hasrelateditem>

<testresult> is defined as testresult[ID]comparison where ID can be one of Verdict, Verdict Type, Modified By, Modified Date,Session ID,Annotation, Session ID, or any test result fields defined by the administrator.

• If the user provides both the --verdictFilter and --filter option an error will be presented indicating that only one of the options can be used.

• The ability to filter by Item fields, for example, Test Case and Test Session is not currently supported.

• --suiteID=value

displays all test results in the specified test suite for the session specified in --sessionID. If you use this option, do not specify test results using the --sessionID, --caseID or relatedToItemID options, or caseID|sessionID:caseID.

The tm results command accepts internal IDs of versioned test cases as an input when used with the --suiteID option. To display internal IDs of versioned test cases, an administrator can create an integer field, add computed expression as ID and make this field visible on the Test Case item type. For more information on creating a computed field, see the PTC RV&S Help Center.

• --sessionID=value

displays all test results in the specified test session. If you use this option, do not specify test results using the --suiteID, --caseID or relatedToItemID options, or caseID|sessionID:caseID.

• --caseID=value

displays test results for the specified test case. If you use this option, do not specify test results using the --suiteID, --sessionID or relatedToItemID options, or caseID|sessionID:caseID.

The tm results command accepts internal IDs of versioned test cases as an input when used with the --caseID option. To view the internal ID of a versioned test case, an administrator can create an integer field, add computed expression as ID and make this field visible on the Test Case item type. For more information on creating a computed field, see the PTC RV&S Help Center.

• caseID|sessionID:caseID|versionedCaseID|versionedSuiteID:versionedCaseID|sessionID:versionedSuiteID:versionedCaseID...

specifies the test case IDs to view test results for. The test cases must all belong to the session specified in the --sessionID option. If the session is not specified in the --sessionID option, you must specify the session ID and case ID for each test case. If you do not specify this option, you must specify the --sessionID option, and results are displayed for all test cases in that session.

As of Integrity Lifecycle Manager 12.0, you can also specify versioned test case IDs to view test results details for.

For example,

tm results --sessionID=1393 853-3.0:856-6.0

displays test results for versioned test case 856-6.0 belonging to versioned test suite 853-3.0 in test session 1393.

It is not mandatory to specify the versioned test suite when using the command with --sessionID option.

For example,

tm results --sessionID=1393 856-6.0

displays test results for versioned test case 856-6.0 in test session 1393.

If the --sessionID option is not used, specify the test session ID with versioned test suite ID and versioned test case ID in the sessionID:versionedSuiteID:versionedCaseID format.

For example,

tm results 1393:853-3.0:856-6.0

The internal ID of the versioned test case is displayed in the output of the tm results command.

The test session item type and the test case item type must be visible to you in order for you to view the test results.