Managing Label Specifications

Topics:

Labels Editor

Creating Labels

Before labels can be printed from BSI, label formats must be created.  Once a label format has been successfully created, the Printing Labels dialog can be used to print the labels. Creating a new label format will prompt the user for the type of label to create.

For information on how to print labels directly to a designated printer using a printer's IP address, see Label Printing.

Only users with the appropriate permissions can create, edit or delete label formats.

Example: Dr. Ken needs a new label specification for his HN-9003 study. After creating the file, he uploads it to BSI via the Labels manager. He sets the default BSI fields which will be associated with the fields in the label file. In this file, he associates BSI ID and Subject ID with the ID Barcode and Patient fields in the label file respectively. Once he saves the file, Dr. Ken can print his labels.

View a Label format

Anyone can view a label format.

To view a label format:

  1. Select the folder containing the label format in the left pane of the Labels manager.  Any labels and sub-folders in the selected folder will be displayed in the right pane.
  2. Highlight the label format in the right pane by clicking on it anywhere in the row.
  3. Select the View button.  The Viewing Label dialog will open.  No information can be changed while viewing a label format.Label Manager View button
  4. Select Close to exit the dialog.

Edit a Label Format

BSI supports .lab and .POF files for Sentinel and IP label printing. It also supports .btw files for Bartender and printing via Labwriter to SlideMate printers. The Label editor will allow users to modify a selected label format by changing its name, description, associated template files, field names, Study ID and the path of the label file.

Users with the appropriate permissions can edit label formats and save them in their home directory.  Users can also open a label format from another directory, edit the format and save it to their own home directory or institution directory (depending on role permissions).  Local Administrators can save label formats in any directory that belongs to their institution.

Sentinel or IP Label printing:

Note: Prior to IP Label Printing, the lkup_printer code list must be configured to include the printer that will be used. This code list includes the following fields: Printer Name, Printer Label, Printing Method (POF, Sentinel, Bartender, or CodeSoft), Printer, POF IP Address, POF Port, Drop Folder, and Active.

For Bartender printing, the Drop Folder value’s format will depend on whether a Mac or PC is being used. If both may be used, then instead create two distinct label formats for use with these printers, one for Mac only and the other for PC only. In the specifications, enter the appropriately formatted value in the Label File path field.

  1. Select the folder containing the label format in the left pane of the Labels Manager.  Any labels and sub-folders in the selected folder will be displayed in the right pane.
  2. Highlight the label format in the right pane by clicking on it anywhere in the row.
  3. Select the Edit button. The Editing label dialog will open.
  4. On the Label File tab of the Editing Label dialog, click the Upload button to search for a data source.Label File tab dialog
  5. Once the .pof or .lab file is selected, click Open. The path will appear in the File path: field.
  6. On the Field Mapping tab, choose the BSI field from the drop down list that corresponds to the CodeSoft field. For .lab files, use the Insert Rows icon to add and map fields.
    • Note: When adding, changing, or deleting a mapping from variable name (CodeSoft Variable Name) to BSI column name (Name displayed in BSI), users should keep in mind that rows with one or more blank columns will be completely ignored; therefore there is no need to delete empty rows, and extra rows need merely be cleared of data.field mapping
  7. On the Description tab, enter a description of the file, if desired.
  8. Select Save.  The Save Label dialog will open.
  9. Enter a name for the label or select the existing name and select Save.  If the existing name is entered or selected, the label format with that name will be overwritten unless the label format is being saved in a different folder.

Bartender or Labwriter:

  1. Select the folder containing the label format in the left pane of the Labels Manager.  Any labels and sub-folders in the selected folder will be displayed in the right pane.
  2. Highlight the label format in the right pane by clicking on it anywhere in the row.
  3. Select the Edit button. The Editing label dialog will open.
  4. On the Label File tab of the Editing Label dialog, select the Label File path where the labels will be saved before printing.
    • In a Bartender label, click the Select Template button then choose the template to be used and press Open.
    • In a Labwriter label, enter the Template Name.Edit Label template
  5. On the Field Mapping tab, choose the BSI field from the drop down list and the corresponding to the Template Field.
    • Note: When adding, changing, or deleting a mapping from variable name (Template Field) to BSI column name (Name displayed in BSI), users should keep in mind that rows with one or more blank columns will be completely ignored; therefore there is no need to delete empty rows, and extra rows need merely be cleared of data.
  6. Select Save.  The Save Label dialog will open.
  7. Enter a name for the label or select the existing name and select Save.  If the existing name is entered or selected, the label format with that name will be overwritten unless the label format is being saved in a different folder.

Mapping Subject Fields in a Label Format

Subject fields can be mapped to the label format fields in the Editing Label dialog.  Subject data is retrieved based on Subject ID and Study ID. The user printing the labels must have permission to edit the subject data in order for the fields to be populated.

To map subject fields:

  1. On the Label File tab of the Editing Label dialog:

    • For POF and Sentinel files, click the Upload button to search for a data source.Label File Upload button
    • For Labwriter files, add the template name and select the Label File.Labwriter Label file
    • For Bartender files, select the template and the Label File Path.Bartender Label File
  2. On the Field Mapping tab, select the Study Id using the Ellipsis (...) button.Field Mapping tab Ellipsis
  3. Select the Insert Row button.
  4. In the BSI field, use the drop-down menu to select the subject attribute of the Study ID.  Continue inserting rows as needed to populate the fields.Subject Attribute Drop Down
  5. In the corresponding label format field, manually enter the field name that the BSI subject attribute corresponds to.
  6. Edit the label as needed and select Save.
    • If saving a new label format, the Save Label dialog will open. Users will be prompted to enter a name for the label or select the existing name and select Save. If the existing name is entered or selected, the label format with that name will be overwritten unless the label format is being saved in a different folder.
    • If saving a pre-existing label format, a dialog will open to notify the user of a successful save.

Delete a Label Format

Users with the appropriate permissions can only delete label formats from their home directory.

To delete a label format from the Labels Manager:

  1. Select the label format to be deleted from the Contents table.
  2. Select the Delete button.  A dialog will be displayed to confirm that you wish to delete the label format.Label Format Delete button
  3. Select Yes to delete the label format.