---
sourceDocument: Xanadu Now Platform の管理
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/platform-administration

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu Now Platform の管理

ft:clusterId :

    - platadm

bundleId :

    - platadm

workflow :

    - Platform


---

# リストおよびレポートの FX 通貨値について

# リストおよびレポートの FX 通貨値について {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：4分

デフォルトでは、リストおよびレポートの FX 通貨フィールドに表示される通貨の値は、FX 通貨フィールドに直接入力する値です。レポートの場合、デフォルトでは、FX 通貨フィールドの集計は参照通貨値です。

## リストビューの FX 通貨値 {#fx-currency-values-lists-reports__section_evs_ng5_tjb}

リストでは、FX 通貨の値は getDisplayValue() から返された書式設定済み通貨文字列として表示されます。

* の \[表示桁\] フィールドと \[表示値通貨 \] フィールドの設定 システムローカリゼーションFX 通貨構成 通貨値がリストにどのように表示されるかを決定します。
* 詳細については、「[FX 通貨フィールドとその表示パラメーターを特定する](https://servicenow-prod.fluidtopics.net/2qibiuyPt2sCfL7IiFhdQg "FX 通貨構成を適用するテーブルとテーブル内のフィールド (cost など) を指定します。次に、フィールドの小数点以下桁数と通貨表示パラメーターを選択します。")」を参照してください。
{#fx-currency-values-lists-reports__ul_x5c_jxv_pkb}  
別の FX 通貨フィールドに依存する FX 通貨フィールドの場合、通貨値は依存先に関連付けられた通貨インスタンス \[fx_currency2_instance\] レコードから取得されます。表示値の形式は、表示設定の構成方法に基づきます。 システムローカリゼーションFX 通貨構成。  
注:  
カスタムテーブルの \[FX 通貨\] フィールドは、実際のレコードへの参照 (sys_id) を格納する参照フィールドです。sys_id は 32 文字であるため、\[FX 通貨\] 列の \[最大長\] は 32 (デフォルト) でなければなりません。

## リストのフィルタリングの FX 通貨値 {#fx-currency-values-lists-reports__section_t3v_gcx_zjb}

リスト内では、FX 通貨フィールドのフィルタリングは、標準の通貨フィールドとは異なる方法で動作します。フィルタリングは、通貨値が最初に FX 通貨フィールドに入力されたときに選択された通貨タイプを使用して行われます。リストをフィルタリングする際、参照通貨は考慮されません。したがって、フィルタリングされていないリストに複数の通貨の FX 通貨フィールドエントリが含まれている場合、フィルタリングされたリストには、指定されたフィルタリング通貨を使用して最初に入力されたレコードのみが含まれます。

* たとえば、通貨値をユーロ (EUR) で入力し、参照通貨が米ドル (USD) である場合、参照通貨値がフィルタリングされていないリストに表示されることがあります。
* ただし、リストをフィルタリングして通貨として USD を選択した場合、最初にユーロで入力された通貨値は表示されません。この場合、最初に USD で入力された通貨値のみが表示されます。
{#fx-currency-values-lists-reports__ul_d33_gvt_1kb}

## 依存 FX 通貨フィールド {#fx-currency-values-lists-reports__section_zf4_ntt_1kb}

FX 通貨ビューまたは依存フィールドを使用すると、以下で定義された代替表示構成を使用できます。 システムローカリゼーションFX 通貨構成 特定の FX 通貨フィールドのFX 通貨フィールドの構成の詳細については、「[FX 通貨フィールドの動作を構成する](https://servicenow-prod.fluidtopics.net/0wDUFbjrbkK6hmAM0NNEbw "グローバル通貨のデフォルトを設定した後、特定のテーブルフィールドのカスタム FX 通貨構成を作成できます。FX 通貨を使用するテーブルフィールドを特定し、通貨換算計算の実行、表示、フィルタリング、および集計方法を定義します。")」を参照してください。

FX 通貨フィールドを作成するときは、別の FX 通貨フィールドに依存するフィールドとしてマークすることができます。FX 通貨フィールドを依存としてマークすると、元の FX 通貨フィールドの構成設定を使用して、金額を異なる通貨で表示することができます。依存フィールドに加えた変更は、元の FX 通貨フィールドには影響しません。

## FX 通貨のレポート、アグリゲーション、およびグループ化 {#fx-currency-values-lists-reports__section_x1q_pg5_tjb}

レポートに含める FX 通貨フィールドを選択すると、リストビューと同じ方法で表示されます。

* FX 通貨フィールドは、getDisplayValue() から返された書式設定済み通貨文字列として表示されます。
* \[ 表示値通貨 \] フィールドを システムローカリゼーションすべてのプロパティ セッション通貨で表示するには、レポートを実行しているユーザーに割り当てられたセッション通貨が表示されます。
{#fx-currency-values-lists-reports__ul_c2h_cdq_5jb}

通貨インスタンスレコード内の同様の参照通貨値を集計できます。Now Platform® の集計された FX 通貨データ形式は次のとおりです。  
{#fx-currency-values-lists-reports__table_wnw_24t_1mb__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | アグリゲーションの値。集計される値が FX 通貨値である場合、戻り値は次のように `currency_code:currency_value` の形式になります。 `USD:134.980000` それ以外の場合、戻り値は、`134.980000` などの通貨値のみです。 注: フィールドに混合通貨タイプの FX 通貨値が含まれている場合、値を集計することはできません。値はセミコロン (;) として返されます。 |
[表 : 1. FX 通貨の集計値]

{#fx-currency-values-lists-reports__table_wnw_24t_1mb}  
たとえば、トランザクションレコードの \[コスト\] フィールドが FX 通貨フィールドである場合は、cost.amount または cost.currency でグループ化できます。

* SUM などの集計操作は、 `SUM(amount)` または `SUM(reference_amount)` として変換されます。グループ化の通貨値に関連付けられている通貨が同じである場合、集計ソースによって変換が決定されます。

  たとえば、`GlideAggregate.getAggregate()` によって返される集計値は、USD; 1234.56 という形式の文字列です。合計通貨値は、グループ化のすべての通貨値に関連付けられている単一の参照通貨で表されます。
* グループ化の通貨値に関連付けられた異なる通貨がある場合、集計値は空になります。たとえば、通貨値の一部が米ドル、一部がユーロ、その他が円である場合、集計値は空になります。
{#fx-currency-values-lists-reports__ul_kfh_xcq_5jb}  
FX 通貨フィールドでグループコマンドを使用することもできます。

* これは、集計ソースで指定されているように、通貨と金額、または reference_currency と reference_amount でグループ化するのと同じです。
* グループ化の値を使用するには、FX 通貨フィールドをドット連結するか、`getDisplayValue()` などの API を使用します。
{#fx-currency-values-lists-reports__ul_l2y_yrm_1kb}
**関連概念**   

* [FX 通貨フィールドの動作を構成する](https://servicenow-prod.fluidtopics.net/0wDUFbjrbkK6hmAM0NNEbw "グローバル通貨のデフォルトを設定した後、特定のテーブルフィールドのカスタム FX 通貨構成を作成できます。FX 通貨を使用するテーブルフィールドを特定し、通貨換算計算の実行、表示、フィルタリング、および集計方法を定義します。")  
**関連タスク**   

* [FX 通貨のグローバル設定の構成](https://servicenow-prod.fluidtopics.net/kdBbuNOrOQcRYmAOPaGWew "FX 通貨を設定して使用する前に、関連するシステムプロパティを確認し、デフォルトの動作を確認または変更してください。")