GlideElementCurrency2 - 범위 지정됨

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기6분

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

    이 API는 다음을 수행할 수 있는 메서드를 제공합니다.
    • 사용자가 입력한 FX 통화 필드 표시 문자열을 가져옵니다.
    • FX 통화 필드의 표시 값을 가져옵니다.
    • FX 통화 필드의 기준 통화 값을 가져옵니다.
    • FX 통화 필드의 세션 통화 값을 가져옵니다.
    • FX 통화 필드의 표시 값을 설정합니다.

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

    GlideElementCurrency2 - getAsEnteredDisplayValue()

    사용자가 입력한 대로 연결된 GlideRecord에서 FX 통화 필드 표시 문자열을 반환합니다.

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

    표 1. 매개변수
    이름 유형 설명
    없음
    표 2. 반환
    유형 설명
    문자열 사용자가 입력한 통화 문자열을 표시합니다.

    이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

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

    연결된 GlideRecord 내에서 FX 통화 필드의 표시 값을 반환합니다.

    FX 통화 구성 [fx_configuration] 테이블에서 display_value가 설정된 방식에 따라 반환 값은 다음과 같을 수 있습니다.
    • 사용자가 입력한 통화 값
    • 세션 통화로 변환된 통화 값(사용자의 로캘 기준)
    • 기준 통화로 환산한 통화 값

    FX 통화 및 구성 테이블에 대한 자세한 내용은 FX 통화 전역 설정 구성을 참조하십시오.

    표 3. 매개변수
    이름 유형 설명
    없음
    표 4. 반환
    유형 설명
    문자열 통화 값 표시

    이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

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

    연결된 GlideRecord 내에서 FX 통화 필드의 기준 통화 값을 반환합니다.

    기준 통화는 필드의 모든 통화 값이 변환되는 공통 통화입니다. getReferenceDisplayValue() 메서드에서 기준 통화를 파생하는 데 사용하는 통화 코드는 다음을 기반으로 합니다.
    • 인스턴스 기록이 있는 경우 메서드는 FX 통화 [fx_currency2_instance] 테이블의 reference_currency 필드에 있는 값을 사용합니다.
    • 인스턴스 기록이 없는 경우 메서드는 인스턴스 기록이 최종적으로 작성될 때 인스턴스 기록에 설정될 기준 통화를 다음 순서에 따라 사용합니다.
      • 설정된 경우 FX 통화 구성 [fx_configuration] 테이블에 표시됩니다 reference_currency .
      • 설정된 경우 FX 통화 구성 [fx_configuration] 테이블에 표시됩니다 reference_currency_source .
      • 시스템 기본값, 시스템 참조 통화입니다.

    FX 통화 구성 [fx_configuration] 테이블의 값에 대한 자세한 내용은 FX 통화 필드 설정 및 작동을 참조하십시오.

    표 5. 매개변수
    이름 유형 설명
    없음
    표 6. 반환
    유형 설명
    문자열 연결된 FX 통화 표시 값의 참조 통화 금액입니다.

    이 예에서는 기준 통화 코드가 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()

    현재 GlideRecord 내에서 연결된 FX 통화 필드의 세션 통화 값을 반환합니다.

    표 7. 매개변수
    이름 유형 설명
    없음
    표 8. 반환
    유형 설명
    문자열 현재 사용자의 로캘을 기반으로 하는 세션 통화로 변환된 통화 값입니다.

    이 예제에서는 세션 로캘이 언어 코드 = 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(String displayValue)

    지정된 통화 값으로 FX 통화 필드의 표시 값을 설정합니다.

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

    표 9. 매개변수
    이름 유형 설명
    displayValue 문자열 FX 통화 필드에서 <통화 코드>; 형식으로 설정할 값 <통화 금액>. 사용자 로캘에서 <통화 금액> 필드의 형식을 지정해야 합니다.

    예를 들어 사용자의 로캘이 USA/eng인 경우 전달된 <통화 금액> 은 123.45가 됩니다. 사용자의 로컬이 FRA/fre인 경우 전달된 <통화 금액> 은 123,45입니다.
    표 10. 반환
    유형 설명
    void

    이 예제에서는 메서드를 호출하는 방법을 보여 줍니다.

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