Searching in CloudM Manage – CloudM

Searching in CloudM Manage is very versatile and useful and can be used to extend beyond just finding users.

Action Users from Search

You can click a single or multiple users that have been returned in a search result and then use the top right hand actions menu to complete actions against them.

Please note: When creating a Group / Smart Contacts from a search, it will include all results returned, not just the selected items as above.

To search for a user in CloudM Manage, you need to simply enter their details into the white search bar at the top centre of the page. This is always visible on whatever page you're currently on.

You can search for users within your domain, external contacts, and also groups of users. In fact, you can search through these different types of items in a variety of ways. Some search terms are restricted to certain types of items (for instance if you want to find everyone in an Organization Unit, you won't find external contacts or groups as they are kept seperate).

Data Types

The following is a list of data types you could use in Search and the syntax to use for each. Please note that the specific data that you are searching for should be added between the brackets (for example, department:(MARKETING):

Field	Syntax
Object type: User	type:(USER)
Object type: External Contact	type:(EXTERNAL_CONTACT)
Object type: Organizational Unit (OU)	type:(ORGANIZATION)
Object type: Group	type:(GROUP)
Object type: Smart Team	type:(GROUP) AND team:(true)
Full Name	name:()
Surname	surname:()
Email address	email:()
Organizational Unit (OU)	ou:()
Job Title	job_title:()
Department	department:()
Employee ID	employee_id:()
Cost Center	cost_center:()
Company	company:()
Description	N/A
Manager	manager:()
Telephone	phone:()
Address	address:()
Tags	tags:()
Employment Type	employment_type:()
Suspended	suspended:suspended
Hidden	hidden:hidden
Custom Key	custom_key:()
Custom Value	custom_value:()
Area	area:()
Building	building:()
Floor	floor:()
Section	section:()
Desk Code	desk:()
Web Links	website:()
Date of Birth	N/A
Subject	N/A
License	type:(USER) AND license:("Google Workspace")
License SKU	type:(USER) AND sku:("Google Workspace Business")

Combine Keywords

Combine different search criteria through the key words "AND", "OR", and "NOT"

This is all very easy when you want to find a single user, you can provide their name and then grab their other details such as their phone number, but in some cases we may have to be more specific, or we may just want only a very definite subset of users, in this case we can combine different search criteria through the key words "AND", "OR", and "NOT". This means we can connect various types of information for instance "name:(John) AND title:(Sales)", this will bring up all the Johns who have Sales as their title, note that this doesn't work on partial matches so if someone has the title "Sales Director" they won't be included. There is no limit to how many search terms and keywords you can use, however if you find yourself running into difficulties getting the term correct please do not hesitate to contact the support team who will be able to assist in this.

Lastly, we can clearly group users together with search terms, which means we could do any number of actions with them such as email the resultant users, create an appointment with them, add delegated access to their accounts and more; Typically we use the search query to create a Group/Contact as a search query is a requirement for creating any smart item.

Searching Predefined Extra Information

When performing searches for your predefined extra information fields you have options to search for the presence of a custom 'key', 'value' or a combination of both as shown below.

Key search syntax - custom_key:"enter key name"

Value search syntax - custom_value:"enter value"

Key and Value search syntax - custom_key_value:"key = value"

Example Searches

Below are some examples of applying the CloudM Manage search syntax to generate specific results

custom_key:"User_ID" - In this example the domain has a pre-defined extra information field called 'User_ID' which is mapped to a external custom field in Google Workspace. This search returns any user profiles which contain this field irrespective of value.

custom_key_value:"User_ID = 123456" - This search returns a specific user with the corresponding UserID of 123456

Advanced Search

Use the Advanced Search drop down icon at the end of the main Search bar to easily build your own criteria.

Advanced search options

Advanced Search type - General

When you select the Advanced Search option, you will initially see the General search fields, displayed below:

Type - A drop down menu that allows you to specify the type of information you want to search for. Additional fields will be displayed depending on the type selected.
Name - Search by name or partial name.
Extra Information Keys - Search by name of custom field.
Extra Information Values - Search by value of custom field.

Advanced Search type - Profile

Selecting Profile from the Type drop down menu will display the following search fields, specifically for searching for users:

Advanced Search type - External Contact

Selecting External Contact from the Type drop down menu will display the following search fields, specifically for searching for External Contacts:

Advanced Search type - OU

Selecting OU from the Type drop down menu will display the following search fields, specifically for searching for Organizational Units:

Advanced Search type - Group / Smart Team

Selecting Group or Smart Team from the Type drop down menu will display the following search fields, specifically for searching for Group or Smart Team: