Clone wiki

qatrackplus / v / 0.2.8 / admin / tests

Configuring Tests

To access existing tests or to configure a new test, click on the
Tests link in the QA section on the the main admin page.

Create a new test by clicking the Add Test link in the top right
hand page of the Tests admin page. The individual fields for
configuring a tests are described below.


A name that describes what the test is (e.g. something like
Temperature (°C) or 0° Gantry - Field Size 10.0x10.0cm - X1 (cm)).

Macro Name

Macro name tl;dr: give your test a short variable name like ion_chamber_reading or temperature .

Every test must be given a macro name which will be used to refer to
this test in composite tests. The macro name must be a
valid Python variable name
(that is it must consist of only letters a-z, letters A-Z, numbers and
underscores) and must not be one of the following reserved words:

and       del       from      not       while
as        elif      global    or        with
assert    else      if        pass      yield
break     except    import    print
class     exec      in        raise
continue  finally   is        return
def       for       lambda    try

Python programmers generally use lower case only variable names with
words separated by underscores (_). That is to say a macro name like
ion_chamber_reading is preferable to ionChamberReading,
IonChamberReading, or Ion_Chamber_Reading. Note that this is by
convention only and you are free to choose whichever names you like.

It is also highly advised that you use use a descriptive name like
ion_chamber_reading instead of something like icr. That way
when other people are reading your code it is obvious what your
variable represents.


The description field is the text that is shown when a user clicks on
the test name while performing QA. This description can be made up of
plain text or html. An example showing an html description is shown
below along with the way it looks when displayed on the test list

Test Description in HTML


The procedure allows you to insert a URL to a more detailed procedure
available elsewhere. A link to that URL will be shown when the user
clicks on the test name while performing QA as shown below.

Detailed Procedure Link


Choose the Test Category that this test belongs to.


QATrack+ currently supports 5 different test types as outlined below.

  1. Simple Numerical A test with a single numerical result
    (e.g. Temperature)

  2. Boolean A test with a Yes or No answer (e.g. Door Interlock

  3. Constant A non-user editablenumerical constant to be used in
    composite tests (e.g. an N_DW calibration factor). When you choose
    Constant for the Type field a Constant Value text box will
    appear for you to enter your numerical constant in.

  4. Multiple Choice A test where the user selects from a predefined
    list of choices. When you choose Multiple Choice for the Type
    field, a Choices text box will appear where you must enter a comma
    separated list of choices for the test.

  5. Composite A value calculated based on other test values (e.g. a
    temperature pressure correction, or a calculated dose). Composite
    tests are easy to define but allow users to do define complex
    calculations with the Python programming language. Please see the
    Calculated Test Page for more information on defining
    this type of test.

  6. String Allows the user to enter a short piece of text (e.g. a
    user ID)

  7. String Composite A Composite test that stores a string (text)
    rather than a numerical value. Please see the
    Calculated Test Page for more information on defining
    this type of test.

  8. Upload A test that allows you to upload an arbitrary file and
    process it with a Python snippet. Please see the
    Calculated Test Page for more information on defining
    this type of test.

An example of configuring tests and grouping them into a test list is
given on our tutorials page.

Test Item Visible In Charts

Uncheck this option to hide the test from the charting page. This can
help keep your charting page clean and limited to the tests you
really care about.

Allow auto review of this test?

Indicate whether this test should be auto-reviewable. For more information
about this option see the Auto Review page

Display image (for upload test types only)

Check this option if you want an image uploaded to QATrack+ to be displayed
on the test list page (supported images depend on browser version but generally
jpg, png & gif work well).