/
Finding things in AMI v8

Finding things in AMI v8

Information valid from AMI version 8.0sp2

Summary

This article shows how to find instances of objects using faceted searching in AMI v8. Faceted searching is commonly used on e-commerce websites and works by filtering. A "facet" is a piece of information you've decided will distinguish an object in your system. For example, your system might have set the "Voltage" attribute as a facet: this lets you filter results by their "Voltage" values.

You set the options for faceted searching in the Search Configuration workspace. See Search Configuration for more information.

The AMI Browse and Search gadgets are still available in AMI v8 and can be added to workspaces as before.




Search filter 

The Search filter is a quick way of filtering results by the value of their name attributes. (An object's name attribute is the one set in its Object Type definition. See Object Type Definition screen for more information.)

Enter a value to filter instances by the value of their names. This will replace any current filters with a Search filter.

Searches on text values are case-insensitive. You can use the * and ? wildcard characters to represent any number of and a single character respectively. However, there are several other powerful search techniques available: see Query String syntax for more information.

Only instances in structures selected for indexing will be displayed.

Browse

The Browse menu option displays Agility structure types. Select a structure type and the indexed structures of that type will be displayed in the Browse section of the available facets list. Only structures selected for indexing will be displayed.

Select a structure point to filter the results to only the instances below that structure point.


As you browse through a structure, the navigation bar will update to show a breadcrumb trail (Wikipedia).

Select a point on the breadcrumb trail to return to a previous structure point. Select Home to remove all filtering by structure point.

Filtering results

Beyond the name and structure point, you can filter results by their Object Types, Attribute values and their metadata.

Create a filter by selecting a facet in the list of available facets and specifying a value.

Once you've created a filter, you can:

  • Disable—temporarily remove the filter from the results.
    A disabled filter is greyed-out.
  • Enable—re-apply a disabled filter.
  • Invert—apply the opposite of the filter to the results.
    For example, if you inverted the filter Object Type: Product it would show only instances that were not Products.
    An inverted filter has its value in a strikethrough typeface. For example, Object Type: Product
  • Remove—permanently remove the filter from the results.

You can edit the values used in a filter by selecting it. This displays a list of the values available in the current results, except for the Search filter and filters on Attributes indexed as Text. For these, you can edit the search text.

For selectable values, the number of instances in the results that match that value is displayed in the Count column.

The filter will apply to all the selected values.

Filters

Filters are based on the facets available in the results currently displayed. As you refine your results, the facets displayed will change to match them.

Use the Configure Facets... menu option to set which facets are available to use as filters.

You can select these groups of facets:

  • Show Default Facets—display the facets selected on the Default tab. These are available to all users.
  • Show Suggested Attributes Facets—display the attributes marked as Auto Suggest that appear on any of the results.
  • Show Object Type Facets—display the object types of instances in the results.
  • Show Saved Search Facets—display the facets defined for the currently selected Saved Search.
  • Show User Defined Facets—display the facets selected on the User Defined tab. These are available only to the current user.

You can define the following types of facet.

Object Type

These are the Agility Object Types of the objects in your results.

Use the More/Multi-Picker option to select multiple object types in a filter.

Attributes

These are the indexed attributes on all the instances in the current results.

Attributes indexed as Keyword or Text and keyword show the values as selectable options.

Attributes indexed as Text show a text box to enter a value, in the same way as for the Search filter.

Date attributes show a list of pre-defined ranges, all relative to the current date and time. Where a range specifies "Last..." then it is a fixed interval. Otherwise a range applies to the calendar date. Days start at 00:00:00 (midnight) and weeks start on Monday.

Only values in attributes selected for indexing in the currently active Language version will be displayed.

Scopes

An instance of an object can have up to three different values for the same attribute in a language version: the Global, Local and Edge Specific scopes.

Metadata

You can filter results by the metadata about an instance of an object:

  • Workflow State—the name of the current state of the instance.
    Different instances of the same object can be at different Workflow States in different structures.
  • Workflow State Group—the name of the Workflow Group to which the instance's current Workflow State belongs.
  • Created—the date when the object was created.
  • Created By—the name of the user who created the object.
  • Modified—the date when the object was last edited.
  • Modified By—the name of the user who last edited the object.

An example of filtering

Here's an example of a filter:

This filter shows instances of Product objects in the Autumn 2020 Flyer event whose name contains the word "001" and a value for their Colour attribute that is not "Blue".

Related pages