Confluence Docs 3.0 : Searching for Users This page last changed on Dec 02, 2008 by smaddox. This page tells you how to use the 'User Search' window, which appears when you click a 'Choose Users' link or a user search icon on a Confluence page. On this page: Accessing the User Search Using the Simple User Search Using the Advanced User Search Searching for Users in One or More Groups Selecting One or More Users More about the User Search ## Accessing the User Search To access the 'User Search' window, Click the user search link or icon when you are performing one of the following actions: When setting page restrictions, click the 'Choose users' link. When assigning space permissions, click the icon in the users section. When adding members to a group, click the icon. The simple 'User Search' window will appear, as shown below. ## Using the Simple User Search
| Crowd and the User Search If you are using Atlassian's Crowd for user management, you will need Crowd 1.5.1 or later to use the 'Simple' option in the user search. If your version of Crowd does not support the simple user search, you will see only the 'Advanced' search form.
To search via the simple user search, Select the 'User' tab on the 'User Search' screen. (See above for instructions on accessing the screen.) If the 'Simple' link is showing, click it. (If you see the 'Advanced' link and no 'Simple' link, then you're fine. The simple search is already active.) The simple user search screen will appear, as shown below. Type some information about the user into the 'Search' textbox. You can type all or part of their username, full name or email address. Click the 'Search' button. Confluence will return a list of matching users. See below for instructions on selecting one or more users. Screenshot: Simple user search ## Using the Advanced User Search The advanced user search allows you to specify the field in which your search term appears, i.e. username, full name or email address. You may find this useful if you need to limit the number of users appearing in the search results. To search via the advanced user search, Select the 'User' tab on the 'User Search' screen. (See above for instructions on accessing the screen.) If the 'Advanced' link is showing, click it. (If you see the 'Simple' link and no 'Advanced' link, then you're fine. The advanced search is already active.) The advanced user search screen will appear, as shown below. Complete one or more of the following fields: User Name — Enter all or part of the person's username i.e. their login id, e.g. 'joe', or 'bloggs'. Full Name — Enter all or part of the person's name, e.g. 'joe bloggs', or 'bloggs', or 'joe'. E-Mail — Enter all or part of the person's email address, e.g. 'acme' Click the 'Search' button. Confluence will return a list of matching users. See below for instructions on selecting one or more users. Screenshot: Advanced user search ## Searching for Users in One or More Groups You can also list the users who appear in a particular group or in a set of groups. To search for users in a particular group, Select the 'Membership' tab on the 'User Search' screen. (See above for instructions on accessing the screen.) The 'Group Membership' search screen will appear, as shown below. Type all or part of a group name into the 'Search' textbox. Click the 'Search' button. Confluence will return a list of users belonging to any groups which match your search term. In the example screenshot below, we entered a group name of 'dev'. The search results show all users belonging to the group 'developers' and all users belonging to the group 'developers-mates'. Now you can select one or more users, as described below. Screenshot: Searching for users in a group ## Selecting One or More Users After searching for users and receiving a list of names from Confluence, as described above, you can now select the user(s) you need. To select one or more users, Click the box next to the username(s) to select or unselect one or more users. You can click 'Check All' to select or unselect all users. Click the 'Select User(s)' button. The 'User Search' window will close and the selected users will appear on the screen which you were using before you accessed the user search. Screenshot: Selecting one or more users ## More about the User Search ##### Case Sensitivity The search is not case sensitive. You can enter either upper- or lower-case text, and it will make no difference to the search results. ##### Wild Cards The search allows the asterisk as a wild card, but you do not need to use it. The search results will be the same whether you use a wild card or not. The wildcard functionality remains available for compatibility with older versions of Confluence. You can use an asterisk '*' as a wild card when entering user details. The search will allow one or more characters to match the asterisk. For example: Enter `jon*` to retrieve all the following: 'Jon Bloggs', 'Jon Smith' and 'Jonathan Jones', etc Enter `*bloggs` to retrieve all the following: 'James Jon Bloggs', 'Joe Bloggs', 'Jon Bloggs' and 'Richard Bloggs', etc Enter `*jon*` to retrieve all the following: 'James Jon Bloggs', 'Jon Bloggs', 'Jon Smith' and 'Jonathan Jones', etc ##### RELATED TOPICS Searching Confluence Setting a Page's Restrictions Assigning Space Permissions Adding or Removing Users in Groups Take me back to Confluence User Guide Attachments: MagnifyingGlass.png (image/png) UserSearch2.png (image/png) UserSearch1.png (image/png)

Document generated by Confluence on Nov 05, 2009 23:36