Premium Resource - Specimen functionality is a legacy feature available with Premium Editions of LabKey Server. For new installations, we recommend using Sample Manager instead. Learn more or contact LabKey.

Notifications from the Specimen Request System will be triggered by various request actions. Specimen Coordinators can configure when and to whom these notifications are sent. Administrators can customize the template of the notification email itself as described in this topic.

The default notification email provides various information about the action that triggered the notification. Customizing the template gives you the flexibility to tailor this email notification to your needs.

Edit the Specimen Request Notification Template

  • Click the study Manage tab.
  • Under Specimen Request Settings, click Manage Notifications.
  • Click Edit Email Template.
  • Confirm that Specimen request notification is selected from the Email type pulldown.
  • Make the changes you need; details about the defaults and options available are below.
  • Click Save when finished.

The Customize Email page shows the current template for emails sent to users about specimen requests. Using a mixture of static text and substitution parameters, design the notification to best fit your needs. For example, the Subject might look like: ^studyName^: ^subjectSuffix^ and the Message might read:

Specimen request #^specimenRequestNumber^ was ^simpleStatus^ in ^studyName^.
<table width="500px">
<td valign="top"><b>Request&nbsp;Details</b></td>
<td valign="top"><b>Specimen&nbsp;Request</b></td>
<td align="left">^specimenRequestNumber^</td>
<td valign="top"><b>Destination</b></td>
<td align="left">^destinationLocation^</td>
<td valign="top"><b>Status</b></td>
<td align="left">^status^</td>
<td valign="top"><b>Modified&nbsp;by</b></td>
<td align="left">^modifiedBy^</td>
<td valign="top"><b>Action</b></td>
<td align="left">^action^</td>
^attachments|<tr><td valign="top"><b>Attachments</b></td><td align="left">%s</td></tr>^

The available parameters, with type, description, and current value if known, are listed at the bottom of the Customize Email page. Properties are passed to the email template as their actual type, rather than being pre-converted to strings. Each type has different formatting options. For example, dates can be presented in either month-first or day-first order, depending on local style.

For full details about the formatting options for each type, see the documentation for java.util.Formatter

Related Topics


Was this content helpful?

Log in or register an account to provide feedback

expand all collapse all