Device Properties in DEX Workflows
About Device Properties
Device Properties are built-in details that DEX Manager Plus can collect from a managed endpoint—for example, Wi-Fi Link Speed, OS Drive Free Space, or Battery Health. You can use them in any workflow without defining them yourself. When you configure a device property in a workflow, its value is collected from the device, so you can build conditions and actions around real device data such as its network, disk, or battery state.
Device Properties are currently available on Windows endpoints.
When you build workflow logic, you can reference three types of variables:
- Device Properties: Built-in device details that are ready to use in any workflow, covering areas such as network, disk, and battery state. These are listed in Device Properties Reference.
- Sensor fields: Device data fields collected through sensors. You can access sensor fields directly in a workflow, without first adding a Sensor stage.
- Previous stage outputs: Values produced by earlier stages in the same workflow—for example, the user’s response from an Engage stage. Reference these to branch or act on what happened earlier in the flow.
Sensor Fields: Direct Access or a Sensor Stage
You can bring a sensor field into a workflow in two ways: reference it directly in a stage such as a Switch, or add a Sensor stage and reference its output. Both achieve the same result. Accessing the field directly is simpler, because it removes the need for a separate Sensor stage and keeps the workflow smaller.
How to Use Device Properties in Workflow Stages
Device Properties are available in a workflow out of the box, so you can use them directly in your workflow logic:
- Switch: Compare a variable against a threshold or expected value to branch the workflow—for example, “Battery Health is less than 80%” or “Wi-Fi Connected is true”.
- Function: Run a Deluge or JavaScript function on the server, passing device properties as its parameters—for example, to transform a value or apply custom logic before it is evaluated.
- Engage and Send Mail: Reference a variable’s value in a message so end users or administrators see the actual reading, such as the remaining disk space.
For how these stages connect on the canvas, see Managing Workflows in DEX Manager Plus.
Example
To warn users about an aging battery, evaluate Battery Health in a Switch (for example, less than 80%), then use Send Mail to alert IT or Engage to notify the user on the matching branch.
Device Properties Reference
The following device properties are available, grouped by category. Each row lists the display name shown in the workflow editor, its data type, and what it measures.
| Group | Display Name | Type | Description |
|---|---|---|---|
| Network | Primary Adapter Connection Type | Enum | The connection type of the primary network adapter of the device — e.g. Ethernet, Wi-Fi. |
| Network | Wi-Fi Band | Float | The frequency band of the Wi-Fi adapter of the device — e.g. 2.4 GHz or 5 GHz. |
| Network | Wi-Fi Network Name (SSID) | String | The SSID (network name) of the Wi-Fi network the device is connected to. |
| Network | Wi-Fi Access Point (BSSID) | String | The BSSID (MAC address) of the wireless access point the device is connected to. |
| Network | Wi-Fi Channel | Integer | The Wi-Fi channel ID in use by the device. |
| Network | Wi-Fi Protocol Standard | Enum | The Wi-Fi protocol standard used by the device — e.g. 802.11n, 802.11ac, 802.11ax. |
| Network | Ethernet Link Speed | Float | The link speed of the Ethernet adapter of the device, in Mbps. |
| Network | Wi-Fi Link Speed | Float | The current link speed of the Wi-Fi adapter of the device, in Kbps. |
| Network | Wi-Fi Connected | Boolean | Whether the device is connected to a Wi-Fi network. |
| Network | Ethernet Connected | Boolean | Whether the device is connected via Ethernet. |
| Network | Wi-Fi Adapter Available | Boolean | Whether a Wi-Fi adapter is installed and available on the device. |
| Disk | OS Drives Total Size (Combined) | Integer | The combined total size of all OS drives on the device, in bytes. |
| Disk | OS Drive Free Space (Combined) | Integer | The combined free space across all OS drives on the device, in bytes. |
| Disk | Non-OS Drives Total Size (Combined) | Integer | The combined total size of all non-OS drives on the device, in bytes. |
| Disk | Non-OS Drive Free Space (Combined) | Integer | The combined free space of all non-OS drives in bytes. |
| Disk | Logical Free Disk Space | Integer | The logical free space (free + purgeable) for OS drives in bytes. |
| Battery | Battery Available | Integer | Whether a battery is present and available on the device. |
| Battery | Battery Design Capacity | Integer | The original design capacity of the battery on the device, in mAh. |
| Battery | Battery Full Charge Capacity | Integer | The maximum charge the battery can currently hold, in mAh. |
| Battery | Battery Health | Integer | The health of the device battery as a percentage of its original design capacity (0–100%). |
| Battery | Battery Name | String | The name or model of the battery in the device. |
| Battery | Battery Chemistry | String | The battery type — e.g. Lithium-ion (Li-ion) or Nickel-metal hydride (NiMH). |
| Battery | Battery Manufacturer | String | The name of the manufacturer of the battery in the device. |
| Battery | Battery Serial Number | String | The serial number of the battery in the device. |
| Battery | Battery Power Plan | String | The currently active Windows power plan on the device. |
| Battery | Sleep Timeout (Plugged In) | Integer | Idle minutes before the device sleeps when plugged in. |
| Battery | Sleep Timeout (On Battery) | Integer | Idle minutes before the device sleeps on battery. |
| Battery | Display Timeout (Plugged In) | Integer | Idle minutes before the display turns off when plugged in. |
| Battery | Display Timeout (On Battery) | Integer | Idle minutes before the display turns off on battery. |
| Battery | Disk Timeout (Plugged In) | Integer | Idle minutes before the disk powers off when plugged in. |
| Battery | Disk Timeout (On Battery) | Integer | Idle minutes before the disk powers off on battery. |
| Battery | Hibernation Timeout (Plugged In) | Integer | Idle minutes before the device hibernates when plugged in. |
| Battery | Hibernation Timeout (On Battery) | Integer | Idle minutes before the device hibernates on battery. |
| Battery | Battery Cycle Count | Integer | The total number of charge-discharge cycles completed by the device battery. |
| Battery | Battery Charge Level | Integer | The current battery charge level of the device, as a percentage (0–100). |
| Battery | Battery Remaining Time | Integer | The estimated remaining battery time at the current charge level, in minutes. |
| Battery | Battery Backup Time (Full Charge) | Integer | The estimated battery backup time at full charge (100%), in minutes. |
| Battery | Battery Discharging | Integer | Whether the battery is currently discharging (1 = yes, 0 = no). |
| Battery | Battery Charging | Integer | Whether the battery is currently charging (1 = yes, 0 = no). |
| Battery | Battery Critical State | Integer | Whether the battery is in a critically low state (1 = critical, 0 = normal). |