Recipe builder reference

Documentation Index

Fetch the complete documentation index at: https://docs.practicemate.com.au/llms.txt

Use this file to discover all available pages before exploring further.

Use this reference when you want to understand what each part of the Recipe Builder does.

​

Opening the builder

From Recipes, select New Recipe. PracticeMate opens with a prompt: What kind of Recipe would you like to create? You can describe the Recipe in plain English, or choose Open the full editor instead. The full editor gives you direct control over every filter, ingredient, connector, and value.

​

Title

The title appears at the top of the editor. Select it to rename the Recipe. Good names are specific:

• Active male patients aged 50+
• Patients with 3+ visits in 2 years
• Active patients with no mobile number

Avoid names like “Test”, “New recipe”, or “Recall list” unless the purpose is obvious to everyone who will use it.

​

Test

Test checks how many patients match the Recipe. Use it before saving, and again after any meaningful change. Testing is especially useful after adding an ingredient, changing an AND/OR connector, or adding a date filter.

​

Save

Save stores the Recipe so you and your team can use it again. PracticeMate will ask you to fix highlighted filters if a required field, operator, or value is missing. Each successful save also creates a new version of the Recipe. Versions are helpful when a Recipe changes over time and your team wants to check what was saved before.

​

Version history

Open Recipes, select the … menu beside a Recipe, then choose Version history. Version history shows earlier saved versions of the Recipe. Select a version to preview it in a read-only builder, then choose Restore version if your practice wants to make that older version current again. Restoring a version updates the editable Recipe and creates a new current version. It does not silently change Broadcasts or Automations that were already set up with a particular Recipe version.

​

Patient section

Every Recipe starts by searching for Patients. This section contains filters about the patient record itself, such as:

• age
• sex
• status
• postcode
• usual doctor
• MyMedicare registration
• contact details

New recipes include:

• Status is Active
• Extraction Opt-Out is False

Keep these defaults unless you intentionally need a broader search.

​

Filter rows

A filter row has three main choices. Field is the piece of information you want to check. Examples: Age (Years), Sex, Postcode, Visit Date. Operator is the comparison. Examples: is, contains, is greater than or equal to. Value is what you are comparing against. Examples: Male, 50, 2 years ago. A complete filter reads like a sentence: Age (Years) is greater than or equal to 50

​

Field chooser

The field chooser includes fields from the current section. In the Patients section, it shows patient fields. Inside a Visits ingredient, it shows visit fields. Inside a Prescriptions ingredient, it shows prescription fields. The field chooser may also include more advanced options for combining or transforming dates, numbers, and text. Most teams can start with the standard fields and only explore these when a Recipe needs them.

​

Operators

The available operators depend on the field you picked. Common operators include:

• is for an exact match
• is not for excluding a value
• contains for text that includes a word or phrase
• does not contain for text that should not include a word or phrase
• starts with and ends with for text patterns
• is greater than and is greater than or equal to for numbers and dates
• is less than and is less than or equal to for numbers and dates
• is one of and is none of for matching several values

​

Values

The value box changes depending on the field. For some fields, you type a value, such as 50. For fields with known options, you choose from a list, such as Male, Female, Other, or Unknown. For dates, you can type plain language values such as today, yesterday, or 2 years ago. If PracticeMate offers a relative-date suggestion, choose it so the Recipe stays current over time.

​

AND and OR

Connectors decide how filters work together. AND means every connected line must be true. Example:

• Age (Years) is greater than or equal to 50
• AND Sex is Male

This finds patients who are both 50 or older and male. OR means either line can be true. Example:

• Sex is Male
• OR Sex is Female

This finds patients whose sex is male or female.

​

Add Filter

Use Add Filter when you want to add another condition inside the same section. For example, in the Patients section:

• Age (Years) is greater than or equal to 50
• Sex is Male

Inside a Visits ingredient:

• Visit Date is greater than or equal to 2 years ago
• Doctor Name is Dr Smith

​

Add Filter Group

A filter group lets you keep a set of filters together. Use filter groups when the Recipe needs a careful mix of AND and OR logic. For example, you might want:

• Age (Years) is greater than or equal to 50
• AND a group where Postcode is 4000 OR Postcode is 4001

If you are unsure, keep the Recipe simple first. Add groups only when one straight list of filters cannot express the patient group clearly.

​

Add Ingredient

Use Add Ingredient when the Recipe needs to look beyond the patient record. Ingredients let you ask about related information, such as:

• visits
• appointments
• prescriptions
• observations
• report values
• reminders
• immunisations
• correspondence
• past history
• smoking or alcohol history

Each ingredient starts with: Where each patient… You then choose the relationship, the related table, and any filters inside that table.

​

Ingredient relationships

PracticeMate supports these ingredient relationships. has any means the patient must have at least one matching related record. Example: has any Prescriptions where Product Name contains amoxicillin. has no means the patient must not have a matching related record. Example: has no Appointments where Appointment Date is after today. only has means all matching related records must fit the filters you set. Use this carefully, because it is more restrictive than “has any”. has a count of lets you count related records. Example: has a count of at least 3 Visits where Visit Date is greater than or equal to 2 years ago. has an average lets you average a number field from related records. Example: has an average Result Value greater than or equal to 6.5 where Result Name contains HbA1c.

​

Count ingredients

Use a count ingredient when the number of records matters. The count controls are:

• exactly
• more than
• at least
• less than
• at most

For “3 or more visits”, use has a count of at least 3 Visits. Always add filters inside the ingredient when the count needs a timeframe or another condition. Otherwise, PracticeMate counts all records in that related table.

​

Average ingredients

Use an average ingredient when you need an average of a number field from related records. An average ingredient asks for:

• the related table
• the number field to average
• the operator
• the comparison value
• filters that decide which records are included in the average

Average ingredients are more advanced. Test them carefully and use clear naming.

​

Saved ingredients

The small import button on an ingredient opens Saved Ingredients. Use saved ingredients for filter patterns your practice uses often, such as a common visit timeframe or prescription search. You can save the current ingredient with a name and description, then load it into another Recipe later.

​

Reordering and deleting

Each filter row has a drag handle on the left and a delete button on the right. Use the drag handle to reorder filters for readability. Reordering filters does not usually change the result unless you are also changing groups or connectors. Use the delete button to remove a filter you no longer need.

​

AI prompt bar

The prompt bar at the bottom of the builder lets you ask PracticeMate to change the Recipe in plain English. For example: Add patients with 3 or more visits in the last 2 years. Review any changes before saving. The visual builder always shows exactly what will be tested and saved.

​

Common checks before saving

Before saving a Recipe, check:

• The title explains the patient group.
• The default active-patient filters are still present if you need them.
• Every filter has a field, operator, and value.
• AND/OR connectors match the plain-English intention.
• Ingredient filters are inside the correct ingredient.
• Date filters use a current relative date when the Recipe should stay up to date.
• The Recipe has been tested and the count looks reasonable.
• The Recipe has been saved after important changes, so Version history has a useful point to return to.