Sample queries
To search through the (supported) attributes of the supported entities, enter a relevant search term in the Quick search field. An auto-completion list appears while you are typing the text, showing some matching entities (see below). Note that this list does not contain all matching results.
![View with Quick search field and auto-completion list*](/assets/images/6644085-552a9397e6222ec9644424a15a1151ea.png)
- Select a result from the auto-completion list to view its attributes.
- Press the Enter button to view the complete list of matching search results, see the figure.
- Click on a search result in the list to open a corresponding administration view with the entity's attributes.
If the system found only one matching result, pressing Enter brings you directly to the corresponding administration view with the entity's attributes.
![Quick search result list](/assets/images/6644088-9cf1a89e1b728b69375040b431b8332c.png)
Besides searching in all supported attributes, you can restrict the query to one specific attribute. To do so, enter <attribute name>:<search term>
in the Quick search field.
Examples:
- To search for users or applications whose name starts with
apple
, entername:apple
in the Quick search field. - To search for users whose e-mail address starts with "
test
, enteremail:test
in the Quick search field, see the figure below.
![Quick user search for e-mail addresses starting with test](/assets/images/6644086-033fe8b5beedc2096f8156e6793a2508.png)
It is also possible to restrict the search to customer-defined properties. To search through all properties, enter <property>:<search term>
in the Quick search field. To restrict the search to a specific property, enter the property name as prefix in the Quick search field: properties.<property name>:<search term>
.
Examples:
- To search for users who have a property value that contains the text
apple
, enter the search expression*property:apple
in the Quick search field. - To search for users whose
user_prop
property contains the textapple
, enter the search expressionproperties.user_prop:apple
in the Quick search field.
Other possible search filters are:
- State (active, disabled, archived) – only possible for users and units
- Modification/creation date – only possible for users
- Type of entity (User, Client, Application, Unit)
Some examples of a search for users or units based on their state:
- To search for active users or units, enter the search term
state:active
in the Quick search field. - To search for disabled users or units, enter the search term
state:disabled
in the Quick search field. - To search for archived users or units, enter the search term
state:archived
in the Quick search field.
Some examples of a search for users based on their modification/creation date:
- To search for users created during the past seven days (including the current day), enter the search term
created:lastWeek
in the Quick search field. - To search for users modified during the past seven days (including the current day), enter the search term
modified:lastWeek
in the Quick search field. - To search for users created during a timestamp range, enter the search term
created:[<yyyymmddhhmmss TO yyyymmddhhmmss>\
in the Quick search field. E.g.,created:[201005011107 TO 20110502]
.- Note: As you can see, the trailing digits can be omitted. In the previous expression the
201005011107
means2010-05-01T11:07:00.000
and2011050116
means2011-05-02T00:00:00.000
.
- Note: As you can see, the trailing digits can be omitted. In the previous expression the
- To search for users modified during a given date range, enter the search term
modified:[<yyyymmddhhmmss TO yyyymmddhhmmss>\
in the Quick search field. E.g.,modified:[20100501 TO 20110501]
- Note: The upper bound of previous expression means
2011-05-01T00:00:00.000
, that means the result will not contain records modified at2011-05-01
, just only those which were modified exactly at midnight. - Note: Basically this way the inclusive interval boundaries become exclusive. Date values (such as
User.birthDate
) have no time part and can be filtered with theyyyymmdd
pattern.
- Note: The upper bound of previous expression means
Some examples of a search that is restricted to a certain type of entities:
- To restrict a search for the text
customer
to the Users type of entity only, enter the search termcustomer AND type:user
in the Quick search field. - To restrict a search for the text
customer
to the Users and Applications types of entity only (excluding the Units and Clients types of entity), enter the search termcustomer AND (type:user OR type:application)
in the Quick search field.