Laboratories

Incomplete document

The Administration - Laboratories screen provides support to configure laboratory plugins and their associated data including:

The buttons are as follows:

New create and edit a new instance of the selected type
View view the selected instance
Edit edit the selected instance
Delete delete the selected instance
Synchronise Data only applicable when the selected instance is a Laboratory.
Adds, updates or deactivates Devices, Investigation Types and Tests  managed by the Laboratory Service.
Import Import laboratory test data.

 

Laboratory

Complete

A Laboratory describes an internal or external service that performs laboratory tests.

Laboratories are provider specific, but in general include the following:

  • Name
 the name of the Laboratory
  • Description
 an optional description of the Laboratory
  • Active
 uncheck the box to deactivate the Laboratory
  • Locations

the Practice Locations that this laboratory may be used at.
If there are no Practice Locations assigned, this laboratory may be used at any Practice Location
  • Mappings
 describes data mapping requirements between OpenVPMS and the Laboratory.
E.g, this may be used to map OpenVPMS species codes to those of the Laboratory.

 

Laboratory Device

Complete

A Laboratory Device describes hardware or software used to perform Laboratory Tests.
These are typically automatically created by Laboratory services when synchronising data.

A Laboratory may:

  • require a Laboratory Device be specified in order to perform a test
  • automatically choose from the available devices, if no Laboratory Device is specified
  • not require any Laboratory Device

The fields are as follows:

  • Name
 the name of Laboratory Device
  • Description
 an optional description of the Laboratory Device
  • Device Id
 a unique identifier for the device, issued by the Laboratory
  • Active
 uncheck the box to deactivate the Laboratory Device
  • Laboratory
 the Laboratory that this device is managed by
  • Locations

the Practice Locations that this device may be used at.
If there are no Practice Locations assigned, this device may be used at any Practice Location.

In multi-location practices, Laboratory Devices that represent physical hardware should be assigned the Practice Location where they are situated.

 

Investigation Type

Complete

Investigation Types describe how patient Investigations are performed.

These are used:

The fields are as follows:

  • Name
 the name of Investigation Type
  • Description
 an optional description of the Investigation Type
  • Active
 uncheck the box to deactivate the Investigation Type
  • Laboratory
 the Laboratory, if the Investigation is ordered automatically
  • Template
optional Document Template. 
If one is specified then it defines the document that will be printed when the investigation is initiated.  It is normally some sort of form that can be used to request the required test(s)
  • Supplier
optional Supplier. 
If one is specified then will be displayed on the Workflow - Investigations screen.
  • Devices
 the Laboratory Devices that may perform tests for this Investigation Type.
These are specified by the associated Laboratory
  • Locations
 optional location relationships where this Investigation Type is used. Each relationship includes an Account Id.
This is to support offline laboratories which need an account identifier included in the documentation submitted with the sample.
Use the investigation:accountId() functions to access the Account Id from within a template.

 

If the Investigation Type has been created by a Laboratory, then the Name, Description, Laboratory and Devices cannot be changed.

 

 

Laboratory Test

Complete

Laboratory Tests describe a test that may be ordered via laboratory.

The fields are as follows:

  • Name
 the name of Laboratory Test
  • Description
 an optional description of the test
  • Code
 a unique code for the test, issued by a Laboratory
  • Active
 uncheck the box to deactivate the Laboratory Test
  • Turnaround
 optional text describing the turnaround for the text
  • Investigation Type
 the Investigation Type that determines how the test will be performed i.e. which Laboratory provides the test, and which Laboratory Devices can be used to perform it
  • Group
 determines if the Laboratory Test can be grouped with other tests on the same Investigation.
  • Use Device
 determines if a Laboratory Device must be specified when performing the test
  • Specimen
 optional text describing the specimen collection requirements

 

If the Laboratory Test was created by a Laboratory, all fields will be read-only, with the exception of the Active field.

 

Import Laboratory Test Data

Complete

The Import Laboratory Test Data window is used to import laboratory test data for offline laboratory providers.

This can be used to:

  • create and update the laboratory tests for a provider
  • update the unit prices for products that use the tests

File format

The file must be specified in a comma-separated-values format, containing the following columns:

Column Required Type Description
Laboratory Yes String The laboratory name. Alphanumeric.
Code Yes String The test code. This is the laboratory's unique identifier for the test.
Name Yes String The test name.
Description No String The test description.
Specimen No String Specimen collection details.
Turnaround Time No String A description of the turnaround time.
Price Yes Number The cost price.

Import

On import, a list of the imported tests will be displayed. If the tests haven't been imported before, enter the Investigation Type that the tests will be associated with.

Click Next to save any changes.

The Update Product Prices window will be displayed.
Here, products that use the tests will be shown, if their current cost price is different to the sum of the test prices.

Select the products that should be saved.
By default, all those products whose unit prices have increased will be selected.

Click OK to save selected products.

Limitations

The following products will not be updated if a test price changes:

  • Products that only have fixed prices
  • Products with unit prices that have Pricing Groups