BSI IDs

BSI IDs are a unique identifier for individual specimens (vials) within your database. BSI IDs are comprised of two components: Sample ID and Sequence. The Sample ID denotes a set of specimens taken from one subject at one time. Because multiple specimen records can have the same Sample ID, Sequences must be unique within each Sample. 

BSI ID Components

Use the Assign BSI IDs tool to generate Sample IDs and Sequence Numbers for vials in an Add batch.  New vials are assigned unused Sample IDs within a specified range and Sequence Numbers starting at a specified value.  Vials containing identical values for a specified field (Grouping Fields) are grouped together with the same Sample ID.  When a different value for the specified field is reached a new Sample ID is used for vials with the new value and Sequence Numbers are assigned to those vials sequentially, starting with the specified start value.

Once IDs have been assigned, they will automatically be reserved for the batch.  The IDs will remain as reserved until the batch is committed or deleted. IDs can be manually unreserved.

In a Data Entry Add batch, using this tool to update Sample IDs can cause already entered sample level data to be updated. If this would happen, then a Sample Data Changed! dialog will open. The dialog shows the changes which will be made and provides an option to continue with the change, or to cancel the change. The ability to continue with changing Sample data on this dialog is controlled by a permission, so if a user does not have this permission, the button to continue will not be active.

To assign BSI IDs:

1. Create or open an existing Add batch.
2. Save the batch (required for new unsaved Add batches; optional for other batches).
3. Select the row(s) to which to assign BSI IDs.
4. Select Assign BSI IDs from the Tools menu. The Assign BSI IDs dialog will appear.
5. Under ID Specification, enter a value for:
   • Assign Sample IDs starting at: Sample ID.
   • Assign Sequence number starting at: starting Sequence number.
6. In some cases, you may want to assign new specimens into an existing Sample ID in the system. To do so, check the Assign Existing Sample IDs checkbox.
7. In the Grouping Fields section, select fields to group Sample IDs by first pressing the Fields button. A Select Sample Fields dialog will appear.
8. Once the starting Sample ID, starting Sequence number, and grouping field(s) have been selected, press the OK button. Sample IDs, Sequence numbers and BSI IDs will be generated for the selected rows.

Reserve BSI IDs

Users can reserve available BSI IDs for prospective specimen records in a Kit, Data Entry Add batch, or a Shipments batch. Once the BSI IDs are reserved, they remain reserved until the specimen records are committed in a Data Entry Add batch, or the kit or batch where the reservation was made is deleted. An error is returned if the BSI IDs cannot be reserved. If a reserved BSI ID is entered in a Data Entry Add or Change ID batch, an error is returned and the batch cannot be committed.

To reserve BSI IDs:

1. In the editor, select the rows with the BSI IDs to be reserved.
2. Select the Reserve BSI IDs option from the Tools menu. A Reservation Complete message is displayed if the selected IDs are successfully reserved.
3. Press the OK button on the message to return to the editor.

To remove BSI ID reservations:

1. Select the specimens with BSI ID reservations to be removed.
2. From the Tools menu, select Remove BSI ID Reservations...
3. The BSI ID reservations are removed, and a Success message opens.
4.  Select OK in the message to return to the editor.