Template Selection

Template File Location

All template files are stored in a single directory on each workstation:

%ProgramData%\FortelineaSoftwareSystems\Prima\{D3F54E67-7D04-495C-B159-516C06E47466}\PrinterTemplates\

This typically resolves to:

C:\ProgramData\FortelineaSoftwareSystems\Prima\{D3F54E67-7D04-495C-B159-516C06E47466}\PrinterTemplates\

Template Naming Convention

Template files are named based on the printer name and can include optional specificity qualifiers. When a label is printed, Prima looks for the most specific matching template.

Selection Priority

Templates are selected in order from most specific to least specific:

  1. Full Match: {PrinterName}.{LabelType}.{CaseSubject}.txt
    Example: Thermo.ControlCassette.Animal.txt
  2. Case Subject Only: {PrinterName}.{CaseSubject}.txt
    Example: Thermo.ClinicalPatient.txt
  3. Label Type Only: {PrinterName}.{LabelType}.txt
    Example: Thermo.ControlCassette.txt
  4. Printer Default: {PrinterName}.txt
    Example: Thermo.txt
  5. Fallback: If no template is found, the surgical number is used as the output.

LabelType Values

Cassette Labels
Value Description
Cassette Standard cassette labels
ControlCassette Quality control cassettes
Slide Labels
Value Description
SurgicalSlide Standard surgical slides
ControlSlide Quality control slides
CytologySlide Cytology slides
HematologySlide Hematology slides
FrozenSlide Frozen section slides

CaseSubject Values

Value Description
ClinicalPatient Human clinical patient cases
ResearchPatient Human research patient cases
Animal Research animal cases

Troubleshooting

Template Not Being Used?
  • Verify the template file is in the correct directory
  • Check that the printer name in the filename exactly matches the printer name in Prima (case-insensitive)
  • Special characters in printer names are removed when matching filenames
  • Ensure the file extension is .txt
Testing Your Template

Templates are reloaded automatically when the file changes. Edit and save your template file, then print a test label to see the updated output immediately.

Example Scenario

If you have a printer named "Thermo Lab1" and these template files exist:

  • Thermo Lab1.txt (default)
  • Thermo Lab1.ClinicalPatient.txt (human patients)
  • Thermo Lab1.Animal.txt (research animals)
  • Thermo Lab1.ControlCassette.txt (QC cassettes)

Then:

  • A cassette for a human patient uses Thermo Lab1.ClinicalPatient.txt
  • A cassette for a research animal uses Thermo Lab1.Animal.txt
  • A control cassette for any subject uses Thermo Lab1.ControlCassette.txt
  • Anything else uses Thermo Lab1.txt