Getting Started With Sesame

Choose a Sesame Module

  1. Go to the Sesame web page in a browser. The Sesame LIMS (Laboratory Information Management System) consists of a growing number of 'modules', or units designed for specific purposes. Modules operate on similar principles and share the same look and feel. Records in some modules are accessible from others.
  2. Launch the module that you expect to use (or use the most) by clicking on its name or on the symbol next to it. It's OK if you end up using another module; registering for access to one gives you access to all.

Note

Registration

If you don't already have a Sesame Username, create one by Registering.

Creating a Lab

  1. In the Options menu, choose Associations. Note that Sesame consists of two parts;
    • The Main Window that opened when you registered; it is generally used to create new records, perform searches, access Lab Resources, generate reports, and more.
    • The "Board", which generally displays the results of actions in the Main Window. The Board can be opened at any time by, in the Options menu, clicking Show Board.
  2. Follow the instructions in Create Association.
  3. Set the lab you just created as your Default Lab.
  4. The person who creates a lab becomes a labmaster. If needed, labmastership can be re-assigned to another lab member by the Sesame Administrator; this generally happens only when a labmaster leaves a lab.
  5. One can always update the lab profile later: Update Lab Profile

View Your Memberships

In the Options Menu, click on Memberships. The window that appears in the Board has the following fields;

The Memberships window is described in more detail in the Memberships help page.

View Your Associations

In the Options Menu, click on Associations. The window that appears in the Board has the following fields;

The Associations window is described in more detail in the Associations help page.

Lab Member Registration

All other people in the lab (investigators, students, postdocs, collaborators, etc.) also have to register before you can invite them to the lab.

  1. Have users Register as you did and Change Default Lab to your lab.
  2. Users may want to Create Desktop Icons for the Sesame modules to avoid having to start from the Sesame web site every time.
  3. Invite users to the lab: Issue Invitation.

User Acceptance

Users should Accept Invitation then set your lab as the default lab: Change Default Lab or Alternative Description

Filling in Lab Resources

Start filling in the lab resources. Start with the locations, plates, type and status, and whatever else is needed. You can make updates as necessary. Check out the Lab Resources Help Pages.

Giving CanDo Privileges

You can give CanDo privileges to individual labmembers, if it makes sense to do so, to help fill and maintain the Lab Resources as well as to generate controlled reports and perform XML dumps containing all of the records for a particular item type: CanDo Privileges

Creating Records

Anyone can create any type of record with the exception of ORF records, which can only be created by labmasters and those with a CanDo.

Note

Workgroup Records

The Workgroup View is a record type that deserves special consideration. It is in Sheherazade and Rukh, and is designed for collecting multiple ORFs into one place and processing them together; this is convenient for purposes such as cloning or small-scale expression testing.

Creating Lab Protocols

It is very often useful to assign a protocol to a record. A protocol describes in detail what the record itself shows in outline. Attaching a protocol also allows the use of Protocol Trees and Actions.

To create a Protocol:

  1. In the Options menu, in the Lab Resources submenu, click on Lab Protocol.
  2. Fill in the blank protocol record and, in the Lab Protocol menu, click Save As New Lab Protocol.

    Fields

    • Protocol number is the unique Sesame ID that will be assigned to the protocol, in the form LP.xxxx, when it is saved.
    • Created By Date is the time when the Protocol was created and the Username of the person who created it.
    • Modified by Date is the time when the Protocol was last modified and the Username of the person who modified it.
    • Lab Name is the name of the lab to which the protocol belongs
    • Title is the title of the protocol.
    • Item Type is a drop-down list of Sesame record types; the one that is chosen is the one to which the protocol can be attached.
    • Status is a drop-down menu of protocol Status choices.
    • Type is a drop-down menu of protocol Type choices.
    • Step is the pipeline step that the protocol describes, for example 'Purification'.
    • Choosable is a check-box that designates whether the protocol is choosable for assignment to records; when checked it will appear as a choice in drop-downs.
    • TT Protocol Type is the TargetTrack Protocol Type, a set of descriptors defined by the Protein Structure Initiative TargetTrack website in order to categorize protocols, e.g. 'purification'.
    • Contact is a list of the Usernames, TargetTrack-defined Role, and Labfund of persons who can be contacted about the protocol.
    • Description is a short description of the protocol.
    • Body is the body, or full text, of the protocol.
    • Parameters are TODO.
    • Action is a list of Actions that can be assigned to a record with that protocol attached.
    • Protocol Tree is a TODO.
    • Tree editable designates whether the tree is editable by users.
    • Linked Protocols is a list of related protocols.
    • Images is a list of JPEG, PNG or GIF Images that have been attached to the Sample record.
    • Files is a list of Files that have been attached to the Sample record.

Note

Searching for Records

To search for a particular record or set of records:

  1. In the Main Window, in the Search Menu, choose a View to be searched and, in the submenu, the type of search.
  2. Fill in search terms in the popup (including * 'wildcards' if appropriate) and click Search.
  3. If a single record is found, that record will open in the Board. Multiple findings will result in a list in the Main Window; double-clicking on a result will open it in the Board.

A subset of the searches available in the Search menu are also available, and may be faster, through the View Window in the middle of the Main Window.

  1. Set the View Window to the type of record to be searched.
  2. Click on a 'magnifying glass' button. The category of search that each magnifying glass does can be seen by hovering over it.
  3. Fill in search terms in the popup (including * 'wildcards' if appropriate) and click Search.

A full description of searches specific for each record type can be found in the Help Pages

Check out the other views too, like protein, sample, mass sample, software, hardware (for example CESG has a simple hardware protocol with actions that allows then to track the calibration status of the pipettes.), or this could be a place to attach the manuals for different instruments/robots, vendor, citation (to keep track of publications, or manuscript/paper docs or pdfs), recipe, job request, calendar, notebook, etc.

Note

Using Labfund

Labfund is a drop-down list of various sources of funding. Distinct projects within a lab can be easily tagged and tracked by assigning a Labfund. This field is found near the top of all records with the exception of ORF records.

  1. To create Labfund names for distinct projects, in the Options menu click on the Lab Resources submenu, Salary and Effort, Labfund.
  2. Search for any previously created Labfunds through Search, then By Owner.
  3. Create new Labfunds by filling in the fields in the lower window and clicking Save Labfund. Alternatively, open a previously created Labfund, modify it, and Save As New Labfund.
  4. When creating a new record, set the Labfund field for the appropriate project. This setting is automatically carried down to child records. Particular Labfunds can be specified in various searches and reports.

Note