リストおよびレポートの FX 通貨値について
デフォルトでは、リストおよびレポートの FX 通貨フィールドに表示される通貨の値は、FX 通貨フィールドに直接入力する値です。レポートの場合、デフォルトでは、FX 通貨フィールドの集計は参照通貨値です。
リストビューの FX 通貨値
リストでは、FX 通貨の値は getDisplayValue() から返された書式設定済み通貨文字列として表示されます。
- の [表示桁] フィールドと [表示値通貨 ] フィールドの設定 通貨値をリストに表示する方法を決定します。
- 詳細については、「FX 通貨フィールドとその表示パラメーターを特定する」を参照してください。
別の FX 通貨フィールドに依存する FX 通貨フィールドの場合、通貨値は依存先に関連付けられた通貨インスタンス [fx_currency2_instance] レコードから取得されます。表示値の形式は、での表示設定の構成方法に基づいています
注:
カスタムテーブルの [FX 通貨] フィールドは、実際のレコードへの参照 (sys_id) を格納する参照フィールドです。sys_id は 32 文字であるため、[FX 通貨] 列の [最大長] は 32 (デフォルト) でなければなりません。
リストのフィルタリングの FX 通貨値
リスト内では、FX 通貨フィールドのフィルタリングは、標準の通貨フィールドとは異なる方法で動作します。フィルタリングは、通貨値が最初に FX 通貨フィールドに入力されたときに選択された通貨タイプを使用して行われます。リストをフィルタリングする際、参照通貨は考慮されません。したがって、フィルタリングされていないリストに複数の通貨の FX 通貨フィールドエントリが含まれている場合、フィルタリングされたリストには、指定されたフィルタリング通貨を使用して最初に入力されたレコードのみが含まれます。
- たとえば、通貨値をユーロ (EUR) で入力し、参照通貨が米ドル (USD) である場合、参照通貨値がフィルタリングされていないリストに表示されることがあります。
- ただし、リストをフィルタリングして通貨として USD を選択した場合、最初にユーロで入力された通貨値は表示されません。この場合、最初に USD で入力された通貨値のみが表示されます。
依存 FX 通貨フィールド
FX 通貨ビューまたは依存フィールドを使用すると、次で定義された代替の表示構成を使用できます 特定の FX 通貨フィールド用。FX 通貨フィールドの構成の詳細については、「FX 通貨フィールドの動作を構成する」を参照してください。
FX 通貨フィールドを作成するときは、別の FX 通貨フィールドに依存するフィールドとしてマークすることができます。FX 通貨フィールドを依存としてマークすると、元の FX 通貨フィールドの構成設定を使用して、金額を異なる通貨で表示することができます。依存フィールドに加えた変更は、元の FX 通貨フィールドには影響しません。
FX 通貨のレポート、アグリゲーション、およびグループ化
レポートに含める FX 通貨フィールドを選択すると、リストビューと同じ方法で表示されます。
- FX 通貨フィールドは、getDisplayValue() から返された書式設定済み通貨文字列として表示されます。
- で [表示値通貨 ] フィールドを設定した場合 セッション通貨で表示するには、レポートを実行しているユーザーに割り当てられたセッション通貨が表示されます。
通貨インスタンスレコード内の同様の参照通貨値を集計できます。ServiceNow AI Platform® の集計された FX 通貨データ形式は次のとおりです。
| タイプ | 説明 |
|---|---|
| 文字列 | アグリゲーションの値。集計される値が FX 通貨値である場合、戻り値は次のように currency_code:currency_value の形式になります。
それ以外の場合、戻り値は、 134.980000 などの通貨値のみです。注: フィールドに混合通貨タイプの FX 通貨値が含まれている場合、値を集計することはできません。値はセミコロン (;) として返されます。 |
たとえば、トランザクションレコードの [コスト] フィールドが FX 通貨フィールドである場合は、cost.amount または cost.currency でグループ化できます。
- SUM などの集計操作は、
SUM(amount)またはSUM(reference_amount)として変換されます。グループ化の通貨値に関連付けられている通貨が同じである場合、集計ソースによって変換が決定されます。たとえば、
GlideAggregate.getAggregate()によって返される集計値は、USD; 1234.56 という形式の文字列です。合計通貨値は、グループ化のすべての通貨値に関連付けられている単一の参照通貨で表されます。 - グループ化の通貨値に関連付けられた異なる通貨がある場合、集計値は空になります。たとえば、通貨値の一部が米ドル、一部がユーロ、その他が円である場合、集計値は空になります。
FX 通貨フィールドでグループコマンドを使用することもできます。
- これは、集計ソースで指定されているように、通貨と金額、または reference_currency と reference_amount でグループ化するのと同じです。
- グループ化の値を使用するには、FX 通貨フィールドをドット連結するか、
getDisplayValue()などの API を使用します。