As the label suggests, you can write any command line argument of the comparator tool (or other tool in the case of failed test links) here. Each argument
should be on its own separate line. The available arguments can be seen in the comparator help message (you can
see this message when running comparator with the --help
argument).
On top of the normal arguments, there is also a type of macro system. This macro system is powerful and can be used for making the link dynamic. These macros represent each part of the split job name (split by the spliterator) or a value from config defined in the config items section, and when loading the report page, they are replaced by it.
The macros have this syntax:%{x}
", where you replace x
with a number corresponding with the xth split part
of the job's name (indexing starting with 1). It will be replaced with that part.%{N-y}
", where you replace y
with a number corresponding for the yth split part
of the job's name from the BACK. It will be replaced with that part. Entering just "%{N}
"
will be replaced with the last part of the name.%{S}
" or "%{SPLIT}
" will be replaced with the spliterator specified in the field
above.%{JOBNAME}
" will be replaced with the full job name.%{TESTNAME}
" will be replaced with a name of a test
(only works when specifying links next to tests - not links to comparator tool).%{dynamic}
", where you replace dynamic
with a name of an item specified in the
config items section (specifically the name from the Name of the item to find field).
It will be replaced by a value from the corresponding config file from the current job and build.
Example of the macros:
There is a job with the job name "jtreg~full-jp11-ojdk11~rpms-f36.x86_64-fastdebug.sdk-f36.x86_64.testfarm-x11.defaultgc.legacy.lnxagent.jfroff
",
spliterator set to "[.-]
" and a build config item with the Name of the item to find field set
to "nvr
" and its evaluation in the config file being "java-17-openjdk-17.0.6.0.9-0.4.ea.el8
".
The macros "%{2}%{S}%{N-1}_something_%{N} - %{nvr}
" will be
replaced with "jp11[.-]lnxagent_something_jfroff - java-17-openjdk-17.0.6.0.9-0.4.ea.el8
".
So an example of the whole prompt with arguments can look like this:
--compare
--history 5
--nvr "%{nvr}"
--job-config-find "cfg.properties:os:operating-system"
--os "rhel9"
--formatting html
--regex %{1}%{S}%{2}%{S}%{3}%{S}.*%{S}%{5}%{S}%{6}%{S}%{7}%{S}.*%{S}%{9}%{S}%{10}%{S}%{11}%{S}%{12}%{S}%{13}%{S}%{14}%{S}%{15}