Cancel Tests Module

The Cancel Tests module allows the user to cancel one or more tests in a query result table. All result records associated with that test are canceled in the same action. This is a reversible process for the most part through the Uncancel Tests module.

The Cancel Tests module copies the current status of a test to the previous_status field and then changes the status of the test to the canceled state. Thus, restoring the test is a simple matter of switching the previous_status (active, in this case) with the status (canceled, in this case).

User Account Privileges

The privileges for Cancel Tests are defined by analysis code. A user may be given analysis = ALL, in which case their account can operate on all analysis codes (typically restricted to the technical staff). Alternatively, the user may be given privilege for specific analysis codes only (e.g., GRA, MS, and PWAVE_L for a phys props scientist working with the WRMSL).

Procedure

1.	Perform a search as described in “Search Functions.” This query returns only active tests.
2.	Select one or more tests to be canceled. Once at least one test is selected, the “CANCEL TESTS” button becomes active.
3.	Click the “CANCEL TESTS” button.
4.	A pop-up audit trail window (Fig. 13) appears, prompting the user for a reason taking this action. Enter a reason (5– 150 characters).
5.	Click “Save Reason and continue.” Note that the “NO CHANGE and return” button returns the user to the previous state and no database action occurs.
6.	Once “Save Reason and continue” is clicked, the operation is performed and the search query runs again after each test is canceled if multiple tests were selected to cancel. The selected tests no longer show in the query results.

Important notes about Cancel Tests

·	If a hierarchy search was used, all samples and their children and grandchildren, along with all analyses and tests run on them are returned.
·	If a TEXT_ID search was used, note that several rows may have the same TEXT_ID, each listing a unique Test Number.
·	If a Test Number search was used, the search should return only a single row in the results table.
·	If a Parameter search was used, only samples matching the parameter appear in the results table (without children).
·	If a sample with many children, grandchildren, and tests and results is canceled (e.g., a core or section), the cancelation process may take some time. The user should be careful not to cancel high-ranked samples without good reason.
·	Selecting a child sample does not affect the selection of its parent sample.
·	Samples shown on the results table are limited by user account privilege.