GlideCurrencyConfig - 범위 지정

GlideCurrencyConfig API는 FX 통화 필드에 대한 다양한 구성 정보를 검색하는 메서드를 제공합니다.

특정 FX 통화 필드를 인스턴스화된 객체에 연결하는 GlideCurrencyConfig(Object ed) 생성자를 호출하여 특정 FX 통화 필드에 대한 정보를 가져올 수 있습니다. 다양한 GlideCurrencyConfig() 메서드를 호출할 때 FX 통화 필드에 대한 FX 통화 구성[fx_configuration] 테이블에 기록이 있으면 요청된 값이 다시 전달됩니다. 기록이나 필드를 사용할 수 없는 경우 기본값이 다시 전달됩니다. GlideCurrencyConfig() 생성자를 호출하여 기본 FX 통화 구성 값을 가져올 수도 있습니다.

FX 통화 구성에 대한 자세한 내용은 FX 통화 필드 설정 및 운영을 참조하십시오.

이 클래스는 sn_currency 네임스페이스에서 실행됩니다.

GlideCurrencyConfig - getAggregationSource()

FX 통화 필드에 대한 집계 소스 값을 반환합니다.

해당 FX 통화 구성[fx_configuration] 기록이 있는 기존 FX 통화 필드에서 호출되면 집계 소스(aggregation_source) 필드의 값을 반환합니다. 그렇지 않고 새 레코드인 경우 기본값을 반환합니다.

집계 소스에 대한 자세한 내용은 테이블 필드와 해당 통화 표시 매개변수 지정을 참조하십시오.

표 1. 매개변수

이름	유형	설명
없음

표 2. 반환

유형

설명

문자열

집계 값의 소스입니다. 반환되는 값은 개체를 인스턴스화하는 데 사용되는 생성자에 따라 달라집니다. 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 Currency 필드에 대한 집계 소스를 반환합니다.

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"을 반환합니다.

환산 날짜 소스 필드에 대한 자세한 내용은 통화 환산을 위한 요율 테이블 및 날짜 소스 식별을 참조하십시오.

표 3. 매개변수

이름	유형	설명
없음

표 4. 반환

유형	설명
문자열	변환 날짜 소스로 사용되는 기록의 필드입니다. 반환되는 값은 개체를 인스턴스화하는 데 사용되는 생성자에 따라 달라집니다. GlideCurrencyConfig(Object ed): fx_configuration 기록이 있는 경우 생성자에 전달된 GlideElementDescriptor에서 지정한 FX 통화 필드와 연결된 fx_configuration 기록에서 conversion_date_source 필드를 반환합니다. fx_configuration 기록이 없는 경우 GlideCurrencyConfig() 규칙을 따릅니다. GlideCurrencyConfig():null을 반환합니다.

이 코드 예에서는 특정 FX Currency 필드에 대한 변환 날짜 소스를 반환합니다.

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) 필드의 값을 반환합니다. 그렇지 않고 새 레코드인 경우 기본값을 반환합니다.

표 5. 매개변수

이름	유형	설명
없음

표 6. 반환

유형	설명
번호	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) 필드의 값을 반환합니다. 그렇지 않고 새 레코드인 경우 기본값을 반환합니다.

표 7. 매개변수

이름	유형	설명
없음

표 8. 반환

유형

설명

문자열

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)의 값을 반환합니다. 그렇지 않고 새 레코드인 경우 기본값을 반환합니다.

요금 테이블 필터에 대한 자세한 내용은 필터링에 사용되는 요금 및 대상 테이블 필드 선택을 참조하십시오.

표 9. 매개변수

이름	유형	설명
없음

표 10. 반환

유형	설명
문자열	요금 테이블 기록을 필터링하는 데 사용되는 요금 테이블의 필드입니다. 반환되는 값은 개체를 인스턴스화하는 데 사용되는 생성자에 따라 달라집니다. 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)의 값을 반환합니다. 그렇지 않고 새 레코드인 경우 기본값을 반환합니다.

요금 테이블 필터에 대한 자세한 내용은 필터링에 사용되는 요금 및 대상 테이블 필드 선택을 참조하십시오.

표 11. 매개변수

이름	유형	설명
없음

표 12. 반환

유형	설명
문자열	요금 테이블을 필터링하는 데 사용되거나 사용하게 될 대상 테이블의 필드입니다. 반환되는 값은 개체를 인스턴스화하는 데 사용되는 생성자에 따라 달라집니다. 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 환율표에 대한 자세한 내용은 환율 테이블 및 통화 변환에 대한 날짜 소스 식별을 참조하세요.

표 13. 매개변수

이름	유형	설명
없음

표 14. 반환

유형

설명

문자열

통화 변환을 수행하는 데 사용되는 요금 테이블의 이름입니다. 반환되는 값은 개체를 인스턴스화하는 데 사용되는 생성자에 따라 달라집니다. 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) 필드의 값을 반환합니다. 그렇지 않고 새 레코드인 경우 기본값을 반환합니다.

참조 통화에 대한 자세한 내용은 참조 통화 설정을 참조하십시오.

표 15. 매개변수

이름	유형	설명
없음

표 16. 반환

유형

설명

문자열

참조 통화를 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) 필드의 값(닷워킹 경로)을 반환합니다. 그렇지 않고 새 레코드인 경우 기본값을 반환합니다.

기준 통화 소스에 대한 자세한 내용은 참조 통화 설정을 참조하십시오.

표 17. 매개변수

이름	유형	설명
없음

표 18. 반환

유형	설명
문자열	참조 통화로 사용되거나 사용할 필드의 닷워킹 경로입니다. 반환되는 값은 개체를 인스턴스화하는 데 사용되는 생성자에 따라 달라집니다. 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();

GlideCurrencyConfig - GlideCurrencyConfig()

전역 기본 FX 통화 구성 정보를 검색할 수 있는 GlideCurrencyConfig 객체를 인스턴스화합니다.

이 유형의 GlideCurrencyConfig 객체에서 사용 가능한 메서드를 호출할 때 반환 값은 시스템 속성의 FX 통화 전역 기본값입니다. 전역 기본값이 시스템 속성에 정의되어 있지 않으면 하드 코딩된 기본값이 반환됩니다(구성되지 않은 경우 빈 값일 수도 있음).

이 개체는 특정 FX 통화 필드에 대한 구성 정보를 제공하지 않습니다. 특정 FX 통화 필드 정보를 검색하려면 GlideCurrencyConfig(Object ed) 생성자를 사용합니다.

자세한 내용은 FX 통화 전역 설정 구성을 참조하십시오.

표 19. 매개변수

이름	유형	설명
없음

var cur_config = new sn_currency.GlideCurrencyConfig();

GlideCurrencyConfig - GlideCurrencyConfig(객체 편집)

특정 FX 통화 필드에 대한 구성 정보를 검색할 수 있는 GlideCurrencyConfig 객체를 인스턴스화합니다.

이 유형의 GlideCurrencyConfig 객체에서 사용 가능한 메서드를 호출할 때 반환 값은 기록이 있는 경우 FX 통화 필드와 연결된 FX 통화 구성[fx_configuration] 기록에서 가져옵니다. 기록이 없으면 기본값이 반환됩니다.

자세한 내용은 FX 통화 전역 설정 구성을 참조하십시오.

표 20. 매개변수

이름	유형	설명
Ed	GlideElement설명자	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);