Search Scopes

Search Scopes are a handy way to make it easier for your users to find things, and can be particularly helpful clarifying where they do and do not have admininistrative rights. Here’s an example of the Search Scopes I’ve provided for IT admins on the Users portal page. Admins can search through all users, or just the ones they manage. They can also view users who fall into particular categories.

Example: Creating a Search Scope on the Users page

Here’s how I made the “BPOS Active Users” search scope.

To create a Search Scope go to Administration -> Search Scopes -> New.
Here I have added two usage keywords:

  • “Person” states that you want the search scope to appear on the Users page, and
  • “ITAdminUI” is a keyword I have defined for use by people with an IT Admin role. There is more on how you set the appropriate permissions below. If you want the search scope to be available to all users then you can instead use “BasicUI” here.

I also set the order to 3 to control where I want the search scope to appear in the drop-down list pictured above.

On the next page, list the attributes that you want to search on when using the scope.
The most important part is the filter. Rather annoyingly you can’t use membership of a Set here, so you may find yourself replicating a definition you’ve already made elsewhere.
Note the trick I’ve done with “(EmployeeID != ”)”. This corresponds to objects with an EmployeeID – however because I’ve only allowed IT Admins to read the EmployeeID of users they administer, this has the resultant effect of listing only BPOS Active Users that the viewer administers.
Finally I specify the object type that should be returned by a search, and the columns I want to see. The columns should be the same as in the “All Users” search scope, so simplest just to copy from there.
You can change the columns to be displayed by modifying this Attribute field, but I’m pretty sure things will work better if you make the colums the same across all search scopes appearing on the Users page.
Submit the new Search Scope.
You will need to do an IISRESET before the search scope appears.

Access permissions for the ITAdminUI Usage Keyword

Above I used the keyword “ITAminUI” because I want the search scope to be available only to IT Administrators. If, instead, you used “BasicUI” you won’t need to follow this bit because the scope is already available to everyone.

Create a Set of all Search Scopes with your selected keyword – in my case “ITAdminUI”.
Create an MPR which gives Read permission for this Set to the users who you want to be able to use the Search Scope.

Another example: Distribution List Search Scope

I’m not going to go through the whole thing again, however I wanted to mention the Usage Keywords that you need to use to add a search scope that appears on the Distribution Lists page. I’m not exactly sure why but I found that I needed all of the following:

  • Distribution
  • Group
  • AllDGs

plus the keyword that gives the access permissions, eg.,

  • BasicUI

Leave a Reply

Your email address will not be published. Required fields are marked *