Indicator scores in reference currency

  • 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 Indicator scores in reference currency

    ServiceNow Performance Analytics allows you to track trends for monetary fields of types Price, Currency, or FX Currency by collecting indicator scores denominated in a reference currency. This capability is essential for users such as global project managers or CFOs who need to view monetary KPIs converted into a single standard currency to make informed decisions based on global trends.

    Show full answer Show less

    Key Features

    • Indicator Configuration: Indicators must be automated (not formula or manual), aggregate a Price, Currency, or FX Currency field, and have the unit set to "Use reference currency" to collect scores in the reference currency.
    • Currency Precision and Symbol: When using reference currency, the indicator precision and currency symbol are inherited from the FX Currency configuration rather than being set on the indicator form.
    • Data Exploration and Sharing: Collected scores can be analyzed in the Analytics Hub or shared via widgets, with all visual elements reflecting the reference currency’s precision and symbol.
    • FX Currency Configuration: FX Currency fields require configuration by a currency administrator before use in indicators.

    Reference Currency Setup

    The reference currency setup is managed by a currency administrator, not Performance Analytics experts. The system reference currency for Price or Currency fields is determined by the glide.system.locale property or defaults based on physical location.

    For FX Currency fields, the reference currency for indicator scores follows this precedence:

    • Field-level FX Currency settings (highest priority)
    • Global FX Currency configuration
    • glide.system.locale setting
    • System default currency (lowest priority)

    Important Considerations

    • If the reference currency changes after indicator setup, score collection may be disrupted.
    • Indicators do not use session currency values.

    Practical Benefits

    By using reference currency indicators, ServiceNow customers can consolidate monetary KPIs across multiple currencies into a unified currency view. This standardization simplifies financial analysis and decision-making in global environments where transactions occur in various currencies.

    You can track the trends for monetary fields of the types Price, Currency, or FX Currency. The scores for an indicator based on any of these fields are collected in the Reference Currency values.

    To collect these scores, select the unit on the indicator as Use reference currency

    Warning:
    If the reference currency for a field changes after you have set up the indicator, scores are no longer collected properly.

    Sometimes you need to provide your users with monetary KPIs converted to a standard currency. Consider a global project manager or CFO who deals with project costs in many different original currencies. They need to see all these costs converted to the global company currency so they can make decisions based on global trends. To provide such users with the KPIs they need, you can configure Performance Analytics indicators to collect scores denominated in a reference currency.

    To collect indicator scores in a reference currency, create an indicator with the following characteristics:
    • The indicator is an automated indicator, not a formula or a manual indicator.
    • The aggregate is not Count or Count Distinct and the indicator is not Scripted.
    • The selected Field to aggregate has the type Price, Currency, or FX Currency.
    • The selected Unit for the scores is Use reference currency.
    For the full procedure of creating such an indicator, see Create an automated indicator.
    Note:
    • A currency administrator must configure FX Currency fields before you use them in indicators.
    • The Precision field is not available on the indicator form when Use reference currency is selected. Instead, the precision is inherited from the FX Currency configuration.

    After the scores have been collected, you can explore them more deeply in the Analytics Hub or share them through a widget. The reference currency precision and symbol are used in all visual elements: the score value, change value, target, threshold, and tooltips.

    System Reference Currency reference

    As a Performance Analytics expert, you do not set up the reference currency. Someone with a currency administrator role performs this task. However, you may still want to know how reference currencies work on the ServiceNow AI Platform. A brief summary with links follows.

    For a Price or Currency field, the system reference currency is the value of glide.system.locale as set in the localization properties. If this property is not set, the system default based on physical location is used. For more information about setting the reference currency for these fields, see Setting up and operating standard currency fields.
    Note:
    Performance Analytics indicators do not use session currency values.
    For an FX Currency field, the indicator scores are based on this hierarchy of configuration settings:
    1. If field-level FX Currency configurations are set, these take precedence. If they are not set...
    2. The Global FX Currency configuration is used. If the global configuration is not set...
    3. The setting in glide.system.locale is used. If no value is set in this property...
    4. The system default is used.

    For more information about configuring FX Currency fields, see Setting up and operating FX Currency fields.