Map a device user to a ServiceNow DEX user

task brazil Updated Sep 10, 2026 1 min read map-a-device-user-to-a-servicenow-dex-user.md

Map a device user to a DEX user so you can notify the user when device metrics breach a predetermined threshold.

Before you begin

Role required: admin

About this task

The user_name column on the base system is used for mapping user records in the sys_user table. In this case, the user_name matches the user ID on the device. You can map a custom ServiceNow DEX user column to a device user ID.

Procedure

Change the application scope from global to DEX Application and Device Health.
Navigate to All > System Properties > All Properties.
Search for sn_dex.dex_user_ref_mapping.
Select the property.
In the pre-populated form, update the Value field as follows:
1. Copy the example JSON string from the Description field: {"prefix": "dex-blah", "device_user_id_column": "first_name", "suffix": "dex-blah"}
2. Paste the JSON string into the Value field and update as appropriate.
  - prefix: Provide the prefix value if appropriate or leave it empty.
  - device_user_id_column: Provide the value for the column to which you’re mapping.
  - suffix: Provide the suffix value if appropriate or leave it empty. For example, {"prefix": "", "device_user_id_column": "login", "suffix": "@example.com"}.
Select Submit.

Parent Topic:DEX advanced configuration

53 lines · 2.2 KB Wrap lines

---
title: Map a device user to a ServiceNow DEX user
description: Map a device user to a DEX user so you can notify the user when device metrics breach a predetermined threshold.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/it-operations-management/digital-end-user-experience-dex/map-a-device-user-to-a-servicenow-dex-user.html
release: brazil
product: Digital End-User Experience \(DEX\)
classification: digital-end-user-experience-dex
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [DEX advanced configuration, Configure, Digital End-User Experience, IT Operations Management]
---

# Map a device user to a ServiceNow DEX user

Map a device user to a DEX user so you can notify the user when device metrics breach a predetermined threshold.

## Before you begin

Role required: admin

## About this task

The `user_name` column on the base system is used for mapping user records in the `sys_user` table. In this case, the `user_name` matches the user ID on the device. You can map a custom ServiceNow DEX user column to a device user ID.

## Procedure

1.  Change the application scope from global to DEX Application and Device Health.

2.  Navigate to **All** &gt; **System Properties** &gt; **All Properties**.

3.  Search for `sn_dex.dex_user_ref_mapping`.

4.  Select the property.

5.  In the pre-populated form, update the **Value** field as follows:

    1.  Copy the example JSON string from the **Description** field: `{"prefix": "dex-blah", "device_user_id_column": "first_name", "suffix": "dex-blah"}`

    2.  Paste the JSON string into the **Value** field and update as appropriate.

        -   `prefix`: Provide the prefix value if appropriate or leave it empty.
        -   `device_user_id_column`: Provide the value for the column to which you’re mapping.
        -   `suffix`: Provide the suffix value if appropriate or leave it empty.
        For example, `{"prefix": "", "device_user_id_column": "login", "suffix": "@example.com"}`.

6.  Select **Submit**.


**Parent Topic:**[DEX advanced configuration](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/it-operations-management/digital-end-user-experience-dex/dex-advanced-configuration.md)