> For the complete documentation index, see [llms.txt](https://spice.docs.medtroniclabs.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://spice.docs.medtroniclabs.org/user-guide/lab-investigations.md).

# Lab Investigations

## Feature Overview

Lab investigations let a clinician order tests for a patient during a medical review, and let the person who performs the test record the result against that order. The result then appears in the patient's history.

Investigations in the app follow a simple life cycle:

1. **Ordered.** A clinician orders a test during a medical review.
2. **Result recorded.** The test result is entered against the order, with the date it was tested.
3. **Viewed.** The result appears in the patient's investigation history at later visits.

All of this happens in the **Investigation** section of the patient's medical review screen. It needs an internet connection.

> **Who does what:** the app does not show a separate lab screen. Ordering and recording results both use the same Investigation section.

## Ordering investigations

1. Open the patient's medical review (see [Medical Review](https://spice.docs.medtroniclabs.org/user-guide/medical-review.md)).
2. Scroll to **Investigation**.
3. Under **Recommended Investigation**, tap the chip for each test you want to order. The test is added to **Today's Investigation**.
4. To undo an order, tap the cross next to the test in **Today's Investigation**.
5. Complete the rest of the review and tap **Submit**. The orders are saved when you submit.

The list of recommended tests is set up by your organisation (see [Medications & Lab Tests](https://spice.docs.medtroniclabs.org/admin-guide/medications-and-lab-tests.md)). The summary at the end of the review lists the tests you ordered.

## Recording a result

A test that has been ordered but has no result yet stays in **Today's Investigation**, and it stays there at later visits until a result is recorded. Each entry shows the test name, the **Ordered Date** and who ordered it.

1. Open the patient's medical review and scroll to **Investigation**.
2. In **Today's Investigation**, tap the edit icon next to the test.
3. In the window that opens, choose the **Tested On** date. This is required and cannot be in the future.
4. Enter a value for each result line and choose its unit from the **Unit** list. Both the value and the unit are required. The result lines depend on the test: a simple test has one line, a panel has several.
5. Tap **Save**.
6. A confirmation appears (**LabTest saved successfully**) and the test moves to **Previous Investigation History**.

To cancel, tap **Cancel** or the close icon. Nothing is saved.

Results are saved straight away. You do not need to submit the medical review for them to be recorded.

If a test was ordered by mistake and has no result yet, tap the cross next to it. Once a result exists, the test can no longer be removed.

## Viewing results

**Previous Investigation History** lists tests that have a result. Each entry shows the test name, the ordered date, who ordered it and the **Tested On** date.

Tap a test, or its arrow, to expand it and see the result values and units. Tap it again to collapse it.

## Notes

* If the device is offline, the app cannot save a result and shows a connectivity message. Try again when you have a connection.
* The fields in a result window come from the test's configuration, including the units offered. If a result line or unit is missing, ask your administrator to check the test setup.
* Lab results recorded in the app also appear when the patient is next reviewed, in **Previous Investigation History**.
