GlideCurrencyConfig - スコープ指定

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

    • GlideCurrencyConfig API は、FX 通貨フィールドのさまざまな構成情報を取得するメソッドを提供します。

    特定の FX 通貨フィールドの情報を取得するには、特定の FX 通貨フィールドをインスタンス化されたオブジェクトに関連付ける GlideCurrencyConfig(Object ed) コンストラクターを呼び出します。さまざまな GlideCurrencyConfig() メソッドを呼び出すときに、[FX 通貨] フィールドの FX 通貨構成 [fx_configuration] テーブルにレコードが存在する場合、要求された値が返されます。レコードまたはフィールドが利用できない場合は、デフォルト値が返されます。GlideCurrencyConfig() コンストラクターを呼び出して、デフォルトの FX 通貨構成値を取得することもできます。

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

    このクラスの実行は、 sn_currency 名前空間にあります。

    GlideCurrencyConfig:GlideCurrencyConfig()

    グローバルなデフォルトの FX 通貨構成情報を取得できるようにする GlideCurrencyConfig オブジェクトをインスタンス化します。

    このタイプの GlideCurrencyConfig オブジェクトで利用可能なメソッドを呼び出すと、戻り値はシステムプロパティの FX 通貨のグローバルデフォルトになります。グローバルデフォルトがシステムプロパティで定義されていない場合は、ハードコードされたデフォルトが返されます (これが設定されていない場合は空の値になることもあります)。

    このオブジェクトは、特定の FX 通貨フィールドの構成情報を提供しません。特定の FX 通貨フィールド情報を取得するには、 GlideCurrencyConfig(Object ed) コンストラクターを使用します。

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

    表 : 1. パラメーター
    名前 タイプ 説明
    なし 
    var cur_config = new sn_currency.GlideCurrencyConfig();

    GlideCurrencyConfig:GlideCurrencyConfig (オブジェクト編集済み)

    特定の FX 通貨フィールドの構成情報を取得できるようにする GlideCurrencyConfig オブジェクトをインスタンス化します。

    このタイプの GlideCurrencyConfig オブジェクトで利用可能なメソッドを呼び出す場合、戻り値は FX 通貨フィールドに関連付けられた FX 通貨構成 [fx_configuration] レコードから取得されます (レコードが存在する場合)。レコードが存在しない場合は、デフォルト値が返されます。

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

    表 : 2. パラメーター
    名前 タイプ 説明
    編集済み GlideElementDescriptor GlideCurrencyConfig オブジェクトに関連付ける FX 通貨フィールドの GlideElementDescriptor オブジェクト。 
    var grCurr = new GlideRecord('my_FXCurrency_table');
var curr_field = grCurr.getElement('currency');
var ed = curr_field.getED();
var cur_config = new sn_currency.GlideCurrencyConfig(ed);

    GlideCurrencyConfig - getAggregationSource()

    FX 通貨フィールドの集計ソース値を返します。

    対応する FX 通貨構成 [fx_configuration] レコードを持つ既存の FX 通貨フィールドで呼び出された場合は、[集計ソース (aggregation_source)] フィールドの値を返します。それ以外の場合、新しいレコードの場合はデフォルト値を返します。

    集計ソースの詳細については、「 テーブルフィールドとその通貨表示パラメーターの指定」を参照してください。

    表 : 3. パラメーター
    名前 タイプ 説明
    なし
    表 : 4. 返される内容
    タイプ 説明
    文字列 集計の値のソース。戻り値は、オブジェクトのインスタンス化に使用されるコンストラクターによって異なります。
    • GlideCurrencyConfig(Object ed):fx_configurationレコードが存在する場合、コンストラクターで渡された GlideElementDescriptor によって指定された FX 通貨フィールドに関連付けられているfx_configurationレコードからaggregation_sourceフィールドを返します。fx_configurationレコードがない場合は、 GlideCurrencyConfig() ルールに従います。
    • GlideCurrencyConfig():設定されている場合、システムプロパティの [glide.currency2.aggregation_source] フィールドの値を返します。それ以外の場合は、ハードコードされたデフォルトの 参照を返します。
    可能な値：
    • デフォルト
    • as_entered
    • 参照

    このコード例では、デフォルトの集計ソースを返します。

    var cur_config = new sn_currency.GlideCurrencyConfig();
var curr_agg_source = cur_config.getAggregationSource();

    このコード例は、特定の FX 通貨フィールドの集計ソースを返します。

    var grCurr = new GlideRecord('my_FXCurrency_table');
var curr_field = grCurr.getElement('currency');
var ed = curr_field.getED();
var cur_config = new sn_currency.GlideCurrencyConfig(ed);
var curr_agg_source = cur_config.getAggregationSource();

    GlideCurrencyConfig - getConversionDateSource()

    通貨換算の日時のソースとして使用されるフィールドを返します。

    対応する FX 通貨構成 [fx_configuration] レコードを持つ既存の FX 通貨フィールドで呼び出された場合は、[変換日ソース (conversion_date_source)] フィールドの値を返します。それ以外の場合、新しいレコードの場合は「null」を返します。

    [換算日ソース] フィールドの詳細については、「 通貨換算のレート テーブルと日付ソースの識別」を参照してください。

    表 : 5. パラメーター
    名前 タイプ 説明
    なし
    表 : 6. 返される内容
    タイプ 説明
    文字列 変換日ソースとして使用されるレコード内のフィールド。戻り値は、オブジェクトのインスタンス化に使用されるコンストラクターによって異なります。
    • GlideCurrencyConfig(Object ed):fx_configurationレコードが存在する場合、コンストラクターで渡された GlideElementDescriptor によって指定された FX 通貨フィールドに関連付けられているfx_configurationレコードからconversion_date_sourceフィールドを返します。fx_configurationレコードがない場合は、 GlideCurrencyConfig() ルールに従います。
    • GlideCurrencyConfig():null を返します。

    このコード例は、特定の FX 通貨フィールドの換算日ソースを返します。

    var grCurr = new GlideRecord('my_FXCurrency_table');
var curr_field = grCurr.getElement('currency');
var ed = curr_field.getED();
var cur_config = new sn_currency.GlideCurrencyConfig(ed);
var curr_conv_date_src = cur_config.getConversionDateSource();

    GlideCurrencyConfig:getDisplayDigits()

    FX 通貨フィールドに表示する桁数を返します。

    対応する FX 通貨構成 [fx_configuration] レコードがある既存の FX 通貨フィールドで呼び出された場合は、[表示桁 (display_digits)] フィールドの値を返します。それ以外の場合、新しいレコードの場合はデフォルト値を返します。

    表 : 7. パラメーター
    名前 タイプ 説明
    なし
    表 : 8. 返される内容
    タイプ 説明
    番号 FX 通貨フィールドに表示する桁数。戻り値は、オブジェクトのインスタンス化に使用されるコンストラクターによって異なります。
    • GlideCurrencyConfig(Object ed):fx_configurationレコードが存在する場合、コンストラクターで渡された GlideElementDescriptor によって指定された FX 通貨フィールドに関連付けられている FX 通貨構成 [fx_configuration] レコードの display_digits フィールドの値を返します。fx_configurationレコードがない場合は、 GlideCurrencyConfig() ルールに従います。
    • GlideCurrencyConfig():設定されている場合、システムプロパティの glide.currency2.display_digits プロパティの値を返します。それ以外の場合は -1 を返します。

    このコード例では、デフォルトの表示桁数を返します。

    var cur_config = new sn_currency.GlideCurrencyConfig();
var curr_display_digits = cur_config.getDisplayDigits();

    このコード例は、特定の FX 通貨フィールドの表示桁を返します。

    var grCurr = new GlideRecord('my_FXCurrency_table');
var curr_field = grCurr.getElement('currency');
var ed = curr_field.getED();
var cur_config = new sn_currency.GlideCurrencyConfig(ed);
var curr_display_digits = cur_config.getDisplayDigits();

    GlideCurrencyConfig - getDisplayValue()

    リストやレポートに FX 通貨値が表示されたときの換算に使用される通貨コードを返します。

    対応する FX 通貨構成 [fx_configuration] レコードを持つ既存の FX 通貨フィールドで呼び出された場合は、[表示値通貨 (display_value)] フィールドの値を返します。それ以外の場合、新しいレコードの場合はデフォルト値を返します。

    表 : 9. パラメーター
    名前 タイプ 説明
    なし
    表 : 10. 返される内容
    タイプ 説明
    文字列 FX 通貨フィールドの表示に使用する通貨コード。戻り値は、オブジェクトのインスタンス化に使用されるコンストラクターによって異なります。
    • GlideCurrencyConfig(Object ed):fx_configurationレコードが存在する場合、コンストラクターで渡された GlideElementDescriptor によって指定された FX 通貨フィールドに関連付けられているfx_configurationレコードから、通貨コードを含むdisplay_valueフィールドを返します。fx_configurationレコードがない場合は、 GlideCurrencyConfig() ルールに従います。
    • GlideCurrencyConfig():設定されている場合、システムプロパティの glide.currency2.display_value プロパティの値を返します。それ以外の場合は、 as_entered を返します。
    可能な値：
    • default:グローバルデフォルト。これは glide.currency2.display_digits プロパティの値です。
    • as_entered:ユーザーが入力した通貨値。
    • in_session_currency:セッション通貨に変換された通貨値。セッション通貨は、ユーザーのロケールに基づきます。
    • in_reference_currency:計算および保存されている場合は参照値。それ以外の場合、通貨値は参照通貨に変換されます。

    このコード例では、デフォルトの通貨コードを返します。

    var cur_config = new sn_currency.GlideCurrencyConfig();
var curr_display_value = cur_config.getDisplayValue();

    このコード例は、特定の FX 通貨フィールドの表示通貨コードを返します。

    var grCurr = new GlideRecord('my_FXCurrency_table');
var curr_field = grCurr.getElement('currency');
var ed = curr_field.getED();
var cur_config = new sn_currency.GlideCurrencyConfig(ed);
var curr_display_value = cur_config.getDisplayValue();

    GlideCurrencyConfig - getRateFilterRateTableField()

    FX 通貨フィールドのレートテーブルフィルターとして使用されるレートテーブルフィールドを返します。

    対応する FX 通貨構成 [fx_configuration] レコードを持つ既存の FX 通貨フィールドで呼び出された場合、レートテーブルフィールド (rate_filter_rate_table_field) の値を返します。それ以外の場合、新しいレコードの場合はデフォルト値を返します。

    レートテーブルフィルターの詳細については、「 フィルタリングに使用するレートテーブルフィールドとターゲットテーブルフィールドを選択する」を参照してください。

    表 : 11. パラメーター
    名前 タイプ 説明
    なし
    表 : 12. 返される内容
    タイプ 説明
    文字列 レートテーブルレコードをフィルタリングするために使用されるレートテーブルのフィールド。戻り値は、オブジェクトのインスタンス化に使用されるコンストラクターによって異なります。
    • GlideCurrencyConfig(Object ed):fx_configurationレコードが存在する場合、コンストラクターで渡された GlideElementDescriptor によって指定された FX 通貨フィールドに関連付けられているfx_configurationレコードからrate_filter_rate_table_fieldを返します。fx_configurationレコードがない場合は、 GlideCurrencyConfig() ルールに従います。
    • GlideCurrencyConfig():null を返します。

    このコード例では、特定の FX 通貨フィールドのレートテーブルレコードをフィルタリングするために使用されるレートテーブルフィールドを返します。

    var grCurr = new GlideRecord('my_FXurrency_table');
var curr_field = grCurr.getElement('currency');
var ed = curr_field.getED();
var cur_config = new sn_currency.GlideCurrencyConfig(ed);
var curr_reference_currency = cur_config.getRateFilterRateTableField();

    GlideCurrencyConfig - getRateFilterTargetTableField()

    FX 通貨フィールドのレートテーブルレコードをフィルタリングするために使用されるターゲットテーブルフィールドを返します。

    対応する FX 通貨構成 [fx_configuration] レコードを持つ既存の FX 通貨フィールドで呼び出された場合は、ターゲットテーブルフィールド (rate_filter_target_table_field) の値を返します。それ以外の場合、新しいレコードの場合はデフォルト値を返します。

    レートテーブルフィルターの詳細については、「 フィルタリングに使用するレートテーブルフィールドとターゲットテーブルフィールドを選択する」を参照してください。

    表 : 13. パラメーター
    名前 タイプ 説明
    なし
    表 : 14. 返される内容
    タイプ 説明
    文字列 レートテーブルをフィルタリングするために使用する、ターゲットテーブルのフィールド。戻り値は、オブジェクトのインスタンス化に使用されるコンストラクターによって異なります。
    • GlideCurrencyConfig(Object ed):fx_configurationレコードが存在する場合、コンストラクターで渡された GlideElementDescriptor によって指定された FX 通貨フィールドに関連付けられているfx_configurationレコードからrate_filter_target_table_fieldを返します。fx_configurationレコードがない場合は、 GlideCurrencyConfig() ルールに従います。
    • GlideCurrencyConfig():null を返します。

    このコード例では、デフォルトのレートフィルター、ターゲットテーブルフィールドを返します。

    var cur_config = new sn_currency.GlideCurrencyConfig();
var curr_rate_filter = cur_config.getRateFilterTargetTableField();

    このコード例は、レートフィルター、特定の FX 通貨フィールドのターゲットテーブルフィールドを返します。

    var grCurr = new GlideRecord('my_FXCurrency_table');
var curr_field = grCurr.getElement('currency');
var ed = curr_field.getED();
var cur_config = new sn_currency.GlideCurrencyConfig(ed);
var curr_rate_filter = cur_config.getRateFilterTargetTableField();

    GlideCurrencyConfig:getRateTable()

    FX 通貨フィールドの通貨換算に使用するレートテーブルを返します。

    対応する FX 通貨構成 [fx_configuration] レコードを持つ既存の FX 通貨フィールドで呼び出された場合、レートテーブルフィールド (rate_filter_rate_table_field) の値を返します。それ以外の場合、新しいレコードの場合はデフォルト値を返します。

    FX 通貨レートテーブルの詳細については、「 通貨換算のレートテーブルと日付ソースの識別」を参照してください。

    表 : 15. パラメーター
    名前 タイプ 説明
    なし
    表 : 16. 返される内容
    タイプ 説明
    文字列 通貨換算の実行に使用されるレートテーブルの名前。戻り値は、オブジェクトのインスタンス化に使用されるコンストラクターによって異なります。
    • GlideCurrencyConfig(Object ed):fx_configurationレコードが存在する場合、コンストラクターで渡された GlideElementDescriptor によって指定された FX 通貨フィールドに関連付けられているfx_configurationレコードからrate_table_fieldフィールドを返します。fx_configurationレコードがない場合は、 GlideCurrencyConfig() ルールに従います。
    • GlideCurrencyConfig():設定されている場合、システムプロパティから glide.currency2.system_rate_table プロパティの値を返します。それ以外の場合は、 fx_system_rate を返します。

    デフォルトのレートテーブルを返します。

    var cur_config = new sn_currency.GlideCurrencyConfig();
var curr_rate_table = cur_config.getRateTable();

    特定の FX 通貨フィールドに使用されるレートテーブルを返します。

    var grCurr = new GlideRecord('my_FXCurrency_table');
var curr_field = grCurr.getElement('currency');
var ed = curr_field.getED();
var cur_config = new sn_currency.GlideCurrencyConfig(ed);
var curr_rate_table = cur_config.getRateTable();

    GlideCurrencyConfig - getReferenceCurrency()

    FX 通貨フィールドの参照通貨を返します。

    対応する FX 通貨構成 [fx_configuration] レコードを持つ既存の FX 通貨フィールドで呼び出された場合は、[参照通貨 (reference_currency)] フィールドの値を返します。それ以外の場合、新しいレコードの場合はデフォルト値を返します。

    参照通貨の詳細については、「 参照通貨の設定」を参照してください。

    表 : 17. パラメーター
    名前 タイプ 説明
    なし
    表 : 18. 返される内容
    タイプ 説明
    文字列 ISO 通貨コードとしての参照通貨。戻り値は、オブジェクトのインスタンス化に使用されるコンストラクターによって異なります。
    • GlideCurrencyConfig(Object ed):fx_configurationレコードが存在する場合、コンストラクターで渡された GlideElementDescriptor によって指定された FX 通貨フィールドに関連付けられているfx_configurationレコードからreference_currencyフィールドを返します。fx_configurationレコードがない場合は、 GlideCurrencyConfig() ルールに従います。
    • GlideCurrencyConfig():設定されている場合、glide.currency2.default_reference_currencyシステムプロパティの値を返します。それ以外の場合、メソッドは指定された順序で次のルールを適用して、参照通貨コードを決定します。
      • glide.system.reference_currencyシステムプロパティが true に設定されている場合は、glide.system.reference_currency.code システムプロパティの値を使用します。
      • glide.system.locale システムプロパティの値 (通貨を含む)。
      • インスタンスが実行されている Java 仮想マシンのデフォルトロケール。

    このコード例では、デフォルトの参照通貨を返します。

    var cur_config = new sn_currency.GlideCurrencyConfig();
var curr_reference_currency = cur_config.getReferenceCurrency();

    このコード例は、特定の FX 通貨フィールドの参照通貨を返します。

    var grCurr = new GlideRecord('my_FXCurrency_table');
var curr_field = grCurr.getElement('currency');
var ed = curr_field.getED();
var cur_config = new sn_currency.GlideCurrencyConfig(ed);
var curr_reference_currency = cur_config.getReferenceCurrency();

    GlideCurrencyConfig - getReferenceCurrencySource()

    FX 通貨フィールドの参照通貨ソースを返します。

    対応する FX 通貨構成 [fx_configuration] レコードを持つ既存の FX 通貨フィールドで呼び出された場合、参照通貨ソース (reference_currency_source) フィールドの値 (ドット連結パス) を返します。それ以外の場合、新しいレコードの場合はデフォルト値を返します。

    参照通貨ソースの詳細については、「 参照通貨の設定」を参照してください。

    表 : 19. パラメーター
    名前 タイプ 説明
    なし
    表 : 20. 返される内容
    タイプ 説明
    文字列 参照通貨として使用/使用するフィールドのドット連結パス。戻り値は、オブジェクトのインスタンス化に使用されるコンストラクターによって異なります。
    • GlideCurrencyConfig(Object ed):fx_configurationレコードが存在する場合、コンストラクターで渡された GlideElementDescriptor によって指定された FX 通貨フィールドに関連付けられているfx_configurationレコードからreference_currency_sourceフィールドを返します。fx_configurationレコードがない場合は、 GlideCurrencyConfig() ルールに従います。
    • GlideCurrencyConfig():null を返します。

    このコード例では、デフォルトの参照通貨ソースを返します。

    var cur_config = new sn_currency.GlideCurrencyConfig();
var curr_reference_currency = cur_config.getReferenceCurrencySource();

    このコード例は、特定の FX 通貨フィールドの参照通貨ソースを返します。

    var grCurr = new GlideRecord('my_FXCurrency_table');
var curr_field = grCurr.getElement('currency');
var ed = curr_field.getED();
var cur_config = new sn_currency.GlideCurrencyConfig(ed);
var curr_reference_currency = cur_config.getReferenceCurrencySource();