2.2 Main Menu

Central to LabWare is the Main Menu.  The icons on the system Main Menu provide the user with an easy way to access the most frequently used menu options.  To display the various system menus, click on the menu name, or press the ALT key plus the underlined letter of the menu name.  For example, ALT+C will display the Configure menu.  Once the menu is displayed, type the underlined letter of the menu selection, or click on the menu selection to run the selected option.  The functionality of each toolbar icon on the Main Menu is described below. 

NOTE: The ALT key plus the underlined letter only works in the Windows Client.  For the Web Client replace ALT with SHIFT+ALT.  For example to display the Configure menu in the Web Client, press SHIFT+ALT+C.

 

The left portion of the Main Menu title bar displays the ODBC data source name for the LabWare database.  The right portion of the Main Menu title bar displays the name of the logged on user.

In the lower left portion of the window, the time of day is displayed.  To the right of the time display is a small icon that shows changes color whenever LabWare LIMS is accessing the database.

NOTE:  On the Web Client the title bar information is located on the tab title and the lower left portion where the time is displayed is not present.

 

The Menu configuration shown is the default configuration.  The menus, the content of the menus and the icons shown on the toolbar can all be customized.  This will be covered later in the Menus and Toolbar section in the Managing GUI chapter.

Figure 2-1 LabWare Main Menu - Web Client

 

Figure 2-2 LabWare Main Menu - Windows Client

 

2.2.1      Main Menu Toolbar

Icon

Function

Equivalent Menu Item

 

Search Recent Bar

Recent

 

 

Exit LabWare

File menu…Exit

Log Out

File menu…Log Out

Manage System Tables

Configure menu…Manage Tables

Explorer Table Manager

Configure menu…Explore Tables

Sample Interface

Run\Log Samples\Template login

View and Drill Down on Samples

Run menu…View Samples

Test Editor

Run menu…Edit Tests

Result Entry

Run menu…Enter Results

Folder Manager

File menu…Open Folder Manager

Project Manager

File menu…Project Manager

Run Reports

Run menu…Reports

 

NOTE: The maximum number of icons which be displayed on the toolbar is 12.  If more than 12 toolbar icons are configured, there will be multiple pages available.  This is indicated by the small circles below the toolbar icons. Click on the hollow circle to switch pages.

 

 

2.2.1.1      Search Recent Bar

Figure 2-3 Recent Search - Go Bar

The Search Recent Bar provides the user with the ability to search for and retrieve recently accessed records.  Only records found in the Recent Menu area are available to search from in the search bar.

To select a recently used record, start typing the name in the Go bar.  A list of matching records will appear below the Search Bar.  The left side of the drop down is the individual record name; the right is the manager area in which the record can be found. Select a record from the list to open the record in the selected manager window. 

Clearing the Recent Menu will also clear the search and no records will appear in the drop down window.

2.2.1.2      Recent Menu and Toolbar Icon Recent Menus

Figure 2-4 Toolbar Icon Recent Menu

The Recent menu contains a list of recently opened records for an individual user and can be used to quickly access recent records in the system.  The menu displays the manager areas and the Sub-Menu the individual records.

The Recent Menu can be cleared by selecting Clear.  All recently accessed records will be cleared from this menu and all individual manager Recent Menus. For example, if Clear is used from the Main Menu, on opening Folder Manager, the recent menu will no longer be present. Clearing Recent Menus from within the individual Managers will only clear records from the current manager window.

Access to recent records can be also be done through the toolbar.  Tables with recently accessed records on the toolbar will have a small arrow  to the right of the icon. Clicking on the arrow will open a menu of recently accessed records for that manager area.  Click on the record to open the manager to the selected record.

2.2.2      File Menu

The File menu provides the user with the following functions.

 

Folder Manager

Refer to section on Folder Manager.

Project Manager

Refer to section on Projects .

Print label(s)

Used for printing barcode labels. Refer to the following section on Print Label(s) for more info.

Open Report

Used for opening report files. Refer to the following section on Open Report for more info.

Import File

Refer to section on Import File.

Log In

Used for logging into the LabWare System. Refer to the following section on Log In for more info.

Log out

Used for logging out of the LabWare System. Refer to the following section on Log Out for more info.

Exit

Used for exiting the LabWare System.

Address Book

Refer to section on Address Book.

Alert Manager

Refer to section on Alert Manager.

Approval Manager

Refer to section on Approval Manager Concepts.

Batch Manager

Refer to section on Batch Manager.

Contact Manager

Refer to section on Contact Manager.

Data Explorer

Refer to section on Data Explorer.

Inventory Manager

Refer to section on Inventory Manager.

Investigation Manager

Refer to section on Investigation Manager.

File Browser

Refer to section on File Browser in the chapter on System Wide Functionality.

Lot Manager

Refer to section on Lot Management.

Message Window

Refer to section on Message Window.

Object Group Manager

Refer to section on Object Group Manager.

Order Manager

Refer to section on Order Manager.

Sample Rules Manager

Refer to section on Sample Rules Manager.

PDF Window

Refer to section on Secure Reporting.

Stored Query Manager

Refer to section on Stored Query Manager.

Worksheet Window

This functionality has been deprecated.

Worksheet

This functionality has been deprecated.

2.2.2.1      Print Label(s)

When the Print Label(s) function is selected, a Sample Prompter opens first for the user to select the sample.   Once the sample is selected then the Integer prompter will open asking for the number of labels to print.

Figure 2-5 Integer Prompter

 

The indicated number of labels will be printed for the selected sample as long as a label ID has been defined in the Sample Login Template for the selected sample. 

NOTE: No label will be printed if no label ID is defined in the Sample Login Template.

The Print Label(s) function will be disabled if any of the following conditions are met:

There is no label printer configured in the System - Client Configuration.

The user does not have the privilege to print labels or receipts.

2.2.2.2      Open Report

The Open Report function enables the user to open a report file that has been generated by LabWare, such as those produced from the Scheduler (refer to the section on Web Service Consume for more on creating reports from Scheduler).  When selected, the Open Report function opens a File dialog that looks for files with the .lim file extension. 

Figure 2-6 Select Report File

 

Once the file is selected the report will be open in the Crystal Reports preview pane.  Only files with the .lim file extension can be viewed using this function.

2.2.3      Configure Menu

The Configure menu provides the user with the following functions.

 

Change Password

Refer to section on LIMS Password Management.

Assign Groups

Refer to sections on Optional Groups and User Groups in the chapter on Security and Auditing.

Manage Tables

Refer to section on Table Managers in the Static Data chapter.

Rules and Events Manager

Opens the Rules and Events Manager.  This dialog is used to configure Automation Scripts, Business Rules, Event Triggers, Icon Rules, Info Rules, and Status Rules. Refer to section on Business Rules.

Configure Browse

Refer to section on Browse Fields Concepts in the chapter on Managing GUI.

Display Fields

Refer to section on Display Fields in the chapter on Managing GUI.

External Link Directories

Refer to section on External Link Directories.

Certify Users

Refer to section on Certify Users.

Scheduler

Refer to section on Web Service Consume.

System\ Client

Refer to section on System Configuration Concepts.

System\System

Refer to section on System Configuration Concepts.

System\Send an alert to all logged in users

This function is used to send an alert to all users currently logged into LabWare. Refer to the following section on Send an alert to all logged in users in the Alert Manager section for more info.

System\Logins

This function is used to disable logins. Refer to the following section on Log In for more info.

Change Signing Password

Refer to section on LIMS Password Management.

Define OK file types for Web upload…

This function is used to restrict file types that can be uploaded in WebLIMS.  It must be a comma separated list.

Menus and Toolbar

Refer to section on Menus and Toolbar.

Explore Tables

Refer to section on Explore Tables.

HTML Query Tags

Refer to section on HTML Query Tag Dialog in Reporting Chapter.

Notebook References

Refer to section on Notebook References.

Notebooks

Refer to section on Notebooks.

Parent Child Record Editor

Refer to section on Parent Child Record Editor in Static Data Management Chapter.

Modify Product Specs

Refer to section on Product Specification Editor.

Set Signature File

Refer to section on Set Signature File.

Specifications Designer

Refer to section on Product Specifications Designer in Product Specifications chapter.

 

2.2.3.1      Define OK file types for Web Upload

The Configure > Define OK file Types for Web upload opens a dialog to allow the entry of a comma separated list of file types that the web client is permitted to upload.  The user must have ConfigureWebOKFileTypes functional privilege to open this dialog.  To allow all file types, set the field to blank or *.

To set specific file types, enter a comma separated list of file extensions and click OK. Click Cancel to keep the existing setting.

Figure 2-7 Define OK File Types for Web Upload Dialog

NOTE: If the system is not set to allow all file types, “obj”,  “xml”, and “zip” must be included on the list to import obj and xml files.

 

2.2.4      Run Menu

The Run menu provides the user with the following functions.

Log Samples/ Log Batch

Refer to section on Batch Login..

Log Samples/ Sample Login

Refer to section on Standard Template Login.

Log Samples/ Log from Sample

Refer to section on Log From Sample.

Log Samples/ Resample

Refer to section on Resample.

Log Samples/ Grid Login

Refer to section on Grid Login.

Log Samples/ Group Login

Refer to section on Group Login.

Modify Samples

Refer to section on Modify Samples.

Charge

Refer to section on Charge.

View Samples

Refer to section on View Samples.

Edit Tests

Refer to section on Edit Tests.

Enter Results

Refer to section on Result Entry.

Reports

Refer to section on Reporting.

Review

Refer to section on Review.

Manage Instruments

Refer to section on Instrument Manager.

Manage Standards and Reagents

Refer to section on Standards and Reagents.

Flags

Refer to section on Flags.

Lock Session

Used for restricting access to LabWare without logging out. Refer to the following section on Lock Session for more info.

Release

Refer to section on Release in the Review chapter.

 

2.2.5      Utilities Menu

The Utilities menu provides the user with the following functions.

 

Changes Manager

Refer to section on Changes Manager.

NLS Differences

Refer to section on National Language Support (NLS).

NLS Logging

Refer to section on National Language Support (NLS).

XML Schema

Will export the XML Schema. Refer to the following section on XML Schema for more info.

XML Viewer

Will open the XML Viewer. Refer to the following section on XML Viewer for more info.

NOTE: There may be other menu items on the Utilities menu if M0052 (DBMT) is installed.

 

2.2.5.1      XML Schema

It is possible to export a LabWare database schema into an XML file. This feature can be accessed by selecting XML Schema from the Utilities Menu.  On selecting XML Schema an XML schema file called labware-lims.xsd is created inside a new folder called XSD (created in the Client Directory, if using Client setup or in the Application directory if using a Full install).

The file thus created contains the schema of the LabWare database on which the application is running.  The following is a screen capture of a segment of the labware-lims.xsd file.

Figure 2-8 Labware-lims.xsd file

2.2.5.2      XML Viewer

The XML viewer is used to view XML files in a format that makes them easier to interpret than opening the raw XML file. To open the viewer, select the XML Viewer menu item from the Utilities menu.

Figure 2-9 XML Viewer

To open an XML file, select Open from the File menu or click on the Open File icon.

Figure 2-10 Select an XML File

Select the file to open then click on Open.  The file will be displayed in the viewer.  The XML file will be displayed in a tree view format.  The tree view is expanded and collapsed using the standard tree view controls e.g. click on the + sign to expand a level and click on the – to collapse.

 

Figure 2-11 XML Viewer – Product Record

The previous example is a product record that has been exported from LabWare using the Export XML menu item from Table Manager (see the section on Export XML in the Table Manager section for more detail on this function).  The record structure can be seen.  Each table and its entries appear as separate records under the LIMS_Object heading.

To find information in the file, the user can use the Search function from the Query menu or click on the Search icon,  , to open a search dialog, as shown in the following figure.

Figure 2-12 Enter Search Pattern to search XML File

 

Enter the search string and click OK and the XML file will be searched for the first occurrence of the string. The user can use the Search Next function from the Query menu to repeat a search to find the next occurrence of the string.

Alternatively, the user can use a query typed into the Query pane in the upper right side of the viewer.  Using the Run function from the Query menu or clicking on the Run Query icon, , the query will be executed and the results displayed in the pane beneath the Query pane, as shown in the following figure.

 

Figure 2-13 Manually enter Query to search XML File

 

To exit the XML Viewer, select Exit from the File menu or click on the Exit icon.

2.2.6      LIMS Basic Menu

The LIMS Basic menu provides the user with the following functions.

Always Open the Debugger

When active, will open the LIMS Basic Debugger when any LIMS BASIC code is run.

Debugging  Options

Controls how hardcoded breakpoints and trace calls in LIMS Basic is handled for the current LabWare session.

Debugging Assistant

Refer to Section on Debugging Assistant in the Managing LIMS Basic Chapter.

Information Window

Refer to Section on LIMS Basic Information Window in the Managing LIMS Basic Chapter.

Run Code Search

Will run the program for searching for Text string.  Refer to the following section on Run Code Search for more info.

2.2.6.1      Always Open the Debugger

The Always Open the Debugger is a toggle menu item and can be accessed from the Main Menu > LIMS BASIC > Always Open the Debugger.  When selected a check mark will appear, indicating the menu item is active. 

Figure 2-14 Always Open the Debugger Check Mark

When any LIMS BASIC routines are run and Always Open the Debugger is active, the Debugger window will open to the currently running routine.  This includes automation scripts.  

See section LIMS BASIC Debugger in the Managing LIMS Basic chapter for more information on the LIMS Basic Debugger.

2.2.6.2      Debugging Options

The LIMS BASIC Debugging Options is accessed from the LIMS BASIC Menu > Debugging Options.  It controls how hardcoded breakpoints and trace points are handled.  Hardcoded break and trace point defaults are controlled for each individual user from the setting on the User Table (Refer to the  section on User Management in the Security and Auditing chapter for more detail on these fields).   

Figure 2-15 Debugging Options Dialog

The Stop on hardcoded breakpoint() calls option is used to specify if hardcoded breakpoints will be recognized by the system and open the debugger on the Breakpoint() function.  The default setting is managed by the setting on the currently logged in user.  If the option is checked, the system will recognize LIMS BASIC Breakpoint() and open the debugger, unchecked will ignore the Breakpoint() and not open the debugger.

The Write hardcoded trace() call data to trace.log option is used to specify if hardcoded trace call will be recognized by the system to write trace information to the Trace.Log File in the client directory.  The default setting is managed by the setting on the currently logged in user.  If the option is checked, the system will recognize LIMS BASIC Trace() and write to the Trace.Log File, unchecked will ignore the Trace() function and will not write to the trace.log file.

 

NOTE: These settings are determined by the user record setting only. Settings on the role records are ignored.

 

NOTE: This menu may have more options if M0542 – Debugging for v7, is installed.

 

2.2.6.3      Run Code Search

The Run Code Search function is used to search LIMS Basic code for a specified text string.  This is a useful function for searching for all occurrences of a LIMS Basic function.  To use this function, select the Run Code Search menu item from the Utilities menu.  A Please Confirm dialog will be displayed.

Figure 2-16 Run Code Search – Confirmation Message

 

Click on Yes to record the records checked, even if there are no matches or click on No to only show records with matches in the Search log. A prompt dialog will be displayed.

Figure 2-17 Prompt Dialog - Enter source code search pattern

 

NOTE: In Access, the search function will search for any string matching the search string, regardless of case.  In Oracle, the search may be case sensitive so you may need to enter more than one version of the string to find all occurrences.

 

Figure 2-18 Select Tables to Search

 

Enter the search string then click OK.  The prompt dialog will be displayed again.  Enter another search string or click OK to the blank dialog to begin the search.  Once the search strings have been entered, a select dialog will be displayed so the user can select the tables to search.

Select the tables to search then click OK.  The search will run and the results will be displayed in a text file called search.log, as shown in the following figure.

 

 

 

 

Figure 2-19 Search.log

Records that match the search string will be indicated by a prefix of “***MATCH – ”.  If the Log No Matches option was selected the records without matching entries will be indicated by a prefix of “NO MATCH – ”.

The search.log is written to the LIMS working directory.

 

NOTE: The Web Client may open a dialog prompting to open or save the Search File.  Different browsers may display this dialog differently and depending on your web browser settings, it may also download automatically.

Figure 2-20 Open Search.Log File Prompt - FireFox

 

Figure 2-21 Open Search.Log File Prompt – Internet Explorer

 

2.2.7      Help Menu

The Help menu provides the user with the following functions.

 

Contents

Will open the LabWare Help file.

About

Will provide user with the version information for LabWare.

Create Support Log

Will create a file containing the information needed by the LabWare help desk to troubleshoot problems.

Find LabTrack Number

LabWare has the ability to check the code to see if a specific LabTrack code fix is present.

LabWare Web Support page

Will open the user's Internet browser to the LabWare support page.

LabWare Web Home page

Will open the user's Internet browser to the LabWare home page.

 

NOTE: Context sensitive help can be opened in any window by pressing the F1 key.

 

2.2.7.1      Create Support Log

The information contained in the support.log is displayed in the following sections: LIMS Information, License Information, Environmental Information, DB Information, Installed LabWare Products, Bind.log, !Bind-Rules.txt, Client.sys. Server.sys, Error.log, Db.log, Rpt.log. Basic.log, Debug.log, Client Directory, and Server Directory.

Figure 2-22 Support Log

2.2.7.1.1        SLL Config Hash

The SLL Config Hash value is based on the SLLs that are bound, as well as the order in which they are bound.  This value can be used to check if all LW instances are running the same SLLs, and whether the SLLs are bound in the same order.  The value is reflected in the LIMS Information section.

NOTE:  The SLL Config Hash value is also displayed at the end of the bind.log file.

 

 

2.2.7.1.2        Customer ID Number

The License Information section provides detail on standard user licenses and restricted user licenses.  The number of licenses currently occupied by logged in users, as well as the total number of concurrent login sessions allowed by LW license, are reflected.

2.2.7.1.3        Operating System Bit-count

The OS Bit Count is reflected in the Environmental Information.

2.2.7.1.4        WebLIMS

The WebLIMS war file build number is listed in the Environment Information section if WebLIMS is implemented; otherwise,  “N/A” is reflected.

2.2.7.1.5        Installed LabWare Products

The Installed LabWare Products section contains which installed products are on the client workstation, including the version and location.  This can include Crystal Reports Support, PDF Components, DotNet, SpreadSheet Gear and Loaded .Net Assemblies.

 

 

LW_Logo.gif (41020 bytes)

LabWare-7 Technical Manual V3

Copyright ©LabWare, Inc. 1994-2016  -   All Rights Reserved  

Home