---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideElementCurrency2 - 범위 지정됨

# GlideElementCurrency2 - 범위 지정됨 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 6분

GlideElementCurrency2 API는 현재 GlideRecord 내의 외환(FX) 통화 필드(Currency2라고도 함)에 대한 작업을 수행하는 메서드를 제공합니다.  
이 API는 다음을 수행할 수 있는 메서드를 제공합니다.

* 사용자가 입력한 FX 통화 필드 표시 문자열을 가져옵니다.
* FX 통화 필드의 표시 값을 가져옵니다.
* FX 통화 필드의 기준 통화 값을 가져옵니다.
* FX 통화 필드의 세션 통화 값을 가져옵니다.
* FX 통화 필드의 표시 값을 설정합니다.
{#GlideElementCurrency2ScopedAPI__ul_dvb_b14_yjb}

GlideElementCurrency2 클래스에는 생성자가 없습니다.

## GlideElementCurrency2 - getAsEnteredDisplayValue() {#ariaid-title2}

연결된 GlideRecord에서 사용자가 입력한 FX 통화 필드 표시 문자열을 반환합니다.
FX 통화 필드에 대한 자세한 내용은 [FX 통화 필드 설정 및 운영](https://www.servicenow.com/docs/access?context=fx-currency&version=australia&pubname=australia-platform-administration&ft:locale=en-US)을 참조하십시오.
{#Scoped-GEC-getAsEntDispVal__table_tpv_5kd_fy__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 1. 매개변수]

{#Scoped-GEC-getAsEntDispVal__table_tpv_5kd_fy} {#Scoped-GEC-getAsEntDispVal__table_upv_5kd_fy__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 사용자가 입력한 대로 통화 문자열을 표시합니다. |
[표 2. 반환]

{#Scoped-GEC-getAsEntDispVal__table_upv_5kd_fy}  
이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    var tablename = 'my_currency2_table';
    var setcur2 = new GlideRecord(tablename);
    setcur2.initialize();
    setcur2.currency_2_field.setDisplayValue('JPY;999999.1234');
    setcur2.insert();
    gs.info('As entered display value: ' + setcur2.currency_2_field.getAsEnteredDisplayValue());

출력:

    As entered display value: ¥999,999.12

## GlideElementCurrency2 - getDisplayValue() {#ariaid-title3}

연결된 GlideRecord 내에서 FX 통화 필드의 표시 값을 반환합니다.
FX 통화 구성 \[fx_configuration\] 테이블에서 display_value가 설정되는 방법에 따라 반환 값은 다음과 같습니다.

* 사용자가 입력한 통화 값
* 세션 통화로 변환된 통화 값(사용자의 로캘 기준)
* 기준 통화로 변환된 통화 값
{#Scoped-GEC-getDisplayVal__ul_c3x_vhj_qjb}

FX 통화 및 구성 테이블에 대한 자세한 내용은 [FX 통화 전역 설정 구성을](https://www.servicenow.com/docs/access?context=fx-currency-configure&version=australia&pubname=australia-platform-administration&ft:locale=en-US) 참조하십시오.
{#Scoped-GEC-getDisplayVal__table_qxq_k5c_fy__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 3. 매개변수]

{#Scoped-GEC-getDisplayVal__table_qxq_k5c_fy} {#Scoped-GEC-getDisplayVal__table_rxq_k5c_fy__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 통화 값 표시 |
[표 4. 반환]

{#Scoped-GEC-getDisplayVal__table_rxq_k5c_fy}  
이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    var tablename = 'my_FXcurrency_table';
    var setcur2 = new GlideRecord(tablename);
    setcur2.initialize();
    setcur2.currency_2_field.setDisplayValue('JPY;999999.1234');
    setcur2.insert();
    gs.info('Display Value: ' + setcur2.currency_2_field.getDisplayValue());

출력:

    Display Value: ¥999,999.12

## GlideElementCurrency2 - getReferenceDisplayValue() {#ariaid-title4}

연결된 GlideRecord 내에서 FX 통화 필드의 기준 통화 값을 반환합니다.
기준 통화는 필드의 모든 통화 값이 변환되는 공통 통화입니다. getReferenceDisplayValue() 메서드가 기준 통화를 파생하는 데 사용하는 통화 코드는 다음을 기반으로 합니다.

* 인스턴스 기록이 있으면 메서드는 FX 통화 \[fx_currency2_instance\] 테이블의 reference_currency 필드에 있는 값을 사용합니다.
* 인스턴스 기록이 없으면 메서드는 인스턴스 기록이 최종적으로 생성될 때 인스턴스 기록에 설정되는 참조 통화를 사용합니다(다음 순서로).
  * 설정된 경우 FX 통화 구성 \[fx_configuration\] 테이블에 있습니다 reference_currency .
  * 설정된 경우 FX 통화 구성 \[fx_configuration\] 테이블에 있습니다 reference_currency_source .
  * 시스템 기본값, 시스템 참조 통화입니다.
  {#Scoped-GEC-getRefDispVal__ul_sb1_2tx_sjb}
{#Scoped-GEC-getRefDispVal__ul_l5z_x3j_qjb}

FX 통화 구성 \[fx_configuration\] 테이블의 값에 대한 자세한 내용은 [FX 통화 필드 설정 및 운영](https://www.servicenow.com/docs/access?context=fx-currency&version=australia&pubname=australia-platform-administration&ft:locale=en-US)을 참조하십시오.
{#Scoped-GEC-getRefDispVal__table_ywn_hmd_fy__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 5. 매개변수]

{#Scoped-GEC-getRefDispVal__table_ywn_hmd_fy} {#Scoped-GEC-getRefDispVal__table_zwn_hmd_fy__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 연결된 FX 통화 표시 값의 기준 통화 금액입니다. |
[표 6. 반환]

{#Scoped-GEC-getRefDispVal__table_zwn_hmd_fy}  
이 예에서는 기준 통화 코드가 USD이고 FX 통화 구성 \[fx_configuration\] 테이블에 지정된 기본 환산율을 사용한다고 가정합니다. 출력은 로케일에 따라 변경됩니다.

    var tablename = 'my_currency2_table';
    var setcur2 = new GlideRecord(tablename);
    setcur2.initialize();
    setcur2.currency_2_field.setDisplayValue('JPY;999999.1234');
    setcur2.insert();
    gs.info('Reference display value: ' + setcur2.currency_2_field.getReferenceDisplayValue());

출력:

    Reference display value: $8,677.99

## GlideElementCurrency2 - getSessionDisplayValue() {#ariaid-title5}

현재 GlideRecord 내에서 연결된 FX 통화 필드의 세션 통화 값을 반환합니다.
{#Scoped-GEC-getSesDispVal__table_ozy_rld_fy__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 7. 매개변수]

{#Scoped-GEC-getSesDispVal__table_ozy_rld_fy} {#Scoped-GEC-getSesDispVal__table_pzy_rld_fy__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 현재 사용자의 로캘을 기준으로 세션 통화로 변환된 통화 값입니다. |
[표 8. 반환]

{#Scoped-GEC-getSesDispVal__table_pzy_rld_fy}  
이 예에서는 세션 로캘을 언어 코드 = eng 및 국가 코드 = 미국으로 가정하고 FX 통화 구성 \[fx_configuration\] 테이블에 지정된 기본 환산율을 사용합니다. 출력은 로케일에 따라 변경됩니다.

    var tablename = 'my_currency2_table';
    var setcur2 = new GlideRecord(tablename);
    setcur2.initialize();
    setcur2.currency_2_field.setDisplayValue('JPY;999999.1234');
    setcur2.insert();
    gs.info('Session display value: ' + setcur2.currency_2_field.getSessionDisplayValue());

출력:

    Session display value: $8,677.99

## GlideElementCurrency2 - setDisplayValue(문자열 displayValue) {#ariaid-title6}

지정된 통화 값으로 FX 통화 필드의 표시 값을 설정합니다.
FX 통화 필드에 대한 자세한 내용은 [FX 통화 필드 설정 및 운영](https://www.servicenow.com/docs/access?context=fx-currency&version=australia&pubname=australia-platform-administration&ft:locale=en-US)을 참조하십시오.
{#Scoped-GEC-setDisplayVal_S__table_enw_5jd_fy__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| displayValue | 문자열 | FX 통화 필드에서 `<통화 코드>; 형식으로 설정할 값 <통화 금액>`. 사용자의 로캘에서 `<통화 금액>` 필드의 형식을 지정해야 합니다. 예를 들어 사용자의 로캘이 USA/eng이면 전달된 `<통화 금액>` 은 123.45가 됩니다. 사용자의 로컬이 FRA/fre인 경우 전달된 `<통화 금액>` 은 123,45가 됩니다. |
[표 9. 매개변수]

{#Scoped-GEC-setDisplayVal_S__table_enw_5jd_fy} {#Scoped-GEC-setDisplayVal_S__table_fnw_5jd_fy__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 10. 반환]

{#Scoped-GEC-setDisplayVal_S__table_fnw_5jd_fy}  
이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

    var tablename = 'my_FXcurrency_table';
    var setcur2 = new GlideRecord(tablename);
    setcur2.initialize();
    setcur2.currency_2_field.setDisplayValue('JPY;999,999.1234');
    setcur2.insert();