> For the complete documentation index, see [llms.txt](https://knowledge.maica.com.au/maica-knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledge.maica.com.au/maica-knowledge-base/appointments/create-an-appointment/general/smart-selection-filter.md). # Smart Selection Filter Learn about how the Smart Selection Filter works in Maica ## What is the Smart Selection Filter? The Smart Selection Filter is a tool designed to identify and rank the most suitable [Participant(s)](/maica-knowledge-base/getting-started/maica-key-concepts/participant.md), [Resource(s)](/maica-knowledge-base/getting-started/maica-key-concepts/resource.md), or [Asset(s)](/maica-knowledge-base/getting-started/maica-key-concepts/asset.md) for an [Appointment](/maica-knowledge-base/getting-started/maica-key-concepts/appointment.md) based on a range of possible `Attributes`. It simplifies the roster selection process by comparing all available options to selected attributes and presenting them in an ordered list based on matches. This feature allows you to quickly and efficiently select the optimal fit for your [Appointment](/maica-knowledge-base/getting-started/maica-key-concepts/appointment.md). Unlike the Resource Optimiser (which evaluates multiple Appointments at once), Smart Selection is a **single-record, real-time matching tool** designed to help end users pick the best candidate during scheduling. ## What does the Smart Selection Filter do? The Smart Selection Filter helps end users choose the most suitable: * **Participant(s)** * **Resource(s)** * **Asset(s)** for an Appointment or Shift by: 1. Filtering out anyone who fails key requirements 2. Scoring everyone who remains 3. Ranking them in order of suitability based on your selected Sort Criteria It uses a simplified version of the [Resource Optimiser](/maica-knowledge-base/the-planner/resource-optimiser.md), providing real-time scoring for a *single* selection. ## Where do I find the Smart Selection Filter? In **Maica**, you select Participant(s), Resource(s), and Asset(s) in the [Basic Details](/maica-knowledge-base/appointments/create-an-appointment/general/basic-details.md) stage of creating or managing an Appointment, it is here you will also find the Smart Selection Filter. On the right side of the selection search box, you will see a `Filter` symbol; simply click this `Filter` to open the Smart Selection Filter pop-up, as shown below. {% hint style="success" %} This tool can also be accessed across Maica where Participant, Resource or Asset selectors are available {% endhint %}
Standard ExperienceLegacy Experience
## Smart Selection Filter Elements Once you have clicked on the Filter icon, and Smart Selection Filter pop-up has been presented, you will notice a number of elements within the tool. These are described below:
ElementDescription
  1. Sort Order Toggle
This button allows you to switch the display order of the list between ascending and descending, letting you view the items from top to bottom or bottom to top based on the current sort criteria.
  1. Score
Displays the calculated Matching Score (%) for each Resource. The score reflects how well the Resource meets the current Skills, Attributes, Availability, Workload, and Travel criteria (based on Matching Score weightings). The list is sorted by this score unless you change the Sort Criteria.
  1. Sort Criteria Dropdown
Allows you to choose how the Resource list is ordered. Overall Matching Score is always available, and each of Availability, Workload, Skills, Attributes and Travel appears only where that criterion currently carries a weighting. These options are detailed below.
  1. Ranking Criteria
Allows you to add additional scoring rules that influence how Resources are ranked. Ranking Criteria work the same as in the Optimiser: each rule consists of a Field, Operator, and Value, and Resources earn score if they match the defined rules.
  1. Settings
Opens the Smart Selection Filter settings panel, allowing you to refine which Resources appear in the list. This includes options such as Only allocated Resources (show only Resources linked to the selected Participant) and Only matched Resources (hide Resources that do not meet the Required Skills and Attributes you have selected). These settings affect the candidate list before scoring is applied. To learn more, see Only matched Resources.
{% hint style="info" %} When you are selecting a Resource, the toolbar also has a **Resource Pool** button, as the first icon. It lets you remove Resources from the list before any scoring takes place. To learn more, see [Resource Pool](#resource-pool). {% endhint %} ## Resource Pool The **Resource Pool** works in the same way as the Resource Pool in the [Resource Optimiser](/maica-knowledge-base/the-planner/resource-optimiser.md#resource-pool). It defines a smaller group of Resources, and any Resource outside the pool is removed from the list. This is different from **Ranking Criteria**, which only change the order and the score of the Resources that remain. To use the Resource Pool: 1. Click the **Resource Pool** button, the first icon in the toolbar. 2. Click **Add Criteria**, then choose a **Field**, **Operator** and **Value**, as described in [How do I use the Smart Selection Filter?](#how-do-i-use-the-smart-selection-filter) 3. Watch the **Current Pool** count. It shows how many Resources match your criteria and updates as you add them, before you apply the pool. 4. Click apply to filter the list. {% hint style="info" %} The **Resource Pool**, **Ranking Criteria** and **Settings** panels are mutually exclusive. Opening one closes the others. {% endhint %} ### How the Resource Pool behaves * Resources that are already assigned to the Appointment or Shift are still shown, even where they fall outside the pool. * The **Resource Pool** button is highlighted whenever a pool is active, including a pool that was passed in from another screen. * The last pool you applied is remembered in your browser and is used the next time you open the window. It is kept separately from the Resource Optimiser's saved pool, and it is shared by anyone using the same browser. * Where the screen that opened the window passes in a pool, that pool is shown and applied instead of your saved pool. This includes an empty pool passed in from the Resource Optimiser. * **Reset** returns the pool to the one the window opened with. * The **Current Pool** count includes criteria on related fields, for example a criterion on a Resource's User or Primary Location. The count uses your own field access, so a criterion on a field you cannot read counts zero Resources. ## Only matched Resources With **Only matched Resources** turned on in **Settings**, Maica removes Resources that do not meet your Required criteria before it scores the rest. * **Required attribute criteria:** a Resource must meet every Required attribute criterion, not just one. * **Required Skills:** each Required skill row filters the list. A Resource meets a row by holding any one of that row's Skills, and must meet every Required row. This applies whatever the Skills weighting is set to. * **Preferred rows:** Preferred criteria never exclude a Resource. They only affect the score. * **Required Resources:** a Resource marked as Required for the selected Participant still appears. * **Text area criteria:** a short text area criterion filters as text. A criterion on a long or rich text area only affects the score. {% hint style="warning" %} The Resource Optimiser and Broadcasting turn **Only matched Resources** on, so their candidate lists narrow in the same way. Where you add two or more Required attribute criteria, a Resource that meets only some of them is no longer offered. {% endhint %} ## Smart Selection Filter Dropdown Criteria Sections {% hint style="info" %} The Dropdown Criteria Sections are only relevant when selecting a Resource(s). When selecting Participant(s) or Asset(s), your `Score` will be a number based purely on the number of matching `Attributes`. {% endhint %} When selecting a Resource(s), you can chose to order your list based on a number of additional criteria. These are further explained in the table below:
CategoryDescription
SkillsMeasures how many of the required Skills a Resource has compared with the total Skills needed.
AvailabilityChecks whether the Resource has enough Available hours on the relevant day to cover the Appointment or Shift. Any existing usage or unavailability is subtracted from the daily limit, and the remaining time is compared against the requirement. The resulting score is weighted by the Availability percentage.
WorkloadEvaluates weekly capacity by comparing the required minutes for the Appointment or Shift plus the Resource’s current scheduled hours against their weekly limit. The result is scaled by the Workload importance percentage.
AttributesCounts how many requested Attributes a Resource satisfies (for example, gender, language, or experience).
TravelScores proximity by comparing the Resource’s distance to the Appointment location against the closest candidate. Resources co-located or nearest to the site receive the highest score, weighted by the Travel importance percentage.
### Which criteria appear in the Sort Criteria dropdown A criterion weighted at 0% contributes nothing to a Resource’s score, so Maica does not offer it as a sort option. The dropdown therefore lists only what has actually been scored for the current search.
Sort optionAppears when
Overall Matching ScoreAlways
Availability, Workload, Skills, AttributesThe criterion’s weighting is above 0%
TravelThe Travel weighting is above 0% and the Appointment has a Location Type
The weightings are resolved for each search in three layers, and the dropdown reflects the final result: 1. The org-wide **Matching Score Importance Level** in Settings 2. The **Shift** equivalents of those weightings, where the record is a Shift 3. Any per-run override set through the Optimiser’s **Ranking Criteria** sliders {% hint style="warning" %} **Travel** does not appear for a Shift unless your organisation has given the Shift Travel weighting a value. It ships at 0%, so its absence from the dropdown on a Shift is correct rather than a missing option. {% endhint %} {% hint style="info" %} If you have already sorted by a criterion and its weighting is then reduced to 0%, the list falls back to **Overall Matching Score** the next time it refreshes, rather than leaving the selection unresolved. {% endhint %} ### Shifts Maica identifies a Shift from its Record Type, so a Shift is scored with the **Shift** weightings from **Rostering Settings** rather than the Appointment weightings. The same applies in the Resource Optimiser, in Highest Scoring assignment of broadcast Shifts, and in Schedule Manager bulk allocation. The Shift rules also apply in the Smart Selection Filter: * The Shift overlap setting is honoured. * A Resource whose roster mode is Appointment is shown as unavailable, with the message "There's a Roster Mode Conflict for the Resource." * The coverage check that applies only to Appointments does not run for Shifts. ### Required and Preferred Resources Where a Participant has Resources marked as **Required**, those Resources are placed at the top of the list and are always included, regardless of their score, even where more Resources match than the list can show. Every search filter still applies to them. A Required Resource that falls outside your search term, the Resource Pool, or the excluded Resources is not surfaced. Required Resources survive the row limit, not the filters.
IconMeaning
Green tickThe Resource is Required for the selected Participant
Orange starThe Resource is Preferred for the selected Participant
{% hint style="info" %} Where a Resource is both Required and Preferred, the green tick takes precedence, in both the desktop and mobile layouts. The same applies to Required Assets in the Asset picker. {% endhint %} ### How many Resources are shown The number of rows the list returns is capped by the **Find Resource Number of Rows** setting, which defaults to 100. The list is ordered by Resource Name when this cap applies, so the same Resources are returned from one search to the next. With **Only matched Resources** on, the cap and the footer count only the Resources that match. Where records were left out, a footer reads “A limited number of records is shown”. Narrow your search term, or apply Ranking Criteria, to bring the list within the cap. {% hint style="warning" %} Resources outside the cap are not selected by score, because scoring happens after the candidate list is retrieved. Where your organisation regularly exceeds the cap, refine the search rather than relying on the top of the list being the best match. {% endhint %} ## How do I use the Smart Selection Filter? To use the Smart Selection Filter, you only need to open it and select your Resource, Participant or Asset, as they will already be ranked by scores generated from your Global Settings and Appointment conditions! However, we advise adding Ranking Criteria refine suitability. To do so, {% hint style="info" %} To learn about the logic behind Ranking Criteria, [click here](/maica-knowledge-base/the-planner/resource-optimiser.md#ranking-criteria). {% endhint %} 1. Click **Add Criteria**. 2. A new filter row will appear where you can specify the **Field**, **Operator**, and **Value**. 3. Multiple criteria can be added to refine the criteria further. **Understanding Filter Components** Each criterion is made up of three components:
ComponentDescription
FieldDefines which field the Optimiser will evaluate. Fields are grouped under Resource or Skill objects.

Examples include Resource → Work Type, Resource → Gender, or Skill → Certificate.
OperatorDetermines how the value is compared to the field. Common operators include equals, not equal to, contains, and does not contain. The Operator value is refined depending on the selected Field.
ValueThe specific value being matched against the field. This may be a picklist option, text entry, or date, depending on the selected field. For example, if Resource → Gender is chosen, available values might be Man or Woman.
Once done, click the **✓** button to apply your selected Criteria. The candidate list will update automatically, with each row recalculated based on your filters and Smart Selection logic and new percentages presented. {% hint style="success" %} You can click on a % score to see a more detailed breakdown of that score {% endhint %} {% hint style="info" %} The Smart Selection Filter uses the **same scoring, ranking, and weighting logic** as Maica’s Optimisation Engine to calculate scores. For a detailed explanation of how scores are calculated (Availability, Workload, Skills, Attributes, Travel, and weighted scoring), refer to the [**Optimisation Engine Logic**](/maica-knowledge-base/maica-administration-guide/system-processes/maicas-optimisation-engine.md) article. {% endhint %} ## **How Smart Selection Differs for Resources, Participants, and Assets** The Smart Selection Filter adapts depending on the type of record you are selecting. #### **Resource Selection (Most Comprehensive)** When selecting a Resource, Smart Selection uses the **full Matching Score logic**, including: * Skills * Attributes * Availability * Workload * Travel * Ranking Criteria Sort Criteria options include the **Overall Matching Score** plus each category that currently carries a weighting, using the same weighting model as the Optimiser. #### **Participant Selection** When selecting a Participant, Smart Selection uses a simplified evaluation model: * **Only Attributes are used for scoring** * Skills, availability, workload, and travel do **not** apply * Ranking Criteria can still be added, but only Attribute-based fields impact scoring The Score column for Participants represents the number of matched Attributes. #### **Asset Selection** Asset matching also uses Attributes only. Examples include: * Vehicle type * Equipment category * Capacity * Location Skills and capacity-based logic used for Resources do not apply. The Score column reflects matched Attribute count. These available options are summarised in the table below:
Target TypeSkillsAttributesAvailabilityWorkloadTravelScore Model
Resource✔✔✔✔✔Overall Matching Score (weighted)
Participant✖✔✖✖✖Attribute match count
Asset✖✔✖✖Optional (location-based)Attribute match count