GlideCurrencySymbol - スコープ付き、グローバル

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間:2分
  • GlideCurrencySymbol API は、通貨記号を取得するためのメソッドを提供します。

    シンボル情報は通貨 [fx_currency] テーブルでも使用できますが、この API には、fx_currency に発行されるクエリを最小限に抑える組み込みのキャッシュがあります。

    この API を使用すると、[通貨] フィールドと [FX 通貨] フィールドだけでなく、ServiceNow AI Platform上のどこでも通貨記号を操作できます。

    この API には、デフォルトで利用可能な FX 通貨 (com.glide.currency2) プラグインが必要です。この API は sn_currency 名前空間内で提供されます。

    GlideCurrencySymbol - getCurrencySymbol (文字列 letterCode)

    指定されたアルファベット通貨コードに対応する記号を返します。

    表 : 1. パラメーター
    名前 タイプ 説明
    レターコード 文字列 ISO 4217 アルファベット通貨コード。
    表 : 2. 返される内容
    タイプ 説明
    文字列 指定されたコードの通貨記号。

    この例では、米ドル (USD) を表す通貨記号を返します。

    gs.info(sn_currency.GlideCurrencySymbol.getCurrencySymbol("USD"));

    出力:

    $

    GlideCurrencySymbol - getSortedActiveCurrencySymbols()

    インスタンスで現在アクティブなすべての通貨記号を返します。

    表 : 3. パラメーター
    名前 タイプ 説明
    なし
    表 : 4. 返される内容
    タイプ 説明
    アレイ インスタンスで現在アクティブな通貨記号オブジェクトのアレイ。

    シンボルは、Unicode コードによってソートされた順序で返されます。これは、通貨 [fx_currency] テーブルでシンボルでソートする場合にも使用されます。

    [
      {
        "code": "String",
        "symbol": "String"
      }
    ]
    <Array>.code 通貨コード。

    データタイプ:文字列

    <Array>.symbol 通貨記号。

    データタイプ:文字列

    この例では、インスタンスで現在アクティブな各通貨コードと記号を一覧表示します。

    var symbols = sn_currency.GlideCurrencySymbol.getSortedActiveCurrencySymbols();
    for (idx in symbols) {
        gs.info(symbols[idx]["code"] + ": " + symbols[idx]["symbol"]);
    };

    出力:

    USD: $
    CHF: CHF
    GBP: £
    JPY: ¥
    EUR: €