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	Adds, updates or deactivates Devices, Investigation Types and Tests managed by a Laboratory Service. Only applicable when the selected instance is a Laboratory.
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:

by Laboratory Tests to determine which Laboratory a test should be submitted to
to specify if a Laboratory Test must be done using a Laboratory Device

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