Custom Search Query
When you display licenses using pre-defined filters, the corresponding
search query is displayed in the search box above the list of
licenses. For example, status:active product:plesk
.
You can specify your own search query. The easiest way to do this is to type a value. This value will be searched for in the license number, license information, short description, and activation code (see The “value” Notation).
For a more specific search, use license attributes, such as platform or product version, as filters in your search query (see The “parameter:value” Notation). To find an exact phrase, use the “parameter:=value” notation.
Note: The search operation is case-insensitive.
The “value” Notation
To use the “value” notation, just type the value you want to search for. For example, to search for licenses that contain plesk in their attributes, type the following search query:
plesk
If the specified value is found in at least one of the attributes - License number, License information, Short description, or Activation code - then the license concerned will be displayed in the search results.
A value can contain spaces, parentheses, hyphens, double quotation marks, or other characters. If your search query contains only such a value, you do not need to put an entire value into quotation marks. For example:
license for "customer-1" new
(not "license for \"customer-1\" new")
To search by a license number, you can type the full number or just its middle part. Zeros at the beginning can be omitted. For example, to search for PLSK.02320288.0007, type either of the following:
PLSK.02320288.0007
PLSK.02320288
02320288
2320288
The “parameter:value” Notation
Use the “parameter:value” notation to filter licenses by a certain attribute (parameter). A match to part of a parameter’s value is enough for a license to appear in the search results.
For example:
keyos:unix
Note: For the list of all parameters and usage examples, see Parameters for License Search.
The “parameter:value” notation supports searching by several values or a range of values, specifying complicated values, and excluding a value from the search results.
To search by several values of one parameter:
Specify (value1, value2, ...)
. For example:
keyos:(unix, macos)
In this example, if the license parameter keyos
is unix
or macos
, the license appears in the search results.
Use square brackets to search for the occurrence of all the specified
values. Square brackets can be used only with the addon
parameter.
This parameter represents features added to a license.
For example:
addon:["Web Presence Builder for Plesk 12 for VPS - 100 Sites", "5 Language Packs"]
In this example, if a license has both the specified features (with the names matching the specified values), such a license appears in search results.
To search by a range of values:
Specify (value1-value2)
. This is applicable only to numeric
parameters. For example:
keydomains:(10-1000)
Some parameters can take the unlimited
value, for example:
keydomains:(100-unlimited)
To specify a complicated value:
If a value contains spaces, parentheses, hyphens, or double quotation marks, put such a value into double quotation marks. Use a backslash before any double quotation mark that is part of the searched value. For example:
desc:"license for \"customer-1\" new"
This rule also applies to the “value” notation if your search query has parameters in both “parameter:value” and “value” notations, such as:
version:11 "license for \"customer-1\" new"
See also Searching by Several Parameters later on this page.
To exclude a value from search results:
To search for licenses that do not contain specific values, add a minus sign (“-“) before the corresponding parameter:
-keyos:unix
The “parameter:=value” Notation
Use the “parameter:=value” notation if you need exact value matching. By contrast, if you need matching by a part of a value, use the “parameter:value” notation.
For example:
keyinfo:1yr
This search query finds licenses where keyinfo
contains “1yr” as a
part, for example “Plesk 10 and later with 1yr SUS” or “My Little Admin
with 1yr support”.
keyinfo:="plesk 10/11 for windows"
This search query finds licenses with keyinfo
equal to “Plesk 10/11
for Windows”.
The “parameter:=value” notation supports searching by several values of a parameter, and specifying complicated values.
Searching by Several Parameters
To include several search criteria in your search query, separate the criteria by adding spaces. Partner Central will find all the licenses that satisfy all the specified parameters.
For example, to find active licenses for Plesk 11.x that have the words license for “customer-1” new in the text attributes, type the following:
status:active product:plesk version:11 "license for \"customer-1\" new"
Excluding Values from Search Results
To search for licenses that do not contain specific values, add a minus sign (“-“) before the corresponding parameter:
-keyos:unix
This operation is supported only for the “parameter:value” notation.
Examples of the “parameter:value” Notation
To search for licenses that are issued for Windows and Unix, type the following search query:
keyos:(windows, unix)
To search for licenses that are issued for the Virtuozzo containers product, type the following search query:
product:pvc
To search for licenses that support from one to ten websites, type the following search query:
keysites:(1-10)
Examples of the “parameter:=value” Notation
To find licenses having a feature with the name “30 Domains w/1 yr SUS” or a feature with the name “Security Core for Plesk 10/11 and Later”, type the following:
addon:=("30 Domains w/1 yr SUS","Security Core for Plesk 10/11 and Later")
To find licenses having both the features “30 Domains w/1 yr SUS” and “Security Core for Plesk 10/11 and Later”, type the following:
addon:=["30 Domains w/1 yr SUS","Security Core for Plesk 10/11 and Later"]