Target Filter View ¶
HOWTO video on Target Filter View
The filters created in the Target Filter View can be applied in the Deployment and Rollout views as seen in Figure 2 and Figure 3 below:
Figure 2 - Deployment View - Custom Filter
Figure 3 - Rollout View -- Custom Target Filter
Add (Plus icon)¶
To create a custom filter in the Target Filter View, click the Plus icon on the top right of the screen.
Clicking the Search icon will enable the user to query by any string inside the container.
You will need to define the Filter Name and also a query. In the example above we have:
Filter Name: Devices in New York
In this case, a query for the tag "office_columbus_ave" will be applied. This means that any Target Device which has the tag "office_columbus_ave" associated to it will be a result.
Other Query Examples¶
||Displays all target devices in ‘error’ state|
||Displays all targets that don’t have the controllerid 192.168.10.24|
||Displays all targets which contain the term ‘nitro’ in their name.|
||Displays all targets that either have the term ‘nitro’ in their name or description.|
||Displays all targets that have the term ‘warp’ in their name and their description|
||Displays all targets with their name starting with ‘warp’ which are in ‘pending’ state.|
||Displays all targets which are either assigned to the ‘Web Content’ distribution and have description equals to ‘Plug’ or which are not in error status.|
||Displays all targets that don’t have the updatestatus In_sync or error and which also contain the term ‘warp’ in their name.|
||Gives all targets that either have the term ‘warp’ in their name or their description and also either have the update status not in state error or pending.|
||Displays all targets which were created (in other words, first poll) on or after Wednesday, August 22, 2018, 00:38:08. The value is expressed as UTC in milliseconds.|
||Displays all targets which are overdue (last poll occurred more than "Polling Overdue Time" ago)|
Android Client Query Examples¶
The Update Factory Android client provides by default several attributes regarding the client itself and the Android OS it runs on. In the Deployment View select a target and open the "Attributes" tab to see the all attributes provided by a device. Additional custom attributes can be specified using Third-party Integration APIs. Here's some example queries using the default attributes:
||Displays all target devices running Android Client with version code 29 or greater (release v1.1.2 and later). Usage of
||Displays all targets devices running on Android 12 and using AB double copy OTA updates|
||Displays all targets with Android build type "user" and signed with the release keys|
- Not Equal:
- Greater than or equal:
- Less than or equal:
- Greater than:
- Less than:
- 'In' parameter:
HOWTO video on Auto-assignment
The Auto Assignment is a feature that allows to apply a distribution to devices that match a target filter. The difference with rollouts is that Auto Assignment applies also to devices that are yet to poll for the first time (in other words, that are not yet among the registered Targets).
For example the
createdat=ge= query from the Other Query Examples table can be used to trigger the application of a distribution to devices that poll for the first time on or after the defined UTC time.
Once you've defined a custom filter, navigate to the Auto assignment column under Target Filter View and click on the none link in your custom filter row (see Figure 5).
On the next popup window that appears, you will enable the auto assignment feature, select a distribution to apply in the list, and then choose save.