Skip to content

Commit

Permalink
Merge pull request #461 from BioKIC/ljwalker-patch-1
Browse files Browse the repository at this point in the history
Clarified text and added an image to batch editing instructions
  • Loading branch information
ljwalker authored Feb 23, 2024
2 parents f41ff8e + 3948690 commit 5dca5e4
Showing 1 changed file with 15 additions and 13 deletions.
28 changes: 15 additions & 13 deletions content/coll_manager/edit/batch/_index.en.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
title: "Batch Editing"
date: 2021-10-28
lastmod: 2021-11-30
lastmod: 2024-02-22
draft: false
authors: ["Cynthia Skema", "Ann Barber"]
editors: ["Katie Pearson"]
editors: ["Katie Pearson", "Lindsay Walker"]
keywords: ["batch", "edit","change","record search form"]
---

Expand All @@ -16,24 +16,26 @@ keywords: ["batch", "edit","change","record search form"]
* Scientific names can only be batch changed through the [Batch Annotation tools](https://biokic.github.io/symbiota-docs/editor/edit/annotations/) or the [Taxonomic Cleaning tools](https://biokic.github.io/symbiota-docs/coll_manager/data_cleaning/taxonomy).

{{< notice note >}}
Exercise caution when using this tool. We also recommend downloading a copy of your database prior to making batch edits
⚠️ Exercise caution when using this tool. We strongly recommend [downloading a copy of your database](https://biokic.github.io/symbiota-docs/coll_manager/download/) prior to making batch edits
{{</ notice >}}

1. There are two options for batch editing specimen records: you can change a value for the entire set of records in your collection or change a value for a selected set of records. To change all records, click on “Display Table” in the Record Search Form, then click the edit icon ![Edit Icon](/symbiota-docs/images/editplus.png) above the resulting table of all records from your collection. Continue to step 3.
2. To change a value for a selected set of records, first search for the records of interest using the [search form](https://biokic.github.io/symbiota-docs/editor/edit/). Once you have the set of records to which you would like to make a batch edit, click on the edit icon ![Edit Icon](/symbiota-docs/images/editplus.png) at the top of your selected table of records.
3. From the dropdown menu next to “Field Name” in Batch Update, select the field you want to edit.
4. In “Current Value:” enter the text that is presently in the field you want to edit.
5. In “New Value:” enter the text that you want to be in the edited field.
6. Choose if you want to match the whole field or just match any part.
There are two options for batch editing specimen records: you can change a value for 1) the **entire** set of records in your collection or 2) change a value for a **subset** of records.
1. Navigate to the Record Search Form (_Administration Control Panel > Edit Existing Occurrence Records_).
2. **Option A:** **To apply batch changes to all records**, click on “Display Table” in the Record Search Form, then click the edit icon ![Edit Icon](/symbiota-docs/images/editplus.png) above the resulting table of all records from your collection. Continue to step 3. **Option B:** **To apply batch changes to a subset of records**, first search for the records of interest using the [search form](https://biokic.github.io/symbiota-docs/editor/edit/). Once you have the set of records to which you would like to make a batch edit, click on the edit icon ![Edit Icon](/symbiota-docs/images/editplus.png) at the top of your selected table of records.
![recordsearchform_batchedit](https://github.com/BioKIC/symbiota-docs/assets/11181096/35af9715-61e3-46e7-a96b-9727e85dabb9)
3. From the dropdown menu next to "Field Name" in Batch Update, select the field you want to edit.
4. In "Current Value:" enter the text that is presently in the field you want to edit.
5. In "New Value" enter the text that you want to be in the edited field.
6. Choose if you want to match the whole field **or** just match any part.
7. Click “Batch Update Field” to enact your batch edit. A pop-up screen will tell you the number of records to be updated, warn you that the replace operation cannot be undone, and prompt you to OK the update. Proceed with caution and see examples below.

{{< notice note >}}
It is easy to inadvertently change text you did not intend to change. Generally, the more specific your Current Value: text, the less likely you are to run into unintended consequences. If possible, get an estimate from your record table of how many records should be affected, and check that against the number of records cited in the warning. If the numbers do not match, rethink your strategy.<br>
It is not possible to check the record count when sorting by Modified By first. Doing so returns a count of the number of fields edited by the Modified By user for all records to be affected, rather than the number of records to be affected.
⚠️ **It is easy to inadvertently change text you did not intend to change.** Generally, the more specific your "Current Value:" text, the less likely you are to run into unintended consequences. If possible, get an estimate from your record table of how many records should be affected, and check that against the number of records cited in the warning. If the numbers do not match, rethink your strategy.<br>
It is not possible to check the record count when sorting by "Modified By" first. Doing so returns a count of the number of fields edited by the "Modified By" user for all records to be affected, rather than the number of records to be affected.
{{</ notice >}}

#### Examples

**Example of a good use of batch edit:** Standardizing plant collector names. If you are standardizing all Wherry’s collections to “Edgar T. Wherry,” then you could enter “E. T. Wherry” in Current Value and “Edgar T. Wherry” in New Value in batch edit for the collector field name, and update. Repeat for alternate forms of this name (e.g., “E T Wherry,” Edgar T Wherry”).
**Example of a good use of batch edit:** Standardizing plant collector names. If you are standardizing all Wherry’s collections to “Edgar T. Wherry,” then you could enter “E. T. Wherry” in Current Value and “Edgar T. Wherry” in New Value in batch edit for the collector field name, and update. Repeat for alternate forms of this name (e.g., “E T Wherry,” Edgar T Wherry”).

**Example of a bad use of batch edit:** Changing cardinal directions. For example, if you entered “n.” in Current Value and “N” in New Value in batch edit for the locality in an attempt to change lower case abbreviated instances of the cardinal direction north, you would accomplish that, but you would also change any other character string with “n.” such as a sentence ending in the letter n. This would result in batch misplacements of “N” where “n.” should be. For example, “Next to the station. East side” would be transformed into “Next to the statioN East side.”
**Example of a bad use of batch edit:** Changing cardinal directions. For example, if you entered “n.” in Current Value and “N” in New Value in batch edit for the locality in an attempt to change lower case abbreviated instances of the cardinal direction north, you would accomplish that, but you would also change any other character string with “n.” such as a sentence ending in the letter n. This would result in batch misplacements of “N” where “n.” should be. For example, “Next to the station. East side” would be transformed into “Next to the statioN East side.”

0 comments on commit 5dca5e4

Please sign in to comment.