Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

There is a way to automate the calls to external scripts. The general idea is that the tests steps to automate will have a text starting with run:, followed by the name of a script to launch on the client side, and optional arguments.

Image Added

There's a utility that must run on the client side, which will be able to:

  • retrieve all the tests (XTC) that need to run, under some conditions
  • launch the execution of the tests and send back the results to Matrix Requirements Medical

Image AddedMore specifically:


Details

  1. The user set up some test steps with the syntax run: followed by the name of a script to run.
    Example in Linux:

    Code Block
    run: /home/scripts/script1.sh x y z 

    Example in Windows:

    Code Block
    run: d:\scripts\script1.cmd x y z


  2. The user generates a test run containing some of the above. Let's say the test run has tests number from XTC-50 yo XTC-60

  3. The user calls the TestRunner program to create the test file (big list of all the tests to run):

    Code Block
    java -jar TestRunner.jar --grab --project=PROJ --category=XTC --start=50 --end=60

    this will generate a file called test.xml on the local directory, with the test steps detected in items XTC-50 to XTC-60.

  4. The actual run of the tests can now take place. The user enters the following command:

    Code Block
    java -jar TestRunner.jar --run --project=PROJ

    This will read the test.xml file and call each script. The script must generate on return a response file (see syntax below).
    The TestRunner program will decode the response and send the ok or error code to Matrix, including some comments.
    It is possible to stop the whole execution at a particular step if a pre-condition is not met by specifying continue=no in the response file

...