CLI Reference > Workflows and Documents Commands > tm testcases
  
tm testcases
displays test cases for a test session
Synopsis
tm testcases [--fields=field1[:width1],field2[:width2]...][--fieldsDelim=value] [--[no]substituteParams][--queryDefinition=query] [--height=value] [--width=value] [--x=value][--y=value] [--hostname=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]] sessionID
Description
This command allows you to view the test cases for one or more test sessions. Test cases are displayed in the order they appear in the test document(s) referenced by the test session. Attachments and related items display as a comma separated list of attachment names and related item IDs.
* 
The test cases that display for test documents are based on the date in the test session’s Tests As Of Date field. Test cases added to test suites after this date are not displayed.
If your test session contains versioned test items, then the output of this command displays versioned test case ID prefixed with versioned test suite ID to which the versioned test case ID belongs to, separated by a colon.
Options
This command takes the universal options available to Windchill RV&S commands, as well as some general options. See the options reference page for descriptions.
--fields=field1[:width1],field2[:width2]...
the test case fields, and their respective widths, to be displayed. Use commas to specify more than one field.
--fieldsDelim=value
the string to be used as a delimiter between the fields in the display.
--[no]substituteParams
specifies whether to replace parameter references in text fields with a parameter value. For more information on how parameter values are determined, see the Windchill RV&S Hilfe-Center.
--queryDefinition=query
defines the query that determines what test cases display. For details of the query format, see the im createquery reference page.
* 
Do not use complex query definitions. For example, any form of query that uses a short or long text field.
sessionID
specifies a test session that you want to view test cases for.
See Also
Commands: tm createresult, tm editresult, tm viewresult, tm extractattachments, tm stepresults, tm resulteditor, tm deleteresult, tm editresult, tm results, tm setresults, tm viewuntested
Miscellaneous: options