GlideCurrencyConfig - 범위 지정됨

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기19분
  • GlideCurrencyConfig API는 FX 통화 필드에 대한 다양한 구성 정보를 검색하는 메서드를 제공합니다.

    특정 FX 통화 필드를 인스턴스화된 객체에 연결하는 GlideCurrencyConfig(Object ed) 생성자를 호출하여 특정 FX 통화 필드에 대한 정보를 가져올 수 있습니다. 다양한 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 반환합니다.
    가능한 값:
    • 기본값: 전역 기본값. 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 Virtual Machine의 기본 로케일입니다.

    이 코드 예제에서는 기본 참조 통화를 반환합니다.

    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();