GlideCurrencyConfig - スコープ付き

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：22分

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

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

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

    このクラスは sn_currency 名前空間で実行されます。

    GlideCurrencyConfig - GlideCurrencyConfig()

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

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

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

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

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

    GlideCurrencyConfig - GlideCurrencyConfig(オブジェクト ed)

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

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

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

    表 : 2. パラメーター
    名前 タイプ 説明
    ed 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(オブジェクト ed)：fx_configuration レコードが存在する場合、コンストラクターに渡された GlideElementDescriptor が指定する FX 通貨フィールドに関連付けられた fx_configuration レコードから、aggregation_source フィールドを返します。fx_configuration レコードが存在しない場合、GlideCurrencyConfig() ルールに従います。
    • GlideCurrencyConfig()：設定された場合、システムプロパティの glide.currency2.aggregation_source フィールドの値を返します。それ以外の場合は、ハードコードされたデフォルトの reference を返します。
    可能な値：
    • default
    • 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(オブジェクト 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(オブジェクト 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(オブジェクト ed)：fx_configuration レコードが存在する場合、コンストラクターに渡された GlideElementDescriptor が指定する FX 通貨フィールドに関連付けられた fx_configuration レコードから、通貨コードを含む display_value フィールドを返します。fx_configuration レコードが存在しない場合、GlideCurrencyConfig() ルールに従います。
    • GlideCurrencyConfig()：設定された場合、システムプロパティの glide.currency2.display_value プロパティの値を返します。それ以外の場合は、as_entered を返します。
    可能な値：
    • デフォルト：グローバルのデフォルトです。これは 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(オブジェクト 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(オブジェクト 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(オブジェクト 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(オブジェクト 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(オブジェクト 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();