メタデータ API 開発者ガイド
jSearchSettings
Metadata メタデータ型を拡張し、その fullName 項目を継承します。
パッケージマニフェストでは、「Settings」の名前を使用してすべての組織設定メタデータ型にアクセスします。詳細は「設定」を参照してください。
ファイルのサフィックスおよびディレクトリの場所
SearchSettings の値は、settings フォルダの Search.settings という 1 つのファイルに保存されます。.settings ファイルは、各設定コンポーネントに設定ファイルが 1 つしかないため、他の名前つきのコンポーネントとは異なります。
バージョン
SearchSettings は、API バージョン 37.0 以降で使用できます。
項目
| 項目名 | 項目の型 | 説明 |
|---|---|---|
| documentContentSearchEnabled | boolean | ドキュメントの全文検索が実行されるかどうかを示します。 |
| enableSetupSearch | boolean | [設定] サイドバーの検索ボックスが拡張されており、Enter キーを押したときに、一致するカスタム項目、カスタムオブジェクト、およびその他のサポートされている設定項目が返されるか (true)、否か (false) を示します。デフォルトは、Developer Edition、Performance Edition、Professional Edition、Enterprise Edition、Unlimited Edition の場合は true、それ以外の Edition の場合は false です。API バージョン 47.0 以降で利用できます。 |
| 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>マニフェストファイル内のワイルドカードのサポート
package.xml マニフェストファイル内のワイルドカード文字 * (アスタリスク) は、機能設定のメタデータ型には適用されません。ワイルドカードは、個々の設定ではなくすべての設定を取得するときにのみ適用されます。詳細は、「設定」を参照してください。マニフェストファイルの使用についての詳細は、「zip ファイルを使用したメタデータのリリースと取得」を参照してください。