GlideElementCurrency2 - スコープ指定

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：6分

    • GlideElementCurrency2 API は、現在の GlideRecord 内の外国為替 (FX) 通貨フィールド (Currency2 とも呼ばれます) で操作を実行するメソッドを提供します。

    この API は、次のことを実行できるようにするメソッドを提供します。
    • ユーザーが入力した FX 通貨フィールドの表示文字列を取得します。
    • FX 通貨フィールドの表示値を取得します。
    • FX 通貨フィールドの参照通貨値を取得します。
    • FX 通貨フィールドのセッション通貨値を取得します。
    • FX 通貨フィールドの表示値を設定します。

    GlideElementCurrency2 クラスにはコンストラクターがありません。

    GlideElementCurrency2:getAsEnteredDisplayValue()

    関連付けられた GlideRecord から、ユーザーが入力した FX 通貨フィールド表示文字列を返します。

    FX 通貨フィールドの詳細については、「 FX 通貨フィールドの設定と操作」を参照してください。

    表 : 1. パラメーター
    名前 タイプ 説明
    なし
    表 : 2. 返される内容
    タイプ 説明
    文字列 ユーザーが入力した通貨文字列を表示します。

    この例では、メソッドを呼び出す方法を示します。

    var tablename = 'my_currency2_table';
var setcur2 = new GlideRecord(tablename);
setcur2.initialize();
setcur2.currency_2_field.setDisplayValue('JPY;999999.1234');
setcur2.insert();
gs.info('As entered display value: ' + setcur2.currency_2_field.getAsEnteredDisplayValue());

    出力：

    As entered display value: ¥999,999.12

    GlideElementCurrency2:getDisplayValue()

    関連付けられた GlideRecord 内の FX 通貨フィールドの表示値を返します。

    FX 通貨構成 [fx_configuration] テーブルでのdisplay_valueの設定方法に応じて、戻り値は次のようになります。
    • ユーザーが入力した通貨値
    • セッション通貨に変換された通貨値 (ユーザーのロケールに基づく)
    • 参照通貨に変換された通貨値

    FX 通貨と構成テーブルの詳細については、「 FX 通貨のグローバル設定の構成」を参照してください。

    表 : 3. パラメーター
    名前 タイプ 説明
    なし
    表 : 4. 返される内容
    タイプ 説明
    文字列 通貨値を表示

    この例では、メソッドを呼び出す方法を示します。

    var tablename = 'my_FXcurrency_table';
var setcur2 = new GlideRecord(tablename);
setcur2.initialize();
setcur2.currency_2_field.setDisplayValue('JPY;999999.1234');
setcur2.insert();
gs.info('Display Value: ' + setcur2.currency_2_field.getDisplayValue());

    出力：

    Display Value: ¥999,999.12

    GlideElementCurrency2:getReferenceDisplayValue()

    関連する GlideRecord 内の FX 通貨フィールドの参照通貨値を返します。

    参照通貨は、フィールド内のすべての通貨値が換算される共通通貨です。getReferenceDisplayValue() メソッドが参照通貨を導出するために使用する通貨コードは、以下に基づいています。
    • インスタンスレコードが存在する場合、メソッドは FX 通貨 [fx_currency2_instance] テーブルの reference_currency フィールドの値を使用します。
    • インスタンスレコードが存在しない場合、メソッドは、インスタンスレコードが最終的に作成されたときにインスタンスレコードに設定される参照通貨を使用します (次の順序)。
      • 設定されている場合は、FX 通貨構成 [fx_configuration] テーブルの reference_currency 。
      • 設定されている場合は、FX 通貨構成 [fx_configuration] テーブルの reference_currency_source 。
      • システムのデフォルト、システム参照通貨。

    FX 通貨構成 [fx_configuration] テーブルの値の詳細については、「 FX 通貨フィールドの設定と操作」を参照してください。

    表 : 5. パラメーター
    名前 タイプ 説明
    なし
    表 : 6. 返される内容
    タイプ 説明
    文字列 関連する FX 通貨表示値の参照通貨金額。

    この例では、参照通貨コードが USD であると仮定し、FX 通貨構成 [fx_configuration] テーブルで指定されたデフォルトの換算レートを使用します。出力はロケールに基づいて変更されます。

    var tablename = 'my_currency2_table';
var setcur2 = new GlideRecord(tablename);
setcur2.initialize();
setcur2.currency_2_field.setDisplayValue('JPY;999999.1234');
setcur2.insert();
gs.info('Reference display value: ' + setcur2.currency_2_field.getReferenceDisplayValue());

    出力:

    Reference display value: $8,677.99

    GlideElementCurrency2:getSessionDisplayValue()

    現在の GlideRecord 内の関連する FX 通貨フィールドのセッション通貨値を返します。

    表 : 7. パラメーター
    名前 タイプ 説明
    なし
    表 : 8. 返される内容
    タイプ 説明
    文字列 現在のユーザーのロケールに基づいてセッション通貨に変換された通貨値。

    この例では、セッションロケールが言語コード = eng で国コード = USA であると仮定し、FX 通貨構成 [fx_configuration] テーブルで指定されたデフォルトの換算レートを使用します。出力はロケールに基づいて変更されます。

    var tablename = 'my_currency2_table';
var setcur2 = new GlideRecord(tablename);
setcur2.initialize();
setcur2.currency_2_field.setDisplayValue('JPY;999999.1234');
setcur2.insert();
gs.info('Session display value: ' + setcur2.currency_2_field.getSessionDisplayValue());

    出力:

    Session display value: $8,677.99

    GlideElementCurrency2:setDisplayValue(文字列 displayValue)

    FX 通貨フィールドの表示値を指定された通貨値で設定します。

    FX 通貨フィールドの詳細については、「 FX 通貨フィールドの設定と操作」を参照してください。

    表 : 9. パラメーター
    名前 タイプ 説明
    displayValue 文字列 FX 通貨フィールドに <通貨コード>;<通貨金額>。ユーザーのロケールで <通貨金額> フィールドを書式設定する必要があります。

    たとえば、ユーザーのロケールが USA/eng の場合、渡される <通貨金額> は 123.45 になります。ユーザーのローカルが FRA/fre の場合、渡される <通貨金額> は 123,45 になります。
    表 : 10. 返される内容
    タイプ 説明
    なし

    この例では、メソッドを呼び出す方法を示します。

    var tablename = 'my_FXcurrency_table';
var setcur2 = new GlideRecord(tablename);
setcur2.initialize();
setcur2.currency_2_field.setDisplayValue('JPY;999,999.1234');
setcur2.insert();