The search area includes all the necessary info to make use of the SCM-Managers search option (excluding the plugin functionality)
\nThere are two types of queries. The first is the simple query.\nA simple query only contains terms and does not contain any of the operators listed below (for example 'AND').\nEvery term used in a simple query get implicitly extended with the * operator at the end. This means that searching for 'Repo' will also match the term 'Repository'.\nThe second type of query is the expert query. Any query that contains at least one operator is considered as an expert query. This query type allows for complex searches.\nBut terms used in the expert query are not extended with the * implicitly. A user has to add them explicitly to a term.
\nSCM-Manager is built for code, and in code one often uses \"CamelCase\" words. To make it easier to search for these words,\nwe split them into separate words. This means that searching for SomeManager will also match the term\nSomeRepositoryManager. If you want to avoid this, you can simply type your words in small letters only. In the example\nabove, searching for somemanager will only match the term SomeManager but not SomeRepositoryManager.
Note: You can not use wildcards as the first character of a search
\n| Definition | \nExample | \n
|---|---|
| ? - single character Wildcard | \n\"Ultimate?Repo\" – finds e.g. Ultimate-Repo, Ultimate Repo, Ultimate+Repo | \n
| * - multiple character Wildcard | \n\"Ultimat*y\" - finds e.g. Ultimate Repository, Ultimate-Special-Repository, Ultimately | \n
Range Queries allow one to match documents whose field(s) values are between the lower and upper bound specified by the Range Query. Range Queries can be inclusive or exclusive of the upper and lower bounds. Sorting is done lexicographically.
\nRanges are not reserved to numerical fields.
\n| Definition | \nExample | \n
|---|---|
| [ … TO … ] - inclusive range | \n\"creationDate:[1609459200000 TO 1612137600000]\" – finds e.G. repositories created between 2021-01-01 and 2021-02-01 | \n
| {… TO …} - exclusive range - multiple character Wildcard | \n\"name:{Aida TO Carmen}\" – finds e.G. repositories with names between Aida and Carmen, excluding these to values | \n
Boosting allows you to control the relevance of a document by boosting its term.
\n| Definition | \nExample | \n
|---|---|
| term^number | \n\"ultimate^2 repository\" – makes the term ultimate more relevant | \n
By default, the boost factor is 1. Although the boost factor must be positive, it can be less than 1 (e.g. 0.2)
\nBy default Repository names are boosted by 1.5, namespace by 1.25.
\nNote: Logical Operators must be entered in upper case (e.g. \"AND\").
\n| Operator | \nDefinition | \nExample | \n
|---|---|---|
| AND | \nBoth terms must be included | \n\"Ultimate AND Repository\" – finds e.g. Ultimate Repository, Ultimate Special Repository | \n
| OR | \nAt least one of the terms must be included | \n\"Ultimate OR Repository\" – finds e.g. Ultimate Repository, Ultimate User, Special Repository | \n
| NOT | \nFollowing term may not be included, \"!\" may be used alternatively | \n\"Ultimate NOT Repository\" – finds e.g. Ultimate user, excludes e.g. Ultimate Repository | \n
| - | \nexcludes following term from search | \n\"Ultimate Repository -Special\" – finds e.g. Ultimate Repository, excludes e.g. Ultimate Special Repository | \n
| + | \nFollowing term must be included | \n\"Ultimate +Repository\" – finds e.g. my Repository, Ultimate Repository | \n
Search supports using parentheses to group clauses to form sub queries. This can be very useful if you want to control the boolean logic for a query.
\n| Definition | \nExample | \n
|---|---|
| () – terms inside parentheses are grouped together | \n\"(Ultimate OR my) AND Repository\" – finds e.g. Ultimate Repository, my Repository, excludes e.g. Super Repository. Either \"Ultimate\" or “My” must exist, “Repository” must always exist | \n
A phrase is a group of terms in a certain order. If you want to search for certain phrases then you can use the \" operator.
\nPlease keep in mind, that words are split when they use \"CamelCase\" (like mentioned in the chapter \"Word Split\") even when they are enclosed with \".
| Definition | \nExample | \n
|---|---|
| \"\" - terms inside the quotes are searched for as a phrase | \n\"Ultimate Repository\" – finds Ultimate Repository but not Repository Ultimate, Ultimate or Repository | \n