クライアントアプリケーションは、toLabel() を使用してユーザの言語に翻訳されて返されるクエリの結果を使用できます。
次に例を示します。
このクエリでは、リードレコードのレコードタイプ名がクエリを発行したユーザの言語に翻訳されて返されます。
レコードタイプを翻訳された名前の値で絞り込むことはできません。レコードタイプは、常にオブジェクトのマスタ値または ID で絞り込みます。
toLabel() を使用して、翻訳された選択リスト値を使用するレコードを絞り込めます。次に例を示します。
Status の選択リスト値が「le Draft」のリードレコードが返されます。ユーザの言語での値が比較されます。指定された選択リストをユーザの言語に翻訳できない場合、マスタ値に対して比較が実行されます。
toLabel() メソッドは ORDER BY 句では使用できません。Salesforce では、定義された順序が選択リストで常に使用されます (レポートと同様)。