When searching, there are some basic rules that must be followed. By default, all searches add an "*" wildcard to the end of the search pattern. For example, searching for the word "check" would find checkout, checkup, and checking. Wildcards will not precede the search parameter, however, when using the search bar. For example, searching for the word "out" will not find "checkout". The addition of a wild card token directly preceding the search term will specify a search pattern for the end of the word. For example, when looking for a player MAC address you could search for: *1234
This search will find all players with the MAC address ending in 1234.
There are some built-in attributes associated with each of these elements that can be added to a filter.
Built-in Site Attributes | Description |
Site Name | The name of the site as set when the site is created or renamed. Free form text can be added along with wildcard searches for site names. |
Time Zone | The time zone selected for the site. The selection is based on a drop-down list of possible time zones. |
Language | The language setting selected for the site. The language selection is based on a drop-down list of available languages. |
Site Type | The type of site as defined by the setting for the site. The site type selection is based on the available site types as defined within EnGage. |
Built-in Player Attributes | Description |
Player Name | The name of the player as set when the player is added or renamed. Free form text can be added along with wildcard search for player names. |
MAC | The MAC address of the player as set when the player is added. This value cannot be changed once the player is added. |
Serial Number | The serial number of the player as set when the player is added. The value cannot be changed once the player is added. |
Current State | The current state, also known the player status of the player. The player status can be changed at any time to reflect the status of the player. |
Built-in Content Attributes | Description |
Content Name | The file name of the media asset. Free form text can be added along with wildcard searches for content file names. |
Description | The description of the media asset. The description of a media asset can be added once the file is uploaded. Free form text can be added along with wildcard searches for description text. |
Media Type | The media type of the media asset. The media type is automatically applied to a media asset or widget when the asset is uploaded or widget added to EnGage. The selection options are based on all the possible EnGage media and widget types. |
Media Format | The format of the media asset as defined by the media assets file name extension. The selection option is based on the valid media formats. For example selecting "jpg" will display search results for all .jpg media files. |
Width (Pixels) | The width, in pixels, of a media asset. |
Height (Pixels) | The height, in pixels, of a media asset. |
Duration(Seconds) | The duration, in seconds, of a media asset. Be sure to add the seconds and milliseconds for a successful search result. For example, type 7.0 to search for media with a 7 second duration. |
Size(Bytes) | The size, in bytes, of a media asset. |
Note that filter rules are not the same as the search rules.
Filter search results do not add a wildcard to the end of the search pattern. An explicit wildcard token, the "*" character, must be added to the search pattern to search for wildcard results.
When creating a filter and searching for string fields that contain spaces, the search must be within double quotes. For example, when searching for a site called "Bob's Hardware" the search string would be:
"Bob's Hardware"