Excluding Users From Home Page Search
Overview
From Activate version 8.1 onwards, custom search filters can be applied to control which objects are included in the home page search index. These filters are applied at index build time and allow organisations to exclude specific users, contacts, or computers based on defined criteria.
This capability is commonly used to remove external accounts or non-relevant directory objects from search results.
How Search Filtering Works
Activate builds its home page search results from an indexed data set. Custom filters modify the underlying query used to build this index.
When a filter is configured and the index is rebuilt:
- Matching objects are excluded from the search index
- Excluded objects do not appear in home page search results
- The filtering applies consistently across searches
Supported Filter Types
The following filter parameters are supported:
- CustomUserFilter – applies to user objects
- CustomContactFilter – applies to contact objects
- CustomComputerFilter – applies to computer objects
Each filter is optional and can be configured independently.
Configuration Steps
Step 1: Create the Filter Parameter
Navigate to:
Resources > Configuration > Search
Add a new parameter using one of the supported filter names:
- CustomUserFilter
- CustomContactFilter
- CustomComputerFilter
Step 2: Define the Filter Condition
Set the parameter value to a valid SQL WHERE condition. This condition is appended to the query used to build the search index.
Example:
Exclude external users from search results:
displayName NOT LIKE '%#EXT#%'
Step 3: Rebuild the Search Index
After saving the filter configuration, trigger a full rebuild of the search index.
The updated index will apply the configured filters and exclude matching objects from home page search results.
Notes and Considerations
- Filters only take effect after a full index rebuild
- Incorrect SQL conditions may result in unexpected exclusions
- Test filter logic carefully before applying in production
- Multiple filters can be configured together as required