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

結果の翻訳

SOQL クエリの結果をユーザの言語に翻訳するには、toLabel(fields) を使用します。

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

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

オブジェクト履歴は制限付きでサポートされます。追跡項目が変更されると、変更された項目のマスタ表示ラベルまたは翻訳済みラベル (存在する場合) が SELECT toLabel(Field) FROM *History によって返されます。項目履歴オブジェクトの OldValue 項目と NewValue 項目も toLabel をサポートしていますが、サポートされる項目種別の変更追跡のみが翻訳された値を返します。

メモ

次に例を示します。

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

レコードタイプを翻訳された名前の値で絞り込むことはできません。レコードタイプは、常にオブジェクトのマスタ値または ID で絞り込みます。

メモ

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

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

toLabel() メソッドは ORDER BY では使用できません。Salesforce では、定義された順序が選択リストで常に使用されます (レポートと同様)。また、ディビジョンまたは通貨の ISO コード選択リストで、WHERE 句に toLabel() を使用することもできません。

メモ