Newer
Older
Managing Storage Of Samples
====
## Allocate storage positions to samples
If we want to track the storage position of samples, openBIS provides a
graphical overview of lab storages.
Lab storages need to be configured by a *lab manager* or *group admin*,
as explained here: [Configure Lab
Storage](https://openbis.readthedocs.io/en/latest/user-documentation/general-admin-users/admins-documentation/customise-inventory-of-materials-and-samples.html#configure-lab-storage)
This can be done in two ways:
1. add storage information on the sample form during (or after) sample
registration
2. batch register storage positions for several samples
### Register storage position for a single sample
1\. Navigate to the **Storage** section, at the bottom of the sample
form. Click the **+ New Storage Positions** above the table, as shown
below:
2. In the widget that opens, select the appropriate **Storage** from the
dropdown menu. Storage must be configured by a lab manager or group
admin as explained in [Configure Lab
Storages](https://openbis.readthedocs.io/en/latest/user-documentation/general-admin-users/admins-documentation/customise-inventory-of-materials-and-samples.html#configure-lab-storage)
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
3\. Select the **position** in the storage (shelf and rack).
4\. If the sample is in a box, provide a **Box Name.**
5\. Select the **Box Size** form the list of configured sizes (the list
can be configured by an *Instance Admin)*.
6\. Select the **Position** in the box.
7\. Click **Accept.**
#### Add additional metadata to storage positions
By default, the storage only keeps track of locations. If the **Storage
Position** has been configured by an *Instance admin* to have additional
metadata (e.g. freezing date), these can be added by clicking on the
link in the storage table, as shown below. The link becomes available
after saving the sample.
The additional information can be entered in the **Storage Position**
*Object* form.
### Batch register storage positions
#### XLS Batch Registration
With the new XLS batch registration, samples and their storage positions
can be registered in one transaction using the XLS template file, as
explained in [Batch register entries in a
Collection](https://openbis.ch/index.php/docs/user-documentation/inventory-of-materials-and-methods/batch-register-entries-in-a-collection/).
#### Batch Registration with TSV file
Storage positions are modelled in openBIS as children of other entries.
To register the positions for several samples with the Batch
Registration using the .tsv template, first the parent samples need to
be registered in openBIS. In a second step, the positions are assigned.
To assign storage positions in batch mode follow the steps below:
> 1. Select **Storage positions **from the **Batch Registration** drop
> down menu.
> 2. Download the **template file**.
> 3. Remove the **identifier** column from the file (identifiers need
> to be automatically generated by openBIS).
> 4. Fill in the **parents** column. These are the identifiers of the
> samples for which we want to register the storage
> positions(/MATERIALS/PROJECT/OBJECT\_CODE).
> 5. Fill the remaining information about the storage positions.
> 6. Save the file and upload with the **Batch Registration**.
An example file can be found
here: [SAMPLE-STORAGE\_POSITION-template.txt](att/SAMPLE-STORAGE_POSITION-template.txt?version=1&modificationDate=1502441624183&api=v2)
Updated on April 26, 2023
## Batch update storage positions
To update several storage positions, we can use the batch update option
from the Object Browser:
1. Go to the **Object Browser** under **Utilities** in the main menu
2. Select the object type **Storage Position** from the dropdown menu
(see picture)
3. Use the table **Filter** to select the storage positions you want to
update
(see [Tables](https://openbis.readthedocs.io/en/latest/user-documentation/general-users/additional-functionalities.html#tables))
[Tables](https://openbis.readthedocs.io/en/latest/user-documentation/general-users/additional-functionalities.html#tables))
5. Edit the file to make the changes needed (e.g. change the name of a
box, change the storage, change a box position, change box size etc)
6. Select **XLS Batch Update Objects** from the **More..** dropdown.
7\. Import the file you modified before and update the storage
positions.
Updated on April 25, 2023
## Delete storage positions
### Delete single storage positions
To delete a single storage position from a sample:
1. Edit the sample for which you want to deleted the storage position
2. Navigate to the **Storage** section at the end of the page
3. Use the “**–**” button in the **Storage Position** table, as shown
in the picture
4. Save the sample
Please note that the storage position deleted in this way is moved to
the trashcan. To delete the position permanently, this has to be deleted
from the trashcan (see
[Trashcan](https://openbis.readthedocs.io/en/latest/user-documentation/general-users/additional-functionalities.html#trashcan)).
### Remove one of multiple positions in the same box
If one sample has been assigned to multiple positions in the same box
and you need to remove only one or some of them, you can follow these
steps:
1. **Edit** the sample for which you need to remove the storage
position in the box
2. Navigate to the **Storage** section at the end of the page
3. Click on the table row** **(see picture below)
4. **Unselect** the position you want to remove (eg. A5 in the example
below)
5. Click **Accept**
6. **Save** the sample
### Delete multiple storage positions
To delete multiple storage positions from multiple samples we can use
the **Object Browser**.
1. Go to the **Object Browser** under **Utilities** in the main menu
2. Select **Storage Position** from the **Object Type** dropdown
3\. **Filter** the table to find the storage positions you want to
delete
(see [Tables](https://openbis.readthedocs.io/en/latest/user-documentation/general-users/additional-functionalities.html#tables))
4\. Select the positions you want to delete from the table and click the
**Delete** button (see picture below)
5\. You will be asked to provide a reason for deletion
6\. The deleted storage positions will be moved to the trashcan and
should be removed from there to be permanently deleted (see
[Trashcan) ](https://openbis.readthedocs.io/en/latest/user-documentation/general-users/additional-functionalities.html#trashcan)
Updated on May 2, 2023
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
## Overview of lab storages
The **Storage Manager**, under **Utilities**, provides an overview of
each single storage configured for the lab, by the lab admin.
> 1. Select the storage containing the samples to visualise from the
> **Storage** drop down menu.
> 2. Click on a box to view its content.
> 3. When hovering with the mouse over a sample inside a box, the info
> about the sample is shown.
>
>
## Overview of lab Storages
### Change storage position of samples
The **Storage Manager** can also be used to move samples from one
storage position to another, if the location of the sample is changed:
> 1. Click on **Toggle Storage B** (see figure above).
> 2. Select the destination storage, from the **Storage** drop down
> menu.
> 3. Drag and drop the box or sample to move from **Storage A** to the
> desired position in **Storage B**. Please note that the move
> operation for samples with multiple positions in the same box or
> in different boxes is not supported.
> 4. Changes are visualised at the bottom of the page. To save them,
> click **Save Changes** on top of the **Storage Manager** form.
Updated on April 25, 2023