ArctosDB / Arctos-Workflows

Standard Arctos tasks broken down into manageable steps
0 stars 0 forks source link

Using Create Container and Bulk Edit Container to create freezer boxes and cryovials from barcode labels #23

Open campmlc opened 2 years ago

campmlc commented 2 years ago

The following workflow describes the process for designating barcode labels as a particular container type in Arctos. In this case, the process specifically refers to converting barcode labels into freezer boxes or cryovials in MSB DGR, but the process is the same for any other container type. Some preliminary info:

Step 1: When the labels are received, the series must be created in Arctos as follows: -Go to Manage Data> Object Tracking > Create Container (bulk) at https://arctos.database.museum/tools/create_container.cfm

campmlc commented 2 years ago

Step 2: Using Bulk Edit Container to change container type and add labels to containers. This method is used for converting any container type into another container type, or to add label information, dimensions, or positions to an existing container. At MSB, this tool is most frequently used to add label fields to barcoded containers (this is how we add labels to cryovials) and to convert container labels to freezer boxes, to convert cryovial labels to parasite vials or to envelopes to archive Nobuto blood strips or hair samples, etc.

-Go to Manage Data > Object Tracking > Bulk Edit Container at https://arctos.database.museum/tools/bulkEditContainer.cfm -Click Load csv to view data fields, download a template and upload csv file. -Note that one of the required fields is the existing ("old") container type in order to change the container. You may not have this information for a large list of barcodes. If not, you can download a csv file with this information by going to Reports/Services >Data Services > Get Container from Barcode at https://arctos.database.museum/DataServices/getContainerFromBarcode.cfm by inputing a single column csv with header "input_barcode". -Review for this User/status -If all looks good, click the blue box for "Check all and set status to autoload", and then click the tan box for "Change status for checked records -Return to Review and Load -Once the items have loaded, they will disappear from this view and should be visible in a search on the barcode at https://arctos.database.museum/findContainer.cfm

campmlc commented 2 years ago

Another useful tool for the above: Reports/Services > Data Services > Make comma-list from anything
https://arctos.database.museum/DataServices/listerizer.cfm

campmlc commented 2 years ago

For Freezer Boxes, freezer racks, or anything else with positions, there is another step to create positions.

Step 3: Bulk Create Positions: -Once the steps above are completed and the container has been created or edited to container positions, -Go to Manage Data > Object Tracking > Bulk Create Positions
-https://arctos.database.museum/tools/bulkCreateContainerPositions.cfm -Click Load csv to see the required fields. -Note: this form requires position dimensions. In the previous forms, you had to enter position orientation and number, eg. 10 x 10 horizontal for a freezer box. In this form, you will need to enter values that are just slightly smaller than the total dimensions of the container when added together - not an easy task to figure out. Go to a similar container in Find Container and click on the positions to see what has previously been used. For freezer box positions, this is: width = 1 cm, length = 1 cm, height = 4 cm. Note that the order of W L H is not always the same in different forms . . . don't get the order wrong. At some point, we should request standard position dimensions in all forms - and we should request that position dimensions be added to the bulk create and bulk edit container forms in an issue, so that this step could be consolidated with previous steps and the process made less confusing. -Load csv. -Review for this User/status -If all looks good, click the blue box for "Check all and set status to autoload", and then click the tan box for "Change status for checked records -Return to Review and Load -Once the items have loaded, they will disappear from this view and should be visible in a search on the barcode at https://arctos.database.museum/findContainer.cfm

Step 3B: Create positions one container at a time: -Go to Manage Data > Object Tracking >Find Container and enter the barcode of the container you wish to edit -Click the box next to the barcode to bring up Container Details at right -Click Positions -If you see the error: insufficient data to proceed; a container must have

NUMBER_ROWS
NUMBER_COLUMNS
ORIENTATION
POSITIONS_HOLD_CONTAINER_TYPE

-Then you must instead go back one screen, click instead on Edit Container at right, and add in the information on number of rows, columns, orientation, and positions. Don't forget to save. Then return to this form to create positions. There is a default value of 1 cm length, 1 cm width, 4 cm height provided for cryovial positions in a freezer box. But for all other positions, you will have to enter the values needed. Go to Find Container for similar containers and look at the position dimensions currently in use.

Jegelewicz commented 2 years ago

@campmlc can we turn this into a template so that you can open a new issue each time the workflow begins and check boxes as you go?

campmlc commented 2 years ago

I wasn't sure how to do that - and not everyone will follow all steps. Happy for you to set it up that way if we can leave this overall summary intact?

On Thu, Aug 25, 2022 at 2:46 PM Teresa Mayfield-Meyer < @.***> wrote:

  • [EXTERNAL]*

@campmlc https://github.com/campmlc can we turn this into a template so that you can open a new issue each time the workflow begins and check boxes as you go?

— Reply to this email directly, view it on GitHub https://github.com/ArctosDB/Arctos-Workflows/issues/23#issuecomment-1227745925, or unsubscribe https://github.com/notifications/unsubscribe-auth/ADQ7JBFY7JL3NVYKCWMGYS3V27LRHANCNFSM57NHNMOQ . You are receiving this because you were mentioned.Message ID: @.***>

Jegelewicz commented 2 years ago

How does this look?