Using This Tutorial

This page assumes you already have the skills taught in the previous tutorial here. ORQA headless allows a task to be run from the command line. This can be useful for automating task execution or running in a non-graphical environment. Running ORQA in headless mode requires the task to have been prepared beforehand.

ORQA headless is currently installed separately from ORQA. To get ORQA Headless, download and unzip (extract) the ORQA headless version from this page.

Running A Task Using ORQA Headless

ORQA headless is run using the ORQA Headless executable along with an argument of the task to be run. This argument is relative to the ORQA Model directory. If the task requires parameters these can be set in the same way as URL parameters. For example, to run the task “example” located in the model directory at “subfolder” with the parameters “foo” and “bar” you would use the following as the launch argument.

subfolder/example.task?foo=1&bar=baz

Output

When a task is run, anything that would show in the ORQA console is printed to standard out. If a task completes successfully the process will exit with code 0, otherwise will exit with a code of 1. Any files written to by the task can be accessed as normal.

Setting The Data Directory

ORQA headless will use the default ORQA data directory. This can be overridden as required by setting the –data parameter, like so.

ORQA-Headless.exe --data "C:/ORQA" example/example.task