Selectors

Selector is a flexible way to choose some subset of devices and then apply compliance tests only to these devices.

This works in the following manner: you define one or more filters and choose how to join these filters (using OR or AND) together. Next you can find out which devices were chosen by a selector at the selector web page. Later you can bind some compliance tests to this selector. These compliance tests will be executed against all the devices matched by this selector.

An additional purpose of a selector is to define how dynamic pairs for the devices are formed.

Warning

Bear in mind that one device can belong to different selectors. If you apply the same test to multiple selectors containing the same device, this test will be executed multiple times for this device.

Fields

Name

The name of the selector. Must be unique.

Multi-filter operation

Choice field: OR or AND This field defines how multiple filter fields interact between each other.

For example, we have a Selector with Name filter equal to asw and Site filter equal to London.

In this case, Multi-filter Operation equal to OR will select all the devices that contain asw plus all the devices from London.

On the other hand, Multi-filter Operation equal to AND will select all asw devices that belong to London site.

Device Name Filter

This field can filter devices by their names. You can use regular expressions syntax to make complex filters. Search logic is applied to the contents of the filter. It means that asw[0-9]{2} filter will match both asw01-london and london-asw01.

Name filter has an additional purpose: to make a rule for dynamic pairs creation. You can read more about it in the Dynamic Pairs reference.

Status Filter

This filter allows filtering device by its status field.

Other filters

  • Tag filter
  • Manufacturer filter
  • Device Type filter
  • Platform filter
  • Location filter
  • Site filter
  • Tenant filter

All of this are some properties of the device that you can filter by. In any of these fields you can use multiple values. Multiple values in a single field have OR logic (and this is completely independent of Multi-filter operation). For instance, if you have Location filter "room-403, room-404", this will select both the devices from room 403 and from 404.

Dynamic Pairs

This field manages the creation of dynamic pairs during the test. For now, it has 3 possible values:

  • NO - dynamic pairs won't be created
  • By name - dynamic pairs will be created according to the Device Name Filter value
  • By tag - dynamic pairs will be created based on tags assigned to devices

More info: Dynamic Pairs.