Looking for quick answers? Browse our glossary and the following commonly asked questions:
Verify that you have the BSI launcher installed. Please see instructions for downloading the launcher here.
First, double-check your account information. Be sure to know what the name of your database is as well as your password.
If you still can't login after verifying that information, it’s possible your account may be inactive. An account can become inactive if you input the wrong password too many times. It also becomes inactive if you haven’t logged in for a certain period of time. BSI will email you before your account is inactivated for that reason.
If your account is inactive, a local administrator can help you.
(The BSI icon has disappeared from my desktop, how can I get it to return?)
Please verify that you have the BSI launcher insalled. Instructions for downloading the launcher may be found here.
Yes; BSI can run on both PC and Mac computers.
(I downloaded the most recent version of BSI and my database name is no longer in the drop-down list on the log on screen. How do I find my database name?)
If you cannot remember which database you belong to, please contact BSI Technical Support.
This depends on your database settings. Please contact BSI Technical Support for more information.
(I forgot my password. How do I get a new one?)
When you first launch the BSI client, there is a Forgot Password? link at the bottom of the dialog. If you select the link, the login dialog will remain open and a temporary password will be emailed to you. After entering the temporary password, you will be prompted to create a new password.
Selecting this link from BSI Engage will open a browser and you will be prompted to enter your username and your database. Once you fill in this information and press the Reset Password button, an e-mail will be sent to you with a randomly generated new password that you can use to log into BSI. Once you have logged on with your new password, we recommend that you change your password immediately to something only you know for security purposes.
If you click the link while attempting to access the BSI production client:
*Note: Using the Forgot Password? link from the Mirror or Beta/UAT environments will not send you an email. If you use the link from the Mirror or Beta/UAT environment, please contact BSI Technical Support to reset your password.
To change your password from the BSI client:
To change your password from BSI Engage:
(I want to change my e-mail address and phone number in BSI, where can I do this?)
To change contact information from the BSI client:
A message dialog will open once your changes have been successfully saved.
To change contact information from BSI Engage:
Mirror is a copy of yesterday’s data used for testing and practice purposes. Do not use mirror to save data because mirror is overwritten on a nightly basis. Your username and password will be the same as they were on production yesterday. It can be located here: https://start.bsisystems.com
Beta is the environment used for user acceptance testing of features and fixes in the next version release of BSI. It can be located here: https://start.bsisystems.com
In the "Choose an Instance" drop down of the BSI Launcher, select the appropriate instance you want to log in to. Select Launch BSI.The link to download the BSI Launcher is: https://start.bsisystems.com
An exception is an error or flaw in BSI. If you receive an exception, please contact BSI Technical Support.
(If my connection is lost, is my data stored in a backup file?)
There is a disaster recovery feature in BSI, but it is not enabled by default. To enable it:
This will create a backup of your work in a temporary folder should BSI shutdown abnormally.
All Access – Personnel will be able to view and report on all specimen data in the database. They can add and modify specimens owned by their repository based on roles. However, they will need study permissions to view and edit subject data. Role permissions will determine the specific managers/abilities the personnel have access to.
Custodial Access – Users are able to view and modify all specimens currently in their repository's custody if they have the proper role permissions. Additionally, users are able to view and modify all specimen records that were once in their repository's custody. Users will not need study permissions to edit specimen records that were part of their repository in the past (though the correct role permissions are still necessary). Users may also gain access to specimens not historically from their repository IF: they are specifically granted access by study or their repository is listed as a trust repository in the repository they are trying to view. Users will still need study permissions to view and edit subject data.
Advanced Custodial Access – Users are able to view and modify all specimens currently in their repository's custody if they have the proper role permissions. Users are NOT able to view and modify all specimen records that were once in their repository's custody, unless the specimen is still currently in the user's repository. Users may also gain access to specimens not historically from their repository IF: they are specifically granted access by study or their repository is listed as a trust repository in the repository they are trying to view. Users will still need study permissions to view and edit subject data.
Study Access Only – Access to view and manipulate specimen data for studies that require authorization must be specifically granted to each repository user. Users at Study Access Only repositories must have both role permissions and study authorizations to perform certain actions.
There are many ways to select multiple rows:
No. To prevent data conflicts, BSI locks the requisition, shipment or data entry batch once one user opens it in edit mode. Another user will not be able to edit the same batch during this time. Some databases have a system preference set which enables users in the database to edit a requisition simultaneously.
The BSI Support Staff sends emails to active users of BSI who have opted to receive them, informing them of any significant changes to the BSI system. In your user profile, from the Preferences tab, the Notifications section contains a preference called “Opt-in to Receive BSI Release Notifications”. This preference, when set to “True/Yes” subscribes you to BSI email notifications; to unsubscribe, change this preference to “False/No”
BSI Local Administrators and study PIs also receive email notifications from BSI during certain processes.
If you are no longer an active user of BSI, but you still receive these notifications, please contact your local administrator or repository contact to deactivate your BSI account.
Be sure to hit "Add to Search Criteria" for the new filter terms you’ve chosen. Also, check if your previous search terms were deleted.
(My coworker is leaving my institution and their account will be deactivated. Will I still be able to use their templates?)
Yes, you are still able to use and access a deactivated user’s templates and reports.
Your institution's Local Administrator can inactivate a user from the User Administration tab. To do so, edit the user and set their status as "Inactive/Deleted" on the Security tab of the user editor
Each database has one or two people designated as a database owner and they are in charge of making decisions for the entire database. Your database owner has several responsibilities. They are: approving requests for enhancements, authorizing new Local Administrators & Database Managers, approving access to the Customization module, approving new monitor reports, approving any Production Data Changes performed by IMS, and approving any other actions by IMS that impact the entire database. Contact IMS if you are unsure who your database owner is.
(For example, I’d like to tell if a ship task was completed by scanning the sample or if the task was completed using the mouse. I have an instance where 20 samples had their ship task completed in the same minute. It’s feasible that this happened within the same minute using the scanner but I’m somewhat skeptical.)
BSI does not currently track the method of the completion.
Only the user that created the requisition, or a local admin at the requisition's repository can cancel a requisition.
(I have added and requested a specimen in a requisition erroneously, how do I drop it?)
In a Pending requisition:
In a Submitted requisition:
(I began a Process task creating 4 children per parent, but I actually ended up only creating 2 children per parent. How does this work in the requisition?)
In the Child Completion dialog, when completing the task, highlight the child rows that were not physically created and press the Delete Row icon (or right-click/Delete Row). The deleted rows will not be created.
If reserved children are not automatically removed from the requisition, you may need to refresh the requisition by closing and reopening it.
The Ship task is used to track specimens being sent to an entity which does not use your BSI database to track the specimens. For example, the Ship task may be used to send specimens to a customer or an unaffiliated lab for processing.
The Transfer Out task is used to send specimen custody to another entity which does use your BSI database to track specimens. For instance, this may be an internal storage center or another facility which processes your specimens before entering data into BSI and transferring the specimens back to you.
The Ship and Transfer Out tasks in Requisitions should not be confused with the Incoming Shipments module. This module is used to track shipments being sent into your repository from an outside, or unaffiliated entity.
In order to specify a ship order:
To unapply a task:
**Note: Only specimens with a task status of Applied or Denied can be unapplied in the Requisitions editor.
Before an Aliquot or Process task can be undone, child specimens created by the task must be deleted.
This cannot be undone in the BSI client. However, a second Transfer task may be completed by the receiving repository to transfer the specimens back to the original repository. If needed, contact BSI Technical Support to explore other options.
In the Create Child Vials Dialog, on the right side, there is a Children button. If you select this while highlighting specimens, a new dialog will open. Input the number of children to be created.
If you have already begun the Aliquot task, then a new Aliquot task will need to be added to the requisition. The new Aliquot task can be completed only on the parent(s) for which additional children are needed.
(I went to the Requisition Manager, but it does not show my batch. What is wrong?)
Chances are that your filter is not including the records. Look at the filter criteria at the bottom left of the manager and make sure it is set correctly.
If you are looking for a specific record, like requisition R2011:123456, then:
The manager will now refresh with your requisition.
(I added a specimen that has a Parent Id to a requisition, but the field is blank.)
The Parent ID field in the requisition only displays a value for specimens created in the requisition.
The Global Parent ID field is only displayed for specimens added to a requisition and takes on the specimen's Parent ID value
Parent ID and Source ID fields both take on BSI ID values. You can enter them in data entry, but the system fills them in when an aliquot or process task is completed in requisitions. Parent ID is the immediate parent of the aliquot or derivative. Source ID is the original parent. So, if you create an aliquot of an aliquot, the source id would be the parent id of the first aliquot.
The requisition will remain as In Process until all tasks on all specimens have been marked as Completed or Denied, and all specimens no longer have an Include status of Included and a Vial Status of Reserved.
Requisitions appearing in red typeface on the manager include some new data which has been added by a user from a repository other than the user’s current repository. For more information see: Read Flag.
You may want to make sure you hit the “Add to Search Criteria” button once you’ve selected search terms. You’ll know you’ve done so when the criteria appears in the bottom box.
The standard search screen has an "Equals ignore case (=^)" search operator for all string fields.
There is also a system preference that can be set for your database, which will ignore case on all searches.
To search on multiple values use a ";" (semicolon) to separate them.
For example: searching on “Material Type= Serum; Plasma” would yield results with both material types.
(My Subject IDs contain hyphens. I tried searching for my subjects but I am having trouble.)
By default the hyphen is used for a range, but will search for values containing hyphens if the user puts quote marks at either end of the ID.
For example, searching Subject ID= "BSI-123" will look for all instances of BSI-123 in the Subject ID field, while searching for Subject ID=BSI-123 will return all values in the Subject ID field from BSI through 123.
Additionally, there is a user preference that allows users to choose their own range delimiter ("~" can signify a range rather than "-").
To search on a range of dates, simply add a "-" (hyphen) between the dates.
For example, if you want to search on Date Received field values from the beginning of December 2009 to the end March 2010 you would enter "Date Received = 12/1/2009-3/31/2010" into the search.
To search on subject fields within the subject module, you'll need to first narrow the selection down by Study ID.
It’s possible the error you’re getting is in a field that is hidden. Try right clicking on a column header and selecting “Hide/Show Columns.” That should let you view the column and input the values the system needs.
You can learn more about hiding and showing columns in our users’ guide article here.
Default values added to a template are only applied when using the template to create brand new specimens in a shipment or Data Entry Add batch. Other types of batches are used to modify existing specimen data. If default values were applied to these types of batches via a template, users could inadvertently update data without realizing. BSI prevents this by only applying the defaulted data to Data Entry Add batches and shipments. Try using Mass Change or Change Values to quickly update data for existing specimens in other batch types.
Some fields are automatically generated by BSI. Because of this, they are not editable.
(I'll be out of the office for a while and other users will need to access my batch.)
While in the batch editor:
This can be changed back to “Owner Only”, if necessary, by following the same steps.
(I forgot to enter a description... is it too late to add it?)
To access batch properties...
**Note that a similar method can be used to modify requisition and shipment properties
These records can only be deleted if no requisition tasks have been applied or completed on them. They can be deleted by committing a Data Entry Delete batch. This should only be used for specimens that were accidentally entered or never existed. If you do not have permissions to commit a Delete batch, please contact your Local Administrator.
(I deleted a Saved, Not Committed batch but now I would like to commit it.)
Once a batch is deleted, it cannot be edited (or undeleted), however the batch can be used to create another batch containing the same specimens, where data can be committed.
(I don't see a Commit Batch icon on the toolbar. Why is it missing?)
If the Commit Batch icon is not on the toolbar it is probably because the batch requires verification (it must be committed at the same time as an identical batch). There are two reasons for this: Either the batch property for requiring verification is set to True/Yes or you have a permission assigned to your account which requires you to commit all Data Entry batches with an identical batch. Batches that require verification must be committed from the manager.
To verify that the batch requires verification:
If this batch property is set to False/No, then check with your database's Local Administrator to verify that you have the correct permissions assigned to you.
Another possibility is that this particular icon is hidden on your toolbar.
(I already committed the batch, but some of the data was wrong.)
Once a batch is committed, it cannot be edited. However, individual records in the batch can be edited through a Modify Batch.
If this option is not available, please contact your local administrator.
To change a BSI ID or part of a BSI ID (i.e. Sample ID or Sequence Number), you will need to add the specimens you wish to edit to a Change ID batch. If you have the proper permissions, you will be able to choose this batch type from the Select Batch Type dialog that opens after pressing the New button in the Data Entry manager.
To add specimens from an Excel document or text file to BSI, use the importer tool. To access the Importer:
You can also use the Specimen and Subject Importer tool to import data from an excel document. This allows file data to be mapped to both specimen and subject fields in BSI.
(The specimens are used, but I still want to track them in BSI)
In a Data Entry Add or Modify Batch, change the Vial Status to "Empty" or "Out". Use an Add batch for specimens which do not already exist in the database and a Modify batch for specimens which are already being tracked by BSI.
One of the best ways to assign sample ids and sequence numbers to specimens is in a Data Entry Add batch.
(I'm receiving an error in my batch that says "The BSI ID [BSI ID] is Reserved by [Data Entry Batch]", How do I clear this?)
You are receiving this error because another user has reserved the BSI ID's that you are trying to commit in another batch by using the Assign BSI ID's tool. You will need to contact the owner of the batch that has the BSI ID's reserved and make sure you are not trying to enter duplicate data. If you are not, you can clear the error by committing or deleting the batch that has the BSI ID's reserved. You can also use the Unreserve BSI IDs tool on the specimens in the original batch to remove the reservations, so that the second batch can be committed with those BSI IDs.
(I am getting specimen location errors in my data entry batch. How do I clear them?)
To clear a specimen location error, you must assign that specimen a valid location. The easiest way to do that is by using the Reserve Locations function located under the Tools menu.
If location data has been keyed in manually or imported into the batch, verify that the values EXACTLY match the values in the location tree, including capitalization. If the values do not match exactly, then the location ID error will be given.
To modify more than one container at a time, you can use the Edit Subcontainers tool. To do this:
To add new containers:
(Right now I only see BSI ID, can I see the Subject Id?)
You can change what is shown in Locations via your user profile.
You may need to refresh (F5) to see the changes in the Locations manager.
There is a user preference for this.
This will display the container's label on the Locations manager.
To unreserve a location:
This will remove the reservations so the locations can be reserved elsewhere.
(I want to print labels for some specimen, but want to leave one of the fields that would normally be displayed off of the label, how can I do this?)
If you use a Brady IP300 Label Printer and need to find the printer's IP Address, follow these steps:
You can then enter this in BSI:
The label specifications may need to be updated to include the correct label size, page size or printer type.
Steps to troubleshoot:
The field names in the label template mapping may not exactly match the field names in the .lab file.
The firmware on the new printer may need to be reverted to a previous version. Contact the printer’s support group for troubleshooting assistance. You may also contact BSI technical support for assistance in contacting the printer support group.
(Our repository is starting a new collection. How do I create a new study for it?)
You create new studies from the Study Manager.
If you cannot access the Study Manager, please contact your local administrator.
If you cannot access the Studies Manager, please contact your local administrator.
When you try to transfer a shipment batch to data entry, be sure to select the vials you are going to transfer. If you do not, no vials will be transferred and you’ll make an empty data entry batch.
For more information about transferring specimens to a data entry batch in the users’ guide here.
Be sure to receive the shipment before transferring specimens. If you don’t receive a shipment, you can’t transfer it to a data entry batch.
To receive a shipment, you can select the Receive button from the Shipments manager. Alternately, you can hit File and then Received Properties from the editor.
You can learn more about this in the users’ guide article here.
You might just need to refresh to be able to see it. Try hitting F5 to refresh.
If that doesn’t work, check the filter button at the bottom of the manager. That will let you see what you are currently viewing and if it would preclude the item you just made.
The Shipments manager allows users to track shipments and shipment discrepancies in the database. There are no specimen-level edit checks in the Shipment editor
Specimens can be received from the Shipment manager, but shipping them out takes place in the Requisitions manager.
In the destination code list there is a field called Inactive. If this is set to "True/Yes", the destination will not be shown when selecting destinations (in a shipment, requisition, etc). Make sure the Inactive value is "False/No" for your destination.
(I transferred specimens from a shipment, and now Date Received is filled in.)
If the field is not already filled for a specimen, the field is populated with the Shipment Batch's Date Received when specimens are transferred. This is specified in the Received properties panel.
BSI Engage is a new web interface for BSI. It retains all the features available in BSI Web and improves them. BSI Engage uses an intuitive, user-friendly search interface to return results almost instantly. It is being made available to databases concurrectly with BSI Web.
You’ll need the appropriate permission to use it. Ask your local administrator to grant you permissions if you’re getting a message that says you are not authorized.
Often, it takes a few minutes for the client to communicate with Engage. Try waiting 5 minutes and then refresh the page.
If this doesn’t work, be sure to check your search filter. It may be precluding the item you just made.
Be sure to check which tables you’re getting your search criteria from. Some tables are not related and if you try to search two of them, no results are possible. If one table isn’t working, you may want to try terms from a different one.
You can learn more about advanced reporting techniques in our article here.
If you’re on a large database or searching for something that will have a large amount of results, a report may take a long time to generate. In these cases, it may be good to reduce the amount of tables you’re searching on to lessen the amount of data that needs to be returned.
Choose a report output type of comma-delimited text file, and then save the report as a .csv file. This file type can be opened in Excel.
You cannot delete a value that is being used. You can disable it so that it will not be used in the future.
The destinations are managed by the Destination code list.
If you do not have access to this manager or are unable to edit the code list, please contact your Local Administrator.
(How do I edit fields in the Material Type code list?)
Some code lists, such as "lkup_general_container_type", are not editable because they are necessary for the system to function. The "Study" code list is not editable through the Code List module, but rather must be edited by creating a new study in the Studies module. Other code lists, such as "lkup_batch_status" are only editable by System Administrators. The "lkup_material_type" code list, and some others, are editable by users with the appropriate permissions via the Code Lists module.
(I reserved samples for a study, and now I would like to delete the reservation for the ones that weren't used.)
These Sample IDs will no longer be reserved.
My Specimens displays all of the specimens a user is allowed to see. If there is a study that you have access to, or there are no restrictions for the study and the specimens are a part of your repository, you will be able to view the data. You can create My Specimens groups, from both the My Specimens manager and the Reports module that will only include the specimens which meet specified criteria. For more about creating My Specimens groups, check out this in the User's Guide.
The "All" filter on the My Specimens manager only displays the first 100 specimens which you have permission to view. Any subsequent My Specimens group which you create and view in the manager will display all of the included specimens, not just the first 100.
If you are a Local Administrator, edit the user and from the Preferences tab, select the appropriate module on the left side, then select the default template from the preference.