{"id":1504,"date":"2011-05-24T20:15:39","date_gmt":"2011-05-24T20:15:39","guid":{"rendered":"https:\/\/www.wapshere.com\/missmiis\/?p=1504"},"modified":"2011-05-24T20:37:32","modified_gmt":"2011-05-24T20:37:32","slug":"search-scopes","status":"publish","type":"post","link":"https:\/\/www.wapshere.com\/missmiis\/search-scopes","title":{"rendered":"Search Scopes"},"content":{"rendered":"

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.
\n\"\"<\/a>
\n<\/p>\n

Example: Creating a Search Scope on the Users page<\/h3>\n

Here’s how I made the “BPOS Active Users” search scope.<\/p>\n\n\n\n\n\n
To create a Search Scope go to Administration -> Search Scopes -> New.
\nHere I have added two usage keywords:<\/p>\n
    \n
  • “Person” states that you want the search scope to appear on the Users page, and<\/li>\n
  • “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.<\/li>\n<\/ul>\n

    I also set the order to 3 to control where I want the search scope to appear in the drop-down list pictured above.<\/td>\n

<\/a><\/a>\"\"<\/a><\/td>\n<\/tr>\n
On the next page, list the attributes that you want to search on when using the scope.
 
\nThe 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.
 
\nNote the trick I’ve done with “(EmployeeID != ”)”. This corresponds to objects with <\/em>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<\/em>.<\/td>\n		\"\"<\/a><\/td>\n<\/tr>\n
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.
 
\nYou 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.
 
\nSubmit the new Search Scope.
 
\nYou will need to do an IISRESET before the search scope appears.<\/td>\n		\"\"<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Access permissions for the ITAdminUI Usage Keyword<\/h4>\n

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.<\/p>\n\n\n\n\n
Create a Set of all Search Scopes with your selected keyword – in my case “ITAdminUI”.<\/td>\n\"\"<\/a><\/td>\n<\/tr>\n
Create an MPR which gives Read permission for this Set to the users who you want to be able to use the Search Scope.<\/td>\n\"\"<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Another example: Distribution List Search Scope<\/h3>\n

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:<\/p>\n

    \n
  • Distribution<\/li>\n
  • Group<\/li>\n
  • AllDGs<\/li>\n<\/ul>\n

    plus the keyword that gives the access permissions, eg.,<\/p>\n

      \n
    • BasicUI<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"

      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…<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"jetpack_post_was_ever_published":false,"footnotes":"","jetpack_publicize_message":"","jetpack_is_tweetstorm":false,"jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":[]},"categories":[42],"tags":[],"class_list":["post-1504","post","type-post","status-publish","format-standard","hentry","category-fim-2010"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_shortlink":"https:\/\/wp.me\/pkp1o-og","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/posts\/1504","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/comments?post=1504"}],"version-history":[{"count":17,"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/posts\/1504\/revisions"}],"predecessor-version":[{"id":1528,"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/posts\/1504\/revisions\/1528"}],"wp:attachment":[{"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/media?parent=1504"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/categories?post=1504"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.wapshere.com\/missmiis\/wp-json\/wp\/v2\/tags?post=1504"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}