| Edwin Kempin | 6cfbb29 | 2017-01-04 09:40:50 +0100 | [diff] [blame] | 1 | = Gerrit Code Review - Searching Groups |
| 2 | |
| 3 | Group queries only match internal groups. External groups and system |
| 4 | groups are not included in the query result. |
| 5 | |
| Edwin Kempin | bad4591 | 2017-01-04 13:42:51 +0100 | [diff] [blame] | 6 | == Basic Group Search |
| 7 | |
| 8 | Similar to many popular search engines on the web, just enter some |
| 9 | text and let Gerrit figure out the meaning: |
| 10 | |
| 11 | [options="header"] |
| 12 | |====================================================== |
| 13 | |Description | Examples |
| 14 | |Name | Foo-Verifiers |
| 15 | |UUID | 6a1e70e1a88782771a91808c8af9bbb7a9871389 |
| 16 | |Description | deprecated |
| 17 | |====================================================== |
| 18 | |
| Edwin Kempin | 6cfbb29 | 2017-01-04 09:40:50 +0100 | [diff] [blame] | 19 | [[search-operators]] |
| 20 | == Search Operators |
| 21 | |
| 22 | Operators act as restrictions on the search. As more operators |
| 23 | are added to the same query string, they further restrict the |
| Edwin Kempin | bad4591 | 2017-01-04 13:42:51 +0100 | [diff] [blame] | 24 | returned results. Search can also be performed by typing only a text |
| 25 | with no operator, which will match against a variety of fields. |
| Edwin Kempin | 6cfbb29 | 2017-01-04 09:40:50 +0100 | [diff] [blame] | 26 | |
| Edwin Kempin | c109ec1 | 2017-01-04 11:09:09 +0100 | [diff] [blame] | 27 | [[description]] |
| 28 | description:'DESCRIPTION':: |
| 29 | + |
| 30 | Matches groups that have a description that contains 'DESCRIPTION' |
| 31 | (case-insensitive). |
| 32 | |
| Edwin Kempin | a45b072 | 2017-01-03 16:15:01 +0100 | [diff] [blame] | 33 | [[inname]] |
| 34 | inname:'NAMEPART':: |
| 35 | + |
| 36 | Matches groups that have a name part that starts with 'NAMEPART' |
| 37 | (case-insensitive). |
| 38 | |
| Edwin Kempin | b07a4f9 | 2017-01-04 12:59:25 +0100 | [diff] [blame] | 39 | [[is]] |
| Edwin Kempin | 2086cbb | 2017-01-16 13:49:15 +0100 | [diff] [blame] | 40 | [[is-visibletoall]] |
| 41 | is:visibletoall:: |
| Edwin Kempin | b07a4f9 | 2017-01-04 12:59:25 +0100 | [diff] [blame] | 42 | + |
| 43 | Matches groups that are in the groups options marked as visible to all |
| 44 | registered users. |
| 45 | |
| Edwin Kempin | a45b072 | 2017-01-03 16:15:01 +0100 | [diff] [blame] | 46 | [[name]] |
| 47 | name:'NAME':: |
| 48 | + |
| 49 | Matches groups that have the name 'NAME' (case-insensitive). |
| 50 | |
| Edwin Kempin | e661af0 | 2017-01-04 12:00:33 +0100 | [diff] [blame] | 51 | [[owner]] |
| Edwin Kempin | dad613e | 2017-01-13 17:08:10 +0100 | [diff] [blame] | 52 | owner:'OWNER':: |
| Edwin Kempin | e661af0 | 2017-01-04 12:00:33 +0100 | [diff] [blame] | 53 | + |
| Edwin Kempin | dad613e | 2017-01-13 17:08:10 +0100 | [diff] [blame] | 54 | Matches groups that are owned by the group whose name best matches |
| 55 | 'OWNER' or that has the UUID 'OWNER'. |
| Edwin Kempin | e661af0 | 2017-01-04 12:00:33 +0100 | [diff] [blame] | 56 | |
| Edwin Kempin | 6cfbb29 | 2017-01-04 09:40:50 +0100 | [diff] [blame] | 57 | [[uuid]] |
| 58 | uuid:'UUID':: |
| 59 | + |
| 60 | Matches groups that have the UUID 'UUID'. |
| 61 | |
| 62 | == Magical Operators |
| 63 | |
| 64 | [[is-visible]] |
| 65 | is:visible:: |
| 66 | + |
| 67 | Magical internal flag to prove the current user has access to read |
| 68 | the group. This flag is always added to any query. |
| 69 | |
| 70 | [[limit]] |
| 71 | limit:'CNT':: |
| 72 | + |
| 73 | Limit the returned results to no more than 'CNT' records. This is |
| 74 | automatically set to the page size configured in the current user's |
| 75 | preferences. Including it in a web query may lead to unpredictable |
| 76 | results with regards to pagination. |
| 77 | |
| 78 | GERRIT |
| 79 | ------ |
| 80 | Part of link:index.html[Gerrit Code Review] |
| 81 | |
| 82 | SEARCHBOX |
| 83 | --------- |
