SampleManager LIMS 12.2 SP1 Release Notes

Product Release Notes
SampleManager LIMS 12.2 SP1
© 2019 Thermo Fisher Scientific Inc. All rights reserved.

No part of this publication may be reproduced without the prior written permission of
Thermo Fisher Scientific Inc.
Page 1 of 128
Product Release Notes SampleManager LIMS 12.2 SP1
Contents
Introduction ...................................................................................................................... 7
Recent SampleManager Releases ...................................................................................... 7
Hardware Recommendations ............................................................................................... 8
Database Server ............................................................................................................. 8
Application Server .......................................................................................................... 8
Web Client Server ........................................................................................................... 8
Desktop Client ................................................................................................................ 9
Web Client ..................................................................................................................... 9
Network Recommendations .............................................................................................. 10
Supported Platforms ........................................................................................................ 11
Hardware Configurations ............................................................................................... 11
Software Configurations ................................................................................................ 11
Database .................................................................................................................. 11
SampleManager Application and Web Server OS ............................................................ 11
Desktop and Web Client OS......................................................................................... 11
Web Client Browsers .................................................................................................. 11
SampleManager Mobile App......................................................................................... 12
SampleManager Web Application Browsers .................................................................... 12
Related Thermo Scientific software products ................................................................. 12
Third-Party Software .................................................................................................. 12
Supported Chromeleon CDS Versions ........................................................................... 12
Product Enhancements ..................................................................................................... 17
Functional Area(s) ........................................................................................................ 17
SampleManager Explorer and UI .................................................................................. 17
Chromeleon .............................................................................................................. 18
Samples ................................................................................................................... 18
MLPs ........................................................................................................................ 18
Instrument Converter ................................................................................................. 18
Report Designer ......................................................................................................... 19
Workflow Nodes ......................................................................................................... 19
Data Manager ............................................................................................................ 19
Laboratory Execution.................................................................................................. 20
Schedules ................................................................................................................. 20
Operators ................................................................................................................. 20
Page 2 of 128
Audits ...................................................................................................................... 20
Schema .................................................................................................................... 21
Data Sources............................................................................................................. 21
Instrument Maintenance Schedules .............................................................................. 21
Security .................................................................................................................... 21
New and Updated Features in SampleManager LIMS 12.2 SP1............................................... 22
General SampleManager Updates ................................................................................... 22
Default Menu Icon ...................................................................................................... 22
Explorer Folders......................................................................................................... 23
Restoring Default Explorer Folder Columns .................................................................... 25
Quick Launcher – Obsolete Items ................................................................................. 26
Values List available for IN Operator ............................................................................ 26
Drag and Drop Attachments ........................................................................................ 26
Password Encryption – LoginInstanceKey registry Item................................................... 26
Editing Entity Status Changes ...................................................................................... 27
Running Convert_Table .............................................................................................. 27
General Property Sheet Updates ..................................................................................... 28
Jobs ......................................................................................................................... 28
Samples ................................................................................................................... 29
New Configuration Items ............................................................................................... 31
Map-related Configuration Items .................................................................................. 31
PDF Convert Configuration Items ................................................................................. 33
Explorer .................................................................................................................... 34
Security .................................................................................................................... 34
MLPs ........................................................................................................................ 36
Auditing .................................................................................................................... 37
Workflow Nodes ........................................................................................................... 37
New Workflow Nodes .................................................................................................. 37
Updated Workflow Nodes ............................................................................................ 43
New Expression Functions .............................................................................................. 45
Alias('', '') ................................................................................................................. 45
AliasWithContext('', '', '', '') ......................................................................................... 45
GetResultValue('','') ................................................................................................... 46
LIMSML Entity Actions Updates ....................................................................................... 46
Sample Result Entry ANAL_TRAIN_REASON .................................................................. 46
Sample Result Entry INST_TRAIN_REASON ................................................................... 46
IGNORE_RESULT_ERRORS .......................................................................................... 46
Page 3 of 128
Stock Batches Updates .................................................................................................. 47

Consuming Stock ....................................................................................................... 48
Reconciling the Current Inventory Value with Actual Stock Batch Quantities ...................... 49
MLP Updates ................................................................................................................ 50
Mapping Updates .......................................................................................................... 51
Form Designer - Map Visualization Control .................................................................... 51
Location Property Sheet - Mapping Page ....................................................................... 52
Data Extraction Updates ................................................................................................ 54
Importing SampleManager Instrument Manager XML files ............................................... 54
Alias Default Values ................................................................................................... 54
Parsing script html support ......................................................................................... 55
Electronic Signature Updates .......................................................................................... 56
Audit Updates .............................................................................................................. 56
Operator Updates ......................................................................................................... 57
Instruments Updates ..................................................................................................... 58
Instrument Maintenance Dashboard ............................................................................. 58
Maintenance Overview Dashboard ................................................................................ 59
Schedules Updates........................................................................................................ 59
Control of the scheduling of individual analyses ............................................................. 59
Logging in Jobs and Samples Using a Schedule .............................................................. 62
Laboratory Execution Updates ........................................................................................ 65
Data Source Updates .................................................................................................... 66
Ad Hoc Reports – Web Client .......................................................................................... 67
Report Designer Updates ............................................................................................... 67
Importing PageHeader and PageFooter from the master template. ................................... 67
Exporting modular reports as .repx files........................................................................ 67
Expressions ............................................................................................................... 69
Operator Language Parameter ..................................................................................... 70
Labels ...................................................................................................................... 70
Schema Updates........................................................................................................... 72
SCHEMA_ Tables........................................................................................................ 72
Chromeleon Link Updates .............................................................................................. 73
Autosampler Positions in Chromeleon Entities ................................................................ 73
Using eWorkflows ...................................................................................................... 74
Running Chromeleon in Black Box Mode ....................................................................... 74
Updates to the Chromeleon Mapping – Mapping page ..................................................... 79
Adding all Components ............................................................................................... 81
Page 4 of 128
Electronic Signature Settings in Chromeleon ................................................................. 81

Mapping a Chromeleon Mapping to Multiple Instruments ................................................. 82
Defining the Id of Sample Replicates in a Chromeleon sequence ...................................... 84
Populating Chromeleon Processing Methods with SampleManager Custom Variables ........... 85
Sending Results from Chromeleon to SampleManager .................................................... 87
Changing a Chromeleon Sequence Status to Results Downloaded Manually ....................... 87
Chromeleon Sequence Syntax ..................................................................................... 87
Updates to the Chromeleon Mapping – Batch Standards page.......................................... 87
Data Manager Updates .................................................................................................. 90
Configure System Tracing ........................................................................................... 90
Chromeleon 7 Database Parameters ............................................................................. 91
Capture Source Status ................................................................................................ 91
Packaging 2-D Data from Chromeleon 7.2 ..................................................................... 92
PDF to Text Converter Class ........................................................................................ 93
Chaining of Conversions ............................................................................................. 93
Instrument Converter Help Updates ................................................................................ 94
Corrections ............................................................................................................... 94
FTIR and Mass Spectrometry converters updated to GAML .............................................. 94
ANDI/netCDF (AIA) FTIR............................................................................................. 94
SQC Updates ............................................................................................................... 100
Displaying and viewing charts with a read-only license .................................................. 100
Web Client Updates...................................................................................................... 100
Rich Text Support ..................................................................................................... 100
Updates to VGL libraries and Routines ............................................................................ 101
STD_SOCKET ........................................................................................................... 101
Documentation-specific updates made for SampleManager LIMS 12.2 SP1 .......................... 101
Location Updates ...................................................................................................... 101
Audit Prompts on SQL Databases ................................................................................ 102
SQC Updates - Scheduling an SQC Chart Report to Print or Email ................................... 103
Installation and Upgrade ................................................................................................. 104
Prerequisites ............................................................................................................... 104
Thermo License Server Handshake Error ........................................................................ 104
Restoring Incorrectly Loaded Icons ................................................................................ 105
Microsoft .NET Framework 4.6.2 .................................................................................... 105
Updated Connection String when Upgrading from SampleManager LIMS 12.0 on SQL Server 106
IIS Features Required for SampleManager Web Client ...................................................... 106
Chromeleon Web API ................................................................................................... 108
Page 5 of 128
Upgrading Ad-hoc Reports from SampleManager LIMS 9.2.1 to 11.2 and later..................... 108
Report Designer .......................................................................................................... 108
Upgrades Required for Using Custom C# Code ................................................................ 109
Data Manager Installation ............................................................................................. 109
SampleManager Mobile App .......................................................................................... 109
Cloning Web Client websites ......................................................................................... 109
Fixed Issues .................................................................................................................. 117
Known Issues ................................................................................................................ 127
Database Changes .......................................................................................................... 128
Page 6 of 128
Introduction
Thermo Fisher Scientific is pleased to announce the release of Thermo Scientific™
SampleManager LIMS™ version 12.2 Service Pack 1. The content in this document describes new
and/or revised functionality in this version of the product, as well as supported platform
combinations, fixed issues and known issues.
Please always be sure to check the support site for any updates to this product.
Recent SampleManager Releases

The SampleManager LIMS 12.2 SP1 kit supports upgrades from the following earlier versions:
• SampleManager LIMS 12.1
• SampleManager LIMS 12.1 SP1
• SampleManager LIMS 12.1 SP2
• SampleManager LIMS 12.2
SampleManager 12.1 SP1 SampleManager 12.2
SampleManager 11.2 SP3
SampleManager 12.1 SP2 SampleManager 12.2 SP1
SampleManager 12.1
Page 7 of 128
Hardware Recommendations
The following section contains information on the recommended hardware for SampleManager
LIMS version 12.2. This information remains valid for SampleManager LIMS 12.2 SP1.
Database Server
Refer to your Oracle® Database or Microsoft® SQL Server™ documentation.
Application Server
The SampleManager application server requires the following minimum hardware:
Minimum Specification
CPU Dual-core processor for up to 20 concurrent connections

+ 1 additional core for every 10 additional concurrent connections
RAM 2 GB + 125 MB for each concurrent connection
Hard Disk 1 GB + 200 MB for installation files
To support more concurrent connections, you must add more processor cores and memory to
your application server. For example:
0–20 Concurrent 20–40 Concurrent 40–60 Concurrent

Connections Connections Connections
CPU Dual-core processor Quad-core processor Six-core processor
RAM 8 GB 8 GB 16 GB
Note These requirements are for a SampleManager application server only. If the same machine
is also used as a database server or web client server, you must include additional
resources.
Web Client Server

The SampleManager web client server requires the following minimum hardware:
CPU Dual-core processor for up to 20 concurrent connections

+ 1 additional core for every 10 additional concurrent connections
RAM 4 GB + 200 MB for each concurrent connection
Hard Disk 1 GB + 614 MB for installation files
Page 8 of 128
To support more concurrent connections, you must add more processor cores and memory to
your web client server. For example:
0–20 Concurrent 20–40 Concurrent 40–60 Concurrent

Connections Connections Connections
CPU Dual-core processor Quad-core processor Six-core processor
RAM 8 GB 12 GB 16 GB
Note The web client server is used to host the SampleManager web client software, so that end
users (on web client machines) can access SampleManager using their web browsers.
Desktop Client
The SampleManager desktop client requires the following minimum hardware:
CPU 2.5 GHz processor
RAM 4 GB
Hard Disk 250 MB for installation files
Display 1400 × 1050 or 1440 × 900 resolution with support for Microsoft® DirectX®
Web Client
The SampleManager web client requires the following minimum hardware:
CPU 2.5 GHz processor
RAM 4 GB
Display 1400 × 1050 or 1440 × 900 resolution with support for Microsoft® DirectX®
Note The web client requires only a web browser, that is, you do not need to install any
SampleManager components.
Page 9 of 128
Network Recommendations
The following table contains information on the recommended network latency for
SampleManager LIMS version 12.2. This information remains valid for SampleManager LIMS 12.2
SP1.
Network Path Recommended Latency
Application server to database server Less than 1 ms
Web client server to application server Less than 1 ms
Desktop client to application server Less than 120 ms
Web client to web client server Less than 120 ms
Page 10 of 128
Supported Platforms
The following section contains information on the platforms currently supported for
SampleManager LIMS 12.2 SP1.
Hardware Configurations
Not applicable
Software Configurations
Database
Oracle® 18c
Oracle® 12c
Microsoft® SQL Server™ 2017
Microsoft® SQL Server™ 2016 SP2
SampleManager Application and Web Server OS

Microsoft® Windows® Server 2016
Note SampleManager LIMS 12.2 SP1 was tested using Microsoft Windows Server 2016 Standard
Edition.
Desktop and Web Client OS

Microsoft® Windows® 7 SP1 x64 Professional
Microsoft® Windows® 7 SP1 x32 Professional
Microsoft® Windows® 10 x64 Professional
Note SampleManager LIMS 12.2 SP1 was tested using Microsoft Windows 10 Professional
version 1607.
Microsoft® Windows® 10 x64 Enterprise
Note SampleManager LIMS 12.2 SP1 was tested using Microsoft Windows 10 Enterprise version
1803.
Citrix XenApp® 7.15 (using Citrix Receiver™ for Web)
Web Client Browsers

Microsoft Edge
Google Chrome™
Page 11 of 128
Note We strongly recommend that you use Google Chrome for optimum performance.
SampleManager LIMS 12.2 was tested using Google Chrome versions 75.0 and 77.0.
SampleManager Mobile App

Thermo Scientific™ SampleManager Mobile™ 3.0
SampleManager Web Application Browsers

Microsoft® Internet Explorer® 11.0
Note The SampleManager Web Application is a legacy feature that provides access to a limited
subset of SampleManager functions through the associated SampleManager web site. Due
to the limitations of the operating system and the .NET Framework version used by the
SampleManager web application, only Microsoft® Windows Server® 2008 R2 SP1 is
supported for use as the SampleManager web application server.
Related Thermo Scientific software products

Thermo Scientific™ Integration Manager™ 3.2 SP2
Thermo Scientific™ SampleManager IDI™ 11.1 SP1
Thermo Scientific™ Chromeleon™ Chromatography Data System (CDS) version 7.2.10
Note The features available in the SampleManager LIMS Chromeleon CDS Link functionality
depend on the version of Chromeleon CDS that SampleManager LIMS connects to. For
more information, see Supported Chromeleon CDS Versions (page 12).
Third-Party Software
Microsoft® Hyper-V® 2016
Microsoft® Active Directory® 2016
Microsoft® Office 2016
Microsoft® Office 2013
Microsoft® Office 365®in installed application mode
Amazon Web Services® (using Amazon RDS and hosting the SampleManager application server
and SampleManager Web Server as virtual machines)
Supported Chromeleon CDS Versions

The features available in the SampleManager LIMS Chromeleon CDS Link functionality depend on
the version of Chromeleon CDS that SampleManager LIMS connects to. For more information
about Chromeleon Link features, see the "Chromeleon Link" chapter in the SampleManager LIMS
Configuration Guide. For more information about configuring the User Mode connection between
SampleManager and Chromeleon CDS, see the "Installing Chromeleon Link" chapter in the
SampleManager LIMS Installation Guide.
The following table shows which features are available when SampleManager LIMS 12.2 SP1
connects to different versions of Chromeleon CDS through the Chromeleon Link:
 Feature is available with this version of Chromeleon CDS
Page 12 of 128
* Feature is available with this version of Chromeleon CDS. The corresponding SampleManager
Chromeleon Interface component must be installed on the Chromeleon CDS server.
Feature Chromeleon CDS Version
7.2 SR5 7.2.6 7.2.8 7.2.9 7.2.10
In SampleManager, create a Chromeleon     

sequence with a specified instrument
method and processing method. Send the
sequence to Chromeleon CDS, where you
can review the sequence and add it to an
instrument queue.
In SampleManager, create a Chromeleon     

sequence with a specified eWorkflow. Send
the sequence to Chromeleon CDS, where
you can review the sequence and add it to
an instrument queue.
In SampleManager, add additional samples  

to an existing sequence by creating a new
sequence with the same name as the target
sequence.
In SampleManager, configure a sequence to  

be automatically added to the queue after
being sent to Chromeleon CDS.
In SampleManager, configure a sequence to  

be automatically started after being sent to
Chromeleon CDS.
In SampleManager, configure the naming     

mechanism for Chromeleon sequences.
In Chromeleon CDS, run an eWorkflow and * * * *

pull samples from a SampleManager batch
sequence.
In Chromeleon CDS, run an eWorkflow and * *

pull samples from SampleManager.
In Chromeleon CDS, create a sequence that *

contains SampleManager test numbers, and
returns results to SampleManager.
In SampleManager, specify injection     

information (such as volume, weight, and
dilution) that will be sent to Chromeleon
CDS.
Page 13 of 128
7.2 SR5 7.2.6 7.2.8 7.2.9 7.2.10
In SampleManager, specify injection 

information (replicate id) that will be sent to
Chromeleon CDS.
In SampleManager, specify standard     

concentration information that will be sent to
Chromeleon CDS.
In SampleManager, configure properties that     

will be sent to Chromeleon CDS as custom
properties of sequences and injections
created from SampleManager data. The
custom properties can be populated with
values pulled from SampleManager batches,
samples, or tests.
In SampleManager, configure properties that  

will be sent to Chromeleon CDS as custom
properties of processing methods. The
custom properties can be populated with
values pulled from SampleManager batches,
samples, or tests.
In SampleManager, map analysis     

components to the corresponding
Chromeleon CDS processing method
components.
In SampleManager, translate the sample     

types in a batch list to the corresponding
Chromeleon CDS injection types.
In SampleManager, create a list of  

associated instruments on a mapping
definition to define all the instruments that
can run a Chromeleon method.
In Chromeleon CDS, use custom variable     

send flags to indicate that results are ready
to transfer to SampleManager.
In Chromeleon CDS, use the injection lock     

flag to indicate that results are ready to
transfer to SampleManager.
In Chromeleon CDS, use 'end point' triggers   

in the Chromeleon Administration console to
indicate that results are ready to transfer to
SampleManager.
Page 14 of 128
7.2 SR5 7.2.6 7.2.8 7.2.9 7.2.10
In SampleManager, manually retrieve     

sequence results from Chromeleon CDS
based on the peak information in
Chromeleon CDS.
In SampleManager, manually retrieve     

sequence results from mapped cells in a
Chromeleon CDS report.
In SampleManager, manually retrieve  

sequence results from mapped cells in a
Chromeleon CDS sequence report specified
in an eWorkflow.
In Chromeleon CDS, manually select a * *

sequence and send its results to
SampleManager.
Use the Download Immediately option to   

automatically send results to
SampleManager when the trigger conditions
set in the Chromeleon Administration
console are met.
Use the SampleManager background to     

automatically retrieve results.
In SampleManager, manually set the  

sequence status to ‘Results Downloaded’ to
complete a sequence after entering missing
results manually.
In Chromeleon CDS, use the Ready Check to * * * *

verify that the current user is allowed to run
the sequence and that the instrument is
ready for use. The user permissions and
instrument status are obtained from
SampleManager.
Connect SampleManager to Chromeleon CDS     

without specifying login details (User Mode
disabled).

with a single Chromeleon CDS user account
for all SampleManager operations (User
Mode enabled, login details supplied during
installation).
Page 15 of 128
7.2 SR5 7.2.6 7.2.8 7.2.9 7.2.10

with individual SampleManager operators
mapped to specific Chromeleon CDS user
accounts (User Mode enabled, Chromeleon
login details stored in SampleManager
personnel records).
In SampleManager, view the status of     

Chromeleon CDS instruments.
In SampleManager, the Chromeleon     

Sequence Report workflow node can retrieve
a sequence report from Chromeleon CDS.
In SampleManager, the Chromeleon     

Injection Report workflow node can retrieve
an injection report from Chromeleon CDS.
Page 16 of 128
Product Enhancements
This product release introduces the new and modified functionality for SampleManager LIMS
version 12.2 SP1.
Functional Area(s)
This release includes a number of enhancement SCRs that have been prioritized in response to
customer requests, and would be used by upgrading SampleManager customers.
SampleManager Explorer and UI

Requirement Description
SCR119693 Update explorer setup so that Global Table Defaults can be used to set
pre-defined columns in explorer folders.
SCR123282 Update explorer style filters to add column headers within the browse
window.
SCR123502 Drag and Drop files to create attachments
SCR123737 Enhancement: update all items on the out-the-box top menu and RMBs
to have an icon
SCR123739 Enhancement: Update QuickLaunch to ignore OBSOLETE master_menu

items
See General SampleManager Updates (page 22) in this document for additional information.
SCR123738 Enhancement: Provide a way to set a skin for an instance and disable
allowing users to change it
See the INSTANCE_SKIN configuration item (page 34) in this document for additional
information.
Page 17 of 128
Chromeleon
See Chromeleon Link Updates (page 73) in this document for additional information.
SCR122177 Chromeleon Link. Enhancement to populate processing method custom

variables.
SCR122518 Chromeleon Link. Populating additional standard Injection parameters

with SampleManager data
SCR122643 Chromeleon Link: Allow Chromeleon mapping definitions to apply to

many instruments
SCR122971 Chromeleon Link: Enhancement to run Chromeleon in Black Box mode
SCR123436 Chromeleon Link. Enhancement request for the Chromeleon Sequence

status to indicate it is complete if 'missing' results are entered manually.
SCR123489 Enhance the SampleManager Chromeleon Addin Send Results

component to handle Sequences that contain SM test numbers, but
where SM doesn't know the sequence or injection URL.
Samples
SCR123372 Enhancement to improve performance when cancelling / completing a

sample on a very large Job (with >9k samples). It currently takes about
two minutes for one sample.
MLPs
See MLP Updates (page 50) in this document for additional information.
SCR115557 Enhancement to MLPs. Would like the result to be rounded before

comparison to match the decimal places specified on the MLP rather
than the analysis component.
Instrument Converter
See Instrument Converter Help Updates (page 94) in this document for additional information.
SCR122353 The converter for ANDI/netCDF Mass Spectrometry should be upgraded

to a GAML converter
Page 18 of 128
Report Designer
See Operator Language Parameter (page 70) in this document for additional information.
SCR123725 Enhancement: Add an Operator Language parameter into Report

Designer
Workflow Nodes
See Workflow Nodes (page 37) in this document for additional information.
SCR122880 The Data Manager workflows should be enhanced to provide better

integration to SampleManager.
SCR123729 Enhancement: allow the email workflow node to be able to send to a

distribution group set up as a 'Mail to Operators' printer
Data Manager
SCR122882 The PDF extraction in Data Manager should be enhanced to provide a

way for values in the file to be entered as result data in SampleManager.
See PDF to Text Converter Class (page 93) in this document for additional information.
SCR122883 Data Manager should have a mechanism to allow chaining of

conversions.
See Chaining of Conversions (page 93) in this document for additional information.
SCR122881 The Data Manager gif creation interface should be enhanced to allow a
report to specify the GAML element.
Page 19 of 128
Laboratory Execution
See Laboratory Execution Updates (page 65) in this document for additional information.
SCR122183 LES. Enhancement for Step Parameter values on the current step to be
displayed on the Introduction section of the same step.
Schedules
See Schedules Updates (page 59) in this document for additional information.
SCR115187 Enhancement to Sample Point Scheduler to be able to log in a new job

for all samples which will be created by the same schedule.
SCR115278 Enhancement to Sample Point Scheduler to allow the user to track which
test schedule was used to log in the sample and test.
SCR122788 Update sample point scheduler to use sample workflows.
SCR123008 Enhancement to add more granular control at the analysis / test

schedule level - active flag and collect holiday flag
Operators
See Operator Updates (page 57) in this document for additional information.
SCR123376 Enhancement to allow personnel record to be marked as ‘always use SM

authentication’ to override any LDAP settings.
Audits
See Audit Updates (page 56) in this document for additional information.
SCR122797 Enhancement request to limit the audit reason prompt to phrase entries
when adding the VALID qualifier to the event_reason field. Currently it
doesn't stop the user editing the text.
Page 20 of 128
Schema
See Schema Updates (page 72) in this document for additional information.
SCR123718 Enhancement: Provide baseline schema XML for the shipped version and
Modules
SCR123732 Enhancement: Provide a visual indicator in the schema editor items that
are in schema only and not yet committed to DB / structure
Data Sources
See Data Source Updates (page 66) in this document for additional information.
SCR123007 Enhancement to serial data sources (client and server) to allow

additional handshake types
Instrument Maintenance Schedules

See Instruments Updates (page 58) in this document for additional information.
SCR123742 Enhancement: Dashboard request for all maintenance schedules /

instruments that are coming up to needing maintenance performing
Security
See Security (page 34) in this document for additional information.
SCR119421 Enhancement request to be able to configure the eSig comment field so

that it becomes mandatory.
SCR123836 Disable the ability to view sensitive information in the Help/About screen
Page 21 of 128
New and Updated Features in

The following sections describe functional changes that will be incorporated into the next issued
version of the SampleManager documentation set. These functional changes arise from
requirements and issue fixes addressed in this project.
General SampleManager Updates
Default Menu Icon

You can specify a default menu item using the DEFAULT_ICON (page 34) configuration item.
In descending order of preference, the icon used for a menu item is set according the following
hierarchy:
• The icon selected on the Display page of the Master Menu property sheet.
• The Action type selected on the Display page of the Master Menu property sheet. The icon is
taken from the MENU_ACTN phrase.
• The default icon set by the DEFAULT_ICON configuration item.
Page 22 of 128
Explorer Folders
Updates have been made to allow Global Table Default settings to be used to set pre-defined
columns, Popup Menu items, Icon Modes and Format Conditions for explorer folders.
A new option is available on the Columns page of the Explorer Folder property sheet:
Override Table Defaults – If selected, you can set the Column Mode and select the Autosize
Columns check box. If cleared, the Column Mode and Autosize Columns prompts are unavailable.
Page 23 of 128
On the General subpage of the Popup Menu page, the Menu procedure and Name prompts have
been switched so that now the Menu Procedure appears first. The Name prompt is automatically
updated when you select a menu procedure.
By default, the settings specified on the Popup Menu page are merged with the table default
settings. To override the default setting, select another option from the PopUp Mode list. Available
options are:
• Merge with Table Defaults – All the settings on the Popup Menu page are merged with
the table default settings. This is the default option.
• Override Table Defaults – Only the settings on the Popup Menu page are used.
• Use Table Defaults – Only the table default settings are used.
Page 24 of 128
By default, the icons specified in the Data Value Icons grid are merged with the table default
settings. To override the default setting, select another option from the Icon Mode list. The Icon
Mode Available options are:
• Merge with Table Defaults – All the settings in the Data Value Icons grid are merged
with the table default settings. This is the default option.
• Override Table Defaults – Only the settings in the Data Value Icons grid are used.
By default, the formatting conditions specified in the Format Conditions grid are merged with the
table default settings. To override the default setting, select another option from the Format Mode
list. Available options are:
• Merge with Table Defaults – All the settings in the Format Conditions grid are merged
with the table default settings. This is the default option.
• Override Table Defaults – Only the settings in the Format Conditions grid are used.
Restoring Default Explorer Folder Columns

A new option is available to let you restore explorer folder columns to their defaults.
To restore the default set of columns for an Explorer folder, right-click the column header row and
select Add/Remove Columns > Show Default Columns.
Page 25 of 128
Quick Launcher – Obsolete Items

Items marked as OBSOLETE are not shown in the Quick Launcher search results.
Values List available for IN Operator

On the Context subpage of the Popup Menu page of an Explorer or Global Table Defaults property
sheet, you can now select multiple values from a drop-down list for the IN Operator.
Drag and Drop Attachments

You can drag and drop files to attach them to SampleManager entities.
Text Notes
After a note is created, you can drag text and images to the lower pane of the Edit Attachments
window to add information to the note. The updated content of the note is saved when you click
OK or Apply on the Edit Attachments window.
File Attachments
 To attach a file or files by dragging them to the main pane of the Edit Attachments window
1. Select a file, multiple files, or a single folder, and drag them into the main pane.
The File Attachments dialog box appears, showing the details of the file. For multiple files,
File Attachment dialog boxes appear sequentially for each file.
2. Check that the information in the dialog box is correct and click OK to attach the file. For
multiple files, if you cancel a File Attachment dialog box, any remaining files in the sequence
are not saved.
Password Encryption – LoginInstanceKey registry Item

The LoginInstanceKey registry item is automatically included with instances of SampleManager
LIMS 12.2 onwards. The LoginInstanceKey lets you determine whether passwords can be copied
between instance databases. By default the value of the LoginInstanceRegistry key is "Default".
To ensure that password encryption is different between instance databases, change the value of
the LoginInstanceKey registry item to an alphanumeric value of your choice.
CAUTION If you change the value of the LoginInstanceKey on an existing system, all
current passwords will stop functioning. The value of the LoginInstanceKey
should only be changed on a new system before any passwords have been set.
Page 26 of 128
Editing Entity Status Changes

You can now edit entity status changes in the workflow_status_event.csv file. You can reconfigure
existing status changes, or define new ones. If you have access, you can also edit entity status
changes in the workflow_status_event table in the SampleManager database.
 To edit entity status changes in the workflow_status_event.csv file
1. From the SampleManager instance Data folder open the workflow_status_event.csv file in a
spreadsheet editor or a text editor.
2. Edit the workflow_status_event.csv file to define the desired status changes. All existing
statuses are given as their single letter abbreviations.
If you edit the CSV file in a spreadsheet editor, edit the content of the appropriate column,
TABLE_NAME, STATUS_FROM, STATUS_TO, or EVENT_TYPE_ID. To add a new status change,
add a new row in the table.
If you edit the CSV file in a text editor, edit the content using the syntax
"TABLE_NAME","STATUS_FROM","STATUS_TO","EVENT_TYPE_ID". To add a new status
change, add a new line in the CSV file.
3. Save and close the workflow_status_event.csv file
4. In SampleManager, from the main menu select, Setup > System > Install Options >
Table Loader.
The Load Database Table from File dialog box appears.
5. Select Use client file.
6. In the File to load data from prompt, click to browse for the updated
workflow_status_event.csv file.
7. In the Table Writing mode prompt, select Overwrite table data with file data, and click
OK.
To use the new entity status changes, create or edit an extended lifecycle workflow.
Running Convert_Table
When you run Convert_table.exe, SampleManager now automatically checks that the correct
indexing is applied to the tables.
Page 27 of 128
General Property Sheet Updates
Jobs
The Jobs property sheet has been updated in the following ways:
• The Template Fields and Internal Fields pages have been combined in a new Property List
page
• There is no Attachments page
• There is a new Parameters page
Job Property Sheet – Property List Page

The Property List page contains a grid showing all of the properties for the job listed in the Global
Table Defaults Folder for the JOB_HEADER table.
The grid is split into two sections:
• Template Properties – shows all of the properties of the job that are selected on the
Template Fields page of the Global Table Defaults Folder for the JOB_HEADER table.
• Properties – shows all of the properties of the job that are not included in the list of template
fields defined by the Global Table Defaults Folder for the JOB_HEADER table.
Page 28 of 128
Job Property Sheet – Parameters Page

The Parameters page shows the parameters associated with the job.
 To add a parameter to a job
1. In the Explorer, right-click a job and select Lab Execution > Add Parameter.
The Job Parameters window appears.
2. Add the required parameter or parameters, and click OK.
Samples
The Samples property sheet has been updated in the following ways:
• The Template Fields and Internal Fields pages have been combined in a new Property List
page
• There is a new Parameters page
Page 29 of 128
Sample Property Sheet – Property List Page

The Property List page contains a grid showing all of the properties for the sample listed in the
Global Table Defaults Folder for the SAMPLE table.
The grid is split into two sections:
• Template Properties – shows all of the properties of the sample that are selected on the
Template Fields page of the Global Table Defaults Folder for the SAMPLE table.
• Properties – shows all of the properties of the sample that are not included in the list of
template fields defined by the Global Table Defaults Folder for the SAMPLE table.
Sample Property Sheet – Parameters Page

The Parameters page shows the parameters associated with the sample.
Page 30 of 128
 To add a parameter to a sample
1. In the Explorer, right-click a sample and select Lab Execution > Add Parameter.
The Sample Parameters window appears.
2. Add the required parameter or parameters, and click OK.
New Configuration Items

The following configuration items are new for this release.
Map-related Configuration Items

MAP_KEY_BING
MAP_KEY_BING stores the API key for Microsoft Bing maps. If no API key is set, by default maps
are shown using Open Street Maps.
Maps are shown on the Mapping page of a location property sheet, and you can also add them to
forms.
Data Type: Text
Default Value:
Alphanumeric values.
Possible Values:
Page 31 of 128
MAP_TILE_URI_OSM
MAP_TILE_URI_OSM is used to specify an alternative tile to use for rendering OpenStreetMap
maps. This option is only available in the SampleManager desktop client.
You must format the tile URI to replace the z, x, and y characters with the numbers 1, 2, and 3,
and also delete $ symbols. For example, the uri
http://www.openptmap.org/tiles/${z}/${x}/${y}.png should be formatted as:
http://www.openptmap.org/tiles/{1}/{2}/{3}.png.
forms.
Data Type: Text
Default Value:
Possible Values:
WEB_CLIENT_REFERER
WEB_CLIENT_REFERER stores the home web address of the company using SampleManager
LIMS. To prevent timeout problems when accessing OpenStreetMap maps, we recommend that
you change the stored address to the home web address of your company.
forms.
Data Type: Text

https://www.thermofisher.com
Default Value:
Possible Values:
WEB_CLIENT_USER_AGENT
WEB_CLIENT_USER_AGENT is used to store the product name and version number. The value
should be entered using the syntax SampleManager/<product-version> <comment>. The
WEB_CLIENT_USER_AGENT configuration item is used to render maps using OpenStreetMap, but
you do not need to update the value from the default value to use OpenStreetMap maps.
forms.
Data Type: Text

SampleManager/{0}
Default Value:
ThermoFisher Scientific
Possible Values:
Page 32 of 128
PDF Convert Configuration Items

PDF Convert configuration items control the resolution and color palette of .pdf reports.
PDFOUT_FORMAT
Sets the default color format of the .pdf report.
Data Type: Routine
Default Value: PNG16M
Possible Values: • PNG16M (24-bit color)

• PNG256 (8-bit color)
• PNG16 (4-bit color)
• PNGGRAY (grayscale)
• PNGMONO (black and white)
PDFOUT_RESX
Sets the default x resolution of the .pdf report.
Data Type: Integer
Default Value: 300
Possible Values: Numeric values
PDFOUT_RESY
Sets the default y resolution of the .pdf report.
Data Type: Integer
Default Value: 300
Possible Values: Numeric values
Page 33 of 128
Explorer
INSTANCE_SKIN
Specifies a skin to use for a specific instance. The new skin is applied when the instance restarts,
and the options to change the skin from the main menu are hidden.
Data Type: Routine
Default Value:
Possible Values: You can browse for an

available skin, or enter a skin
name manually. The skin
name is case sensitive.
DEFAULT_ICON
DEFAULT_ICON is used to set the default icon used for menu items. Icons are specified using the
icon Id. to find the Id of an icon, in the Navigator, select the System Folders cabinet and open the
Icons folder. The icon Id is shown in the Identity column.
For more information, see Default Menu Icon (page 22).
Data Type: Text
Default Value:
Possible Values: Any Icon Id
Security
ESIG_MANDATORY_COMMENT
Specifies that the user cannot close the electronic signature dialog box without entering a
comment.
Data Type: Boolean
Default Value: No
Possible Values: • Yes

• No
Page 34 of 128
SECURE_HELP_ABOUT
SECURE_HELP_ABOUT determines how much information appears in the About SampleManager
window. The About SampleManager window appears when a user selects Help > About
SampleManager from the main menu. The About SampleManager window provides basic
information about the SampleManager instance.
If SECURE_HELP_ABOUT is set to No, the About SampleManager window displays information
about the SampleManager instance. This is the default mode.
If SECURE_LOCK_INFO is set to Yes, the About SampleManager window contains minimal

information.
Page 35 of 128
Data Type: Boolean
Default Value: No
Possible Values: Yes

No
MLPs
MLP_ROUNDING
If MLP_ROUNDING is set to Yes, result values are rounded to the number of decimal places
specified on the MLP before being compared to the MLP. For more information, see MLP Updates
(page 50).
If MLP_ROUNDING is set to No, result values are compared to the MLP without being rounded to
the number of decimal places specified on the MLP. The result remains formatted using the
number of decimal places, number of significant figures, and the rounding base specified in the
associated analysis component.
For example, if the limits are Min=5 and Max=15, then a result value of 4.9 will:
• Return FAIL as the comparison outcome if MLP_ROUNDING is set to No, because the value
"4.9" will be used for the comparison.
• Return PASS as the comparison outcome if MLP_ROUNDING is set to Yes, because the
original value of "4.9" will be rounded to 0 decimal places ("5") before comparison.
Data Type: Boolean
Default Value: Yes
Possible Values:
• Yes
• No
Page 36 of 128
Auditing
AUDIT_VALID_REASON
Allows or disallows the user to enter free text in a prompt audit dialog box. When set to True, the
user must select an item from a list in the prompt audit dialog box and cannot enter free text.
When set to False, the user can either enter free text or can select an item from the list.
Data Type: Boolean
Default Value: False
Possible Values: True

False
Workflow Nodes
New Workflow Nodes

Data Manager Nodes
The Data Manager section contains nodes used to update SampleManager result values using
GAML files, and set links in the DM_GAML entities schema.
The Data Manager section contains the following nodes:

• Enter Sample Results from GAML Node (page 38)
• Enter Test Results from GAML (page 39)
• Link to Entity Node (page 41)
Page 37 of 128
Enter Sample Results from GAML Node

The Enter Sample Results from GAML node copies sample result values from a GAML file to the
specified sample in SampleManager.
In the following example, the Enter Sample Results from GAML node is used to enter results for
each of the data items in a Data Manager data package.
Parameter Description
Sample source table The DM_GAML entity table containing the field used to locate the
sample.
Sample source field The expression used to specify the entity field that will be used to
locate the sample.
To open the Expression Editor, click the Expression Editor button
Analysis source table The DM_GAML entity table containing the field used to locate the
analysis.
Analysis source field The expression used to specify the entity field that will be used to
locate the analysis.
Result name source The DM_GAML entity table containing the field used to locate the
table result name.
Result name source The expression used to specify the entity field that will be used to
field locate the result name.
Result value source The DM_GAML entity table containing the field used to locate the
table result value.
Page 38 of 128
Result value source The expression used to specify the entity field that will be used to
field locate the result value.
Result allow ad-hoc If selected, any analysis components in the GAML file that are not in
the analysis are created in the analysis. Result values are copied to
the new components.
If cleared, result values are not copied if they are associated with
components in the GAML file that are not present in the analysis.
Link GAML If selected, the workflow sets existing links in the DM_GAML entities
schema. If the link already exists in the DM_GAML entities schema
then the existing link is updated, otherwise a new link is created.
If cleared, the workflow does not set any links in the DM_GAML
entities schema.
Enter Test Results from GAML

The Enter Test Results from GAML node copies result values from a GAML file to the specified test
in SampleManager.
In the following example, the Enter Test Results from GAML node is used to enter test results for
each of the data items in a Data Manager data package.
Test source table The DM_GAML entity table containing the field used to locate the
test.
Test source field The expression used to specify the entity field that will be used to
locate the test.
Page 39 of 128
Result name source The DM_GAML entity table containing the field used to locate the
table result name.
Result name source The expression used to specify the entity field that will be used to
field locate the result name.
Result value source The DM_GAML entity table containing the field used to locate the
table result value.
Result value source The expression used to specify the entity field that will be used to
field locate the result value.
Result allow ad-hoc If selected, any analysis components in the GAML file that are not in
the analysis are created in the analysis. Result values are copied to
the new components.
If cleared, result values are not copied if they are associated with
components in the GAML file that are not present in the analysis.
Link GAML If selected, the workflow sets existing links in the DM_GAML entities
schema. If the link already exists in the DM_GAML entities schema
then the existing link is updated, otherwise a new link is created.
If cleared, the workflow does not set any links in the DM_GAML
entities schema.
Page 40 of 128
Link to Entity Node

The Link to Entity node is used to create a link from data from Data Manager GAML files to
SampleManager entity properties. To create the link, SampleManager searches the specified
SampleManager entity table for the DM_GAML entities schema property value Id. If the DM_GAML
entities schema property value does not have the same Id as the SampleManager entity table
field Id you want to link it to, you can use an expression to convert the Id of the property value of
the DM_GAML entities schema.
Page 41 of 128
In the following example, the Link to Entity node is used to create a link between the IdText of
the SAMPLE entity in SampleManager with the LimsId value from each of the
DmGamlExperiments of each of the data items in a Data Manager data package, where the value
of the [LimsId] property is the same as the value of the IdText field in the SAMPLE entity.
Entity The SampleManager entity table containing the field you want to
link to the specified property value in the DM_GAML entities
schema.
Property The field of the SampleManager entity table you want to link to the
specified property value in the DM_GAML entities schema.
Value The DM_GAML entities schema property value to search for in the
SampleManager entity table. You can use an expression to convert
the DM_GAML entities schema property value.
Page 42 of 128
Debug Property Bag Node

The Debug Property Bag node provides a way to see what is in the workflow property bag. The
node displays a message that shows what is currently available in the workflow property bag. If
the contents of the workflow property bag are too large to be displayed in the message, you can
view the full output using the Workflow Spy.
The Debug Property Bag node has no parameters.
Updated Workflow Nodes

Message node
You can use limited html formatting in the expression used to generate messages, however links
are not supported.
The following html tags are supported:
• Bold - text
• Underline - text
• Italic text
• Color (name) - <color=red>text</color>
• Color (RGB values) - <color=10,40,156>text</color>
• Size (points) - <size=30>text</size>
You must place html tags in text strings, or the message will not display correctly. For example, if
you use the following expression in a message:
'Sample'+[IdText]+' logged in for the salad.'
The 'Sample' and [IdText] appear in bold in the message:
Page 43 of 128
Comment node
Due to added html support, the Comment node is highlighted in green in the workflow nodes
tree.
Mail node and Send Mail node

The Mail node and Send Mail node have been updated to let you send email to specified email
addresses or to distribution lists. An Active parameter has also been added to help with
debugging workflows.
Distribution List The distribution list of email addresses to send the mail to. The list
shows the distribution lists as printers, however these are email
printers, not physical printers.
You can use distribution lists to send emails to:
• Single email addresses

• A list of comma delimited email addresses
• Lists of personnel records. The email addresses used are those
specified on the personnel records.
• A list of other distribution lists. You should make sure that
distribution lists are not self referential.
Select a distribution list from the list.
Page 44 of 128
Active If selected, emails are sent to the specified email address or

distribution list when the Mail node is parsed.
If cleared, emails are not sent when the Mail node is parsed. This
option is primarily used for debugging workflows.
New Expression Functions
Alias('', '')
Alias(",") returns a translation of the input value using the latest version of the given alias.
Alias('Name','InputValue')
Where:
• Name is the name of the alias.

• InputValue is the value you want to translate using the alias.
The following example returns the translation of the analysis description using the NewLabTerms
alias.
Alias('NewLabTerms','[Analysis.Description]')
AliasWithContext('', '', '', '')

AliasWithContext(",",",") returns a translation of the input value using the latest version of the
given alias if the context name and value are also present on the alias.
Alias('Name','InputValue','ContextName','ContextValue')
Where:
• Name is the name of the alias.

• InputValue is the value you want to translate using the alias.
• ContextName is the name of the context you want to confirm is present on the alias. This is
the value given in the Context column in the grid on the Aliases page of an Alias. For more
information, see Aliases in the "Data Extraction" chapter in the SampleManager LIMS
Configuration Guide.
• ContextValue is the value of the context you want to confirm is present on the alias. This is
the value given in the Analysis Context column in the grid on the Aliases page of an Alias, and
is only available if you select VERSIONED_ANALYSIS as the Context.
The following example returns the translation of the analysis description using the NewLabTerms
alias if the alias has a VERSIONED_ANALYSIS context with the value C1.
Alias('NewLabTerms','[Analysis.Description]','VERSIONED_ANALYSIS','C1')
Page 45 of 128
GetResultValue('','')
GetResultValue ('','') gets a result value by specifying the test number and result name
('TestNumber', 'ResultName').
GetResultValue('TestNumber', 'ResultName')
Where:
• TestNumber is the number of the test to return the result of

• ResultName is the name of the result to return the value of
The following example gets the value of the "C1" result of the sample selected on test "1".
GetResultValue('1', 'C1')
If the value of C1 is 50.5, the returned value is 50.5.
LIMSML Entity Actions Updates

New LIMSML entity actions have been added to ensure that errors can be returned when an
operator tries to enter results but does not have the required analysis or instrument training
(IGNORE_RESULT_ERRORS). Two others (ANAL_TRAIN_REASON, and INST_TRAIN_REASON) let
users override result entry even if they do not have the required analysis or instrument training.
Sample Result Entry ANAL_TRAIN_REASON

If ANAL_TRAIN_REASON is TRUE, the user can override result entry if they enter a comment,
even if they do not have the required analysis training. If the user enters a comment and
overrides result entry, an incident is created and the reason given is entered in the incident.
This parameter is optional, however the user must have the TRAINING OVERRIDE role to be able
to override result entry.
Sample Result Entry INST_TRAIN_REASON

If INST_TRAIN_REASON is TRUE, the user can override result entry if they enter a comment,
even if they do not have the required instrument training. If the user enters a comment and
overrides result entry, an incident is created and the reason given is entered in the incident.
This parameter is optional, however the user must have the TRAINING OVERRIDE role to be able
to override result entry.
IGNORE_RESULT_ERRORS
If IGNORE_RESULT_ERRORS is TRUE, general result entry errors are ignored.
If IGNORE_RESULT_ERRORS is FALSE, an error appears if there are general result entry errors.
The default value of this parameter is set in $LIMSML_SAMPLE_USER:
GLOBAL CONSTANT LIMSML_SAMPLE_IGNORE_RESULT_ERRORS = "TRUE"
This parameter is optional.
Page 46 of 128
Stock Batches Updates

Stock batches have been updated so that a warning appears if you try to consume more stock
than is currently available. There are new comments boxes available when you consume and
reconcile stock, and these comments are visible on the Current Status page of the Stock Batch
property sheet.
Column Description
Comments Text entered in the Comments field when stock is

consumed or reconciled.
Page 47 of 128
Consuming Stock
 To record the consumption of material from a stock batch
1. In the Explorer, right-click the required stock batch and select Consume Stock.
The Stock Batch – Consume Stock window appears.
2. In the Amount Consumed field, type the amount of the stock batch that you used.
3. If necessary, in the Comment field, enter a comment.
4. Click OK.
SampleManager creates a stock inventory record of type "Consumed" recording the amount
of material you used.
If you enter an amount of stock to consume that exceeds the amount currently available, the
Comment field becomes mandatory. After you enter a comment and click OK, a warning
appears to confirm that you want to consume more stock than is currently available.
To consume the stock, click Yes.
Page 48 of 128
Reconciling the Current Inventory Value with Actual Stock

Batch Quantities
 To set the current quantity of material in a stock batch
1. In the Explorer, right-click the required stock batch and choose Reconcile Stock.
The Stock Batch – Adjust Stock Level window appears.
2. In the Actual Amount field, enter the observed quantity of material in the stock batch.
3. If necessary, in the Comment field, enter a comment.
4. Click OK to update the current amount of the stock batch.

SampleManager creates a stock inventory record containing the actual amount of material
held in the stock batch.
Page 49 of 128
MLP Updates
MLPs have been updated to change the way result values are compared to MLP limits. Now, by
default, result values are rounded to the same number of decimal places as the MLP limit before
being compared. This behavior is controlled by the new configuration item MLP_ROUNDING (page
36).
The Investigate Comparison screen has been updated to show the actual result value compared
to the MLP limit and the number of decimal places it was rounded to.
In the lower pane, the Processed column shows the result value that was actually used for
comparison with the MLP limit. By default, the result value is rounded to the same number of
decimal places as used for the limits in the MLP specification before it is compared against the
MLP limits. This behavior is controlled by the MLP_ROUNDING configuration item. The number of
decimal places the result value was rounded to before comparison with the MLP specification is
given in the Places column.
Page 50 of 128
Mapping Updates
Maps have been updated to use OpenStreetMap by default, but you can also select Bing Maps.
Form Designer - Map Visualization Control

The map control uses Open Street Maps or Microsoft Bing Maps to display an interactive map of a
specific location.
Note Due to properties updates in SampleManager LIMS 12.2, maps created in previous
versions of SampleManager may need to be updated in order to function properly.
New and updated options are available in the Virtual Earth section of the Properties list to
configure map rendering:
Option Description
MapProvider The source of the map to display.
Available options are:
• OpenStreetMap
The use of OpenStreetMap in SampleManager depends on the

WEB_CLIENT_REFERER (page 32) and
WEB_CLIENT_USER_AGENT (page 32) configuration items. Both
configuration items are set to default values. However, for
optimal use of OpenStreetMap, we recommend that you update
the value of the WEB_CLIENT_REFERER configuration item to
the home web address of your company.
You can use alternative tiles for OpenStreetMap by specifying a

tile URI in the MAP_TILE_URI_OSM (page 32) configuration
item.
Page 51 of 128
Option Description
• BingMaps
You need a key from Microsoft in order to use Bing Maps. Enter
the key into the MAP_KEY_BING (page 31) configuration item. If
no key is available, by default maps are displayed using Open
Street Maps.
OSMMapStyle The style of Open Street Map to display. This control is only
available if you select OpenStreetMap as the map provider.
• Basic
• CycleMap
• Hot
• Grayscale
• Transport
Location Property Sheet - Mapping Page

The Location property sheet has a new page, displaying the physical position of a location.
The Mapping page lets you set the precise position of the location on a map.
By default maps are rendered using OpenStreetMap. The use of OpenStreetMap in
SampleManager depends on the WEB_CLIENT_REFERER (page 32) and
WEB_CLIENT_USER_AGENT (page 32) configuration items. Both configuration items are set to
default values. However, for optimal use of OpenStreetMap, we recommend that you update the
value of the WEB_CLIENT_REFERER configuration item to the base web address of your company.
You can use an alternative tile for OpenStreetMaps by specifying a tile URI in the
MAP_TILE_URI_OSM (page 32) configuration item.
You can also render maps using Microsoft Bing maps. In order to use Microsoft Bing maps you
must:
• Enter the Microsoft Bing API key in the MAP_KEY_BING (page 31) configuration item.
• Select Bing Maps as the map provider on the mapping page of the Location form.
Page 52 of 128
You can enter a longitude and latitude value for the location, or search for a location in the search
panel.
To edit the location information, click .
Control Description
Longitude The longitude value of the location.
Latitude The latitude value of the location.
To toggle the search panel, click .
 To search for a geographical location using the search panel
1. In the Find prompt, enter a geographical location in the Find prompt and click .
A list of available geographical locations appears in the Location grid under the Find prompt.
Select a geographical location from the list.
2. The map image and the address information in the Result Info area at the bottom of the
search panel update.
Page 53 of 128
Data Extraction Updates
Importing SampleManager Instrument Manager XML files

You can import SampleManager Instrument Manager (IM) XML files as parsing scripts.
 To import SampleManager IM XML files
1. On the Parser page of the Parsing Script property sheet, right-click in the Commands area and
select Import SMIM XML File. You can only import a SampleManager IM XML file into an
empty parsing script. If there are any nodes currently in the Commands area, the Import
SMIM XML File menu option is unavailable.
A browse window appears.
2. Select the desired SampleManager IM XML file and click Open.

You can only import one SampleManager IM XML file into each parsing script. If a SampleManager
IM XML file has been imported into the parsing script, the Import SMIM XML File menu option is
unavailable.
Alias Default Values

The Aliases page of the Alias property sheet has been updated with new controls that let you
specify a default value to use if the evaluation of the alias is unsuccessful.
Page 54 of 128
Control Description
Use Default If selected, the alias uses the specified default value if the
translation is unsuccessful. The default value is given as the
translation result.
If cleared, no default value is used if the translation is

unsuccessful.
Default Value The default value to use if the translation is unsuccessful. To use
the default value you must select the Use Default check box.
Parsing script html support

Due to added html support, the nodes in a parsing script appear differently in the node tree.
Comments are highlighted in green, and arguments appear in bold.
Page 55 of 128
Electronic Signature Updates

A new option is available on the Layout page of the Configure Electronic Signatures window that
lets you require a user to enter a comment before they can close the Electronic Signature dialog
box.
To force the user to enter a comment before they can close an electronic signature dialog box,
select the Esig mandatory comment check box. This value is stored in the
ESIG_MANDATORY_COMMENT (page 34) configuration item.
Audit Updates
A new configuration item, AUDIT_VALID_REASON is available, which allows you to specify the
nature of user input in a prompt audit dialog box.
• If the AUDIT_VALID_REASON configuration item is set to TRUE, the user can only select
an item from a list. The items in the list are determined by the AUDIT_TEXT phrase.
• If the AUDIT_VALID_REASON configuration item is set to FALSE, the user can either select
an item from a list or can enter free text.
Page 56 of 128
Operator Updates
The Operator property sheet has been updated to include the option to always use
SampleManager authentication to override any LDAP settings.
Field Description
Force Native If selected, SampleManager authentication always overrides any

existing LDAP settings.
If cleared, Any LDAP settings override SampleManager

authentication.
Page 57 of 128
Instruments Updates
Instrument Maintenance Dashboard

The Instrument Maintenance dashboard provides convenient access to the instrument
maintenance functions in SampleManager.
To access the Instrument Maintenance dashboard, in the Navigator panel, open the Laboratory
Setup Folders cabinet and select the Instrument Maintenance Dashboard folder.
The Instrument Maintenance dashboard has two grids:
• Instrument - Displays a list of instruments that have a status of Maintenance Due, Requires
Calibration, Requires Servicing, or Unavailable
• Instrument Part - Displays a list of instrument parts that have a status of Maintenance Due,
Out of Calibration, Out of Service, or unavailable
Page 58 of 128
Maintenance Overview Dashboard

The Maintenance Overview dashboard provides convenient access to the general, instrument and
instrument part maintenance functions in SampleManager.
To access the Maintenance Overview dashboard, in the Navigator panel, open the Laboratory
Setup Folders cabinet and select the Maintenance Dashboard folder.
The Maintenance Overview dashboard has a Maintenance grid that displays maintenance items
that have a status of Required Maintenance or In Maintenance.
Schedules Updates
Control of the scheduling of individual analyses

The Sampling Points page of the Schedules property sheet has been updated to provide more
control over the scheduling of individual analyses and test schedules on each sample point.
Page 59 of 128
The Analyses and Test Schedules grids now contain Active, Collect Downtime and Collect Holiday
options.
The Analyses child grid contains the following additional columns:
Column Description
Active If the Active check box is selected, the schedule point analysis is
active, and tests will be assigned to the sample.
The Active check box can be used to temporarily suspend the

testing of samples for a specific schedule point analysis in a
schedule.
Collect Downtime If the Collect Downtime check box is selected, tests will be assigned
to the sample for this schedule point analysis during Site Shutdown
periods defined in the calendar linked to the schedule.
Collect Public Holiday If the Collect Public Holiday check box is selected, tests will be
assigned to the sample for this schedule point analysis during
Holiday periods defined in the calendar linked to the schedule.
Page 60 of 128
The Test Schedules child grid contains the following additional columns:
Column Description
Active If the Active check box is selected, the schedule point test schedule
is active, and tests will be assigned to the sample.
The Active check box can be used to temporarily suspend the

testing of samples for a specific schedule point test schedule in a
schedule.
Collect Downtime If the Collect Downtime check box is selected, tests will be assigned
to the sample, as determined by the schedule point test schedule,
during Site Shutdown periods defined in the calendar linked to the
schedule.
Collect Public Holiday If the Collect Public Holiday check box is selected, tests will be
assigned to the sample, as determined by the schedule point test
schedule, during Public Holiday periods defined in the calendar
linked to the schedule.
Page 61 of 128
Logging in Jobs and Samples Using a Schedule

The Control page of the Schedule property sheet has been updated to include prompts for a job
template or workflow, criteria and filter. Depending on whether you have selected to log in a job
using a template or a workflow, you can log in the samples using templates or workflows on the
Sampling Points page of the Schedule property sheet.
Control Description
Workflow Login If selected, you can log in jobs and samples using workflows.
If cleared, you can log in jobs and samples using templates.
Job Workflow The workflow to use to create a new job for the samples created
by the schedule.
This option is available if the Workflow Login option is selected.
Job Template The job template to use to create a new job for the samples
created by the schedule.
This option is available if the Workflow Login option is cleared.
Page 62 of 128
Control Description
Job Criteria The criteria used to define the collection of jobs to select an
existing job from. You can use the Job Filter prompt to select a
specific job.
By default, the criteria used is the Job default schedule login,

which excludes jobs with a status of Authorized, Rejected,
Canceled, and Suspended, and orders the jobs by the date they
were created.
Job Filter The filter used to select an existing job from the collection of jobs
defined by the job criteria.
By default, the filter used is GetDate( [DateToStart] ) ==

GetDate( ClientNow() ), which finds a job created on the day of
processing.
The JOB_HEADER table has two new fields
Field Description
Schedule The identity of the schedule used to log in the

job.
Schedule Group The identity of the schedule group used to log in

the job.
Page 63 of 128
The Sampling Points page shows the schedule points that are included in the schedule, and the
schedule point.
The schedule points, schedule point analyses, and schedule point test schedules are displayed in
a master-detail grid. The top level grid shows details of the schedule points assigned to the
schedule. If the Workflow Login option on the Control page is cleared, the Sample Template
column is available.
If the Workflow Login option on the Control page is selected, the Sample Workflow column is
available.
Page 64 of 128
A new Schedule column shows the schedule associated with the schedule points.
Column Description
Sample Point The identity of the sample point associated with the schedule
point.
Schedule The schedule associated with the schedule point. You cannot
change the associated schedule.
Test Schedules Recorded During Sample Login

During sample login using a schedule, the associated test schedule is now recorded to the sample
and test records:
• Sample record - The Test schedule associated with the sample point (if one is specified)
is copied to the sample record from the schedule point.
• Test record – The test schedule used to create the test (if one is specified), is copied to
the test record from the schedule point analysis.
Laboratory Execution Updates

A new parameter property has been added, Refresh Instructions, that lets you force the step
instructions to refresh if the parameter values changes.
Control Description
Refresh Instructions If selected, if you change the parameter value, the step instructions
refresh to use the new parameter value.
If cleared, if you change the parameter value, the step instructions
remain the same and are not refreshed.
Note Date-time variables are refreshed when the step is refreshed,

however date-time parameter values are not refreshed.
This update also has consequences for updating variables on lab execution steps. Variables are
now re-evaluated when the step is modified.
Page 65 of 128
When a user starts the step, the placeholder is replaced with the evaluated expression. If the step
is revisited, the placeholder is re-evaluated. If a placeholder expression cannot be evaluated, the
placeholder name is displayed.
If you are using date-time information and do not want it to be reevaluated if the step is
modified, we recommend you place the information in a parameter. Date-time parameter values
are not re-evaluated if the step is modified.
Data Source Updates

The serial data source has been updated to support additional handshake types.
Control Description
DTR If selected, SampleManager reads Data Terminal Ready signals

from the equipment.
If cleared, SampleManager does not read Data Terminal Ready
signals from the equipment.
Handshake Type The handshaking protocol used by the equipment.

• None
• Request to Send (RTS)
• Request to Send (RTS) and XOn/XOff
• XOn/XOff
Page 66 of 128
Control Description
RTS If selected, SampleManager reads Ready to Send signals from the

equipment.
If cleared, SampleManager does not read Ready to Send signals
from the equipment.
Ad Hoc Reports – Web Client

If you produce a report using the SampleManager web client, you can only export the report as a
CSV file. File formatting information is not used.
Report Designer Updates
Importing PageHeader and PageFooter from the master

template.
If a master report template is used that defines the PageHeader band and/or PageFooter band,
the PageHeader and/or PageFooter bands do not appear in the Report Designer.
Exporting modular reports as .repx files

Reports have been updated to let you export modular reports as a single .repx file, which can
then be imported as a report template.
When a modular report is exported as a .repx file, it is dissociated from the table name, so when
you import a .repx file you will be asked to specify a table name to associate with the report
template. The table name given must match the original table name of the exported modular
report in order for the bindings to work.
Page 67 of 128
You can export a modular report as a .repx file from the Report Definition page of the Modular
Report property sheet.
To export the modular report as a single .repx file, click Save as repx. The .repx file contains the
full C# definition of the modular report. You can open the .repx file in a text editor.
You can also now export report layout headers as .repx files from the Configuration page of the
Report Layout Header property sheet.
Page 68 of 128
Control Description
Export as .repx Let’s you export the report header as a .repx file. The .repx file
contains the full C# definition of the report header. You can open a
.repx file in a text editor.
Expressions
The following expression functions are now available in the Report Designer:
• String functions
o Inc()
o IncPadded()
o Increment(‘’, ‘’)
o IncrementPadded(‘’, ‘’, )
• Date-time functions
o FormatDateDefault()
o ClientNow()
• All functions
o Alias(‘’, ‘’)
o AliasWithContext(‘’, ‘’, ‘’, ‘’)
o CollectionCount()
o CollectionMax()
o CollectionMin()
o CollectionSum()
o GetCurrentCSVString()
o GetCurrentParameterValue(‘’)
o GetCurrentSequenceSlotValue(‘’)
o GetCurrentStepParameterFormattedValue(‘’)
o GetCurrentStepParameterValue(‘’)
o GetCurrentStepVariableValue(‘’)
o GetEntity(‘’, ‘’, ‘’)
o GetEntities (‘’, ‘’, ‘’)
o GetEntityFromCollection(,)
o GetFolder(‘’)
o GetParamtereValue(, ‘’)
o GetResultValue(‘’, ‘’)
o GetStep(‘’, ‘’)
o GetStepCount(‘’)
Page 69 of 128
o GetStepParameter(‘’, ‘’)
o GetStepParameterFormattedValue(‘’, ‘’)
o GetStepParameterFormattedValues(‘’, ‘’)
o GetStepParameterValue(‘’, ‘’)
o GetStepParameters(‘’, ‘’)
o GetStepVariable(‘’, ‘’)
o GetStepVariableValue(‘’, ‘’)
o GetValue(‘’, ‘’)
o Guid()
o HasPrivilege()
o HasRole(‘’)
o RegexMatch(‘’, ‘’)
o RegexReplace(‘’, ‘’, ‘’)
o WorkflowValue()
Operator Language Parameter

A new parameter, paramOperatorLanguage, is available in the Field List of the report designer.
Labels
Measurement units
The available measurement units have been updated to the following units:
• Pixels
• Hundredths of an inch
• Tenths of a Millimeter
Label Orientation
To print landscape labels on portrait label stock, you must rotate the label and any other required
objects by 90 or 270 degrees.
 To rotate a label in Report designer
1. In the Designer area select the label.
2. In the Properties area, click the Behavior properties button.
3. In the Angle property enter 90 or 270, depending on the precise orientation you require.
Page 70 of 128
 To rotate a barcode on a label
1. In the Designer area, select the barcode.
2. In the Properties area, click the Behavior properties button.
3. From the Orientation list, select the required barcode orientation.
Page 71 of 128
Schema Updates
Uncommitted changes to the schema tree are highlighted in orange. Uncommitted changes are
only shown on the live schema object. To refresh the live schema, you must run
CreateEntityDefinition.
SCHEMA_ Tables
The SCHEMA_ tables are a set of tables in the SampleManager database that store records that
represent the structure of the SampleManager database. The records are created from
structure.txt by the CreateEntityDefinition tool.
If you use the Schema Layout property sheet to update the records in the SCHEMA_ tables,
SampleManager automatically updates the structure.txt file for the instance to match your
changes.
Default SCHEMA_ table CSV files are now provided in the installation kit. Following installation,
the CSV files are located in the ..\<version_number>\Data folder and follow the naming
convention default_<version_number>_schema_<table_name>.csv.
Where:
• <version_number> is the current version of SampleManager.

• <table_name> is the name of the SCHEMA_table.
You can use the default SCHEMA_ table CSV files to help you identify custom table fields in your
existing database structure.
Page 72 of 128
Chromeleon Link Updates
Autosampler Positions in Chromeleon Entities

The Instrument Mapping page of the Chromeleon Entity now has a read-only column showing the
available autosampler positions
To update the valid autosampler positions visible in the Autosampler Positions column, select Get
Autosampler Positions and click Update Autosampler Positions.
Column Description
Autosampler The valid autosampler positions in the

Positions Chromeleon CDS instrument.
Page 73 of 128
Using eWorkflows
Chromeleon Link has been updated to only overwrite injection properties if expressions are
specified. On the Sequence Creation page of the Chromeleon Mapping property sheet, the
Injection Volume prompt default value has been changed to 0 and the description of the prompt
has been updated in the documentation:
Field Description
Injection Volume The default volume for each injection in the sequence. By default,
the injection volume is 0.
This setting is unavailable when the Workflow Mapping option is

selected on the Mapping page. To use the injection volume value
from an eWorkflow, the Injection Volume value must be 0. Any
value other than 0 will overwrite the eWorkflow specified values.
Running Chromeleon in Black Box Mode

Chromeleon Link has been updated to let you run sequences in black box mode. Running
Chromeleon in black box mode means that a sequence can be sent to Chromeleon, queued, run
on the associated instrument, and the results sent back to SampleManager without needing to
Open Chromeleon.
To allow this there are some additional options on the Sequence Creation page of the Chromeleon
Mapping property sheet.
Page 74 of 128
Field Description
Operator Chooses If selected, the user can choose whether to queue or run the
sequence when the sequence is created.
If cleared, the Queue Sequence and Run Sequence options are

used as selected on this page, and the user cannot change them
when the sequence is created.
Queue Sequence If selected, the sequence is automatically queued.
If cleared, the sequence is not queued.
This option is used to run Chromeleon in black box mode.
Run Sequence If selected, the sequence runs automatically if the instrument

available and ready check passes. The sequence only runs if it is
the only sequence in the queue. If there are other sequences in
the queue then the sequence is added to the queue.
If cleared, the sequence does not run automatically.
This option is only available if Queue Sequence is selected. This

option is used to run Chromeleon in black box mode.
Page 75 of 128
Field Description
Allow User to Ignore If selected, all warnings will be ignored when if the user retries
Warnings on Retry creating the sequence. However, errors will stop the process.
If cleared, warnings will be displayed if the user retries creating

the sequence.
Running Chromeleon in black box mode has the following logical sequence:
To run Chromeleon in black box mode, you must configure various items in SampleManager and
Chromeleon.
 To configure SampleManager to allow Chromeleon to run in black box mode
1. Make sure that the SampleManager Chromeleon Interface is installed. Without the
interface, results cannot be automatically sent back to SampleManager from Chromeleon.
During the installation process, on the Interface Components dialog box, make sure that
the Sequence Ready to Send to LIMS option is selected. The Sequence Ready to Send to
LIMS option is selected by default. For more information, see "Installing Chromeleon Link
Components" in the SampleManager Installation Guide.
2. On the Definition page of the Personnel property sheet (page 78) of the operator running
the sequence, enter a Chromeleon username and password. For more information, see
"Security" in the SampleManager System Administration Guide.
3. On the Sequence Creation page of the Chromeleon Mapping property sheet, select the
Queue Sequence and Run Sequence options. You must select Queue Sequence to make
the Run Sequence option available.
A sequence runs if it is the only sequence in the queue, otherwise the sequence is queued.
Page 76 of 128
4. On the Send Flags page of the Chromeleon Mapping property sheet, select Configure for
Chromeleon and the Download Immediately option.
 To configure Chromeleon to allow Chromeleon to run in black box mode
1. Click the Windows Start button.
2. Open the list of applications and select Thermo Chromeleon 7 > Administration
Console.
3. Expand Organizational Units and Global. (only required if Organizational Units are enabled)
4. Select User Database > Electronic Signature tab.
5. From the A sequence will be ready for LIMS transfer list, select "when an electronic report
is saved".
 To run a sequence on Chromeleon in black box mode
1. Log in a sample and a test. Make sure that the test on the sample uses the same analysis
as the analysis on the Chromeleon Mapping.
2. In the Explorer, right-click the test and select Create Chromeleon Sequence.
The Create Chromeleon Sequence from Tests window appears.
3. Select Create Sequence.

The Create Chromeleon Sequence window appears.
4. Select Update Chromeleon.
5. The Create Sequence dialog box appears to indicate that the sequence has been created
successfully.
6. If the instrument ready check fails, an error message appears.
To retry running the sequence, click Yes. To abort the run, click No. If you abort the run,
the sequence is still created in Chromeleon, but will have to be queued or run manually in
Chromeleon.
If the Instrument ready check passes, the sequence runs in Chromeleon.
The results will be available in SampleManager when the sequence has finished running in
Chromeleon.
Page 77 of 128
Personnel – Definition Page

The Chromeleon username and password information has been relocated to the Definition page of
the Personnel property sheet.
Field Description
Username Username for the operator in Chromeleon CDS. The Chromeleon

Link functionality uses the Chromeleon Username to make
Chromeleon API calls with the correct user information.
For more information, see the "Chromeleon Link" chapter in the

SampleManager LIMS Configuration Guide.
Password Set If checked, the Chromeleon CDS password is set. This check box is
read-only.
Page 78 of 128
 To set a Chromeleon CDS password for an operator
1. Click Set Chromeleon Password.

The Please enter password dialog box appears.
2. Enter a password and click OK.
3. The Confirm dialog box appears.
4. Re-enter the same password and click OK.

If the passwords match, the Password set message appears.
If the passwords do not match, the Invalid password message appears.
5. Click OK.
If the password was invalid, click Set Chromeleon Password to repeat the process.
To reset the password, you can click Set Chromeleon Password at any time.
Updates to the Chromeleon Mapping – Mapping page

Taking results from Chromeleon Reports
The Chromeleon report options have also been relocated from the Result Mapping page to the
Mapping page of the Chromeleon mapping property sheet.
Page 79 of 128
Control Description
Template Folder The folder containing the report template to use.
Select a folder from the list. If there are no folders

available, click Connect to refresh the list.
Report The report template to use to create the report.
Add to Sequence If selected, the report is added to the sequence.
Report from eWorkflow Use the report from the eWorkflow specified on the Mapping
page.
You can use an Excel-style formula to extract a value from a cell in the report by entering a
formula in the Result Mapping section on the Result Mapping page of the Chromeleon Mapping
property sheet. If you enter an Excel-style formula, you must either:
• Specify a report manually, in the Chromeleon Report area of the Result Mapping page.
or
• Select the Workflow Mapping option and select an eWorkflow that contains a report.
If you do not specify a report manually when using an eWorkflow, the Chromeleon Web
API attempts to find the default report on the sequence at the time of processing. If the
Chromeleon Web API fails to find the default report, the evaluation of the Excel-style
formula will fail.
Additional details will be available in the Chromeleon Web API log in the Chromeleon Web API
program folder.
eWorkflow Filter
A new option is available to let you filter the available eWorkflows
Control Description
The filter used to limit the eWorkflows available for the

eWorkflow Filter
Workflow Mapping option. If you leave this option blank, all
eWorkflows are loaded if you select the Workflow Mapping
option. If this process takes longer than 10 seconds, a
message appears suggesting that you use a filter.
You can use a wildcard to filter the eWorkflows:
• Ben*4 - Loads all eWorkflows that start with Ben and

end with 4.
• Benzene - Loads all eWorkflows that contain the word
Benzene.
Page 80 of 128
Adding all Components

A new option is available on the Result Mapping page of the Chromeleon Mapping property sheet
that lets you add all components from an analysis.
To add all the components from the SampleManager LIMS analysis, click Add All Components.
Electronic Signature Settings in Chromeleon

On the Electronic Signature tab of the Chromeleon Administration Console, a new option is
available that lets you determine that the sequence is ready for LIMS transfer when an electronic
report is saved.
Page 81 of 128
Mapping a Chromeleon Mapping to Multiple Instruments

You can now map a single Chromeleon mapping to multiple instruments.
On the General page of the Chromeleon Mapping, you can select a primary instrument.
Field Description
Primary Instrument The preferred SampleManager LIMS instrument.
The browse list contains the SampleManager LIMS instruments

listed on the Instrument Mapping page of the Chromeleon entity.
You can specify additional instruments on the Associated

Instruments page (page 83).
Page 82 of 128
Chromeleon Mapping – Associated Instruments Page

The Associated Instruments page defines additional instruments that can be used to run the
analysis. The instruments specified on the Associated Instruments page are used if the primary
instrument specified on the General page is unavailable.
When the user creates a sequence, they can select the instrument they would like to use.
Field Description
Filter using Primary If selected, the list of available Chromeleon instruments is limited to
Instrument those with the same category as the primary instrument specified
on the General page.
If cleared, the list of available Chromeleon instruments contains all

the instruments listed on the Instrument Mapping page of the
Chromeleon entity.
Chromeleon The SampleManager LIMS instrument associated with the

Instrument Chromeleon mapping.
The browse list contains the SampleManager LIMS instruments

listed on the Instrument Mapping page of the Chromeleon entity.
Instrument Name The name of the Chromeleon instrument.
Page 83 of 128
Field Description
Instrument The description of the Chromeleon instrument.

Description
If you use an associated instrument on one Chromeleon mapping as the primary instrument for
another Chromeleon mapping, conflicts can occur. If this happens, an error message appears.
Defining the Id of Sample Replicates in a Chromeleon

sequence
A new expression prompt is available on the Sequence Creation page of the Chromeleon Mapping
property sheet that lets you define the Id of sample replicates.
Field Description
Replicate Id The expression used to define the Id of sample replicates. To open

Expression
the Expression Editor, click the Expression Editor button .
This value will overwrite any default values specified in an

associated eWorkflow.
Page 84 of 128
Populating Chromeleon Processing Methods with

SampleManager Custom Variables
A new Standard Properties page is available on the Chromeleon Mapping property sheet.
Chromeleon Mapping – Standard Properties Page

The Standard Properties page lets you populate the Chromeleon component table in Chromeleon
processing methods with data from custom variables associated with the sample, test, or batch in
SampleManager. These variables could contain additional measurements, administrative data
such as the operator name, or information relating to the processing method elements.
If any of the conditions cannot be evaluated an error will appear when you try to run the
Chromeleon sequence.
Page 85 of 128
The Standard Properties grid contains the following columns:
Column Description
Table Name The name of the table to add the custom variable to. Available
options are:
Sample
Test
Batch Header
Batch Entry
Condition The expression used to specify the conditions under which to create
the custom variable. The context of the expression is the
Chromeleon CDS sequence entry.
For example, if you use the expression GetParameterValue(

[TestNumber] , 'FlagName')==True, the custom variable will be
created if the FlagName parameter value is True.
Component Name The expression used to specify the component of the Chromeleon
CDS processing method to add the custom variable to. The context
of the expression is the table tame.
Custom Variable The expression used to specify the name of the custom variable.
Name The context of the expression is the table tame.
Custom Variable The expression used to specify the value of the custom variable.
Value The context of the expression is the table tame.
Page 86 of 128
Sending Results from Chromeleon to SampleManager

SampleManager has been updated to let you send sequence results to SampleManager when the
sequence was created in Chromeleon.
 To send sequence results to SampleManager LIMS from Chromeleon CDS when the sequence has been
created in Chromeleon CDS
1. In Chromeleon CDs, create a custom variable (page 85) on the injections called LIMS
Test Number.
2. In the injections grid, enter the SampleManager test number in the LIMS Test Number
column for each injection.
3. Right-click and choose Send Results to SampleManager. If the results are uploaded to
SampleManager LIMS successfully, a success message appears. Otherwise, an error
message appears.
You can also send results to SampleManager LIMS using the SampleManager Chromeleon
Interface.
The sequence is created in SampleManager LIMS.
Changing a Chromeleon Sequence Status to Results

Downloaded Manually
If all results have a status of Results Downloaded, the Chromeleon sequence is automatically set
to status Results Downloaded.
However, you can change the status of a Chromeleon sequence to Results Downloaded manually.
This might be useful if some results in a sequence are entered manually.
 To change the status of a Chromeleon sequence to Results Downloaded
1. In the Explorer, right-click a sequence in the Explorer and choose Process > Results
Downloaded. The Complete dialog box appears.
2. To change the status of the sequence to Results Downloaded, click OK.
Chromeleon Sequence Syntax

Sequence name syntaxes must include a table name. If you do not include a table name, the
Chromeleon sequence syntax fails, and an error message is displayed. The standard table name
to include in the sequence name syntax is CHROMELEON_MAPPING.
Updates to the Chromeleon Mapping – Batch Standards page

The Chromeleon Mapping Standards page has been updated and renamed as the Batch Standards
page.
The Batch Standards page lets you map the component concentration levels of standards in
SampleManager LIMS to processing methods in Chromeleon CDS using the standard version
specified in the batch. The concentration levels in Chromeleon CDS are equivalent to the
component concentrations of a standard version in SampleManager LIMS. You can map
Page 87 of 128
SampleManager LIMS component concentrations to either of the following items in Chromeleon

CDS:
• Concentration levels in the mapped processing method

• Concentration levels in the processing methods referenced by an eWorkflow
If a test is identified as a standard, and Translate Types on the Sequence Creation page is
selected, the injection is flagged with an appropriate type, and the concentration level is set when
the sequence is created. The concentration level is taken from the Chromeleon Mapping property
sheet. This page has the following sections:
• Batch Standard Levels grid – Maps components in the SampleManager LIMS analysis to a
SampleManager standard and to the Chromeleon CDS concentration level.
• Component Mapping grid – Maps component names in SampleManager LIMS to component

names in Chromeleon CDS. Use this grid when the component name in SampleManager LIMS
is different to the corresponding component name in Chromeleon CDS. If the component
name is the same in both systems, the component is mapped automatically.
• Standard Concentrations – Lets you update the Chromeleon CDS processing method with the
standard concentration amounts.
You must establish a connection to the Chromeleon server to complete the settings on this page.
If the Connect button is visible, the connection between SampleManager LIMS and the
Chromeleon Link Web API is not established. To establish a connection using the settings on the
Connection page of the Chromeleon entity, click Connect.
To update the values available in the prompts, click Refresh to reconnect to the Chromeleon CDS.
To update the component concentrations in the processing method to match the values of the
batch standard version when the sequence is created, select the Update Chromeleon with
selected Batch Standard Version check box.
Page 88 of 128
The Batch Standard Levels grid contains the following columns:
Column Description
Standard The SampleManager LIMS standard used to map the component

concentration to the Chromeleon CDS concentration level.
This column is read-only.
Concentration Level The Chromeleon CDS concentration level to map to the standard
component concentration.
Page 89 of 128
The Component Mapping grid contains component mapping information for the standard that is
selected in the Batch Standard Levels grid. This grid contains the following columns:
Column Description
Component Name The name of the component in the SampleManager LIMS standard.
Chromeleon Name The name of the component in Chromeleon CDS.
Data Manager Updates
Configure System Tracing

All references to GRAMS Converter and Component Tracing have been removed.
Page 90 of 128
Chromeleon 7 Database Parameters

All references to the SAMPLE_NAME database parameter have been removed.
The description of the ONE_GAML_PER_SAMPLE database parameter has been updated to reflect
this change:
ONE_GAML_PER_SAMPLE When set to FALSE (the default), this parameter

instructs the converter to create a single GAML file for
each sequence containing all of the samples in the
specified sequence.
When set to TRUE, this parameter instructs the

converter to create a separate GAML file for each
sample in the specified sequence.
Capture Source Status

The Data Manager Capture Source Status has been updated to provide a mechanism to refresh
the form, and to update the navigation information to open the form.
To view the most recent capture source activity, from the main menu, select Data Manager >
Monitoring > Capture Source Status. The most recent capture source activity appears in the
Capture Source Status grid at the bottom of the Data Manager Explorer page.
To refresh all the information shown in the form, click Refresh Now.
 To refresh all the information shown in the form at regular intervals
1. Select Auto Refresh (sec).
2. Set the refresh interval (in seconds) in the prompt to the right of the Auto Refresh (sec)
check box.
Page 91 of 128
Packaging 2-D Data from Chromeleon 7.2

This topic has been updated to reflect an update to the process of manual packaging of 2-D data
from Chromeleon 7.2.
 To manually package 2-D data from Chromeleon 7.2

1. From the Explorer, right-click the packaging rule to be used for the packaging process and
select Package Now.
2. The Login to Chromeleon dialog box appears.
3. Enter the user name and password, and click Connect to connect to Chromeleon CDS.
The Chromeleon to GAML Convert Selection dialog box appears.
4. Right-click DataSource to view a context menu of display and selection options.
5. Select the check boxes beside the samples or sequences that you want to convert, and click
Convert.
Page 92 of 128
PDF to Text Converter Class

A new PDF to Text converter class has been added.
Converter Class Converter Name Supported Methods Data Types
PDF to Text Not Used Filepath, Default, Creates a text file from
Regular Expression the contents of a PDF
file, then extracts
contents from text files.
Chaining of Conversions
Data Manager has been updated to let users chain conversions in a sequence. This is configured
on the Definition page of the Data Manager packaging rule property sheet. Users can also
override the Store neutral file option on the Definition page that is applied to the entire packaging
rule
The Converters grid on that page has been updated to include two additional columns, Sequence
and Store Neutral.
Field Description
Sequence The position of the conversion in a sequence of conversions given

as a number, where the output files of one conversion in the
sequence are used as the input files for the following conversion.
Sequence numbers are given in the form n.y, where n represents
the sequence, and y represents the position in the sequence.
In the screenshot above, the conversions are run in sequence in the

following order:
1. Pdf to Text – creating a text file (Sequence 1.1)
2. Transformation – from text to XML (Sequence 1.2)
3. Transformation – from XML to XML (Sequence 1.3)
Page 93 of 128
Field Description
Store Neutral Can be used to overwrite the Store neutral file option on the
Definition page.
If the Store neutral file option is selected, you can enter FALSE in
the Store Neutral column to override the option. The neutral file for
the conversion will not be saved.
If the Store neutral file option is cleared, you can enter TRUE in the
Store Neutral column to override the option. The neutral file for the
conversion will be saved.
For more information, see the Store neutral file option on the
Definition page.
Instrument Converter Help Updates
Corrections
The following topics were updated to correct all references to the file extension .pm to .prn.
• ASCII XY (Variable X Spacing) [GAML]
• ASCII XY (Linear Spacing) [GAML]
The same was also done for the ASCII XY (High Precision X) topic, which has been renamed
ASCII XY (High Precision X) [GAML]
FTIR and Mass Spectrometry converters updated to GAML

The converter for the ANDI/netCDF Mass Spectrometry and FTIR has been upgraded to a GAML
converter. The associated topics have been updated accordingly, and associated GAML
parameters topics have been created.
ANDI/netCDF (AIA) FTIR

This section describes the ANDI/netCDF (AIA) FTIR data file format.
• Converter Name – AIA_FTIR
• Files/Extensions – *.CDF
• Software – netCDF v4.0.1.0 (Unidata)
This converter supports import of data files in the ANDI/netCDF FTIR Data Interchange format
(formerly known as "AIA Format"). The ANDI FTIR format is supported by a few FTIR instrument
software products from Bio-Rad and Mattson. Most FTIR software packages support either the
JCAMP or the GRAMS SPC format for data interchange, so the ANDI FTIR format is not widely
used.
Page 94 of 128
Currently, the ANDI FTIR Data Interchange format is under the control of the ASTM Standards
E13.15 subcommittee on Analytical Data. However, because there are already other data
interchange standards in wide use for FTIR data, it is unlikely that the ANDI format will be
approved as an ASTM standard. For more information, see the ASTM International web site at
www.astm.org http://www.astm.org/.
All translators for the ANDI FTIR format are based on the public-domain netCDF software engine
provided and maintained by Unidata. For more information, see
http://www.unidata.ucar.edu/software/netcdf/. This converter uses V4.0.1.0 of the netCDF
software to read and write ANDI FTIR data files.
AnDI / netCDF (AIA) FTIR – Input Files

The converter takes AIA/ANDI Mass Spectrometry files (*.cdf or *.nc) as input and generates a
single GAML file for each input file.
Output GAML File Structure

The output GAML document from this converter consists of the following elements. Boldface
annotations are not part of the GAML file.
<GAML>
<parameter>...<parameter>
<experiment>
<collectdate>
<trace>
<Xdata>
<Ydata>
Each input file corresponds to one output GAML file, with one experiment and one trace. There
are no facilities for combining multiple source files into a single GAML document.
Refer to a list of parameters (page 95) that can be found in the GAML output file of the AIA_FTIR
converter. These parameters can be used to create mapping rules in Data Manager.
ANDI/netCDF (AIA) FTIR – GAML Parameters

This section lists the parameters that are found in the GAML file output of the AIA_FTIR (page 94)
file converter.
The tables list name and label attributes. The "Name" attribute is used to describe the parameter
as it relates to the original data system software. Often this parameter is the name of the variable
in the programmer's documentation for the software or the relevant name of the parameter in the
file itself (for example, in the case of parameters already stored in ASCII files).
The "Label" attribute is used to assign an additional text string that describes the parameter.
The <parameter> element can also have an optional "Group" attribute. This attribute is intended
to identify a parameter as belonging to a particular collection of parameters that exist in the
same level in the GAML document hierarchy. This attribute is especially useful in complex
instrument control systems, such as Chromatography or NMR, where there are a large number of
parameters related to making a measurement.
Page 95 of 128
Like "Group", "Alias" is an optional field that is used to provide a consistent name for items that
are common across instrument formats (for example, "Operator" and "SampleName").
Note There are some AIA specifications for AIA GC/MS and FTIR data,
but because there are few mandatory elements there are few pre-
determined GAML parameters. The converter reads the ASCII
sections of the file and writes the data as parameters.
GAML Parameters
Parameters set in the GAML object contain information about the data conversion process.
Group: Data Conversion

Hierarchy Level: <GAML>
Name Label
converter_name Converter name
converter_description Converter description
converter_version Converter version
conversion_date Conversion date
converter_input_source Converter input source
converter_output_file Converter output file
Experiment Parameters
Group: <see table>

Hierarchy Level: <experiment>
Note: Elements and values found in the following table
will be added to the Experiment parameters.
Name Experiment parameters group
Global Global Attributes
Variable Data
Variable Metadata Variable Metadata
Page 96 of 128
ANDI/netCDF (AIA) Mass Spectrometry

This section describes the ANDI/netCDF (AIA) FTIR Mass Spectrometry data file format.
• Converter Name – AIA_MS
• Files/Extensions – *.CDF
• Software – netCDF v4.0.1.0 (Unidata)
This converter supports import of data files in the ANDI/netCDF Mass Spectrometry Data
Interchange format, formerly known as "AIA Format". The ANDI format is supported by many
mass spectrometer and third-party software packages. Most commercial mass spectrometry
software products permit export to the ANDI format for interchange of data files between
different data processing systems.
The Analytical Data Interchange format for Mass Spectroscopy (ANDI-MS) is under the control of
the ASTM E13.15 subcommittee on Analytical Data. The ANDI Mass Spectrometry format is
specified in the ASTM E1947 standard. For more information, visit the ASTM International web
site at http://www.astm.org/.
All translators for the ANDI Mass Spectrometry format are based on the public-domain netCDF
software engine provided and maintained by Unidata. For more information, see
http://www.unidata.ucar.edu/software/netcdf/. This converter uses V4.0.1.0 of the netCDF
software to read and write ANDI Mass Spectrometry data files.
This converter supports import of measured mass spectrometry data sets only. Import of ANDI
Mass Spectrometry Library files is not supported.
The converter takes as input AIA/ANDI Mass Spectrometry files (*.cdf or *.nc) and generates a
AnDI / netCDF (AIA) Mass Spectrometry – Additional Information for

GRAMS Product Users
While importing ANDI files to the GRAMS SPC format, the converter reads certain sample and
data source information, when available in the ANDI file, into the SPC file Audit Log. The ANDI file
sample/source information starts after the AIA_info_begin line and ends with a AIA_info_end line.
Note When an SPC file imported from the ANDI Mass Spectrometry
format is processed, the information might not carry into the
modified files.
If the ANDI data file has sufficient data to extract a Total Ion Chromatogram (TIC), then a
GRAMS chromatogram file (CGM) with the same base name as the GRAMS SPC file containing all
the mass spectra is created. When the TIC data is not present or when a conversion error occurs
during TIC import, the converter continues to import the mass spectra and does not report any
errors, because the presence of TIC data in an ANDI Mass Spectrometry file is optional. When TIC
data is found and imported, the converter requires valid TIC data fields; the information in the
experiment type is ignored. As a result, for some implementations of the ANDI Mass
Spectrometry format, the converter may incorrectly create a CGM file of TIC data when none is
present, or not create the CGM file when the TIC data is present.
Page 97 of 128
AnDI / netCDF (AIA) Mass Spectrometry – Input Files

The converter takes AIA/ANDI Mass Spectrometry files (*.cdf or *.nc) as input and generates a
Output GAML File Structure

The output GAML document from this converter consists of the following elements. Boldface
annotations are not part of the GAML file.
<GAML>
<experiment>...<experiment>
<collectdate>
<trace> [CHROM trace]
<Xdata>
<Ydata>
<peaktable>
<peak>
<peak>...
<peaktable>
<peak>
<peak>...
<trace> [MS trace]
<Xdata>
<Ydata>
<peaktable>
<peak>
<peak>...
<peaktable>
<peak>
<peak>...
Each input file corresponds to one output GAML file, with one experiment and one trace. There
are no facilities for combining multiple source files into a single GAML document.
Refer to a list of parameters (page 98) that can be found in the GAML output file of the AIA_FTIR
converter. These parameters can be used to create mapping rules in Data Manager.
ANDI/netCDF (AIA) Mass Spectrometry – GAML Parameters

This section lists the parameters that are found in the GAML file output of the AIA_MS (page 97)
file converter.
The tables list name and label attributes. The "Name" attribute is used to describe the parameter
as it relates to the original data system software. Often this parameter is the name of the variable
in the programmer's documentation for the software or the relevant name of the parameter in the
file itself (for example, in the case of parameters already stored in ASCII files).
The "Label" attribute is used to assign an additional text string that describes the parameter.
The <parameter> element can also have an optional "Group" attribute. This attribute is intended
to identify a parameter as belonging to a particular collection of parameters that exist in the
same level in the GAML document hierarchy. This attribute is especially useful in complex
instrument control systems, such as Chromatography or NMR, where there are a large number of
parameters related to making a measurement.
Page 98 of 128
Like "Group", "Alias" is an optional field that is used to provide a consistent name for items that
are common across instrument formats (for example, "Operator" and "SampleName").
Note There are some AIA specifications for AIA GC/MS and FTIR data,
but because there are few mandatory elements there are few pre-
determined GAML parameters. The converter reads the ASCII
sections of the file and writes the data as parameters.
GAML Parameters
Parameters set in the GAML object contain information about the data conversion process.
Group: Data Conversion

Hierarchy Level: <GAML>
Name Label
converter_name Converter name
converter_description Converter description
converter_version Converter version
conversion_date Conversion date
converter_input_source Converter input source
converter_output_file Converter output file
Experiment Parameters
Group: <see table>

Hierarchy Level: <experiment>
Note: Elements and values found in the following table
will be added to the Experiment parameters.
Name Experiment parameters group
Global Global Attributes
Variable Data
Variable Metadata Variable Metadata
Page 99 of 128
Trace Parameters
Group:
Hierarchy Level: <trace>
Name Label
time_values_units Time values units
time_values_scale_factor Time values scale factor
total_intensity_units Total intensity units
total_intensity_scale_factor Total intensity scale factor
SQC Updates
Displaying and viewing charts with a read-only license

Users can now display and view SQC charts if they have a read-only license.
Web Client Updates
Rich Text Support

The SampleManager web client now supports rich text.
Page 100 of 128

Updates to VGL libraries and Routines
STD_SOCKET
There is a new routine available in the STD_SOCKET library, socket_text_mode
socket_text_mode
Syntax
socket_text_mode ( required_mode )
Description
This routine in the STD_SOCKET standard library changes the format of the messages read from
and written to sockets.
Available formats are:
• ANSI
• UNICODE
By default, messages are read from and written to sockets using UNICODE.
Documentation-specific updates made for

The following sections describe corrections made to the documentation that either provide
improvements to the clarity of existing text, or correct previous documentation oversights. The
changes described in this section were not made due to any functional changes of the software
during this project.
Location Updates
Location Property Sheet Properties Page
In the “Locations, Sample Points, and Schedules” chapter of the SampleManager Reference
Guide, additional instructions are provided that explain how to display the Properties page on the
Location property sheet.
 To show the Properties page on the Locations property sheet by adding properties to the entity template
1. From the main menu, select Setup > System > Explore Table Defaults.
2. In the Explorer, open the Locations global table defaults folder.
3. On the Template Fields page, select the required properties that you want to appear on the
Properties page of the location.
4. To close the Locations global table defaults property sheet, click OK.
5. From the main menu, select Setup > Login > Entity Templates > Add.
Page 101 of 128

6. On the General page, in the Name prompt enter a name, and from the Table Name list select
LOCATION.
7. On the Properties page, add one or more properties and in the Property column in the grid,
select the desired property.
The available properties are those selected on the Template Fields page of the Locations
global table defaults folder.
8. To close the entity template property sheet, click OK.
9. From the main menu, select Setup > Environment > Location Types > Add.
10. On the General page, in the Name prompt enter a name.
11. On the Definition page, from the Entity Template list, select the entity template defined in
steps 5-8.
12. To close the entity template property sheet, click OK.
13. From the main menu, select Setup > Environment > Location > Add.
14. On the General page, from the Location Type list, select the location type defined in steps 9-
12.
The Properties page appears on the Location property sheet.
Audit Prompts on SQL Databases

In the “Auditing” chapter of the SampleManager System Administration Guide, an update was
made to make users aware of how to deal with the locking of tables with associated audit
prompts.
If an audit prompt is left open, the associated table is locked. Therefore, if audit prompts are
configured on heavily used tables, such as SAMPLES or RESULTS, we recommend that you
configure the committed snapshot settings to allow snapshot isolation.
For example, to enable snapshot isolation, you can execute the following SQL:
ALTER DATABASE MyDatabase
SET ALLOW_SNAPSHOT_ISOLATION ON
ALTER DATABASE MyDatabase

SET READ_COMMITTED_SNAPSHOT ON
Page 102 of 128

SQC Updates - Scheduling an SQC Chart Report to Print or

Email
In the “SQC in SampleManager” chapter of the SQC User Guide, references to the following task
parameters were removed:
• emailto
• reportattached
• Printqueue
The emailing and printing of reports is configured on the Scheduling page of the SQC Chart
Editor.
Page 103 of 128

Installation and Upgrade

Installation and upgrade instructions for SampleManager can be found in the SampleManager
LIMS Installation Guide, in the Docs folder of your installation kit:
..\SampleManager 12.2 SP1\Docs
Further information, specific to SampleManager LIMS 12.2 SP1, is given below.
Prerequisites
Before you install SampleManager, make sure you have installed all the updates for the Windows
operating system on your server. If the Update for Universal C Runtime (2999226) is not
installed, the SampleManager installation will fail.
Thermo License Server Handshake Error

If you upgrade the license server, the license server may fail to deploy the licenses correctly and
a bad handshake error appears. To restore the license server, you must uninstall the license
server, delete additional files in the Thermo Licensing Server folder, and re-install the license
server.
 To restore the license server using the Windows Uninstall or Change a Program window
1. To uninstall the Thermo Licensing Server, use the Windows Uninstall or change a program
window.
2. In a Windows Explorer, open the Thermo Licensing Server folder and make a backup copy of
the .lic license file.
3. In the Thermo Licensing Server folder, delete all files except the .lic license file.
4. To install the Thermo Licensing Server, in a Windows Explorer, open the SampleManager
LIMS 12.2.1 License folder and double-click the ThermoLicensingServerSetup.exe file.
The Installation Wizard appears.
5. To install the Thermo Licensing Server, follow the installation instructions on the installation
wizard.
The license server should now deploy correctly.
If the problem is not resolved by restoring the license server using the Windows Uninstall or
Change a Program window, you must restore the license server using
ThermoLicensingServerSetup.exe.
Page 104 of 128

 To restore the license server using ThermoLicensingServerSetup.exe
1. In a Windows Explorer, open the SampleManager LIMS 12.2.1 License folder, double-click
ThermoLicensingServerSetup.exe.
2. To uninstall the Thermo Licensing Server, follow the uninstallation instructions on the
installation wizard.
3. In a Windows Explorer, open the Thermo Licensing Server folder and make a backup copy of
the .lic license file.
4. In the Thermo Licensing Server folder, delete all files except the .lic license file.
5. To install the Thermo Licensing Server, in a Windows Explorer, open the SampleManager
LIMS 12.2.1 License folder and double-click the ThermoLicensingServerSetup.exe file.
6. To install the Thermo Licensing Server, follow the installation instructions on the installation
wizard.
Restoring Incorrectly Loaded Icons

If icons are not loading properly, check for any incorrect DLLs in the Solution Assemblies folder.
 To restore incorrectly loaded icons
1. Open the Solution Assemblies folder of your SampleManager instance Exe folder.
2. Delete any incorrect .dll files.
3. Open SampleManager and from the main menu select Setup > System > Server
Management.
The Client Server Management window appears.
4. In the Structure section, select Create Structure/Entity Definitions and click Execute.
Microsoft .NET Framework 4.6.2

SampleManager LIMS 12.2 SP1 requires Microsoft .NET Framework 4.6.2. If the correct version of
the .NET Framework is not installed, the SampleManager Server installation process will fail.
The installer for the required version of the .NET Framework is included in the following folder of
the SampleManager installation kit:
..\SampleManager 12.2 SP1\Server\Redistributables
Page 105 of 128

Updated Connection String when Upgrading from

SampleManager LIMS 12.0 on SQL Server
If you are upgrading a SampleManager LIMS 12.0 instance that connects to a SQL Server
database, make sure that the connection string that the SampleManager application server uses
to connect to the database specifies the SQL Server Native Client provider, not SQLOLEDB. Verify
that the connection string uses the correct provider before you start the upgrade process. If you
start the upgrade process with a connection string that uses the SQLOLEDB provider, the upgrade
will fail. The connection string for a SampleManager instance is stored in the
smp$ado_connection_string value of the following registry key:
COMPUTER\HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\LabSystems\SampleManager
Server\<instance_name>
Where <instance_name> is the name of your SampleManager instance.
The connection string for a SampleManager LIMS 12.0 instance with a SQL Server might specify
the Provider as SQLOLEDB. For example:
Provider=SQLOLEDB;Server=UKALT-TESTSERV7;Database=VGSM;User Id=VGSM;Password=VGSM;MARS
Connection=true;
The SQLOLEDB provider no longer works. Edit your connection string in the registry to use the
SQL Server Native Client provider, e.g. SQLNCLI11. For example:
Provider=SQLNCLI11;Server=UKALT-TESTSERV7;Database=VGSM;User Id=VGSM;Password=VGSM;MARS
Connection=true;
Note If the connection string value in the registry has been encrypted, enter a new plain text
value in the registry and encrypt it after the upgrade process is complete, using the tool
provided in SampleManager. For detailed instructions, see the "Post-Installation Tasks"
chapter in the SampleManager LIMS Installation Guide.
IIS Features Required for SampleManager Web Client

There are two possible mechanisms for installing the SampleManager web client:
• If you want the SampleManager installer to install and configure Internet Information
Services (IIS) for you, run the following file in the SampleManager installation kit:
..\SampleManager 12.2 SP1\Web\WebClient_Setup.exe
• If you want to use a custom configuration for IIS, or if IIS is already installed on your server,
run the following file in the SampleManager installation kit:
..\SampleManager 12.2 SP1\Web\SampleManagerWebInstaller.msi
Page 106 of 128

The SampleManager web client requires the following IIS features:
• Web Server (IIS)
• Web Server
• Common HTTP Features
• Default Document
• Directory Browsing
• HTTP Errors
• Static Content
• HTTP Redirection
• Health and Diagnostics
• HTTP Logging
• Performance
• Static Content Compression
• Dynamic Content Compression
• Security
• Request Filtering
• IP and Domain Restrictions
• Windows Authentication
• Application Development
• .NET Extensibility 4.6
• ASP.NET 4.6
• ISAPI Extensions
• ISAPI Filters
• WebSocket Protocol
• Management Tools
• IIS Management Console
Page 107 of 128

Chromeleon Web API

Both Chromeleon CDS and the Chromeleon Web API have a User Mode configuration setting,
which can be enabled or disabled during installation. If the User Mode settings are different for
Chromeleon CDS and the Chromeleon Web API, the Chromeleon Web API can crash when it
attempts to connect to Chromeleon CDS.
To prevent crashes, the Chromeleon Web API service has been updated to check whether its User
Mode setting matches the User Mode setting for Chromeleon CDS. If the two User Modes do not
match, the service stops and adds an error to the Windows Event Log.
To resolve the problem, make the User Mode settings match. In Chromeleon CDS, the User Mode
setting is available in the Chromeleon Administration Console. To change the User Mode setting in
the Chromeleon Web API, repeat the installation.
Upgrading Ad-hoc Reports from SampleManager LIMS

9.2.1 to 11.2 and later
Using an ad-hoc report in SampleManager LIMS 11.2 and later that was created in
SampleManager LIMS 9.2.1 gives the error "Internal failure - variable_read". To use the ad-hoc
reports you must migrate the criteria cache by running the following processes:
1. $AFL $CONVERT_REPORTER
2. GRL $CONVERT_REPORTER
Report Designer
SampleManager Report Designer now supports the use of expressions for binding controls to data
and applying conditional formatting.
You can use expression binding to:
• Applying conditional formatting to controls
• Create summary results
• Create controls that contain more than one property value
Expression binding is the default mechanism that is used by all report designs created from
SampleManager LIMS 12.1 SP2 onwards.
You can convert report designs that use the legacy data binding mechanism to use the new
expression binding mechanism. Before you convert your report designs, back up the .repx report
design files in the smp$textfiles folder of your SampleManager instance. There is no mechanism
to convert a report design from expression bindings to data bindings.
To convert a report design to use the expression binding mechanism, open the report design in
the Report Designer. The following message appears:
The XtraReport contains bindings. Do you want to convert them to expressions?
Click Yes to convert the report design to use expressions, or No to retain the original data
bindings.
Page 108 of 128

Upgrades Required for Using Custom C# Code

If you want to customize your SampleManager functionality using custom C# code, you must
make sure that you have the latest version of Microsoft Visual studio installed. The C# compiler
must be version 6.0 or later.
Data Manager Installation

$DM_INSTALL is run automatically as part of the SampleManager installation process. There is no
longer any need to run it independently. However you can still run it if required.
SampleManager Mobile App

The SampleManager Mobile app is available from app stores and is released independently of
SampleManager LIMS.
Cloning Web Client websites

You can clone web client websites of the same version of SampleManager that was initially
installed. The cloned website can use a different port and location, and can be configured to
access any SampleManager instance of the same version.
To clone a web client website, you must:
1. Create a new website folder.
2. Delete the connections.config file and instance folders from the App_Data, Help, and Sandbox
folders of the cloned website.
3. Create a new application pool in the Windows Internet Information Service (IIS) Manager.
4. Create a new website in the Windows Internet Information Service (IIS) Manager.
5. Configure the new website, test and synchronize files on the Server Setup window.
 To create the new website folder
1. In a Windows explorer, navigate to the folder containing the SampleManager instance. By

default, the folder is C:\inetpub\SampleManager.
2. Create a copy the folder of the SampleManager version you are using and rename the new
folder with an appropriate name.
Page 109 of 128

 To delete the connections.config file and instance folders
1. In a Windows explorer, navigate to the folder C:\inetpub\SampleManager\<new

website>\App_Data. Where <new website> is the name of the new website.
2. Delete the connections.config file and the instance folders.
3. In a Windows explorer, navigate to the following folders and delete the instance folders,
where <old instance name> is the name of the original SampleManager instance:
• Help – C:\inetpub\SampleManager\<new website>\Help\<old instance name>
• Sandbox – C:\inetpub\SampleManager\<new website>\Sandbox\<old instance name>
 To create the new application pool
1. From the Windows administrative tools, open Internet Information Services (IIS) Manager.
The Internet Information Service (IIS) Manager window appears.
2. In the Connections tree on the left of the window, expand the tree until you see the
Application Pools folder.
3. Select the Application Pools folder and in the Application Pools grid, right-click and select Add
Application Pool.
4. The Add Application Pool dialog box appears.
5. In the Name prompt, enter a name for the website.
6. Make sure that the .NET CLR version is version 4 and click OK.
7. The new application pool appears in the Application Pools grid.
Page 110 of 128

8. Right-click the new application pool and select Advanced Settings.

The Advanced Settings window appears.
9. In the Process Model section, select the Identity prompt and click the ellipsis button.
The Application Pool Identity dialog box appears.
10. From the Built-in account list, select NetworkService and click OK.
Page 111 of 128

11. In the Recycling section, select the Specific Times prompt and click the ellipsis button.
The TimeSpan Collection Editor dialog box appears.
12. To add a new timespan, click Add.
13. To close the Timespan Collection Editor dialog box, click OK.
14. To close the Advanced Settings window, click OK.
 To create the new website in the Windows Internet Information Service (IIS) Manager
1. In the Connections tree on the left of the Internet Information Service (IIS) Manager window,
right-click the Sites folder and select Add Website.
The Add Website window appears.
2. In the Site name prompt, enter the name of the new instance.
Page 112 of 128

3. Click Select.
The Select Application Pool dialog box appears.
4. From the Application pool list, select the application pool created in steps 1-14 and click OK.
5. On the Add Website window, click the ellipsis button next to the Physical path prompt.
A browse window appears.
6. Locate and select the website folder created in steps 1-4 and click OK.
7. In the Port prompt, enter the port number you want to use.
8. To close the Add Website window and create the new instance, click OK.
 To configure the new website and synchronize files
1. In a web browser, open the new website.

The SampleManager login dialog box appears.
Page 113 of 128

2. To configure the server settings, click .

The Server Setup window appears.
3. Click Authenticate to Modify.
4. The Server Credentials dialog box appears.
5. Enter your username and password in the appropriate prompts and click Accept.
Note Make sure that the values entered on the Add New
Connection dialog box are for a user that has administrative
privileges, or that has write access to the new website
folder and all the subfolders.
Page 114 of 128

6. New options appear on the Server Setup window.
7. To add a new server, click Add.
8. The Add New Connection dialog box appears.
9. Enter values for the Name, Server Address, Port, and Instance prompts and click Accept to
close the Add New Connection dialog box.
The new connections.config file is created and the server appears on the Server Setup dialog
box.
10. To test the connection and make sure the details are valid, click Test.
When the testing is complete a dialog box appears.
11. If the test is successful, click OK to close the dialog box.

If the test is unsuccessful, click OK to close the dialog box, check the connection values and
test the connection again.
12. To synchronize the data with the server, click Synchronize.

The synchronization progress is shown in the Connection Synchronization Progress dialog
box.
Page 115 of 128

13. When synchronization is complete, click OK to close the Connection Synchronization Progress
dialog box.
The Tested and Synchronized values of the server change to True.
14. To close the Server Setup dialog box, click Close Server Setup.
Page 116 of 128

Fixed Issues
The following table details the software issues that have been corrected in this product release.
Issue ID Summary
SCR115190 The new sample point scheduler logs samples for removed schedules.
SCR115312 Nested test schedules don't work with the sample point scheduler.
SCR115456 Error cancelling or authorising multiple tests from the same sample, one
after another.
SCR116005 Right clicking on a sample and selecting Write Sample Report does not pass
sample Id through
SCR116117 Explorer RMB Popup Context issue. The value for Context is stored in the
database differently to the value expected by the function.
SCR116151 The hyperlink to the Thermo website on the SampleManager Help About
screen no longer works.
SCR116550 Training Course field Type incorrectly links to phrase ATT_TYPE after adding
attachment tab to the form.
SCR117250 Sample Point Scheduler should take account of the Test Schedule 'Std Test'
setting.
SCR117766 GRAMS Conversion of an SPC file to GAML created empty peak table if there
are no peaks.
SCR117774 The GRAMS ASCII with Header converter does not handle the comment
properly.
SCR118798 Ctrl+A on samples, tests or results in the explorer grid causes a crash.
SCR119536 Service Monitor - No Scroll Bar
SCR119602 CTRL F find in the explorer grid produces different results if a custom
column is displayed.
SCR119722 Pressing "Set as Default" with no Servers listed causes a crash.
SCR120035 Workflows with reporting nodes crash after upgrade to 11.2 because Report
Templates are now versioned.
SCR120057 Flickering text observed while entering text in a Prompt for Text box.
Page 117 of 128

SCR120257 Explorer folder grouping by date. On the 1st of the month the user sees a
folder displaying samples created that day in a folder named for the next
month.
SCR120312 Phrase dropdown gives error: 'The ID you specified does not exist' when
selecting items with PHRASE_TEXT over 30 chars.
SCR120375 Recalculating message when trying to authorize when

RESULT_AUTHORISE_RECALC is set to yes.
SCR120453 Running a report designer report using a menu option, will cause the client
to hang if you preview the report for 3 minutes due to a messaging issue.
SCR120737 Data changes made outside the current client session are not always
reflected in Explorer upon performing a refresh
SCR120756 Explorer Search. After doing “Ctrl+F” the value is only highlighted in yellow.
It should be yellow and filtered to the selection.
SCR120812 Explorer Pre-defined columns. If the first field is from a linked table, the
system crashes when using Find. Also Sorting and Filtering do not work.
SCR121057 Workflow Job Login. Test Data Tab, the Std column shows a checkbox for
first row, but for all rows below, the text 'True' is displayed instead.
SCR121141 Analysis form. A new Inspection plan is not validated when added at the
prompt, it needs to be selected from the dropdown list.
SCR121157 Web Client. Cancelling out of any of the 'Add' options, 'Do you want to
abandon your changes?' message is displayed with [OK] and [Cancel]
buttons instead of [Yes] and [No] buttons.
SCR121158 Web Client. Web: There is no way to 'find' records on a forms browse
screen.
SCR121171 Web Client. Explorer column filters for added columns don't populate with
potential values. The only options displayed are (All), (Non blanks) and
(Blanks).
SCR121173 Web Client. LES Import SOP doesn't copy highlighted text into steps.
SCR121174 Web Client. LES Import SOP bullet points display differently to the imported
document.
SCR121175 Web Client. LES Add Parameter does not copy text.
SCR121178 Web Client. Explorer filters. Edit filter - values get blanked out when moving
off the date field.
SCR121179 Web Client. Adhoc Report Templates do not work on the Web.
SCR121182 Web Client. LES parameters - units column is always displayed.
Page 118 of 128

SCR121191 Web Client. Remove Add and Modify RMB options for Report Templates.
SCR121197 Web Client. Explorer Filters. Blank or Non Blank filter options for some
standard columns like Id Numeric do not work.
SCR121207 Web Client. LES Reports display information differently to desktop client.
SCR121224 Web Client. Grid contents are displayed / filtered randomly when adding an
extra column to the grid.
SCR121225 Web Client. The 'Custom' filtering option in column headers is not available.
SCR121239 Result entry display error with read only license.
SCR121391 Workflow. When using 'generate report' or 'save as pdf' through workflows,
temporary files are created and never get removed. That is causing disk
space issues.
SCR121421 Explorer Modify Folder. After selecting a Menu Procedure, the name defined
above it in the form gets overwritten.
SCR121429 FormatDate in Report Designer doesn't appear until used in the Expression
Editor first.
SCR121570 When an operator doesn't have the training for the analysis or instrument,
or the instrument status is unavailable, LIMSML and PUT_TEST_RESULTS
don't save the results but look successful.
SCR121571 Report Templates. Application freezes after opening the report preview
window and waiting for over 3 minutes before closing. Duplicate of
SCR120453.
SCR121573 Web Client. Incorrect entity opens when sorting by modified on and new
entry added.
SCR121621 Web Client. Properties menu option not available for RMB Lab Execution
Tasks | Lab Methods.
SCR121710 The map control (Virtual Earth, using DevEvpress / MS Bing Maps) in both
the desktop and web clients has stopped working due to deprecated
services from Microsoft.
SCR121711 Explorer. After applying a filter, the sort order is defaulted to Ascending.
SCR121726 Web Client. Home page explorer grid resize flicker.
SCR121827 Workflow node "Create Test by Formula" has the wrong entity as the base
type. It has Sample instead of Test properties for use with Set Property
actions.
SCR121830 Criteria browse list on the Report Design page of Report Template is only
populated when the report template is saved and re-opened.
Page 119 of 128

SCR121874 Enter results by (parent) sample locks all records when the parent has no
tests assigned directly on it
SCR121875 Analysis definition screen not reporting the correct Max PQL when the
component is specified as a significant figure (only).
SCR121902 The GAML Cirrus converter produces incorrect data if there are multiple
channels.
SCR121951 Web Client. Explorer filtering is not working as expected.
SCR122042 Workflow sample lifecycle doesn't allow going from Status I to C.
SCR122053 Comments in Result Entry allows the user to enter any number of
characters, but truncates to 255 on saving.
SCR122117 Sample locked when entering results by batch or spreadsheet.
SCR122158 Unable to email report designer report from the watch dog timer WDT.
SCR122165 Samples with calculated results can cause a crash on authorisation if

WORKFLOW_STATUS_CHANGE is yes and RESULT_AUTHORISE_RECALC is
Yes.
SCR122198 LES. Master Menu item 37156 Generate Execution Report no longer runs.
The task has changed name but the Master Menu item was not updated.
SCR122259 LES. Lab Method modify. The Apply button is not active after modifying the
'Instructions' area more than once.
SCR122273 Web Client hangs when browsing for a record during job / sample login if
that entity has a lot of records (300,000+).
SCR122275 Explorer Grouping of Stability samples in the right grid results in incorrect
groups.
SCR122287 Explorer Modify Folder > Popup tab > Context tab. Crash when entering
text in the 'Value' field before defining the Field Name.
SCR122330 LES. Adding attachments during execution and moving between steps
causes a crash when clicking continue.
SCR122335 LES. Adding many attachments during an execution step can sometimes
lead to a crash: 'Object reference not set to an instance of an object'
SCR122338 Issues with the Data Manager embedded GAML Viewer
SCR122340 The transpose button on the tool bar of the embedded GAML viewer is
obscured in some configurations.
SCR122348 Web Client. Clicking within a grid cell during Workflow Login does not re-
enable the Fill buttons if they are disabled.
Page 120 of 128

SCR122352 There are several issues with the GAML ASCII converter.
SCR122354 The Data Manager Configuration tool does not warn if changes have been
made.
SCR122446 Web Client. Session Locked screen does not display the Domain Account
even if the Domain Account was used to access SM.
SCR122496 The Chromeleon 7 converter fails with special characters and sequences
that have no injections.
SCR122497 Chromeleon Sequences that contain a large number of samples cannot be

packaged in Data Manager.
SCR122559 Web Client. When adding Workflow Nodes and entering some text, focus is
lost on the screen.
SCR122561 Workflow Sample Login. Crash when there are many samples (~1000)
being logged in.
SCR122565 Several DM components can crash if a percent symbol ('%') is passed to the
tracing routine.
SCR122582 Datatype Interval fields are not displayed in the Explorer grid.
SCR122583 An Explorer folder showing a view won’t automatically refresh after a RMB
option has been invoked.
SCR122614 Batch result entry doesn't always release result record lock after exiting
result entry.
SCR122630 Explorer filter. Pre-defined columns with Id_Numeric first crashes when
clicking on the filter in the Job Name column header. SM12.1 SP1 only.
SCR122631 Sample with two tests. Blanking out results in one test does not release the
lock on the other test in result entry
SCR122636 Stock Batch > Consume doesn't warn the user if consuming more than
current amount.
SCR122656 Lock session does not lock SampleManager if the lock is attempted directly
after launching a task from a dashboard which starts with a prompt.
SCR122669 Opening and cancelling Job Login by Workflow can occasionally crash with
error unable to access disposed object DockWindowContainer.
SCR122670 Disconnected from server error when authorising a Matrix result.
SCR122686 The JCamp converter has issues with some units and the scientific notation
format.
SCR122698 Chromeleon Link. For sequences created via eWorkflow, the mapped
property values from SampleManager are overwritten by the eWorkflow.
Page 121 of 128

SCR122700 SQL Server only. Leaving a prompt audit prompt open will lock records in
the same table for other users.
SCR122748 Stability. With the ‘Use Highest Version’ box checked on the study, samples
are logged in with the latest version of the MLP, regardless of the
mlp_header.approval_status.
SCR122771 The Chromeleon 7 converter can crash if a Chromatogram does not have
any points.
SCR122774 The Chromeleon 7 GAML converter has performance issues in interactive

mode.
SCR122779 Memory leak in Data Manager Agent and other components.
SCR122782 The Indico converter can produce bad results if the input data contains
negative values.
SCR122783 Envision is stripping spaces on parameter values.
SCR122784 Envision version 2.2 cannot read AnIML files.
SCR122785 Workflow Sub samples are not created in the expected order.
SCR122811 Using 'Change Job' to move a sample from one job to another doesn't work.
SCR122829 Table_saver and VGL selects behave differently between ADO and Oracle.
SCR122841 Locked records following Result Entry where samples have been multi
selected from explorer.
SCR122849 Calculation of Stock Inventory does not consider the Removeflag on Stock
Batches.
SCR122877 The Data Manager configuration tool does not combine the two trace logs
by default.
SCR122878 The Data Manager status tables for Agents and Capture Sources can have
duplicate entries.
SCR122879 The Data Manager status forms do not have a mechanism to refresh
automatically.
SCR122890 CONVERT_TABLE (Oracle) in ANALYZE mode on VIEWS can cause a full

table scan, this can be very slow.
SCR122910 Filter a large list of training records for an operator and then press escape,
it is possible to get a Null Reference Exception.
SCR122918 When the Create Resample workflow node is used to create a sample, it is
not possible to cancel out of the Sample Admin window to discontinue with
sample login.
Page 122 of 128

SCR122928 Chromeleon Link. The option in the mapping to take a result from the
Report in Chromeleon doesn't work if the Report Uri is not populated on the
sequence record in SM.
SCR122942 Repeatedly refreshing a job or sample in the explorer tree can cause an
'Invalid Property supplied for Query' error.
SCR122949 SQC. When using advanced criteria to define an MLP version, it is not
possible on the configuration tab for the MLP limits Specification Type to be
tied to that version.
SCR122950 Some empty date fields display 1900-01-01 on SQL Server systems.
SCR122970 Explorer. Ctrl+F on a folder where criteria uses two tables which both have
the same Boolean field defined AND that field is a folder column. The values
are yellow, but NOT filtered to the selection.
SCR122987 Master menu 37174 is missing from the standard master menu and errors
when trying to run the audit report option from the LES landing page.
SCR123013 Using a lab execution to create a Chromeleon sequence leaves the

sequence’s status as Unavailable.
SCR123052 Users with read only licenses cannot display / view SQC charts.
SCR123072 Stability. Performance issue - using Citrix, create or modify a study

template on the matrix screen, the "Pull info" tab does not redraw when
scrolling right.
SCR123132 Explorer. Custom filters are not returning data where date authorised >
date created.
SCR123231 Explorer folder. Popup tab, RMB 'Name' field appears blank when re-
opening folder for modification.
SCR123244 Report Templates Chart Designer hangs when adding data filter collection
for a manual series.
SCR123375 Report Designer. Using modular reports, a calculated field doesn't show on
the second report.
SCR123378 Web Client. Unable to select values from the multi select list control on the
entity template.
SCR123382 It is possible to use SampleManager after timeout by using the keyboard to

access the File > Run window.
SCR123406 Modular reports do not include the footer from detail reports from the first
report template.
SCR123478 Explorer doesn't refresh to show sub-sub-samples for a job under specific
circumstances.
Page 123 of 128

SCR123481 Report Templates. PivotGrid number of columns shown in the field list is
higher than expected.
SCR123483 Report Designer PDF attachment resolution is grainy.
SCR123497 Stability. Analyses with the same name, but different Analysis Ids can be
created when Stability is installed.
SCR123500 Report Templates. Reports can’t handle formula functions like Global().
SCR123503 Web Client. Explorer. Intermittent issue where the grid doesn't display all
the expected columns for a folder. Only the icons are shown.
SCR123508 PQL calculation does not trigger after deleting a result, moving off the result
cell and back again and typing another result.
SCR123580 Job Workflow Login > Modify. It is possible to unassign completed tests
using Fill Down on the Test Assignment Tab.
SCR123582 Performance issue when adding a component to an analyses with many

(~600) components.
SCR123589 SampleManager is unable to handle escaped url characters in Chromeleon

sequence addresses.
SCR123606 Schedules. The prediction calendar control doesn’t show the expected
tooltip.
SCR123616 Stability. Show Study Template Report master menu item (28853) has
Action Type LOGIN. It should be REPORTING.
SCR123631 Stability. The Context information for the rmb items Remove and Restore
for Stability Article are incorrect. They should be set as True.
SCR123632 SQC. Issue with chart comments after criteria modification.
SCR123644 Property Sheet Details Page (Text Editor). Typing the Polish ż character will
clear the entered text.
SCR123662 There is a discrepancy between esig display on the analysis form vs the
Signature Viewer.
SCR123664 Browse list 'filter on find' still active after text is deleted from a prompt.
SCR123675 Mobile. The Bad Request toast message is displayed when attempting to
complete audit during lab execution.
SCR123676 Mobile. Non-mandatory aux prompts behave as mandatory.
SCR123679 Mobile. A lab method step involving the Read action is not automatically
updated to Completed and stays at status Review. As a result, the entire
task has the status of Review instead of Authorized.
Page 124 of 128

SCR123708 MLP Spec form. The user is able to enter an invalid limit where Min has a
value and Max is empty. The VGL form gives a 'No maximum value
supplied' validation warning.
SCR123709 Schema. Missing message - Differences Explanation & Differences

Explanation Caption.
SCR123710 Typo in CreateEntityDefinitions report: 'Unknown Languages Parameter'.
SCR123771 Web Client. Translation editor navigation tree initially displays

phrase_header as expanded with no child phrase nodes.
SCR123803 LoginInstanceKey needs to be included in a new instance install.
SCR123804 If you change the instrument category assigned to an instrument template,

the change is not copied through to any descendent instruments of that
type.
SCR123805 Instruments and instrument templates aren't inheriting the icon assigned to
the parent instrument category or instrument template.
SCR123808 LES. Rename the 'Method Workflow' label on the Lab Method > Workflow
Tab.
SCR123809 The parser looks like an SM-IM XML can be imported and parsed however, it
doesn't work.
SCR123812 Schema. In the Schema Layout editor, you can't add a field with the same
name as a table or view that already exists in that schema layout.
SCR123820 Chromeleon Link. Error 'Item has already been added' when Chromeleon
has multiple components with the same name.
SCR123905 Chromeleon Link. Check Standards and Calibration Standard types translate
incorrectly in SampleManager.
SCR123909 Reconnect sometimes results in two SampleManager sessions open in the

foreground.
SCR123914 Chromeleon Link syntax issue. The SampleManager sequence name is

incrementing in 2’s each time a new sequence is generated.
SCR123980 Web Client. Typing quickly / using backspace in prompts and text fields
misses or deletes characters.
SCR123998 MLP form adds decimals as significant figures within a field if the value
contains three sig. fig. and the component is setup to take decimal places.
SCR124019 Label designer custom settings aren't copied across to the label. Instead
they are reset to a standard size.
SCR124032 VGL file handling issues caused by the introduction of Unicode.
Page 125 of 128

SCR124209 MLP form. New Version doesn't save limit changes.
SCR124330 MLP header forms allows for commas to be used, but the value is evaluated
to whatever comes after comma.
SCR124368 SM 12.2 $upgrade.rpf program adds menu option 37140 as default action
to the VERSIONED_ANALYSIS.
SCR124412 MLP Copy. Creation date is also copied from the original.
Page 126 of 128

Known Issues
There are no known Priority 1 or Priority 2 issues identified within this product version as of
31 October 2019.
Any other known issues, Knowledge Base articles, and workaround details may be obtained via
the Thermo Scientific Informatics Support Portal by using the following link:
https://support.thermoinformatics.com/. You must have a valid and current support contract in
order to access this information.
Page 127 of 128

Database Changes
This section indicates whether or not changes were made to the database structure as a result of
the enhancements and/or issue resolution included in this release.
Yes, changes were made
No, changes were not made
Not applicable
Some minor changes were made to the database structure in the SampleManager LIMS 12.2 SP1
release. To see the changes in detail, use a file comparison tool to compare the structure.txt file
in the SampleManager LIMS 12.2 SP1 installation kit with the structure.txt file for your current
version of SampleManager.
For more information, see the "Upgrading SampleManager" chapter in the SampleManager LIMS
Installation Guide.
Page 128 of 128

SampleManager LIMS 12.2 SP1 Release Notes

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

SampleManager LIMS 12.2 SP1 Release Notes

Uploaded by

Copyright:

Available Formats

Product Release Notes

SampleManager LIMS 12.2 SP1

© 2019 Thermo Fisher Scientific Inc. All rights reserved.

Stock Batches Updates .................................................................................................. 47

Electronic Signature Settings in Chromeleon ................................................................. 81

Recent SampleManager Releases

• SampleManager LIMS 12.1

• SampleManager LIMS 12.1 SP1

• SampleManager LIMS 12.1 SP2

• SampleManager LIMS 12.2

SampleManager 12.1 SP1 SampleManager 12.2

SampleManager 11.2 SP3

SampleManager 12.1 SP2 SampleManager 12.2 SP1

CPU Dual-core processor for up to 20 concurrent connections

RAM 2 GB + 125 MB for each concurrent connection

Hard Disk 1 GB + 200 MB for installation files

0–20 Concurrent 20–40 Concurrent 40–60 Concurrent

CPU Dual-core processor Quad-core processor Six-core processor

Web Client Server

CPU Dual-core processor for up to 20 concurrent connections

RAM 4 GB + 200 MB for each concurrent connection

Hard Disk 1 GB + 614 MB for installation files

0–20 Concurrent 20–40 Concurrent 40–60 Concurrent

CPU Dual-core processor Quad-core processor Six-core processor

CPU 2.5 GHz processor

Hard Disk 250 MB for installation files

CPU 2.5 GHz processor

Network Path Recommended Latency

Application server to database server Less than 1 ms

Web client server to application server Less than 1 ms

Desktop client to application server Less than 120 ms

Web client to web client server Less than 120 ms

SampleManager Application and Web Server OS

Desktop and Web Client OS

Microsoft® Windows® 10 x64 Enterprise

Citrix XenApp® 7.15 (using Citrix Receiver™ for Web)

Web Client Browsers

SampleManager Mobile App

SampleManager Web Application Browsers

Related Thermo Scientific software products

Supported Chromeleon CDS Versions

Feature Chromeleon CDS Version

7.2 SR5 7.2.6 7.2.8 7.2.9 7.2.10

In SampleManager, create a Chromeleon     

In SampleManager, create a Chromeleon     

In SampleManager, add additional samples  

In SampleManager, configure a sequence to  

In SampleManager, configure a sequence to  

In SampleManager, configure the naming     

In Chromeleon CDS, run an eWorkflow and * * * *

In Chromeleon CDS, run an eWorkflow and * *

In Chromeleon CDS, create a sequence that *

In SampleManager, specify injection     

Feature Chromeleon CDS Version

7.2 SR5 7.2.6 7.2.8 7.2.9 7.2.10

In SampleManager, specify injection 

In SampleManager, specify standard     

In SampleManager, configure properties that     

In SampleManager, configure properties that  

In SampleManager, map analysis     

In SampleManager, translate the sample     

In SampleManager, create a list of  

In Chromeleon CDS, use custom variable     

In Chromeleon CDS, use the injection lock     