toLabel()

クライアントアプリケーションは、toLabel() を使用してユーザの言語に翻訳されて返されるクエリの結果を使用できます。

toLabel() は、通常、複数選択、ディビジョン、または通貨コードの選択リスト項目 (関連する記述用のAPI コール (describe) によって返される選択リスト値を含むすべての項目)、データカテゴリグループとデータカテゴリの一意の名前の項目、または RecordType の名前で使用します。すべての組織が toLabel() を使用できます。これはトランスレーションワークベンチを有効にしている組織で特に役立ちます。

次に例を示します。

このクエリでは、リードレコードのレコードタイプ名がクエリを発行したユーザの言語に翻訳されて返されます。

toLabel() を使用して、翻訳された選択リスト値を使用するレコードを絞り込めます。次に例を示します。

Status の選択リスト値が「le Draft」のリードレコードが返されます。ユーザの言語での値が比較されます。指定された選択リストをユーザの言語に翻訳できない場合、マスタ値に対して比較が実行されます。