GlideElementCurrency2 - 범위 지정됨

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기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 필드에 있는 값을 사용합니다.
    • 인스턴스 레코드가 없는 경우 메서드는 인스턴스 레코드가 최종적으로 생성될 때 인스턴스 레코드에 설정되는 기준 통화를 사용합니다(다음 순서대로).
      • 설정된 경우 reference_currency FX 통화 구성 [fx_configuration] 테이블에 있습니다.
      • 설정된 경우 reference_currency_source FX 통화 구성 [fx_configuration] 테이블에 있습니다.
      • 시스템 기본값, 시스템 기준 통화입니다.

    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. 반환
    유형 설명
    문자열 세션 통화로 환산된 통화 값으로, 현재 사용자의 로캘을 기준으로 합니다.

    이 예제에서는 세션 로캘이 language code = eng 및 country code = USA라고 가정하고 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)

    지정된 통화 값으로 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();