Search locations

The Search button on the toolbar which can be configured to point to your SharePoint Search Site(s) or Search Page(s):

The URLs of the search locations can be configured through the configuration update process.

The <searchLocation> tag must be inserted within opening and closing <SharePoint> and <searchLocations> tags.

The table below describes the properties that can be modified.

Property	Mandatory / Optional	Description
action	Mandatory	Set to "insert" to add the search location
title	Mandatory	The user friendly name to display in the search dropdown menu when multiple search locations are configured
url	Mandatory	The url of your search site or search page e.g. http://portal/search/default.aspx

The search drop down menu:

Example: Add a single search location (any locations already setup by the user will be preserved)

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <sharepoint>
    <searchLocations>
    <searchLocation title="Portal" url="http://portal/search/default.aspx" action="insert"/>
    </searchLocations>
    </sharepoint>
</configuration>

Example: Remove any previously configured search locations and replace with 2 new search locations

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <sharepoint>
        <configElementDeletions>
        <configElementDeletion elementPath="sharepoint/searchLocations"/>
        </configElementDeletions>
     <searchLocations>
        <searchLocation title="Portal" url="http://portal/search/default.aspx" action="insert"/>
        <searchLocation title="Records" url="http://portal/search/records.aspx" action="insert"/>
 </searchLocations>
      </sharepoint>
</configuration>

These settings can be restricted from being modified by users, through the configuration update process

The <search> tag must be inserted within opening and closing <sharepoint> tags.

The table below describes the properties that can be modified.

Property

Mandatory / Optional

Description

action

Mandatory

Set to "insert" to change the default behavior

Set to "delete" to revert to default behavior

Enabled

Optional

Set to restrict/allow users to change this setting through the OnePlaceMail Settings > SharePoint tab.

Valid values: “true or “false” (default is true)

Example: Prevent user from modifying search locations through OnePlaceMail settings

<?xml version="1.0" encoding="UTF-8"?> 
<configuration>
    <sharepoint>
    <search action ="delete"/>
    <search action="insert" enabled="false"/>
    </sharepoint>
</configuration>

Example: Revert to allow a user to modify search locations through OnePlaceMail settings

 <?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <sharepoint>
    <search action="delete"/> 
    </sharepoint>
</configuration>