| Table of Contents |
|---|
...
OpenSpecimen supports printing labels for specimen and visit labels. On configuring printing, OpenSpecimen generates and writes the labels as CMD or CSV files on the file system. OpenSpecimen does not actually print the labels. It only writes the required data in the file format understood by the printer automation software like Bartender, NiceLabel, etc. The print software Printer software like NiceLabel/Bartender can be configured to process read and print these CMD files in an automated fashion.
...
For configuring the printing into the in OpenSpecimen please refer configuration section.
...
| title | JSON files to a database table |
|---|
...
.
Below is the block diagram of the workflow:
...
Q: Which printer software should we use?
A: BarTender Automation Edition is most recommendedand NiceLabel are two well known options. You are free to choose any other option as long as they support automated printing. Most of them follow similar approaches and should work with OpenSpecimen.
Q
...
:
...
Q: Does any user that would like to print labels from OpenSpecimen would need a separate printer?
A: No. There could be a single printer for multiple users based on the group/network requirements. If using multiple printers that , it can be configured in the automation software to read the labels and send them to different printers as per the requirement.
...
A: No. This is same as above. However, historically, this has been used to specify the path of printer label design template
Q: How to handle printing from remote sites?
For sites which will operate OpenSpecimen remotely from multiple geographical locations, below are the options to handle printing:
Option 1: Via shared folder on the cloud like DropBox
For example, when user prints from 'Site A', OpenSpecimen sends label information into DropBox/SharedFolderA. BarTender is installed on a cloud server which is listening to this DropBox folders. The printers should also be accessible on the cloud so that BarTender is able to route the printing job to specific printer.
Option 2: Download printed labels file CSV from OpenSpecimen UI
By enabling 'Download Labels Print File' in 'Settings' of OpenSpecimen, users can download the CSV with labels information to be printed. This CSV can be manually fed to printer to print labels. Refer to 'Download specimen labels print file' section in 'Print Rules' wiki page for more details.
Q. Bartender Videos
Refer to the files below for help setting up a File Integration:
https://support.seagullscientific.com/hc/en-us/articles/227353867-Print-Document-Using-a-Data-File-Integration-Video-6-31-
https://support.seagullscientific.com/hc/en-us/articles/227354787-Print-Document-Using-Print-Command-Script-Video-9-40-
Also, we have two webinar with additional information:
https://support.seagullscientific.com/hc/en-us/articles/115004072388-Building-a-file-integration-using-a-CSV-file-38-26-
https://support.seagullscientific.com/hc/en-us/articles/115003215107-Building-a-file-integration-using-Print-Command-Script-27-58-
Q Sample output files
...
OpenSpecimen uses print rules to decide on how the contents of the specimen label content should be formatted and printed. Refer toCreate to Print Rules Via UI for more details. The printing rules can be customized based on CP, specimen type among other attributes as explained in below table.Rules are matched in sequential fashion and stopped at first matching rule. Users are notified with an error message when none of the rules match specimen whose label is to be printed.
Step 2: Configure printer software to read generated labels
There are 2 options:
...
Based on print rules, label files are creates as CMD or CSV files and saved in directory identified by
...
'Output Directory' value specified in the rules.
Printer software like Bartender/NiceLabel can be configured to poll the 'Output Directory' at periodic intervals for new
...
files and print labels.
...
Adopters can implement custom print tokens by extending class AbstractLabelTmplToken and providing implementation for following methods:
getName()- returns unique name of token. Example: "specimen_requirement_code"getReplacement(Specimen s)- returns string to be included in printed label
The custom token implementation class needs to be registered with specimenPrintLabelTokensRegistrar bean
Sample Specimen Label Formats
...