User resolution rule fields

  • Release version: Yokohama
  • Updated January 30, 2025
  • 2 minutes to read

    • Fields on the User Resolutions Rules page help you create a rule to map the User field in the Software Subscription [samp_sw_subscription] table to an associated user in the User [sys_user] table within the ServiceNow AI Platform.

    Table 1. User Resolution Rules
    Field Description
    Display name Name of the user resolution rule.
    Active Option for enabling the user resolution rule.

    If this check box is cleared, this rule isn't applied to resolve user subscriptions.
    Category Category of the integration profile that the user resolution rule applies to.
    • SaaS
    • SSO

    By default, this field value is set to SaaS.
    Source table Table that contains subscription records.

    Select Software Subscription [samp_sw_subscription].

    This field appears only when SaaS is selected from Category.
    Look up table This field is automatically set to User.
    Applies to One or multiple integration profiles to which the user resolution rule applies to.

    This field appears only when SaaS is selected from Category.
    Source field A field in the Software Subscription [samp_sw_subscription] table used for lookup against the User [sys_user] table, such as User principal name and External user id.

    As other columns might not contain sufficient data, select either User principal name or External user id.

    This field appears only when SaaS is selected from Category.
    Look up field The field against which you want to match the Source field value.
    For example, if you select User principal name in Source field and Email in Look up field, Software Asset Management tries to match these two fields. The match must be exact. If it isn’t, you can change the value to User ID in Look up field.
    Note:
    User resolution rules created for non-indexed Look up fields in the sys_user table are automatically marked as inactive. This applies to both manually created and AI-generated user resolution rules.
    Apply transform on input Option to apply transformations to the Source field value.
    • None: The Source field value is matched exactly with the Lookup field value.
    • Remove domain: If you have selected Email in Look up field, the first part of the email address (before the @ symbol), which is the User ID or name, is matched with the Source field value.
    • Replace domain: When you have selected Email in Look up field and you want to replace the domain name, that is, the second part of the email address (after the @ symbol). For example, replace example.com with exampletest.com.
    • Run script: This option is available only to administrators for updating the script.
    New domain The new domain that you want to add after the @ symbol when Email is selected in Look up field.

    This field appears only when Replace domain is selected from Apply transform on input.
    Script
    Important:
    This field is available only to administrators.

    If the mapping still fails after replacing or removing the domain or the logic is complex, the script can be updated to achieve the desired result.