この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

convertCurrency()

通貨項目をユーザの通貨に変換するには、SOSL クエリに convertCurrency() を使用します。このアクションを使用するには、組織でマルチ通貨が有効化されている必要があります。

この構文を RETURNING 句で使用します。

convertCurrency(Amount)

次に例を示します。

1FIND {test} RETURNING Opportunity(Name, convertCurrency(Amount))

組織で高度な通貨管理を有効にしている場合は、商談、商談品目名、商談履歴の通貨項目を変換するときに期間指定換算レートが使用されます。高度な通貨管理では、convertCurrency は特定の項目 ([CloseDate on opportunities] など) に対応する換算レートを使用します。高度な通貨管理が有効になっていない場合は、入力された最新の換算日が使用されます。

convertCurrency() 関数は WHERE 句では使用できません。使用すると、エラーが返されます。組織の有効な通貨からユーザの通貨に数値を換算するには、次の構文を使用します。

1WHERE Object_name Operator ISO_CODEvalue

以下に例を示します。

1FIND {test} IN ALL FIELDS RETURNING Opportunity(Name WHERE Amount>USD5000)

この例では、レコードの通貨の Amount 値が USD 5000 相当より大きい場合、商談レコードが返されます。たとえば、金額が USD5001 の商談は返されますが JPY7000 の商談は返されません。

組織で有効になっている、アクティブな ISO コードを使用してください。ISO コードを入力しないと、比較金額の代わりに数値が使用されます。前の例を使用すると、JPY5001、EUR5001、USD5001 の商談レコードが返されます。WHERE 句で IN を使用する場合は、ISO コード値と ISO 以外のコード値を混在させて使用できません。

順序は、レポートの場合と同様に、必ず換算後の通貨の値に基づきます。したがって、convertCurrency() と ORDER BY 句は一緒に使用できません。

メモ

currentCurrency() 関数では別名指定がサポートされます。さらに、クエリに同じ項目が複数回含まれるときは、別名指定が必要です。以下に例を示します。

1FIND {Acme} RETURNING Account(AnnualRevenue, convertCurrency(AnnualRevenue) AliasCurrency)

Force.com SOQL および SOSL リファレンス

convertCurrency()