> For the complete documentation index, see [llms.txt](https://help.security.gallagher.com/knowledge-hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.security.gallagher.com/knowledge-hub/command-centre-client/configuring-command-centre/configuring-licensable-features/broadcast-notification-configuration/creating-a-new-broadcast-notification/select-by-criteria.md).

# Select by Criteria

1. Select **by Criteria**.

   The Advanced Search Rule Definition pop-up displays.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-b4b309c5640d7fbfe0e5224671dcd889e063fab6%2Fadvancesearchrules_popup.png?alt=media)

   This pop-up allows you to set the rules, (i.e. one or more conditions) to define your search. If a rule has been defined previously this pop-up will be pre-populated, otherwise the grid will be empty.
2. Click on the function you want to perform:

<details>

<summary>Inserting a condition</summary>

1. Click the **Insert Condition** button.

   The Cardholder Search Condition pop-up displays.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-e8ed6ef6427592f87fdfffbd1ab4bc60db85c677%2Feditcondition_popup.png?alt=media)
2. Select a Condition **Type** from the drop-down list.

   The options available depend on the Condition Type you selected.
3. Select the appropriate options for the condition you require.

   **Note:** For a multi-server system, if you select to search on "Cardholder last requested access", aggregation must be turned on in order for the search results to be accurate.
4. Click the **OK** button.

   The condition is added to the Advanced Search Rule Definition pop-up.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-ef1152121d0ea7f319b2a888494cfaf450366c56%2Faddedcondition_advancedsearch.png?alt=media)
5. Repeat Steps 1 - 4 for each additional condition you want applied to this rule.

   Each additional condition is also added to the Advanced Search Rule Definition pop-up. As conditions are added an **'And'** will appear to the left of the added row (as shown below):

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-7d1cdbc3342ec0d83f68ee46320a36db7c0012e4%2Faddedcondition_advancedsearch2.png?alt=media)

   **Notes:**

   * The conditions can be re-ordered by clicking the ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-29736411754d57a3b21865d1406c092a8221406f%2Fstatus_orderbuttons.png?alt=media) buttons.
   * Only Cardholders who match ALL conditions will be returned in the Search results.
   * Each condition can only be added once to the same "And" grouping in a Cardholder search, with the exception of unique Personal Data Fields and Competencies.
   * The **'And'** setting of a condition can be changed to **'Or'** by selecting the condition and clicking the **Change to 'Or'** button. The **'And'** is replaced with **'Or'** above the row of the selected condition (as shown below):

     ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-6b0d4abb13fc9f22db6154c550abc50f2728dd14%2Faddedcondition_advancedsearch3.png?alt=media)

     Should you want to revert it back to **'And'**, either select the row the **'Or'** is on and click the **Change to 'And'** button, or click the **Cancel** button.

</details>

<details>

<summary>Editing an existing condition</summary>

1. Click the **Edit** Condition button.

   The Cardholder Search Condition pop-up displays and is populated with data relevant to the condition type selected.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-59457898acfec6e2d08fe989f410632896c4c5b2%2Feditexistingcondition_popup.png?alt=media)

   **Note:** In this example, all cardholders that have an expired Competency will be included in the Advanced Search.
2. Edit the condition as required, and click the **OK** button.

   The condition is altered accordingly in the Advanced Search Rule Definition pop-up.

   **Note:** The conditions can be re-ordered by clicking the ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-29736411754d57a3b21865d1406c092a8221406f%2Fstatus_orderbuttons.png?alt=media) buttons

</details>

<details>

<summary>Removing a condition</summary>

Click the **Remove** button.

The condition is removed from the Advanced Search Rule Definition pop-up.

</details>

3. Click the **Search** button.

   The search starts immediately and the Cardholder filter appears in the **Cardholder Selection** grid.

   **Notes:**

   * Clicking the ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-46de7e526830dd1b8bd583073883ebba6321ce51%2Fdisplaycholdbutton.png?alt=media) button opens a Cardholder Selection pop-up that displays the cardholders that fit the search criteria.

     ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-8e0625767e947142f7c5cf8e2a9e8f9b69d889cc%2Fbulkchange_choldselectionpopup.png?alt=media)
   * Cardholder filters in the **Cardholder Selection** grid can be edited by clicking the ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-7c2828918c7cb681beaf46588ec4d5b23de9a63b%2Feditfilterbutton.png?alt=media) button, or removed by clicking the ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-7fa22e8d9be426ba5f5787abe105815d42650a55%2Fremovefilterbutton.png?alt=media) button.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.security.gallagher.com/knowledge-hub/command-centre-client/configuring-command-centre/configuring-licensable-features/broadcast-notification-configuration/creating-a-new-broadcast-notification/select-by-criteria.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
