Trackable Items

Cases

Cases represent the submission of one or more samples along with any extra requested work/pathologist analysis/etc.

There are three types of Cases that can be tracked using Prima, the main difference being the (case subject) source of the sample.

HumanResearchCases track a research case associated with a human patient and keep patient personal information hidden.

VeterinaryResearchCases track a research case associated with an animal.

ClinicalCases track a clinical case associated with a human patient. Patient personal information/history available.

Studies

Studies are recorded in Prima to capture important research data to help the lab. Some of this data includes an objective/purpose of the study, the name of a principal investigator, and starting/ending dates.

Any number of VeterinaryResearchCases or HumanResearchCases can be associated with one study using the studyId field.

Fetching Study Data

To view studies recorded in Prima, the Study API endpoint can be used.

To order and filter studies, ODATA query options can be used.

Example Finding studies titled "Test Study": https://{baseUrl}/api/v2/Study?$filter=title eq 'Test Study'

Example Finding veterinary research cases with study Id 13: https://{baseUrl}/api/v2/VeterinaryResearchCase?$filter=studyId eq 1

Specimens

There are four types of Specimen samples that can be tracked using Prima, generally using barcoded stickers on specimen jars: Surgical Specimens (SurgicalSpecimenDto), Cytology Specimens (CytologySpecimenDto), Frozen Specimens and Hematology Specimens.

Surgical Specimens represent some human or animal tissue (or sometimes entire animals). Can be cut using Prima Prosect (Trimming) module into Cassettes.

Cytology Specimens represent a cytology fluid sample such as urine or spinal fluid. Can be made into Cytology Slides using Prima Cytology Slide Prep module.

Frozen Specimens represent some frozen tissue. Can be cut using Prima Prosect (Trimming) module into Cassettes and/or cut into Frozen Slides using Prima Cryostat module.

Hematology Specimens represent a hematology (blood) sample (e.g. tube). Can be aliquoted into Hematology Slides at Prosect

Cassettes/Blocks

Cassettes/Blocks are tracked using Prima generally using barcodes printed onto plastic Cassettes. Cassettes can be cut from Surgical Specimens and Frozen Specimens. They can also be brought through the Prima Accession module from an outside source, processed/embedded or not.

Cassettes can be cut into Slides (Surgical Slides) using the Microtomy module after they have been processed and embedded. Specimen parent can is identified by ParentId Property.

In Prima Cassettes and Blocks are both tracked using Cassette objects.

Slides

There are four types of Slide samples that can be tracked using Prima, generally using barcoded labels printed onto glass slides: Surgical Slides (SurgicalSlideDto), Cytology Slides (CytologySlideDto), Frozen Slides (FrozenSlideDto) and Hemotology Slides (HematologySlideDto).

Surgical Slides are cut from Cassette/Blocks. Cassette/Block parent identified by ParentId Property.

Cytology Slides are made from a cytology fluid sample. Cytology Specimen parent identified by ParentId Property.

Frozen Slides are cut from a FrozenSpecimen. Frozen Specimen parent identified by ParentId Property.

Hemotology Slides are made from a hematology (blood) sample. Hematology Specimen parent identified using ParentId Property.