スクリプトのデフォルト通貨値

  • リリースバージョン: 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() は使用しないでください。常に各レコードを個別に削除してください。
    通貨値には小数点以下 4 桁が含まれています。
    • getValue() などの値を返す API は、小数点以下 4 桁までを返します。末尾のゼロは常に削除されます。
    • getDisplayValue() などの表示値を返す API には、小数点以下が最小で 2 桁、最大で 4 桁あります。
    • GlideAggregate は小数点以下 4 桁を返します。
    システムで小数点以下 2 桁を使用することができます。小数点以下 2 桁に設定すると、API によって返される数値には小数点以下 2 桁が含まれます。通貨換算レートにはより多くの小数点以下の桁数がある場合がありますが、通貨フィールドには小数点以下 2 桁しか格納されません。数値を受け入れる API は、小数点以下を 2 桁に丸めます。
    • getValue() などの値を返す API は、小数点以下 2 桁までを返します。データベースから読み取られた値の末尾の 0 は削除されますが、00 などの値が後で設定された場合は、1.00 を返すことができます。返される末尾の 0 の数には一貫性がありません。
    • getDisplayValue() などの表示値を返す API には、小数点以下 2 桁までが含まれます。7.10 などの値でも 2 桁を返すことがありますが、それ以外の場合は末尾の 0 が削除される可能性があります。返される末尾の 0 の数には一貫性がありません。
    • GlideAggregate は小数点以下 2 桁を返します。
    注:
    システムで使用される小数点以下の桁数を変更する方法については、「デフォルトの通貨の小数点以下桁数を変更する」を参照してください。
    次の例では、ユーザーのロケールがドイツ (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 通貨コードのプリフィックスが付けられ、セミコロンで区切られます。 JPY 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