---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideElementCurrency2 - スコープ指定

# GlideElementCurrency2 - スコープ指定 {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](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=xanadu&pubname=xanadu-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=xanadu&pubname=xanadu-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=xanadu&pubname=xanadu-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、国コードが 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) {#ariaid-title6}

\[FX 通貨\] フィールドの表示値を指定された通貨値で設定します。
FX 通貨フィールドの詳細については、「 [FX 通貨フィールドの設定と操作](https://www.servicenow.com/docs/access?context=fx-currency&version=xanadu&pubname=xanadu-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();