Configure & Manage DQM QAPPs

<< Click to Display Table of Contents >>

Navigation:  DQM >

Configure & Manage DQM QAPPs

Overview

Example

Create the DQM QAPP Code

Select the DQM Checks to be included in the DQM QAPP

Modify Qualifiers, Remarks, and Reason Codes for all DQM Rules

Modify Check Parameters

Add Holding Times

Add Control Limits

Add Matrices

Save the File

Load QAPP to Database

 

Overview

 

A DQM Quality Assurance Project Plan (QAPP) EDD can be created and uploaded into the EQuIS database via Professional EDP. When creating a DQM QAPP EDD, utilize the template file DQM Starter QAPP.xlsx, (typically located in C:\Program Files\EarthSoft\EQuIS\Formats\DQM or for per-user installation, %localappdata%\Programs\EarthSoft\EQuIS\Formats\DQM).

 

Example

 

Locate the DQM QAPP EDD (DQM Starter QAPP.xlsx) and save the file with a new name that contains the name of the project or DQM QAPP.

 

Review and modify the template file, based upon company and/or project requirements. Perform the following steps to create a new DQM QAPP EDD. For more information on the data tables referenced by each check, see DQM Data Sources.

 

DQM_QAPP-Workflow

Click the stages above to go to the corresponding step.
 

 

1.Create the DQM QAPP Code

a.Open the DQM QAPP EDD to the RT_DQM_QAPP spreadsheet. The DQM Starter QAPP.xlsx file comes pre-populated with a single DQM QAPP; however it is possible to define and input multiple DQM QAPPs in the same EDD:

dqm_rt_dqm_qapp-spreadsheet

b.Create a DQM QAPP Code for your project by populating the DQM_QAPP_CODE in RT_DQM_QAPP. Populate the other fields in the worksheet for the QAPP description and remark as desired.

dqm_create-dqm-qapp-code

 

c.To use the DQM functionality for associating target analytes to specific surrogate or deuterated monitoring compounds for the surrogate recovery check, keep the DQM_QAPP_CODE = QAPP_SURR_ASSO_CAS_RN in the DQM QAPP. Delete any of the pre-populated data that are not applicable to the project.

d.To inherit checks, rules, and parameters from a previously uploaded DQM QAPP, but not its holding times and/or control limits, input the PARENT_QAPP_CODE field with the DQM_QAPP_CODE of the previously uploaded DQM QAPP. Note that any changes made to the PARENT QAPP will continue to be inherited by the new “child” QAPP.

e.To prevent changes to the QAPP by non-admin users, set MASTER_QAPP_YN = 'Y'. This will lock the QAPP and prevent changes by non-admin users. Admin users will also not be able to make changes through the DQM Settings form while the QAPP is locked. Admin users can unlock the QAPP from the DQM Settings Form.
 

2.Select the DQM Checks to be included in the DQM QAPP

a.Open the DQM QAPP EDD to the RT_DQM_CHECK spreadsheet. The DQM Starter QAPP file comes pre-populated with all available DQM Checks; however, the checks are included across the three different DQM QAPPs included in the file. Review the DQM Checks online documentation for a description of each of the available DQM checks and determine which checks that you would like to include in your DQM QAPP.

b.Delete the rows for the checks that do not apply to your QAPP. Modify the description and remark fields as desired.

c.Edit the DQM_QAPP_CODE to match your input in Step 1. (Hint: A global Find and Replace with the "Within" option set to "Workbook" is best for changing the DQM_QAPP_CODE). Continuing with the above example, the RT_DQM_CHECK tab would be changed as shown below.

dqm_edd-qapp2-checks_zoom60

 

 

3.Modify Qualifiers, Remarks, and Reason Codes for all DQM Rules

a.Open the DQM QAPP EDD to the RT_DQM_RULE spreadsheet. The DQM Starter QAPP file comes pre-populated with all rules for the DQM checks.

b.Do NOT delete or change any of the Rules for checks present in the QAPP. Only delete rules if the entire check is deleted. To disable a specific rule so that certain data is not flagged, change its STATUS_FLAG to 'R' in RT_DQM_RULE after the QAPP is uploaded.

c.Modify column “D” (qualifier) with the qualifier you desire to use to flag the associated detected analytes when the DQM rule is exceeded. Modify column “F” (nd_qualifier) with the qualifier you desire to use to flag the associated non-detected analytes when the DQM rule is exceeded.  Input the value “NQ” for any instances that you desire no qualifier to be applied by DQM when the rule is exceeded. The DQM-refvals format will not accept a NULL value in either the qualifier or nd_qualifier columns.

dqm_edd-qapp2-rules_zoom60

d.Modify column “E” (remark) with the text you desire to be displayed to describe the Quality Control (QC) failure associated with the data. This will be used to populate the Apply Remark field in the DQM Event Form.

e.Open the RT_DQM_QUALIFIER spreadsheet in the DQM QAPP EDD. For any qualifier and nd_qualifier added in the RT_DQM_RULE spreadsheet, create a new row containing the desired QAPP code in column "A", the new qualifier in column "B", and optionally a description of the qualifier in column "C".

f.Locate and open the RT_DQM_REASON spreadsheet in the DQM QAPP EDD. Reason codes are short codes to describe why qualifiers are added to results when QC excursions occur. See the help article Ranking Qualifiers and Reason Codes for more information. Modify the reason codes that come pre-populated in RT_DQM_REASON.REASON_CODE and add descriptions and remarks as desired.

g.Return to the RT_DQM_RULE spreadsheet and modify the reason codes in column G, H, and I that you desire to use as a short code to describe why that qualifier has been added to a result.  The reason code is stored in DT_RESULT.DQM_REASON_CODE when a result record is qualified and in DT_RESULT_DQM.REASON_CODE.
 

4.Modify Check Parameters

a.Open the DQM QAPP EDD to the RT_DQM_CHECK_PARAM spreadsheet.  The DQM Starter QAPP file comes pre-populated with all the parameters for all available DQM checks.

b.Delete the rows for the check parameters for the DQM checks that you do not want to include in your DQM project QAPP, as done in Step 2B.

c.Modify column “G” (param_value) for each check parameter according to your project needs. Review the online documentation for each check for details about each check parameter. In some instances, you may also need to edit the analytic method and/or cas_rn fields based upon your project needs.

dqm_edd-qapp-check-params

d.Open the DQM QAPP EDD to the RT_DQM_CHECK_PARAM_TYPE spreadsheet and delete the rows for the check parameters for the DQM checks that you do not want to include in your DQM project QAPP, as done in Step 2B.
 

5.Add Holding Times

a.Open the RT_DQM_HOLDING_TIME_V2 spreadsheet in the DQM QAPP EDD.  The DQM Starter QAPP file comes pre-populated with example data for how the spreadsheet should be populated.

b.Modify RT_DQM_HOLDING_TIME_V2 to include the holding times for all analytical methods, medium codes, cas_rns, and prep method combinations for your DQM project QAPP. See the online help article DQM Check for Holding Times for more information.
 

6.Add Control Limits

a.Open the DQM QAPP EDD to the RT_DQM_CONTROL_LIMITS spreadsheet. The DQM Starter QAPP file comes pre-populated with example data for how the spreadsheet should be populated.

b.Modify RT_DQM_CONTROL_LIMITS to include the QC limits for each analytical method, matrix, and cas_rn combinations for your DQM project QAPP. See the online help article DQM Control Limits for more information on populating the control limits.
 

7.Add Matrices

On the worksheet RT_MATRIX, populate the MATRIX_CODE and MATRIX_DESC with all the field matrices that are applicable to the project.

 

Notes: In the DQM forms, any list of checks will display the DQM_CHECK_DESC column. There are a couple of things to consider:

The checks can be displayed in a language other than English by changing the DQM_CHECK_DESC column.

Although the DQM_CHECK_DESC column will accept 255 characters, DQM forms only display about
50 characters, without scrolling.

If the DQM_CHECK_DESC column is blank, the user will get an error when trying to select checks to Start an Event.

 

8.Save the File
 

9.Load QAPP to Database
The last step is to load the modified DQM QAPP EDD file to the EQuIS database using Professional EDP.

a.On the EQuIS Professional Home ribbon, select the EDP button.

DQM_Ribbon-EDP-Professional

b.Click the Format button and select DQM-refvals.zip from the installed DQM files, typically located in \Programs Files\EarthSoft\EQuIS\Formats\DQM.

c.Select the EDD button.

d.Select the modified DQM Checks EDD created in the above steps.

e.Create and Commit the EDD.

 

Note: For updating an existing DQM install, load the latest DQM_Checks EDD using the Insert and Update commit type.

 

Note: Existing DQM QAPP data can be exported for update or to copy and reuse in the configuration of a new QAPP. The DQM-refvals EDD exports will pull data into the sections of the format from the database tables of the same name. The sections into which each export will pull data can be found by hovering the mouse over the name of each export.