User resolution rule fields

  • Release version: Yokohama
  • Updated January 30, 2025
  • 2 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of User Resolution Rule Fields

    The User Resolution Rules page in the ServiceNow AI Platform allows you to create rules to link the User field in the Software Subscription table to a corresponding user in the User table. This functionality is essential for managing user subscriptions effectively.

    Show full answer Show less

    Key Features

    • Display Name: The name assigned to the user resolution rule.
    • Active: A checkbox to enable or disable the rule. If unchecked, the rule will not be applied.
    • Category: Specifies the integration profile category the rule pertains to, defaulting to SaaS.
    • Source Table: Specifies the table containing subscription records, which should be set to Software Subscription.
    • Look Up Table: Automatically set to User.
    • Applies To: Defines one or multiple integration profiles applicable to the rule, visible when SaaS is selected.
    • Source Field: The field in the Software Subscription table used for lookup against the User table, such as User Principal Name or External User ID.
    • Look Up Field: The field in the User table that matches the Source Field value, requiring an exact match.
    • Apply Transform on Input: Options to transform the Source Field value, including exact match, remove domain, replace domain, or run a script.
    • New Domain: Specifies a new domain for email addresses when replacing the domain.
    • Script: For administrators to update complex mapping logic if standard transformations fail.

    Key Outcomes

    By utilizing User Resolution Rules, ServiceNow customers can ensure accurate mapping of user subscriptions, enhancing the management of software assets. Proper configuration of these fields enables precise user identification, leading to improved efficiency in subscription handling.

    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.