Skip to content
Snippets Groups Projects
Commit d7d36d24 authored by Marco Del Tufo's avatar Marco Del Tufo
Browse files

Update inventory-of-materials-and-methods.md

parent 9a24b4f6
No related branches found
No related tags found
1 merge request!40SSDM-13578 : 2PT : Database and V3 Implementation - include the new AFS "free"...
Hide whitespace changes
Inline Side-by-side
docs/user-documentation/general-users/inventory-of-materials-and-methods.md
+ 26
− 190
View file @ d7d36d24
......@@ -3,10 +3,6 @@ Inventory Of Materials And Methods
## Customise Collection View
[](# "Print this article")
It is possible customise the view of *Collections* in the ELN.
The default *Collection* can have a **Form View** or a **List View**.
......@@ -16,10 +12,6 @@ Depending on this selection, the collection view will be different.
![image info](img/customize-collection-view.png)
**Form View:** This shows the metadata of the *Collection* along with
the table of objects. This view is useful when a user wants to see
specific metadata for a *Collection*.
......@@ -58,41 +50,27 @@ Updated on April 25, 2023
## Register single entries in a Collection
[](# "Print this article")
[](# "Print this article")
In this example, we will see how to register one *Object* of type
**Sample** in the **Raw Samples** *Collection.* The same procedure
should be followed to register any other *Object* in other
*Collections*.
1. Click on the **Raw Samples** *Collection* folder in the main menu.
2. Click the **+ New Sample ** in the main page
3. Fill in the form
4. **Save**
Please note that the *Object type* shown in the **+New** button (in this
case **Sample**), is what is defined as *default object type* for the
*Collection*. If this is missing in the *Collection,* the button will
not be present.
![image info](img/register-single-entry-collection-button-1024x299.png)
To register a different object type in the Collection:
1. Select **New Object** from the **More** drop down menu (as shown
below)
2. Select the relevant *Object type* from the list *(Sample,* in this
......@@ -100,8 +78,6 @@ To register a different object type in the Collection:
3. Fill in the form
4. **Save**
![image info](img/register-single-entry-collection-more-1024x300.png)
Updated on April 25, 2023
......@@ -110,8 +86,6 @@ Updated on April 25, 2023
[](# "Print this article")
It is possible to register several samples at once via file upload. Two
methods are currently available:
......@@ -120,22 +94,15 @@ methods are currently available:
2. Batch registration via TSV template file (TSV Batch Register
Objects)
![image info](img/batch-register-entries-one-collection-1024x300.png)
![image info](img/warning-sign-1024x904.png)
In openBIS versions prior to 20.10.6, the XLS batch registration is not
recommended to register several hundreds of entries. The use of the TSV
batch upload to register several hundreds of entries is recommended in
those cases.
## Batch registration via Excel template file
### Batch registration via Excel template file
To register several entries of the same type with an Excel file:
......@@ -147,12 +114,8 @@ To register several entries of the same type with an Excel file:
[SAMPLE-COLLECTION-REGISTRATION-SAMPLE-STORAGE\_POSITION-template](https://openbis.ch/wp-content/uploads/2022/02/SAMPLE-COLLECTION-REGISTRATION-SAMPLE-STORAGE_POSITION-template-2.xlsx))
4. Upload the file.
#### **Codes**
In most cases, *Object* types have the option to auto-generate codes set
to true in the admin UI. In this case, openBIS automatically generates
codes and identifiers when *Objects* are registered. If that is not the
......@@ -162,14 +125,10 @@ however be manually added if codes should be provided by the user and
not automatically generated by openBIS. If codes should be manually
entered and are missing, openBIS will show the error message
“*UserFailureExceptionmessage: Code cannot be empty for a non auto
generated code.*”
generated code.*”
#### **Controlled vocabularies**
For Controlled Vocabularies fields, i.e. fields with a drop down menu,
you can enter either the **code** or the **label** of the terms in the
Excel file.
......@@ -179,16 +138,10 @@ Please note that codes are not case-sensitive, but labels are.
Codes and labels of vocabulary terms can be seen under
**Utilities -> Vocabulary Browser**.
#### Assign parents
1. **Assign already existing parents**
If the parents you want to assign to your Objects are already registered
in openBIS, in the **Parents** column of the Excel file, you can assign
the relationship, by providing the identifier of the parent (i.e. /SPACE
......@@ -200,18 +153,12 @@ the keyboard shortcuts **Alt** + **Enter.**
Example file:
[SAMPLE-COLLECTION-REGISTRATION-ANTIBODY-STORAGE\_POSITION-template](https://openbis.ch/wp-content/uploads/2022/02/SAMPLE-COLLECTION-REGISTRATION-ANTIBODY-STORAGE_POSITION-template-1.xlsx)
** Note:** no other separators (e.g “,” or “;”) should be used,
otherwise an error will be thrown.
**2. Register Objects and assign parents in the same batch registration
process. **
If you want to register a few *Objects* and at the same time establish a
parent-child relationship between some of them, you can do so by using
the **\\$** and **Parents** columns. In the example below we want to
......@@ -221,37 +168,23 @@ antibody 1 we need to enter numbers or letters proceeded by the \\$ symbol
(i.e. \\$1, or \\$parent1). In the **Parents** column of antibody 2, we need
to use the same value used in the **\\$ column** for antibody 1.
![image info](img/register-objects-assign-parents-in-same-transaction.png)
#### Date format
For date fields, the expected format is YYYY-MM-DD.
### Register storage positions and samples in the same XLS file
A **sample** and its **storage** **position** can be registered
together, as shown in the template provided above:
- The info in the **\$** column of the **sample** spreadsheet should
match the **Parents** column in **Storage Positions** spreadsheet.
In the \$ column you can enter numbers or letters proceeded by the \$
symbol (i.e. \$1, \$2 or \$parent1, \$parent2)**.**
## Batch registration via TSV template file
### Batch registration via TSV template file
1. Select **TSV** **Batch Register Object*****s*** from the
**More*** *drop-down menu
......@@ -261,9 +194,7 @@ together, as shown in the template provided above:
** **
### **Rules to follow to fill in the template .tsv file**
#### **Rules to follow to fill in the template .tsv file**
1. **Identifiers**:
1. Identifiers are given by **/SPACE code/PROJECT code/OBJECT
......@@ -286,9 +217,7 @@ together, as shown in the template provided above:
5. **Date fields**. The expected syntax for dates is YYYY-MM-DD.
## Advantages of XLS batch registration vs the old batch registration
### Advantages of XLS batch registration vs the old batch registration
1. XLS batch registration uses labels instead of codes in the column
headers in the template file.
......@@ -300,46 +229,30 @@ together, as shown in the template provided above:
4. Upload of samples and storage positions can now be performed using
single template file.
The *old* batch register mode is being maintained for backward
compatibility and will be phased out.
Updated on April 25, 2023
## Batch register entries in several Collections
[](# "Print this article")
It is possible to batch register *Objects* that belong to different
*Collections*.
This can be done from the **Object Browser** page, under **Utilities**.
Two options are available:
1. **XLS Batch Register Objects**: batch registration via Excel
template file.
2. **TSV Batch Register Objects**: batch registration via .tsv template
file.
![image info](img/batch-register-entries-object-browser.png)
### XLS Batch Register Objects
This option for batch registration is available since openBIS version
20.10.3. It allows to register *Objects* of different types to multiple
*Collections*.
......@@ -349,8 +262,6 @@ available types.
![image info](img/object-broswer-types-selection.png)
You can then download the template that will allow you to register
*Objects* of the selected types to single or multiple *Collections*. The
*Space, Project, Collection* need to be entered in the file. The
......@@ -358,12 +269,8 @@ complete path for *Projects* and *Collections* need to be used, as shown
in this example file:
[SAMPLE-GENERAL-REGISTRATION-EXPERIMENTAL\_STEP-MASS\_MEASUREMENT-SAMPLE-template](https://openbis.ch/wp-content/uploads/2022/03/SAMPLE-GENERAL-REGISTRATION-EXPERIMENTAL_STEP-MASS_MEASUREMENT-SAMPLE-template.xlsx)
### TSV Batch Register Objects
The batch registration via .tsv file allows to batch register only one
type of *Object* at a time. *Objects* however can be registered to
several *Collections*.
......@@ -371,54 +278,34 @@ several *Collections*.
This batch upload method is kept for backward compatibility, but it will
be phased out.
![image info](img/object-browse-batch-reister.png)
In this case, if *Objects* are to be registered to multiple
*Collections*, an **identifier** for the *Objects* needs to be provided,
as shown below. This is not the case with the XLS batch registration,
where identifiers can be automatically generated by openBIS.
![image info](img/Screenshot-tsv-file-batch-upload-1024x221.png)
Updated on April 25, 2023
## Batch update entries in a Collection
[](# "Print this article")
It is possible to modify the values of one or more fields in several
objects simultaneously via batch update. This can be done in two ways:
1. **XLS Batch Update Objects**
2. **TSV Batch Update Objects**
### XLS Batch Update Objects
1. Navigate to the relevant collection (e.g. **Raw Samples**).
2. In the Collection table, from the **Columns,** select **Identifier**
and the field(s) you want to update (e.g. **Source**), as shown
below
![image info](img/Batch-update-entries-one-collection-column-selection-1024x584.png)
3\. If you have several entries you can filter the table
......@@ -428,23 +315,18 @@ objects simultaneously via batch update. This can be done in two ways:
Selected Columns; All pages/Current page/Selected rows** (depending on
what you want to export)**.**
![image info](img/export-tables-1024x419.png)
5\. Modify the file you just exported and save it.
6\. Select **XLS Batch Update Objects** from the **More..** dropdown
![image info](img/collection-XLS-batch-update-menu.png)
6\. Upload the file you saved before and click **Accept**. Your entries
will be updated.
**Note**:
If a column is removed from the file or a cell in a column is left empty
......@@ -455,25 +337,16 @@ enter   
![image info](img/Screenshot-2022-10-13-at-15.59.01.png)
into the corresponding cell in the XLS file.
### TSV Batch Update Objects
1. Navigate to the relevant collection (e.g. **Raw Samples**).
2\. Select **TSV** **Batch Update Objects** from the **More…** dropdown.
![image info](img/collection-TSV-batch-update-menu.png)
3\. Select the relevant *Object* *type*, e.g. **Sample **
![image info](img/old-batch-update.png)
4\. Download the available **template**
......@@ -489,8 +362,6 @@ table and paste them in the file. Identifiers have this format:
7\. Save the file and upload it via the **XLS Batch Update
Objects** from the **More..** dropdown
**Note**:
If a column is removed from the file or a cell in a column is left empty
......@@ -506,25 +377,17 @@ Updated on April 25, 2023
[](# "Print this article")
It is possible to batch update *Objects* that belong to different
*Collections*.
This can be done from the **Object Browser** page, under **Utilities**.
Two options are available:
1. **XLS Batch Update Objects**: batch update via Excel template file.
2. **TSV Batch Update Objects**: batch update via .tsv template file.
![image info](img/batch-register-entries-object-browser-1.png)
### XLS Batch Update Objects
This option for batch update is available since openBIS version 20.10.3.
......@@ -536,8 +399,6 @@ types.
![image info](img/object-browser-xls-batch-update.png)
You can then download the template that will allow you to update
*Objects* of the selected types to single or multiple *Collections*. The
*Space, Project, Collection* need to be entered in the file. The
......@@ -547,14 +408,8 @@ are unique in openBIS, by providing them openBIS will know which
*Objects* have to be updated. Example file:
[SAMPLE-GENERAL-REGISTRATION-EXPERIMENTAL\_STEP-MASS\_MEASUREMENT-SAMPLE-template](https://openbis.ch/wp-content/uploads/2022/03/SAMPLE-GENERAL-REGISTRATION-EXPERIMENTAL_STEP-MASS_MEASUREMENT-SAMPLE-template-1.xlsx)
### TSV Batch Update Objects
The batch update via .tsv file allows to batch update only one type of
*Object* at a time. However, it is possible to update *Objects* that
belong to several *Collections*.
......@@ -562,51 +417,33 @@ belong to several *Collections*.
This batch update method is kept for backward compatibility, but it will
be phased out.
![image info](img/object-browser-batch-update.png)
The *Space, Project, Collection* need to be entered in the file. The
complete path for *Projects* and *Collections* need to be used. In
addition, identifiers for the *Objects* need to be provided: identifiers
are unique in openBIS, by providing them openBIS will know which
*Objects* have to be updated.
![image info](img/Screenshot-tsv-file-batch-upload-1024x221.png)
Updated on April 25, 2023
## Copy entries
[](# "Print this article")
To create a copy of an existing entry, select **Copy** from the
**More..** drop down menu in the *Collection* page.
![image info](img/copy-menu.png)
When an entry is copied, the user has the option to **link parents**,
**copy children into the Parents’ collection** and **copy the comments
log**.
All these options are disabled by default.
![image info](img/copy-entry.png)
Updated on July 27, 2022
......@@ -615,39 +452,23 @@ Updated on July 27, 2022
[](# "Print this article")
You can move entries to a different *Collection* either from the e*ntry*
form or from a *Collection* table.
### Move from entry form
To move entries to a different *Collection*, select **Move** from the
**More…** drop down menu in the entry form.
![image info](img/move-menu.png)
You have the option to move to an existing *Collection* or to create a
new *Collection*.
![image info](img/move-options.png)
### Move from Collection Table
It is also possible to move objects from *Collection* tables. You can
select one or multiple entries from a table and click on the **Move**
button.
......@@ -655,12 +476,27 @@ button.
Also in this case you can move to an existing *Collection* or create a
new one.
![image info](img/move-from-table-1-1024x412.png)
Updated on July 27, 2022
## Register Protocols in the Methods Inventory
Updated on July 27, 2022
Protocols are standard operating procedures (SOPs) used in the lab. If such procedures are in place, they should be organised in folders in the Methods Inventory which, by default, is accessible by all lab members.
openBIS provides a General Protocol Object type that can be used. If different specific metadata is needed for protocols, new Object types can be created by an Instance admin in the admin UI and the corresponding Collections can be created in the ELN UI.
To register a new General Protocol in the General Protocols folder, follow these steps:
1. Go to the General Protocols Collection in the Methods folder.
2. Click the + New General Protocol button in the main page.
3. Fill in the relevant fields in the form or choose from available templates.
4. Save
![image info](img/register-protocol-1024x237.png)
### LINKS TO SAMPLES, MATERIALS, OTHER PROTOCOLS
When writing a protocol, it is possible to create links to samples, materials or other protocols stored in the Inventory. These are parent-child relationships in openBIS.
Everything that is used in the protocol can be added as Parent of the protocol itself. This can be done as described fo Experimental Steps: [Add parents and children to Experimental Steps](lab-notebook.md)
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment