GlideCurrencyConfig - 범위 지정됨

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(Object ed)

특정 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 필드에 값을 반환합니다. 그렇지 않으면 하드 코딩된 기본값 reference를 반환합니다. 가능한 값: 기본값 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 통화 구성 [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 시스템 속성의 값(통화를 의미함)입니다. 인스턴스가 실행되고 있는 JVM(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();