스크립트의 기본 통화 값

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

    • 스크립트에서 통화 필드를 사용할 수 있습니다.

    이러한 메서드는 GlideElement 객체에서 사용할 수 있습니다.

    통화 값을 표시하려면 getDisplayValue() 표시 API를 사용합니다. 표시 이외의 방식으로 통화 값을 사용하려면 형식이 지정되지 않은 숫자를 반환/수락하는 API를 사용합니다.

    주:
    값에 대한 계산을 수행하기 전에 getDisplayValue() 메서드를 사용하지 말고 문자열을 처리하여 서식 정보를 제거하십시오.
    getValue() 및 getCurrencyValue()와 같은 메서드는 형식이 지정되지 않은 숫자를 문자열로 반환합니다. 부동 소수점 값을 얻으려면 JavaScript 함수 parseFloat()를 사용한 다음 결과 값을 사용하여 계산을 수행합니다. 이러한 값과 연결된 통화를 가져오려면 통화 코드를 반환하는 API를 사용합니다. getCurrencyCode() 메서드를 사용하여 필드의 통화를 결정할 수도 있습니다. 
    var rate = parseFloat(current.base_rate);
var currencyCode = current.base_rate.getCurrencyCode();
    setValue() 메서드를 사용하여 통화 필드의 값을 설정합니다. 이 통화가 사용자의 세션 통화인 경우 일반 숫자 또는 이를 포함하는 문자열의 부동 소수점 숫자를 사용합니다. 그렇지 않으면 3자리 ISO 통화 코드를 값에 접두사로 붙입니다. 
    var totalCost = rate*current.hourly_rate;
current.total_cost.setValue(currencyCode + ";" + totalCost);

    통화 또는 가격 필드에서 GlideAggregate를 사용할 때 기준 통화 값으로 작업하는 것입니다. 표시하려면 집계 값을 사용자의 세션 통화로 변환해야 합니다. 결과 값이 예상과 다를 수 있습니다. 통화 또는 가격 필드 값과 집계에 사용되는 기준 통화에 사용되는 환산율이 변경되었을 수 있습니다.

    통화 값이 포함된 기록을 삭제하면 플랫폼은 연결된 모든 통화 기록을 삭제합니다.
    주:
    통화 필드가 있는 테이블에는 deleteMultiple() 을 사용하지 마십시오. 항상 각 기록을 개별적으로 삭제하십시오.
    통화 값에는 소수점 이하 네 자리가 포함됩니다.
    • getValue()와 같은 값을 반환하는 API는 소수점 이하 4자리까지 반환합니다. 후행 0은 항상 제거됩니다.
    • getDisplayValue()와 같은 표시 값을 반환하는 API는 소수점 이하 두 자리에서 최대 네 자리까지 있습니다.
    • GlideAggregate는 소수점 이하 네 자리를 반환합니다.
    시스템에서 소수점 두 자릿수를 사용하도록 할 수 있습니다. 소수점 이하 두 자리로 설정하면 API에서 반환되는 숫자 값에는 소수점 이하 두 자리가 포함됩니다. 통화 환산율은 소수 자릿수가 더 많을 수 있지만 통화 필드에는 소수점 이하 두 자리만 저장됩니다. 숫자 값을 허용하는 API는 소수 자릿수를 두 자리로 반올림합니다.
    • getValue()와 같은 값을 반환하는 API는 소수점 이하 두 자리까지 반환합니다. 데이터베이스에서 읽은 값에 대해 후행 0이 제거되지만 나중에 00과 같은 값을 설정하면 1.00을 반환할 수 있습니다. 반환되는 후행 0의 수가 일관되지 않습니다.
    • getDisplayValue()와 같은 표시 값을 반환하는 API는 소수점 이하 두 자리까지 포함합니다. 때로는 7.10과 같은 값에 대해서도 두 자리를 반환 할 수 있지만 다른 시간에는 후행 0을 제거 할 수 있습니다. 반환되는 후행 0의 수가 일관되지 않습니다.
    • GlideAggregate는 소수점 이하 두 자릿수를 반환합니다.
    주:
    시스템에서 사용하는 소수 자릿수를 변경하는 방법은 문서를 참조하십시오 기본 통화 소수 자릿수 변경.
    다음 예제에서는 사용자의 로캘이 독일어(de.DE)로 설정되고 기준 통화가 USD로 설정되어 있습니다. 이 값에는 일본 엔화 기준 21345.67, 유로화 기준 1563.72, 미국 달러 기준 1152.48의 통화 값이 사용됩니다.
    표 1. 통화 필드에 접근하는 방법
    메서드 이름 설명 예제
    getValue() 사용자의 세션 통화로 된 통화 값을 형식이 지정되지 않은 숫자로 반환합니다. 1563.72
    getReferenceValue() 기준 통화의 통화 값을 형식이 지정되지 않은 숫자로 반환합니다. 1152.48
    getSessionValue() 사용자의 세션 통화로 된 통화 값을 형식이 지정되지 않은 숫자로 반환합니다. 1563.72
    getCurrencyValue() 형식이 지정되지 않은 숫자로 입력한 통화 값을 반환합니다. 21345.67
    getDisplayValue() 통화 기호를 사용하여 사용자의 로캘 형식으로 통화 값을 반환합니다. €1.563,72
    getSessionDisplayValue() 통화 기호를 사용하여 사용자의 로캘 형식으로 통화 값을 반환합니다. €1.563,72
    getReferenceDisplayValue() 통화 기호가 있는 사용자의 로캘 형식으로 된 기준 통화의 통화 값을 반환합니다. 1,152.48달러
    getCurrencyDisplayValue() 통화 기호를 사용하여 사용자의 로캘에 형식이 지정된 입력한 통화 값을 반환합니다. ¥21.345,67
    getCurrencyString() 입력된 통화 값을 형식이 지정되지 않은 숫자로 반환하고, 프리픽스로 3글자 ISO 통화 코드를 붙이고 세미콜론으로 구분합니다. 21345.67 엔
    getCurrencyCode() 입력한 통화 값의 3자리 ISO 통화 코드를 반환합니다. JPY
    getSessionCurrencyCode() 사용자의 세션 통화에 대한 3자리 ISO 통화 코드를 반환합니다. EUR
    getReferenceCurrencyCode() 기준 통화의 3자리 ISO 통화 코드를 반환합니다. USD
    setValue() 통화 값을 다음과 같이 설정합니다.
    • 사용자의 세션 통화에서 값으로 사용되는 형식화되지 않은 숫자입니다.
    • 형식이 지정되지 않은 숫자로, 앞에 세미콜론으로 구분된 3자리 통화 코드가 붙습니다.
    		 4369.21 또는 JPY 4369.21
    setDisplayValue() 통화 값을 다음과 같이 설정합니다.
    • 사용자 세션 통화의 값으로 간주되는 사용자 로캘로 서식이 지정된 숫자입니다.
    • 사용자 로캘로 형식이 지정된 숫자로, 프리픽스로 세미콜론으로 구분된 3자리 통화 코드입니다.
    		 4369.21 또는 JPY 4369.21