Label

The Label column allows you to specify a hierarchical location for the testplan.  The label is a pipe ( | ) separated string that determines how a test is named in the test report and how it appears in the test selection user interface.

Because directories and files are created based on this label value, the label must not contain characters that create filenames that are considered illegal in your operating system. The following characters are considered legal in most cases:

  • Numbers and letter (A-Z, a-z, 0-9)
  • Percent (%)
  • Dash (-)
  • Underscore (_)
  • Comma (,)
  • Period (.)
Important: The Windows operating system has a 260-character limit for a file path. Because DVM creates subdirectories based on the label, a path with 260 or more characters prevents the testplan from running.

Although testplans are grouped together and sorted alphabetically by label in the test-selection user interface, the order of execution is determined by its position in the testplan file. The Label column can be blank, but if no label is specified, the test is labeled as "Test n" where n is its numerical position in the testplan.