The Device namespace is always the asset for which the expression rule is being processed. Use this namespace with asset-related triggers and NOT with system-related triggers. See Using Appropriate Actions and Namespaces with Triggers for Expression Rules.
If the symbol provides a string that will be used in comparisons, that value will be case-sensitive. For example, make sure the Model symbol value is written in the correct case for comparison (If Device.model == "ModelXYZ" Then ).
The following table outlines the symbols for Device namespace:
Qualified Symbol |
Returns |
Description |
Example |
Device.city |
String |
The city name of the asset's location. |
If: Device.city == "Boston" |
Device.country |
String |
The name of the country in which the asset resides. |
If: Device.country == "United States" |
Device.countryCode |
String |
The code of the country in which the asset resides. |
If: Device.coutryCode == "US" |
Device.language |
String |
The language of the asset. |
If: Device.language == "English" |
Device.line1Address |
String |
The first line of the address of the asset's location. |
If: Device.line1Address == "1 Main Street" |
Device.line2Address |
String |
The second line of the address of the asset's location. |
If: Device.line2Address == "Apartment 2" |
Device.location |
String |
The name of the location in which the asset resides. |
If: Device.location == "Location 1" |
Device.model |
String |
The model name or number assigned to the asset in the Platform; the value for this string is case-sensitive. |
If: Device.model == "ModelXYZ" |
Device.organization |
String |
The organization name of the asset. |
If: Device.organization == "Acme" |
Device.region |
String |
The name of the region in which the asset resides. |
If: Device.region == "Northeast" |
Device.serial |
String |
The serial number assigned to the asset in the Platform; the value for this string is case-sensitive. |
If: Device.serial == "Serial1234" |
Device.state |
String |
The name of the state in which the asset resides. |
If: Device.state == "Massachusetts" |
Device.zip |
String |
The zip code of the location where the asset resides. |
If:Device.zip == "02101" |
If you wanted to use the serial number or model of the asset in an expression rule, the syntax would be:
Device.serial
Device.model
Notice that the namespace always starts with a capital letter while the symbols always start with lowercase letters. Always use "Device" to reference the asset in your expressions so that the Platform treats the symbol as referring to the asset and not as a data item.
Example: If (Device.model == "AcmeFX" && Device.serial == "PS123456")