Location Search - Navigation Tree

The Navigation tree in OnePlaceDocs and 'Save to SharePoint', dialog boxes, support search based on locations.

The search service setting determines how farm wide searches are performed, this uses the <searchLocation>tag which must be inserted within opening and closing <configuration> and <navigationTree> tags.

Typically you would use this setting if you have connections to multiple SharePoint farms and need to specify which farm the search should be performed against.

Property	Mandatory /Optional	Description
action	Mandatory	Set to “insert” to change the default behavior Set to “delete” to revert to default behavior
mode	Mandatory	Valid values: “auto" – uses search services associated with first site collection added to OnePlaceMail and OnePlaceDocs. This is the default setting. "custom" – uses the search service associated with the site collection specified in the “url” property "off" – disables farm wide search. A scoped search (below a selected node on the navigation tree is still enabled).
url	Mandatory if mode = custom	This setting is only used when mode=”custom”. This specifies a site collection url e.g. http://myserver. OnePlace Solutions will use the search service associated with the site collection to perform the farm wide search.

Example: Specify which site wide searches should use the search service

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <navigationTree>
        <searchLocation ="delete"/>
        <searchLocation action="insert" mode="custom" url="http://vs-server38"/>
    </navigationTree>
</configuration>

Example: Set the search querymode to "kql" (Keyword Query Language"

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <navigationTree>
        <searchMode action="delete"/>
        <searcMode action="insert" mode="kql"/>
    </navigationTree>
</configuration>

Navigation Tree Filter Settings

The OnePlace Solutions navigation tree allows filtering of nodes to quickly locate an item by using type ahead.

This can be set to ‘starts with’ matching algorithm, to a ‘contains' algorithm.
This can be set using the <filterMode> tag which must be inserted within opening and closing <configuration> and <navigationTree> tags

Property

Mandatory / Optional

Description

action

Mandatory

Set to "insert" to change the default behavior
Set to "delete" to revert to default behavior

mode

Mandatory

Valid values:
"contains" – This filters the tree to match items that contain with the characters typed. This is the default setting.

"startswith" – This filters the tree to match items that starts with the characters typed.

Example: Set the filter mode to "contains"

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <navigationTree>
        <filterMode action="delete"/>
        <filterMode action="insert" mode="contains"/>
    </navigationTree>
</configuration>

Example: Set the filter mode to "starts with"

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <navigationTree>
        <filterMode action="delete"/>
        <filterMode action="insert" mode="startswith"/>
    </navigationTree>
</configuration>

Setting the maximum number of results for Navigation Tree location searches

Modify the maximum number of search results that are returned when performing a location search from the Navigation Tree.
The <search> tag must be inserted within opening and closing <configuration> and <navigationTree> tags. Below details the tag properties:

Property	Mandatory / Optional	Description
action	Mandatory	Set to "insert" to change the default behavior Set to "delete" to revert to default behavior
maxSearchResults	Mandatory	Maximum number of search results e.g. 5

Example: Set the maximum number of search results to 5

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <navigationTree>
        <search action="delete"/>
        <search action="insert" maxSearchResults="5"/>
    </navigationTree>
</configuration>