Deleting DNA Runs
Definition
- The DNA Runs tab is used to delete DNA Runs from GDM.
- Only users with "Superadmin" and "Admin" roles can perform a delete action.
- Users with "User" role can only view DNA Run information using this feature, and cannot delete any information
- All delete actions are permanent and will impact GDM immediately.
- It is highly recommended to back up data in GDM before proceeding, as actions performed in this tool are not reversible.
Filtering
Filters are used to reduce the records displayed in the table, and users can use this feature to only display records of interest. Use two or more filters to get an intersection list of datasets that meet all filtering criteria. There are two parts to the filtering. The left-hand side has a similar functionality to the filters found in the Dataset tab, while the right-hand side filters give the option to select multiple items per category. Each election will affect the items that will be shown in the succeeding category (this will be further explained in the table below). At the bottom of it, a summary of the right-hand side selections will be specified under the "Current Filters" field.
To filter records:
- Go through each of the filters and set values in fields as desired.
- Click on "Submit Query" button to apply filters.
- To reset fields, click on "Clear" button. This will also clear out all filters.
Filter | Definition | Influence on other filters |
---|---|---|
DNA Run ID, DNA Sample ID, Germplasm ID | Used to get records with specific database IDs. The first field is used to get all IDs greater than or equal to the specified ID, and the second is used to get IDs smaller than or equal to the specified ID. Use the two fields together to get IDs within a range | When a value for an ID Range is specified, It's corresponding Name list is disabled. (See photos in the warning below) |
DNA Run Names, DNA Sample Names, Germplasm Name | Use this filter to get records with specific names. Specify list of names with one line per name. Delimiters such as commas, colons and tables cannot be used in the list. | When a value for a Name list is specified, It's corresponding ID Range is disabled. (See photos in the warning below) |
DNA Sample UUID | Use this filter to get records with specific DNA Sample UUID. | None |
Projects | Use this filter to search for DNA Runs belonging to specific Projects. | Will affect the list of Experiments and Datasets |
Experiments | Use this filter to search for DNA Runs belonging to specific Experiments. If Projects are selected, the list will only show Experiments under the selected Projects. | Will affect the list of Datasets |
Datasets | Use this filter to search for DNA Runs belonging to specific Datasets. If Projects or Experiments are selected, the list will only show Datasets under the selected Projects and/or Experiments. | None |
When a value for an ID Range is specified, It's corresponding Name list is disabled. And vice versa (See photo example below)
In the right-side filter, there are number indicators beside each category that gets updated with each change of selection, indicating how many items are in that list.
Each list has a search bar that reduces the number of items as you type.
There is a small notch/arrow right below the submit query button (between the filters panel and the result table) that you can click to collapse the filters. It will result in a bigger view of the result table.
Clicking the downward arrows, on the far right of the Filters label, will revert back to the default view.
Viewing Additional DNA Run Detail
Clicking on a row in the results table will show additional DNA Run detail if the DNA Run is associated to a Dataset.
DNA Run are only allowed to be deleted IF the they are not being used in any Dataset.
Deleting DNA Runs
STEP 1 : FILTER
- Use filters to reduce content of DNA Run records to desired ones.
- Click on checkboxes of desired DNA Run records.
STEP 2: SELECT DNA RUNS TO DELETE
- Click on red "Delete Selected" button above table.
- A confirmation box will pop-up with the list of files you have selected for deletion.
- Click "Yes" to proceed, and "No" to abort.
STEP 3: PREREQUISITE CHECK
If "Yes" is selected, each of the DNA Runs will be checked whether or not it is associated with a dataset. A warning will pop-up with a list of DNA Runs that cannot be deleted and the datasets with which they are associated. This list can also be exported to a file and be used as a reference.
A DNA Run cannot be deleted if it is associated with a dataset.
- In the warning dialog, the Dataset ID will be enclosed in a parenthesis beside the Dataset name.
- A DNA Run can be associated with multiple datasets. In which case, all the datasets need to be deleted first before that DNA Run can be deleted.
STEP 4: CONFIRM FINAL WARNING
If there are selected DNA Runs that are not associated with a dataset, there will be a final warning to confirm permanent deletion.
- If you click "Yes", a warning will pop-up alerting you that "This action is not reversible".
- If you still want to continue, click "Yes", or click "No" to abort.
- If you click "Yes", the selected datasets will be deleted and a pop-up of the summary will be displayed.
Deletion Summary
Upon completion of deletion, a summary page of what was deleted will be displayed and will contain:
Total number of rows deleted
Filtering criteria (This field will be empty if there was no search query performed prior to deleting the DNA Runs)
Deletion duration