Search box
Whether you are using the desktop client or web client, the search box can be used to filter the data being displayed. When you enter a text string into the search box, the results include items that have a string attribute that contains the text that was entered. This same basic search functionality is also available for many of the detail panes and selection dialogs, allowing you to filter the data displayed in the associated pane or dialog.
When searching for objects in the object lists, an attribute search functionality is also available where you can filter the results, based on a specific attribute. That is, the search term matches if the specified attribute contains the text. To perform an attribute search, click the icon to select the attribute to be searched.
Rules for using the search functionality:
- Search strings are not case-sensitive. Exception: in the web client, the Approvals and Reviews searches are case sensitive.
- Wild cards are not allowed.
-
Try using quotes and omitting quotes. As you use the product, you will become familiar with the search requirements for the search fields you frequent. Safeguard may perform a general search (for example, omits quotes) or a literal search (for example, includes quotes). Example scenarios follow:
- When multiple search strings are included, all search criteria must be met in order for an object to be included in the results list.
- When you combine a basic search and an attribute search, the order they are entered into the search box matters. The attribute searches can be in any order, but the basic search must come after the attribute searches.
- In large environments, you will see a result number to tell you how many objects match the criteria; however, only the first 200 objects will be retrieved from the server. When you scroll down the list, more objects will be retrieved (paged) as needed.
To search for objects or object details
- Enter a text string in the Search box. As you type, the list displays items whose string attributes contain the text that was entered.
Examples:
- Enter T in the search box to search for items that contain the letter "T".
- Enter sse to list all items that contain the string "sse," (such as "Asset")
Note:The status bar along the bottom of the console shows the number of items returned.
-
To clear the search criteria, click Clear.
When you clear the search criteria, the original list of objects are displayed.
You can also Search by attributeSelect a drop-down to sort
Search by attribute
The attributes available for searching are dependent on the type of object being searched. The search drop-down menu lists the attributes that can be selected.
API attributes can be searched
The drop-down menu lists a limited number of attributes that can be searched; however, you can perform an attribute search using the English name of any attribute as it appears in the API. Nested attributes can be chained together using a period (.). To see a list of all the attributes, see the API documentation. For information about the API, see How do I access the API.
Entering the search string
-
Click the icon and select the attribute to be searched.
The selected attribute is added to the search box. For example, if you select Last Name then LastName: is added to the search box.
-
In the search box, enter the text string after the colon in the attribute label.
You can specify multiple attributes, repeating these steps to add an additional attribute to the search box. Do not add punctuation marks, such as commas or colons, to separate the different attributes. When multiple attributes are included, all search criteria must be met in order for an object to be included in the results list.
As you type, the list displays items whose selected attributes contain the text that was entered.
Note:The status bar along the bottom of the console shows the number of items returned.
-
To clear the search criteria, click Clear.
When you clear the search criteria, the original list of objects are displayed.
Attributes in each Search box
The following attributes are available when you click the icon. In addition, API attributes can be searched in the search box.
Accounts
- Name
- Description
- Asset
- Domain Name
- Profile
- Partition
- Tag
Account Groups
Assets
- Name
- Description
- Platform
- Forest Root Domain
- Network Address
- Partition
- Is Directory
- Tag
Asset Groups
Entitlements
- Priority
- Name
- Description
- Users Display Name
- Users Name
Partitions
Users
- User Name
- Description
- First Name
- Last Name
- Email Address
- Domain Name
User Groups
Select a drop-down to sort
By default, the desktop client lists the objects in alphabetical order; however, you can use the controls located above the list to sort the object list.
To sort the desktop client object lists
- Select Ascending or Descending under the Search box to sort the list in either alphabetical or reverse-alphabetical order.
- To sort the list of Accounts, open the drop-down menu under the Search box and choose one of the following options before sorting the list in either Ascending or Descending order:
- Name (Default)
- Description
- Asset
- Domain Name
- Profile
- Partition
-
To sort the list of Account Groups, open the drop-down menu under the Search box and choose one of the following options before sorting the list in either Ascending or Descending order:
- Name (Default)
- Description
- Dynamic
- To sort the list of Assets, open the drop-down menu under the Search box and choose one of the following options before sorting the list in either Ascending or Descending order:
- Name (Default)
- Description
- Platform
- Network Address
- Partition
-
To sort the list of Asset Groups, open the drop-down menu under the Search box and choose one of the following options before sorting the list in either Ascending or Descending order:
- Name (Default)
- Description
- Dynamic
- To sort the list of Entitlements, open the drop-down menu under the Search box and choose one of the following options before sorting the list in either Ascending or Descending order:
- Priority (Default)
- Name
- Description
-
To sort the list of Partitions, open the drop-down menu under the Search box and choose one of the following options before sorting the list in either Ascending or Descending order:
- Name (Default)
- Description
- To sort the list of Users, open the drop-down menu under the Search box and choose one of the following options before sorting the list in either Ascending or Descending order:
- User Name (Default)
- Description
- First Name
- Last Name
- Email Address
- Domain Name
- To sort the list of User Groups, open the drop-down menu under the Search box and choose one of the following options before sorting the list in either Ascending or Descending order:
- Name (Default)
- Description
- Type (Sorts by local and directory groups.)
Using the web client
The web client is functionally similar to the desktop client end-user view and useful for requestors, reviewers, and approvers. Many administration functions are available as well. The web client is sometimes called the Windows client. The web client uses a responsive user interface design to adapt to the user's device, from desktops to tablets or mobile phones.
NOTE: In this documentation, you will see the following icons which denote the interface:
(web client)
(desktop client)
In the web client, to add or change your photo in the upper right, click the user avatar. Select the image file, then click Open.
The pages available to you display on the left. You will see Home and, based on your role, you may also see My Requests, Approvals, Reviews, Settings, or a combination of those.
You can show less of the left menu. In the upper left of the page, click to collapse or expand the menu.
You can customize the information you see on the pages. From the Home page, click Settings. For more information, see Settings, version, and Windows desktop client (web client).
Home page
Click Home to go to the home page. Based on your role, the dashboard displays My Requests, Approvals, and Reviews, the number tasks in each queue, and the status of each task (for example, Available, Denied, Pending) as well as whether the task is Due Today.
You can perform the following from the Home page: