- 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
This tutorial step returns us to the role of the Specimen Coordinator after a request has been submitted. Here we explore the tracking and approval features of the specimen request tracking system. If you are an administrator impersonating a specimen requestor, adjust your impersonation for this tutorial step so that you are a reader and specimen coordinator.
View and Track Specimen Requests
List Current Requests
To access the list of existing specimen requests:
- Click the Specimen Data tab.
- Expand Specimen Requests in the Specimens panel.
- Click View Current Requests.
- You will see a list of existing specimen requests, their current statuses, and options for managing them.
You can choose to filter requests by using the My Requests
link and/or Filter by Status
pulldown on the top row. You can also use grid sorting
You can also customize this grid, as you can any data grid. See Customize Grid Views
Manage an Existing Specimen Request
for any existing request to see the current status, contents, and any notes. If the request has not yet been submitted, and you have appropriate permissions, you will have options for managing the request.
- View History: A list of all changes to the request.
- Update Request: Options for update, including attachment of supporting information.
- Originating Location Specimen Lists: Configure and send email notifications to the location where the specimen was originally drawn or collected.
- Providing Location Specimen Lists: Configure and send email notifications to the location which currently possesses the specimen aliquot and will mail it out after full approval has been granted.
The Current Requirements
section lists the current status of all approval requirements associated with this request. Click any Details
link for information and options, including the addition of comments and sending of notifications to the members of the associated Actor. In this tutorial, no requirements were preconfigured, so we can add one here:
- As shown in the above screencap: Select the Actor "Institutional Review Board".
- Select the Location "High Point Clinic".
- Enter "The IRB must approve the request" in the Description.
- Click Add Requirement.
- The requirement is now shown as "Incomplete".
- Click Details for the new requirement.
Use the Manage Requirement
page to approve specimen requirements. Once all requirements are met, the request can be approved. As steps are completed, links for subsequent steps are added to the UI.
Completion of Requirements
Prior to approval, each requirement must be completed by the associated Actor.
- To mark a requirement completed, first open the "Manage Requirement" page using the Details link.
- Check Complete, add any comments, attachments, or additional notifications and click Save Changes and Send Notifications.
Note: Hover over the ? next to any Notify group to see a list of members. Inactive users are shown with strikethrough text.
Final Notification Steps for Approval
After all requirements are completed, the list of next three steps will be listed at the top of the specimen request detail page with links for completing them:
- Email specimen lists to their originating locations: [Originating Location Specimen Lists]
- Email specimen lists to their providing locations: [Providing Location Specimen Lists]
- Update request status to indicate completion: [Update Request]
For details on emailing specimen lists to these groups, see Email Specimen Lists
Update Request Status to Indicate Completion
- To finalize the request, click the Update Request link
- Select Complete from the Status drop-down menu.
- Add any supporting documents and select actors to notify.
- Click Save Changes and Send Notifications.
Upon receiving notification of an approved request, the Providing Location would ship the specimens according to their own procedures.
You have completed the tutorial and learned to manage specimen requests. Remember to click Stop Impersonating
when you are finished with this tutorial.