Configuring FX Currency global settings

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

    • Before setting up and using FX Currency, review the related system properties to confirm or modify its default behavior.

    Before you begin

    Role required: admin

    About this task

    The global defaults you establish in system properties apply the configuration option to all FX Currency fields. You can then customize them for specific dictionary attributes in System Localization > FX Currency Configuration. When you create a currency configuration, it applies those settings only to the FX Currency field that you add it to. To learn more about FX Currency configurations, see Configuring FX Currency field behavior.
    FX Currency configuration settings for specific FX Currency fields take precedence over system properties. Administrators can set a global configuration for a property, and then apply exceptions on a field-by-field basis.
    • If you change system defaults, except for display_digits and display_value, the changes apply to updated and new values only.
    • Existing values and data don't change but rather display differently, depending on configuration.
    Important:
    Don't edit the Currency [fx_currency] table directly. The system maintains this table and your changes could have unintended consequences.

    Procedure

    1. Navigate to All > System Localization > FX Currency Configuration.
    2. Review the system defaults and make any desired changes.
      Table 1. FX Currency field properties and attributes
      System property FX Currency configuration mapping Description
      glide.currency2.display_digits currency_display_digits Default number of digits displayed in FX Currency fields.
      Note:
      In a form, FX Currency fields display the number of digits you enter, up to 12 digits in length.
      • Type: Number
      • Default value: -1, or currency default
      • Available options: 0–12
      • Develop: GlideCurrencyFormatter
      glide.currency2.display_value currency_display_value Default currency display value returned from getDisplayValue().
      • Type: String
      • Default value: as_entered
      • Available options:
        • as_entered: Currency value as entered by the user
        • in_session_currency: Currency value as entered by the user and converted to the session currency
        • in_reference_currency: Currency value as entered by the user converted to the reference currency
      • Develop: GlideCurrencyFormatter
      glide.currency2.system_rate_table conversion_rate_table Conversion rate table used to perform currency conversions. By default, the source for currency conversions is the System Currency Conversion Rate [fx_system_rate] table, which stores the daily reference rates retrieved from the European Central Bank. If you have defined a custom rate table, you can change the rate table used in currency conversions.
      glide.currency2.default_reference_currency reference_currency Three-digit ISO currency code used for the reference currency. The default reference currency for FX Currency fields is the system reference currency.
      • Type: String
      • Default value: If you set glide.system.reference_currency to true, the three-digit ISO currency code determined by glide.system.reference_currency.code.

        If set to false, the system locale is the default.

      • Learn more: Session and reference currency
      • Develop: GlideElementCurrency2