SearchSettings | メタデータ API 開発者ガイド

組織の検索設定を表します。Metadata メタデータ型を拡張し、その fullName 項目を継承します。

パッケージマニフェストでは、「Settings」の名前を使用してすべての組織設定メタデータ型にアクセスします。詳細は「設定」を参照してください。

ファイルのサフィックスおよびディレクトリの場所

SearchSettings の値は、settings フォルダの Search.settings という 1 つのファイルに保存されます。.settings ファイルは、各設定コンポーネントに設定ファイルが 1 つしかないため、他の名前つきのコンポーネントとは異なります。

バージョン

SearchSettings は、API バージョン 37.0 以降で使用できます。

項目

項目名	データ型	説明
documentContentSearchEnabled	boolean	ドキュメントの全文検索が実行されるかどうかを示します。
optimizeSearchForCJKEnabled	boolean	日本語、中国語、および韓国語の検索が最適化されるかどうかを示します。この設定は、サイドバー検索に影響を及ぼします。また、サイドバー検索とグローバル検索でリードレコードに対して [重複の検索] 機能を使用して取引先検索を行う場合にも影響を及ぼします。ユーザが日本語、中国語、または韓国語で検索することが多い場合、および検索可能項目の入力文字のほとんどが日本語、中国語、または韓国語である場合には、このオプションを有効にします。
recentlyViewedUsersForBlankLookupEnabled	boolean	ユーザのオートコンプリートルックアップおよび空白のユーザルックアップから返されたレコードのリストが、ユーザの最近参照したユーザレコードから取得されるかどうかを示します。ルックアップで組織全体の最近アクセスしたユーザレコードのリストを表示する場合、この設定は false です。ユーザオブジェクトの空白のルックアップ検索にのみ適用されます。
searchSettingsByObject	SearchSettingsByObject	各オブジェクトの検索設定のリストを表します。
sidebarAutoCompleteEnabled	boolean	サイドバー検索でオートコンプリートが有効になっているかどうかを示します。オートコンプリートはユーザが検索語の入力を開始するときに実行され、最近参照したレコードの該当リストがサイドバー検索に表示されます。
sidebarDropDownListEnabled	boolean	サイドバーの [検索] セクションにドロップダウンリストが表示されるかどうかを示します。このリストから、タグ内を検索するか、特定のオブジェクト内を検索するか、すべてのオブジェクトから検索するかを選択できます。
sidebarLimitToItemsIOwnCheckboxEnabled	boolean	[私の所有データ] チェックボックスが表示されるかどうかを示します。このチェックボックスにより、ユーザがサイドバーに検索クエリを入力するときに、自身がレコード所有者であるレコードのみを対象にすることができます。
singleSearchResultShortcutEnabled	boolean	ショートカットが有効になっているかどうかを示します。ショートカットでは、検索結果が 1 つの項目だけを返した場合、検索結果ページをスキップし、レコードの詳細ページに移動します。この設定は、タグ、ケースコメント (高度な検索の場合)、およびグローバル検索には適用されません。
spellCorrectKnowledgeSearchEnabled	boolean	ナレッジ検索でスペルチェックが有効になっているかどうかを示します。

SearchSettingsByObject

各オブジェクトの検索設定のリストである ObjectSearchSetting データ型が含まれます。

項目名	データ型	説明
searchSettingsByObject	ObjectSearchSetting	各オブジェクトの検索設定のリストが含まれます。

ObjectSearchSetting

各オブジェクトの検索設定のリスト。

項目名	データ型	説明
enhancedLookupEnabled	boolean	オブジェクトで高度なルックアップが有効になっているかどうかを示します。
lookupAutoCompleteEnabled	boolean	ルックアップ検索でオートコンプリートが有効になっているかどうかを示します。オートコンプリートはユーザが自動推奨を選択して参照項目をインラインで編集するときに実行されます。
name	string	設定されるオブジェクトのエンティティ名。
resultsPerPageCount	int	ページあたりの検索結果数。

宣言的なメタデータの定義のサンプル

次に、Search.settings ファイルの例を示します。

1<?xml version="1.0" encoding="UTF-8"?>
2<SearchSettings xmlns="http://soap.sforce.com/2006/04/metadata">
3    <documentContentSearchEnabled>true</documentContentSearchEnabled>
4    <optimizeSearchForCJKEnabled>true</optimizeSearchForCJKEnabled>
5    <recentlyViewedUsersForBlankLookupEnabled>true</recentlyViewedUsersForBlankLookupEnabled>
6    <searchSettingsByObject>
7        <searchSettingsByObject>
8            <enhancedLookupEnabled>false</enhancedLookupEnabled>
9            <lookupAutoCompleteEnabled>false</lookupAutoCompleteEnabled>
10            <name>Account</name>
11            <resultsPerPageCount>25</resultsPerPageCount>
12        </searchSettingsByObject>
13        <searchSettingsByObject>
14            <enhancedLookupEnabled>false</enhancedLookupEnabled>
15            <lookupAutoCompleteEnabled>false</lookupAutoCompleteEnabled>
16            <name>Activity</name>
17            <resultsPerPageCount>25</resultsPerPageCount>
18        </searchSettingsByObject>
19        <searchSettingsByObject>
20            <enhancedLookupEnabled>false</enhancedLookupEnabled>
21            <lookupAutoCompleteEnabled>false</lookupAutoCompleteEnabled>
22            <name>Asset</name>
23            <resultsPerPageCount>25</resultsPerPageCount>
24        </searchSettingsByObject>
25    </searchSettingsByObject>
26    <sidebarAutoCompleteEnabled>true</sidebarAutoCompleteEnabled>
27    <sidebarDropDownListEnabled>true</sidebarDropDownListEnabled>
28    <sidebarLimitToItemsIOwnCheckboxEnabled>true</sidebarLimitToItemsIOwnCheckboxEnabled>
29    <singleSearchResultShortcutEnabled>true</singleSearchResultShortcutEnabled>
30    <spellCorrectKnowledgeSearchEnabled>true</spellCorrectKnowledgeSearchEnabled>
31</SearchSettings>

パッケージマニフェストの例

組織の取引先設定メタデータをリリースまたは取得するために使用される、パッケージマニフェストの例を次に示します。

1<?xml version="1.0" encoding="UTF-8"?>
2<Package xmlns="http://soap.sforce.com/2006/04/metadata">
3    <types>
4        <members>Search</members>
5        <name>Settings</name>
6    </types>
7    <version>37.0</version>
8</Package>