🚀Getting Started

What are Result Filters?

Result filters automatically identify which test results should be treated as critical. When a test result comes in, Rooster checks if it matches your filter criteria and alerts the right doctors if it's critical.

How it works: Rooster examines each result's ordered location and test code, then applies the most relevant filter to determine if an alert should be sent.

Before You Start

You'll need:

• Lab type (Biochemistry, Radiology, etc.)

• Test name/code you want to monitor

• Ordered location of the test

• Criteria for what makes a result "critical"

Technical note: This data is extracted from the HL7 message:

• Ordered location: Found in ORC 13 field

• Test code: Found in OBX 3.1 segment

Creating Your First Filter

Step 1: Navigate to Result Filters

1. Go to Clinical in the main navigation

2. Select Result Filters from the dropdown

   
3. Click '+ Create New Filter'

Step 2: Fill Out the Basics

A popup will appear with the configuration form. You'll set:

• Lab Type: Choose from 5 options (Biochemistry, ECG, Haematology, Microbiology, Radiology)

• Test Name (Test code): Select from available test codes (varies by lab type)

• Locations: The result's ordered location (can select "All" or specific locations)

• SMS template: This allows you to configure the SMS message sent to end users (e.g., physicians) Copy and paste the variables (free text or valid variables) to include in the message

  

  SMS configured according to the SMS template on Rooster

Step 3: Configure Alert Conditions

This is where you define what makes a result critical - this is covered in detail in Setting Up Conditions

Special Cases

Microbiology Results Without Test Codes

If a microbiology result appears in the NTE segment of the HL7 message but lacks a corresponding OBX segment, select the 'No Test Code (-1)' option. This serves as a catch-all for results without specific test codes.

Missing Test Codes or Locations

If your needed test code or location isn't available in the dropdown:

• Test codes: Follow these instructions to add new ones

• Location codesets: Follow these instructions to add new ones

What's Next

Once you've created the basic filter, you'll need to set up the conditions that determine when results are critical. Head to Setting Up Conditions to configure your alert criteria.