---
sourceDocument: Australia IT Service Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/it-service-management

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia IT Service Management

ft:clusterId :

    - itsm

bundleId :

    - itsm

workflow :

    - Technology


---

# Map a device user to a ServiceNow DEX user

# Map a device user to a ServiceNow
DEX user {#ariaid-title1}

Release version: Australia  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
Complete this procedure to map a device user to a DEX user so you can notify the user about any of the device metrics breaching a predetermined threshold.

## Before you begin

Role required: admin

## About this task

Column `user_name` 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 AllSystem PropertiesAll 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 JASON string from the Description field: `{"prefix": "dex-blah", "device_user_id_column": "first_name", "suffix": "dex-blah"}`
   2. Paste the JASON string to 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.

      {#map-a-device-user-to-a-servicenow-dex-user__ul_hk5_kqt_fhc}

      For example, `{"prefix": "", "device_user_id_column": "login", "suffix": "@example.com"}`.
   {#map-a-device-user-to-a-servicenow-dex-user__substeps_thf_3kt_fhc}
6. Select Submit.

*[\>]: and then