ServiceNow インスタンスで異なる通貨を使用する方法 - Support and Troubleshooting

ServiceNow インスタンスで異なる通貨を使用する方法 Issue  システムが各値に対して少なくとも 2 つの通貨を操作する場合、通貨フィールドのフィルタリング、ソート、および表示の結果に混乱することがあります。システムには、ユーザーのロケール設定によって決定されるセッション通貨と、各通貨値のシステムロケールによって決定される参照通貨があります。インスタンスで複数の通貨が許可されている場合、ユーザーが追加の通貨値を処理している可能性があります。

集計とフィルタリングでは参照通貨が使用され、ユーザーにはセッション通貨が表示されることに注意してください。換算レートが変化するので、フィルタリングされた参照通貨の値は、セッション通貨の値が示す順序とは異なる場合があります。集計でも同様の問題が発生します。

症状 参照通貨値はフィルタリングに使用されますが、セッション通貨の値は表示されるため、通貨フィールドでフィルタリングされたリストが期待どおりの順序にならない場合があります。

参照通貨の値が集計されてからセッション通貨に変換されるため、通貨フィールドの集計では期待される結果が得られない場合があります。

通貨値は通貨コードではなくユーザーのロケールに基づいて書式設定されるため、通貨値が想定どおりに書式設定されない場合があります。

Cause この混乱は、セッション通貨と参照通貨の違い、換算レートの変化、およびレポートなどで異なるユーザが使用するセッション通貨の違いによって発生します。

Resolution 通貨処理について 通貨フィールドには、値、通貨コード、および参照通貨値が保持されます。通貨コードは 3 文字の ISO 通貨コードで、値の指定に使用される通貨を識別します。参照通貨値は、参照通貨の通貨値を表す数値です。参照通貨値は、通貨値が保存されるときにレート換算によって計算されます。

価格フィールドは、換算と表示のための特別な機能を備えた通貨フィールドの一種です。たとえば、サービスカタログは価格フィールドを使用します。

通貨フィールドは、次のアイテムを表すために使用されます。

何かの価格 (電話の価格など) トランザクション (契約に費やされた金額など) 算術演算を実行できる値。たとえば、サービスの時給に時間数を掛けた値

ロケール ロケールには、システムロケールとユーザーロケールの 2 つの設定があります。

システムロケール システムロケールは、 glide.system.locale プロパティを使用して設定されます。値の形式は Language.Country で、言語は ISO 639 言語コード、国は ISO 3166 言語コードです。内部的には、この値は Java で指定されたとおりに使用されます。システムロケール設定は、 Java サポート対象ロケール リストに含まれている必要があります。

通貨フィールドの参照通貨値は、システムロケールが示す通貨であると想定されるため、新しい zboot でシステムロケールを一度設定する必要があります。

警告 :通貨値をインスタンスに入力した後は、システムロケールを変更しないでください。システムロケールを変更すると、参照通貨値は調整されません。つまり、レート換算は行われません。この永続性により、集計とフィルタリングが無効になります。

ユーザーロケール ユーザーのロケールは、考慮順に以下で決定されます

glide.system.locale.test を使用してローカルセットをテストする (SN テクニカルサポート用) 国と言語の両方が指定されたユーザーレコード プロパティ glide.system.locale を使用して設定されたシステムロケール ブラウザーのロケール 通貨と単一通貨モード システムは、セッションと参照の 2 種類の通貨を使用します

セッション 通貨は、ユーザーのロケールまたは単一通貨モードによってユーザーに対して定義されます。 参照 通貨は、システムロケールによって決定されます。参照通貨は、インスタンス全体で使用される標準です。通貨または価格フィールドに値が入力されるたびに、次の 3 つの情報が保存されます。

ユーザーのロケールで入力された値 ユーザーのロケールの通貨コード 現在の為替レートを使用して参照通貨に換算された値 注 : 複数通貨モードでは、通貨フィールドに保存されている通貨コードがセッション通貨コードと同じでない場合があります。たとえば、セッション通貨がユーロで、入力される数値が日本円である場合があります。

セッション通貨 ユーザーが通貨値を表示するときには、入力した形式またはセッション通貨形式で値を表示できます。形式には次のものが含まれます。

通貨記号 セッション通貨に変換され、ローカライズされた数値形式で表示される値。 ユーザーのロケールによってセッション通貨形式が決まります。

数値形式は、ロケールに基づいて小数点などの機能が異なる場合があります。たとえば、米国の書式は 1,234,567.89 で、ドイツの書式は 1.234.567,89 です。

セッション通貨は、検討順に以下により決定されます

glide.i18n.single_currency と glide.i18n.single_currency.code を使用して設定した単一通貨モード ユーザーのロケールのデフォルト通貨 基準通貨 異種通貨の値に対して計算を実行するために、プラットフォームは 参照 通貨と呼ばれるシステム通貨に変換された通貨値を保存します。システムのすべての通貨フィールドには、参照通貨値が含まれています。

基準通貨は、検討順に以下により決定します。

プロパティ glide.system.locale を使用して設定されたシステムロケール Java のデフォルトロケール、通常は en.US 参照通貨は通常米ドルです。

フィルタリングおよび集計機能では、参照通貨値を使用して計算を実行します。これにより、換算レートが変化するため、不正確な結果が生じる可能性があります。

単一通貨モード 単一通貨モードの目的は、プラットフォームのすべてのユーザーが同じ通貨で通貨値を表示できるようにすることです。このモードを正しく設定するには、次のプロパティを設定する必要があります。

i18n.single_currency :true または false i18n.single_currency.code – 3 文字の ISO 通貨コード システムロケール glide.system.locale 単一通貨モードには次の制限があります。

単一通貨モードでは、参照通貨 は変更されません。 そのため、計算 (集計/フィルタリング) が実行されると、一部のレート換算で予期しない結果が生じる可能性があります。 単一通貨モードでは、ユーザービューの通貨が変更され、数値の書式設定は変更されません 。 そのため、さまざまな国のユーザーが 1 つの通貨で通貨値を表示しても、数値の書式設定 (ユーザーのロケールによって決定される) が期待どおりに機能しない可能性があります。 通貨値の入力は単一通貨になるように制限されているため、価格フィールドの機能は使用できません。 レート換算の影響は、システムロケールと参照通貨を単一通貨に設定することで回避できます。ただし、通貨形式はユーザーのロケールによって決まります。単一通貨とユーザーロケールが異なる場合、通貨の表示がユーザーの期待とは異なる場合があります。

価格フィールド 価格フィールドは、換算や表示の制御を有効にする通貨フィールドです。サービスカタログは価格フィールドを使用します。

換算と表示の選択は、価格フィールドごとに選択でき、いつでも変更できます。次の 3 つのバリエーションがあります。

計算済み [デフォルト]:通貨フィールドタイプと同じように動作します。換算が実行されるたびに、最新の通貨換算レートが使用されます。価格フィールドが表示されると、ユーザーのセッション通貨で表示されます。 固定 :価格フィールドが表示される場合、値の入力時に使用された通貨コードで表示されます。換算が実行されるたびに、最新の通貨換算レートが使用されます。 複数: 価格ごとに異なる通貨を使用して、アイテムの複数の価格値を入力できます。フィールドの値は、ユーザーのセッション通貨で入力された値です。それ以外の場合は、最初に入力された価格がユーザーのセッション通貨に換算されます。換算が実行されるたびに、最新の通貨レートが使用されます。 注意: 最初に入力した値が表示時に使用されます。追加の値は計算時に使用されません。

価格フィールドの使用例については、サービスカタログで使用されているテーブルを参照してください。

プレゼンテーション 通貨値は、リストビューとフォームビューで異なる方法で表示されます。

リストビュー 通貨値は、ユーザーのロケールで表示できるように書式設定されたユーザーのセッション通貨で表示されます。通常は、通貨記号の後に書式設定された数値が続きますが、ロケールによって異なる場合があります。通貨記号はfx_currencyテーブルに格納されます。

さまざまなフィールドタイプが次のように表示されます。

通貨フィールドタイプ:ユーザーのセッション通貨での値 価格フィールドタイプ/計算済み:ユーザーのセッション通貨での値 価格フィールドタイプ/固定:ユーザーが入力した通貨での値 価格フィールドタイプ/複数:ユーザーのセッション通貨に関連付けられた値 (この値が存在する場合)。それ以外の場合は、最初に入力された値がユーザーのセッション通貨に換算されます 切り替え値の表示 通貨値 (Geneva 以降) の横に地球アイコンが表示され、値を次のいずれかに変更できます。

ユーザーが入力した値 セッション通貨での値 入力した値と、括弧で囲まれた参照通貨での値。 アイコンは、ユーザーのセッション通貨がユーザーが入力した通貨と異なる場合に表示されます。アイコンをクリックすると、一覧が順番に表示されます。

Preview (プレビュー) レコードのプレビューでは、通貨値はユーザーのロケールで表示できるように入力された形式で表示されます。

アグリゲーション 通貨列には、基本的な集計演算を適用できます。これらには、合計、グループ化、平均、最小、および最大が含まれます。集計は次の 2 つのステップで行われます。

すべてのレコードの参照通貨値を集計します このアグリゲートを表示用にユーザーのセッション通貨に変換します 注意 : 通貨フィールドの値 (表示されているもの) と参照通貨の値 (集計に使用) の間の換算レートが変更されている可能性があるため、結果がユーザーの期待と異なる場合があります。

注 :この制限は、さまざまな価格タイプに適用されます。

価格タイプが [固定] の場合、計算された参照値が古い可能性があります。 価格タイプが [複数] の場合、使用される参照値は最初に入力された価格です。他の通貨の値は使用されません。 集計値は、通貨記号を使用してユーザーのロケールで書式設定されて表示されます。

(イスタンブール)イスタンブール以降、通貨フィールドは 4 桁の小数部で格納され、集計は 4 桁の小数部で格納されます。アップグレードの場合、この値はプロパティによって制御されます。

フィルタリング 通貨フィールドにフィルターを設定できます。通貨値は通貨コードと数値として入力されます。フィルタリングは、次の 2 つのステップで実行されます。

フィルターの通貨値が参照通貨に換算されます。 フィルターの計算された参照値は、レコード内の参照値と比較されます。 一致するレコードがリストビューに表示されます。

注意 :フィルターの実行時に使用された換算レートは、個々のレコードで参照値を計算するときに使用された換算レートと異なる場合があるため、フィルタリング結果では期待した結果が得られない場合があります。

注: この制限は、さまざまな価格タイプに適用されます。

価格タイプが [固定] の場合、計算された参照値が古い可能性があります。 価格タイプが [複数] の場合、使用される参照値は最初に入力された価格です。他の通貨の値は使用されません。 フォームビュー フォームビューでは、通貨値は入力された通貨で表示されます。コンボボックスには、システムで利用可能な通貨のリストが表示されます。形式はユーザーのロケールによって決まります。

数値を入力または変更するときは、ユーザーのロケールで指定された形式で値を書式設定してください。

新しいレコードのフォームで、通貨のリストを含むコンボボックスで参照通貨が選択され、数値がゼロに設定されます。

価格フィールドの編集 価格フィールドの通貨コードと数値は、フォームで変更できます。価格フィールドの横に編集アイコンが表示されます。編集アイコンをクリックすると、価格フィールドのすべての詳細を編集するために使用できるフォームが表示されます。

通貨:システムで有効になっている通貨のリストのコンボボックス 金額:ユーザーのロケールで書式設定された数値 タイプ:計算済み、固定、複数を含むコンボボックス 価格タイプが [複数] に変更されると、プラットフォームで有効になっているすべての通貨の子レコードが作成され、最新の通貨換算レートを使用して金額フィールドから変換された値が入力されます。 価格タイプはいつでも変更できます。 読み取り専用レコード レコードが読み取り専用の場合、通貨値は入力されたとおりに表示され、ユーザーのロケールで表示されるように書式設定されます。価格フィールドには、セッション通貨値が表示されます。

単一通貨モード 単一通貨モードでは、通貨はラベルであり、変更することはできません。編集アイコンが表示されていないため、前述のフィールドの詳細を編集するためのフォームにアクセスできません。

通貨インスタンステーブルの編集 Helsinki 以降、通貨インスタンステーブルfx_currency_instanceを編集できるユーザーのフィールドの横に編集アイコンが表示されます。これにより、financial_mgmt_user ロールを持つユーザーは、通貨フィールドに関連付けられた値を編集できます。

注 :fx_currency_instanceテーブルは編集しないでください。このテーブルはプラットフォームによって管理されるため、変更によって意図しない結果が生じる可能性があります。

レポート レポートの通貨値は、ユーザーのセッション通貨で、ユーザーのロケールと通貨記号で書式設定されます。ユーザーは、レポートの実行方法によって異なります。

共有レポート:レポートを実行するユーザー スケジュール済みレポート:通常、レポートをスケジュールしたユーザーとして実行されます レポートには 次の 2 つのユーザーに固有の値があります。

ユーザーセッション通貨 換算値 注意: レポートを実行するユーザーとは異なるセッション通貨を使用しているユーザーは、予期しない結果を受け取る可能性があります。

通貨変換 通貨値は、保存およびアクセス時に他の通貨に換算できます。

通貨値は、挿入時か更新時かにかかわらず、保存時に参照通貨に変換されます。

これは、参照通貨値と通貨値が保存されることを意味します。

通貨値は、表示のためにユーザーのセッション通貨に変換されます。

フィルターで指定された通貨からフィルターに入力された値は、参照通貨に変換されます。

レートテーブル 換算レートはテーブルfx_rateに保存されます。各レコードには、特定の通貨からユーロへの換算レートが含まれています。レートは、ECB Web サイトの ECB 為替レートのロードと呼ばれるスケジュール済みジョブから毎日更新されます。

レート使用率 ある通貨から別の通貨への通貨換算には、2 つのレートが含まれます

ある通貨からユーロに換算するレート ユーロから第二通貨に換算するレート 変換が実行されるたびに、プラットフォームは最新の変換レートを使用します。したがって、計算によって予期しない結果が生じる可能性があります。例：

参照通貨値を格納する際に、異なる通貨値に異なるレートが適用される可能性があります。したがって、集計では、異なるレートで値を結合し、別のレートで換算して戻すことができます。 フィルター値は現在のレートで換算されますが、データベース内でフィルターされる値は異なるレートで換算される可能性があります。今日のレートで $100 のフィルターは、昨日のレートで取得した $99 の値と一致する可能性があります。 注 :表示のため、使用される通貨値は、ユーザーが入力したものをセッション通貨に換算したものです。ただし、集計とフィルタリングでは、参照通貨値が使用されます。これにより、異なるレートで換算された通貨値を比較することができます。

インポート/エクスポート 一般に、プラットフォームの境界を越える通貨値は、ユーザーのセッション通貨で表され、ユーザーのロケールで書式設定されます。

インポート/変換 通貨値は、他のフィールドと同様に文字列としてインポートされます。通貨フィールドへのデフォルトの変換マッピングでは、 setDisplayValue () を使用します。この関数に想定される形式は次のとおりです。

ユーザーのロケールで書式設定された数値:ユーザーのセッション通貨での値として取得されます (例: 1,234.56)。 この数値の前に 3 文字の通貨コードが付き、セミコロンで区切られます (例:EUR;1.234,56)。 この動作は、変換マップスクリプトでカスタマイズできます。

エクスポート 通貨値は、XML としてエクスポートする場合を除き、ユーザーのセッション通貨でエクスポートされます。XML で通貨をエクスポートする場合、値は書式設定のない参照通貨値になります。

Related Links 通貨値を使用するスクリプティング スクリプティング環境では、通貨フィールドに GlideElement としてアクセスできます。

API 次の表に、メソッドとその仕組みを示します。値の例では、通貨値 21345.67 (ユーロで 1563.72、米ドルで 1152.48) を使用し、ユーザーのロケールをドイツ (de.DE) に設定し、参照通貨を USD に設定しています。

メソッド名

説明

例

getValue()

(record.field としてアクセス)

ユーザーのセッション通貨で通貨値を書式設定されていない数値として返します。

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 日本円;4369.21

setDisplayValue()

通貨値を次のように設定

ユーザーのセッション通貨で値として取得される、ユーザーのロケールで書式設定された数値。 2.ユーザーのロケールで書式設定され、3 文字の通貨コードがプリフィックスとしてセミコロンで区切られた数値。 4.369,21 日本円;4.369,21

有効割合の桁数 API によって返される数値には、2 桁の小数部が含まれています。通貨換算レートの小数部の桁数が多くなる場合がありますが、通貨フィールドには小数部が 2 桁しか格納されません。数値を受け入れる API は、小数点以下の桁を 2 桁に丸めます。

getValue () などの値を返す API は、小数点以下 2 桁までを返します。

データベースから読み取られた値の末尾の 0 は削除されますが、00 などの値が後で設定されると、1.00 を返す可能性があります。戻り値に一貫性がありません。

getDisplayValue () などの表示値を返す API には、小数点以下 2 桁までが含まれます。

これにより、7.10 などの値でも 2 桁が返されることがありますが、それ以外の場合はトレーニング ゼロが削除される可能性があります。戻り値に一貫性がありません。

GlideAggregate は小数点以下 2 桁を返す

(イスタンブール)イスタンブール以降、通貨値には 4 桁の小数部を含めることができます。

getValue () などの値を返す API は、小数点以下 4 桁までを返します。末尾のゼロは常に削除されます。 getDisplayValue () などの表示値を返す API には、小数点以下 2 桁以上、小数点以下 4 桁までがあります。 GlideAggregate は小数点以下 4 桁を返します。 通貨値の使用 通貨値を表示するには、表示 API を使用します。表示以外の方法で通貨値を操作するには、書式設定されていない数値を返す/受け入れる API を使用します。

注意: getDisplayValue () メソッドを使用せずに、値の計算を実行する前に文字列を処理して書式設定情報を削除してください。

値の取得 getValue () や getCurrencyValue () などの API は、書式設定されていない数値を文字列として返します。浮動小数点値は、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;

currency.total_cost= currencyCode + ";" + totalCost;

値の削除 通貨値を含むレコードが削除されると、プラットフォームは関連する通貨レコードを削除します。ただし、これは deleteMultiple () が呼び出されたときにすべての条件で発生するわけではありません。

注意 :通貨フィールドのあるテーブルには deleteMultiple () を使用しないでください。常に各レコードを反復処理し、各レコードを個別に削除します。

監査 通貨フィールドを含むテーブルが監査されると、通貨値が監査されます。監査レコードに入力された値は、セッション通貨での数値です。通貨コード/記号が存在しません。レコードを表示しているユーザーのロケールがレコードを更新したユーザーと異なる場合、番号の意味や通貨コードに関する指示がないと混乱が生じる可能性があります。

Istanbul 以降、監査レコードに入力された値は、USD;1234.56 の形式でユーザーが入力した通貨値に変更できます。これは、Glide プロパティ glide.sys.audit_currency_value によって制御されます。デフォルト値は false です。 true に設定すると、監査で新しい形式が使用されます。

テーブル fx_currency このテーブルには、プラットフォームで設定された通貨が含まれています。各レコードには、3 文字の ISO 通貨コード、通貨の記号、通貨がアクティブかどうかが保持されます。この情報には、 システムローカリゼーション メニューからアクセスできます。

通貨のリストを含むコンボボックス (通貨フィールドを含むレコードのフォームビューなど) には、このテーブルでアクティブとマークされている通貨のリストが含まれます。

注意 :fx_currency内の既存のレコードは削除しないでください。既存のレコードを削除すると、関連するすべての通貨/価格レコードが無効になります。

fx_currency_instance このテーブルには、通貨フィールドタイプの通貨値が保持されます。各レコードは、fx_currencyテーブルへの参照としての通貨、数値、参照値、および参照通貨を保持します。

注: 通貨データは非正規化されます。親レコードの通貨列には参照通貨値が含まれています。fx_currency_instanceレコードには、参照通貨値の数値部分を含む親レコードのsys_idが保持されます。

fx_price このテーブルには、価格フィールドタイプの通貨値が保持されます。各レコードは、fx_currencyテーブルへの参照としての通貨、数値、参照値、および参照通貨を保持します。 価格タイプに基づいて、追加のレコードが存在する場合があります。

固定、計算:単一レコード 複数:親フィールドが空のプライマリ通貨値があり、親フィールドがプライマリ通貨値を持つレコードのsys_idに設定されている他の通貨の通貨値を含む追加のレコードがある場合。 注 :通貨データは非正規化されます。親レコードの通貨列には参照通貨値が含まれています。fx_priceレコードには、通貨値を含む親レコードのsys_idが保持されます。

fx_rate このテーブルには、通貨換算レートが保存されます。各レコードは、fx_currencyテーブルへの参照としての通貨と、その通貨をユーロに変換するための換算レートを保持します。各レコードには、最新のレートを取得するために使用される作成時間と更新時間のシステムフィールドも保持されます。 ある通貨から別の通貨に換算すると、2 つのレートレコードが検索される場合があります。

ECB のダウンロード 欧州中央銀行 (ECB) の Web サイトからレートを毎日ダウンロードし、fx_rateテーブルにレコードを追加するスケジュール済み ECB 為替レートロードジョブ。

削除 親レコードから通貨値が削除されると、fx_currency_instance/fx_priceのレコードが削除されます。ただし、これは deleteMultiple () が使用されている場合に常に発生するとは限りません。これは、通貨 API の既知の制限です。

deleteMultiple () が許可されている場合、通貨レコードが孤立する可能性があります。これは機能には影響しません。ただし、テーブルは大きくなる可能性があります。

deleteMultiple () は、次のような特定の条件下では使用できません。

ビジネスルールを削除 (前または後) 親テーブルが監査されます 親テーブルに反復削除属性セットがあります 親テーブルに更新同期が設定されています 注意 :通貨フィールドを含むレコードでは deleteMultiple () を使用しないでください。