How to search in Alloy
Finding any item quickly (be that an asset, job, inspection, user or anything else) is a key part of using Alloy. It utilises a feature called Global Attribute Search (GAS). In addition to searching on string and number attribute types you can also search on date attributes (Date, DateTime, Time, Seasonal).
The search tool supports formats dependent on customer culture information that is stored as part of a customers settings. Alloy performs attribute value searches in the format relevant to each location / culture.
You can access the main search panel from the right menu panel where you see the search icon . The search displays the suggestion panel by default, unless a previous search was performed. The suggestion panel provides you with a list of search categories (such as designs, workflows or users) that allow you to refine the scope of your search. See suggestion panel
Once a category has been selected, the search panel displays a list of all the items in that category. Once you have selected a category you can further refine the list within the category by entering a search term.
You can customise the list of categories that are displayed in the suggestion dropdown.
If you have recently performed a search or displayed a list, then the search panel displays the previous search category allowing you to change your search term again. If you want to search within a different category, select the icon to clear the previous search category and enter a new one.
The search panel is also displayed when you select links in most dashboard cards, for example Designs to view designs from the Designer card, with each link defining a specific query to list the relevant items in the search panel.
Searching by Item Id
A quick way to find any item is to enter the Item Id or partial item Id directly into the search panel prior to selecting a search category. When you enter hexadecimal characters into the search panel, Alloy recognises this as an attempt to locate items in the system by their Item Id. When you enter a complete item Id, this allows you to locate an item and display it in the search panel immediately. If you enter a minimum of the first six characters of the Id, then the search returns a list of all the items starting with that partial item Id.
In the example below, entering
01b37e lists all the items whose Ids start with those six digits.
Using search terms
When you select a category to define the scope of a search, you can further refine the search by using complete or partial search terms to find items.
There are three types of search term types:
- Alphanumeric - The search term entered must be at least three or more alphanumeric characters before Alloy will perform the search within all searchable attributes. Alloy returns items with any searchable attributes that contain the term as either the first part or all of the attribute.
For example, if you are looking for a specific street light, you would enter the term
street lights in the search field, this displays a list of designs or interfaces matching this term and reduces the scope of the search.
Once you have selected the design or interface that you require, a list of all the items associated with that design is displayed in the search panel. You can scroll through the list or you can then enter a search term for the specific street light, for example,
CBL1711 to find the street light.
You could enter
street lighting, which would display interfaces as well as designs that you could select to define the scope. If you selected the
Street lighting assets interface the scope of the search would include all types of street lighting, which would be a much bigger list than using a specific design.
Numeric - If three or more characters are entered, and they are all numeric, for example
32356, then the search returns any items where the whole number occurs in an attribute. The culture setting for each customer allows for users to search for number attribute values using their native notation in terms of decimal and thousands separators. For example, German customers can search for comma separated decimal numbers using 3,45 that matches the same attribute value as 3.45 if searched for by a customer on a UK project.
Date and time - There are four types of Date and time searches that Alloy can perform:
Dates - This allows you to search for an item containing a specific date using the format
MM/DD/YYYYwhere appropriate. Alloy searches for all items containing a date attribute and also takes into account customer culture information, for example 10/01/2021 will be understood as 10th January 2021 in the day first cultures, while in the month first cultures like America this search string would be interpreted as 1st October 2021.
DateTime - This allows you to search for an item containing a specific date and time using the format
MM/DD/YYYY hh:mmdepending on the users culture as above. All DateTime values in Alloy are stored in UTC, the entered DateTime search term should be entered in a local customer time zone, for example, New Zealand customers may search for items with a DateTime attribute value 22/01/2021 9:00 which would internally search for the UTC equivalent 21/01/2021 20:00.
Time - This allows you to search for an item containing a specific time using the format
hh:mm. You can search for hour and minute values, for example, 12:40 to more specific one as 12:40:15.876. You can also search on AM/PM time string, for example, 4 PM or 3:15pm, the dot separator is not supported, for example, 3.15pm is not a valid time format.
Seasonal - This allows you to search for an item containing a specific seasonal date using the format
MM/DDwhere appropriate. Alloy searches for all items containing a seasonal date attribute and also takes into account customer culture information, for example 10/01 will be understood as 10th January in the day first cultures, while in the month first cultures like America this search string would be interpreted as 1st October.
You must be aware of permission settings as items may not be displayed if you do not have permission to view them, see Permissions.
When you have completed a search and the results are listed in the search panel, you can configure the search settings to refine the list and the order in which it is displayed.
Recently viewed items
Recently viewed items are shown in the search panel by default. You can view these items by hiding the suggestions drop down. To hide the suggestions drop down you can either click on the toolbar or select the Escape key.
You can select an item directly from the recently viewed list.