# Search

Settings | Search

### Configure Search Sources

The default search source is Entra ID Users.

#### Search Source Options:

There can be multiple search sources of the same type with different configurations. Each search source will appear as another tab in the search panel.

To rearrange the display order of the search tabs on the contact search panel, select a search source from the list and use the up or down arrow to adjust its position.

| Name                            | Description                                                                                      | Link                                                                                                                                                        |
| ------------------------------- | ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Entra ID User Search            | Also known as Active directory users or Microsoft 365 users.                                     | [https://learn.microsoft.com/en-us/graph/api/resources/user](https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0)                |
| Exchange Search                 | Personal Outlook contacts                                                                        | <https://learn.microsoft.com/en-us/graph/api/resources/contact>                                                                                             |
| External Search                 | Custom API Contacts                                                                              | [External Search](https://ac.docs.landis.cloud/appendix/external-search)                                                                                    |
| People Search                   | Returns organization users and contacts relevant to the signed in user. Supports fuzzy matching. | [https://learn.microsoft.com/en-us/graph/api/user-list-people](https://learn.microsoft.com/en-us/graph/api/user-list-people?view=graph-rest-1.0\&tabs=http) |
| Global Exchange Contacts Search | Mail contacts. Also known as Active Directory contacts or organizational contacts.               | <https://learn.microsoft.com/en-us/graph/api/resources/orgcontact>                                                                                          |

#### Search Source Configuration Details:

{% tabs %}
{% tab title="Entra ID User Search" %}
Entra ID search will only search on display name and is a "begins with" search.

<table><thead><tr><th width="298">Column</th><th>Description</th></tr></thead><tbody><tr><td>Search Source Display Name</td><td>Custom display name of search source.</td></tr><tr><td>Max Contact Search Results</td><td>The maximum amount of contacts returned from a search.</td></tr></tbody></table>

{% hint style="info" %}
By default, disabled user accounts are not returned in search results. If you would like disabled accounts to be displayed, enter the text below in the [Custom Settings](https://ac.docs.landis.cloud/advanced#custom-settings) field:

{

"key": "includeDisabledAccountsInAdSearch",

"description": "Filter disabled user accounts in AD Search",

"value": "false"

}
{% endhint %}
{% endtab %}

{% tab title="Exchange Search" %}
Exchange search will only search on display name and is a "contains" search.

| Column                     | Description                                                                                                                                            |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Search Source Display Name | Custom display name of search source.                                                                                                                  |
| Folder ID                  | The Exchange Mailbox contact folder ID.                                                                                                                |
| User ID or UPN             | The Azure active directory ID (GUID) or the user principle name of the mailbox. This can be a primary mailbox or a mailbox with delegated permissions. |
| Max Contact Search Results | The maximum amount of contacts returned from a search.                                                                                                 |

{% hint style="info" %}
To search your default personal contacts folder in your Exchange mailbox, the folder ID and User ID/UPN fields are not required.
{% endhint %}

To retrieve an Exchange contact folder ID:

1. Create a contacts folder in Outlook or OWA.
2. Browse to <https://developer.microsoft.com/en-us/graph/graph-explorer>
3. Sign in to Graph Explorer
4. Change the API URL to <https://graph.microsoft.com/v1.0/me/contactFolders>
5. Select "Modify permissions" tab. Verify consent has been granted to Contacts.Read. If not, consent.
6. Run Query
7. Copy the id of the appropriate contact folder and enter it into Folder ID field in Attendant Console.
   {% endtab %}

{% tab title="External Search" %}
External search can query your custom search API. The response from the API should return contact information that will be shown in the search panel.

For more information, see [External Search](https://ac.docs.landis.cloud/appendix/external-search)

| Column                      | Description                                            |
| --------------------------- | ------------------------------------------------------ |
| Search Source Display Name  | Custom display name of search source.                  |
| External Contact Search URL | External API URL to query for search results.          |
| Max Contact Search Results  | The maximum amount of contacts returned from a search. |
| {% endtab %}                |                                                        |

{% tab title="People Search" %}
People search will search on display name and email and is a "begins with" search. It also supports fuzzy matching.

| Column                     | Description                                                                                                            |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Search Source Display Name | Custom display name of search source.                                                                                  |
| Max Contact Search Results | The maximum amount of contacts returned from a search.                                                                 |
| Subclass                   | Types of contacts that are returned. See: <https://learn.microsoft.com/en-us/graph/search-concept-person#person-types> |
| {% endtab %}               |                                                                                                                        |

{% tab title="Global Exchange Contacts" %}
**Additional permissions are required to enable global Exchange contacts. See** [**Permissions**](https://ac.docs.landis.cloud/permissions#orgcontact.read.all)

Global Exchange Contacts will only search on display name and is a "begins with" search.

| Column                     | Description                                            |
| -------------------------- | ------------------------------------------------------ |
| Search Source Display Name | Custom display name of search source.                  |
| Max Contact Search Results | The maximum amount of contacts returned from a search. |
| {% endtab %}               |                                                        |
| {% endtabs %}              |                                                        |

#### Search Pre-filter

Search pre-filters will always filter the search results by the values in these fields.

| Column               |
| -------------------- |
| Departments          |
| Office Locations     |
| Countries            |
| Postal Codes         |
| Job Titles           |
| Given Names          |
| Surnames             |
| Display Names        |
| Emails               |
| User Principle Names |

### Configure Filters Item Lists

The custom names added to these fields will be listed as persistent filter options in the advanced search panel. Multiple filter options can be added to each field. Each option must be separated by a semicolon. Example:

![](https://3897683970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MeAMhH-VlLBjxTpiKK3%2Fuploads%2FAHgv8BbvhE7dJ9xwsXDo%2Fimage.png?alt=media\&token=09bdc5b0-0fb7-44c5-9b39-53227430e555)

These options will appear in the Advanced search filter:

![](https://3897683970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MeAMhH-VlLBjxTpiKK3%2Fuploads%2F9JvNNgD0wXRwqb6FaP6A%2Fimage.png?alt=media\&token=42513362-0ed8-4db0-9111-21b2b356a4e7)
