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...

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 Integrity Lifecycle Manager 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.

• --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.

• caseID|sessionID:caseID...

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.

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.