For the complete documentation index, see llms.txt. This page is also available as Markdown.

CQL examples

This page contains a series of useful CQL (Crisisworks Query Language) searches for use across all registers.

Overview

Searching and Filtering

CQL (Crisisworks Query Language) can be used to perform advanced searches. They allow you to use structured queries to search for content.

The following search queries can be pasted into the Contains box on the relevant datagrid after you select the filter icon.

Example of CQL search to find all the 'Ricks' and all the 'O'Sheas'

Refer to the Reference Lookup Values table below.

Contacts

The following common CQL searches can be performed in Operations > Contacts:

Name searches

Find contacts with the first name of rick or Rick ✔

Find contacts with last name matching O’Shea or o’shea ✔

Find contacts with first name Rick and last name O’Shea (as well as lowercase versions) ✔

Find contacts with first name of Rick and last name of O’Shea or any Crisisworks user. ✔

Find contacts that have a first name starting with Ric and contacts with last that sounds like Smith. For example this could return a contact called Rick Smith or Ricky Smyth ✘

Perform a full-text search on all fields with the term Rick ✔

Media Searches

Find contacts where an avatar file has been uploaded

Find contacts where the avatar file field is empty

Find contacts where a signature file has been uploaded

Find contacts where the signature file field is empty

Requests

The following common CQL searches can be performed in Operations > Requests:

Due date searches

Find items with due date of 25 March 2026

Find items with an exact due date and time

Find items that were due yesterday

Find items due between the date range provided. For this example it will find all items due between 1st and 20th March 2026

Find items due between between date range and time provided. For this example it will find all items due on 1st April 2026 between 10am and 11am

Find items greater than 7 days ago and less than 6 days ago

Find items where no due date is set

Find items where the due date is set

Requestor searches

Find items where the requestor has a firstName of Rick

Find items where requestor has the firstName of Rick and the lastName of Jones (items must have both of these values set to return a match)

Find items where the requestor has either the firstName of Rick or the lastName of Jones. For example Rick Smith will be a match and Bob Jones will also be a match.

Find items where no requestor has been set

Find items that have a requestor set

Status searches

Find all items in the status of Requested.

Find items in both the Assigned and In Progress statuses. You can use either of these, status key or label.

Region searches

Find items where the region is not set (ie empty)

Find items where the region is either not set or set to the region “default”.

Assignment searches

Find all items assigned to the MEMO Deputy position.

Cost Recovery Method searches

Find items where “Cost Recovery Method” is set to None

Find items where “Cost Recovery Method” is set to “MEMO - authorised council to pay”

Find items where “Cost Recovery Method” is set to “MERC - authorised as an incident cost”

Find items where “Cost Recovery Method” is set to “Requestor - authorised and has agreed to pay”

Find items where “Cost Recovery Method” is set to “Other”

Media Searches

Find items that have no Attachments uploaded

Find items that have Attachments uploaded to the item

Information

The following common CQL searches can be performed in Operations > Information:

Promote on Dashboard searches

Find all items that have the “Promote on dashboard” checkbox ticked. Any of these options will work.

Find all items where the “Promote on dashboard” checkbox is unticked.

Date searches

Find items where the “Expires at” date is before the current date ie Overdue

Find items where the Valid From date is after 1st Jan 2025.

Find items where the Schedule A Review checkbox is ticked

Find items where Schedule A Review checkbox is ticked, and where Valid from date is after 1st Jan 2026

Find items where the Next Review date is after 1st Jan 2025

Find items where the Next Review date is after 1st Jan 2025

Find items where the Next Review date is set

Media Searches

Find items that have no Attachments uploaded

Find items that have Attachments uploaded to the item

Recovery Cases

Affected Person(s) Searches

The following common CQL searches can be performed in Recovery > Cases:

Affected Person(s) searches

Find cases where the Affected Person is unknown

Find cases where the Affected Person is known

Find cases where the Primary Contact has consented to share full details

Find cases where the Primary Contact have not consented to share their details

Find cases where the Primary Contact has not been asked about consent to share their details

Find cases where the Primary Contact or group are of Aboriginal or Torres Strait Islander origin

Below are other ATSI Origin searches where the values are No, Prefer Not to Say or Not Yet Asked

Find cases where the Primary Contact’s Contact Type is set to Individual

Find cases where the Primary Contact’s Contact Type is set to Organisation

Find cases where applicants have the First Name set to Kelly. This will be an exact search for the word “Kelly”. If a middle name is set in this field it will not return a result.

Alternatively you can use a wildcard search as per the example below which will find results such as Kelly, Kelly-Anne or Kelly Rose.

Find cases where applicants have the Family Name set to Smith

Find cases where the applicant has the Family Name set to Smith and the Given Names that start with the word Kelly

Find cases where the applicant has the Family Name set to either Smith or Brown

Find cases where the applicant has the email address “matt.brown@gmail.com"

If the entire email address is not known, a wildcard search can be useful. This will find cases where the applicant’s email address has the word brown anywhere in the email address.

Property Use searches

Find cases where the Property Use has the Residential checkbox ticked

Find cases that have either the Residential - Primary or the Residential - Secondary checkboxes

Find cases that do not have the Residential - Primary checkbox ticked.

Below is a list of all Property Use search terms that can be used to find one of more property uses:

Private Asset searches

Find cases that have one or more Private Assets added

Find cases that have no Private Assets added

Find cases that have a Private Asset added with the category set to Dwelling

Find cases that have a Private Asset added with the category set to either Dwelling or Equipment

Find cases that have a Private Asset added with the Asset Type set to Dairy

Find cases that have a Private Asset added with the Damage Level set to Totally Destroyed

Find cases that have a Private Asset with the Category of Dwelling and has the Damage Level set to either “Totally Destroyed” or “Damaged- Habitable / Functioning”.

Note - this query is using the label of the Damage Level field so the label must be entered exactly as it is displayed.

Alternatively you can use a wildcard to search for the word Damaged within the Damage Level label:

This will return the same result as the previous search without the need for entering the entire label. This will return all cases that have Private Assets with the Category of Dwelling and has the Damage Level starting with the either the words “Damaged” or “Totally”

Alternatively, you can use the numerical keys of the Damage Level field (which is called buildingDamage in the back end).

This will allow you to perform the following search using these numerical keys

This will return the same result as the previous search where the Private Asset Category is set to Dwelling and has the Damage Level set to either “Damaged- Habitable / Functioning” or “Totally Destroyed”.

Will find private assets with the category of Dwelling where the Is this a Primary Place of Residence checkbox is ticked

Needs & Tasks

The following common CQL searches can be performed in Recovery > Needs & Tasks:

Need & Task searches

Find cases that have a Needs & Task record with the category set to Accommodation

Find cases that have a Needs & Task record with the category set to either Accommodation or Counselling

You can also use the label of the category when searching

You can use wildcard searches when using the label if you’re unsure of the entire label

This will return cases that have a Needs & Task record with the category that starts with Livestock. This will return results where the category is set to Livestock Burial, Livestock Feed and Livestock Transport.

General Case Queries

Active cases with no damaged assets and no active tasks searches

Active cases with no damaged assets and no active tasks searches

Active cases with active recovery tasks

Date searches

Find cases where the Referral Date is after 1st Jan 2025

Find cases where the Referral Date is not set

Find cases where the Referral Date is set

Media Searches

Find cases where the field “General Photo(s) of property” is empty

“General Photo(s) of property” field

Find cases where the media field “Case Documents” is empty

Find cases that have photos uploaded into the “Case Documents” field

Cases without Secondary Impact Assessments (SIA) inspections

The objective is to find cases that came from the FRV import process that have been incorrectly closed without having an SIA follow-up. It assumes the council is using one or more tags containing sia to track cases having SIA data or requirements to collect data.

Cases with tasks assigned

The objective is to find active cases where a Needs & Tasks record was created and assigned the MRM Deputy position

Reconciling cases with windemere tag against assignments to Windemere

Some councils use tags at the case level to identify records they want to assign before assignment actually occurs. They then assign the contractor via Needs & Tasks.

To extend the above recipe, this reconciles cases against the windemere tag as follows: the objective is to find records tagged with windemere that have NOT been formally referred to Windemere using a Needs & Tasks record.

Records Tagged with arborist that don't have a recovery task for “arborist”

We want to find all active records that have a tag starting with "arborist" that don't have a task with a label starting with "arborist" so we can bulk create a new task, note once done remove these tags so you are only working with the needs/tasks for the recovery cases

Find the use of the words tree that doesn’t have a recovery task for “arborist”

Look for words in the case anywhere where "tree" or "arborist" appear where there is no task created yet, so you can bulk add a task, you may want to review each record to be sure

Find tagged cases starting with "Fence" that don’t have an affected private asset of "Fence"

We want to find all active records that have a tag starting with "arborist" that don't have a task with a label starting with "arborist" so we can bulk create a new task, note once done remove these tags so you are only working with the needs/tasks for the recovery cases

Find tagged cases starting with "Fence" that don’t have an affected private asset of "Fence"

We want to find all active records that have a tag starting with "arborist" that don't have a task with a label starting with "arborist" so we can bulk create a new task, note once done remove these tags so you are only working with the needs/tasks for the recovery cases

Private Assets

The following common CQL searches can be performed in Recovery > Private Assets:

Private assets without a building type

This CQL finds open records without a buildingType attribute, which is typically a mistake.

Private assets caravans linked to an active Case

Private assets with category of dwelling and building Type of Caravan

Private assets with an attachment uploaded without the tag import

This CQL finds open records with a PDF uploaded that do not have the tag import

Environmental Health Assessments

The following common CQL searches can be performed in Recovery > Environmental Health:

EHAs in ‘inspection required’ even though the inspection was conducted

Some inspections were conducted but the status incorrectly set to ‘inspection required’. We can achieve this by checking if one of the inspection fields has been set.

EHAs in ‘inspection required’ and no inspection was conducted

Infrastructure Assessments

The following common CQL searches can be performed in Recovery > Infrastructure:

Infrastructure searches

Find Infrastructure Assessments with the type of either Council Facility or Council Property with the Damage Level of either “Damaged- Habitable / Functioning” or “Unknown - Requires Assessment”

Reference Lookup Values

Category
Label
Value

Building Category

Dwelling

dwelling

Building Category

Facility

facility

Building Category

Structure

structure

Building Category

Equipment

equipment

Building Category

Vehicle

vehicle

Building Category

Other

other

Building Type

Bikes

vehicle/bike

Building Type

Boats

vehicle/boat

Building Type

Business Economic Impact

other/business-economic-impact

Building Type

Cars

vehicle/car

Building Type

Caravans

dwellling/caravan

Building Type

Community Centre(s)

facility/community

Building Type

Dairy

equipment/dairy

Building Type

Other Dwelling

dwelling/other

Building Type

Other Equipment

equipment/other

Building Type

Other Facility

facility/other

Building Type

Fencing

structure/fencing

Building Type

Flats/Units

dwelling/flat

Building Type

Government

facility/gov

Building Type

Holiday House

dwelling/holiday-house

Building Type

Holiday Rental

dwelling/holiday-rental

Building Type

A Primary Place of Residence

dwelling/house

Building Type

Irrigation Pumps

equipment/irrigation

Building Type

Machinery

equipment/machinery

Building Type

Other

other/other

Building Type

Shed/s

structure/shed

Building Type

Shops/Factories

facility/shop

Building Type

Other Structure

structure/other

Building Type

Tank

structure/tank

Building Type

Trailers

vehicle/trailers

Building Type

Other Vehicle

vehicle/other

Building Damage (Damage Level)

Habitable / Functioning

1

Building Damage (Damage Level)

Uninhabitable / Non-Functioning

2

Building Damage (Damage Level)

Partially Destroyed (no longer used)

3

Building Damage (Damage Level)

Destroyed

4

Building Damage (Damage Level)

Unknown - Requires Assessment

5

Building Damage (Damage Level)

Not Damaged

6

Last updated

Was this helpful?