Preview Settings

If SharePoint based preview is not enabled on your SharePoint farm, via Office Web Apps, the software will revert to using local (client side) preview.

To ensure performance is not impacted, we put controls in place to warn users of large files they are about to download or stop the download of the file completely and allow you to enable/disable preview just for specific file types.

The <localPreview> tag must be inserted within opening and closing <configuration> and <outlook> tags.

Property	Mandatory / Optional	Description
action	Mandatory	Set to "insert” to change the default behavior Set to "delete” to revert to default behavior
enableEdit	Optional	This setting determines if the preview settings are editable in the settings dialog by the user (default is true). Valid values : “true” or “false”
thresholdDownloadNoWarnings	Optional	This setting sets the ‘Warning Size (KB)’. The default is 200KB. The value is the kilobyte value as a whole number example: thresholdDownloadNoWarnings="200"
thresholdDownloadNever	Optional	This setting sets the ‘Maximum Size (KB)’. The default is 4000KB. The value is the kilobyte value as a whole number e.g. t hresholdDownloadNever="1000"
type	Optional	This setting sets the types of files that can be previewed using local preview. The default is ‘All’. Valid values are: “All”, “None”, “AllExcept” or “NoneExcept” example: type=”None”
extensions	Optional	Required if you have specified "AllExcept" or "NoneExcept" for the ‘type’ value above. Example: type=”AllExcept” extensions =”.docx” to allow local preview of all file types except .docx files.
maxCacheSizeInBytes	Optional	This setting allows you to set the maximum cache size in Bytes for the local preview e.g.
msgConversionType	Optional	This setting determines how .msg files are handled when previewed. Valid values are: AllowExternalContent: Full fidelity .msg preview, external images and resources included. PreventExternalContent: Simplified preview of .msg. External resources (images, script, css are ignored). Layout and presentation may be affected. Helps to maintain user privacy, (URL tracking in image resources) at the expense of preview quality. PromptUserToSelectType: Default Option. User is prompted between AllowExternalContent or PreventExternalContent on first time to preview a msg file

Example: PreventExternalContent, prevent user modifying setting

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <outlook>    
        <localPreview action="delete"/>
        <localPreview action="insert" msgConversionType="PreventExternalContent" enableEdit="false" />
    </outlook>
</configuration>

Disabling preview of SharePoint content

This setting is used to disable preview of SharePoint files and items within OnePlaceMail and OnePlaceDocs.
The <filePreview> tag must be inserted within opening and closing <configuration> 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
enabled	Mandatory	Valid values: true (default)

Example: Disable file preview

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

Example: Disable edit of preview settings

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

Example: Disable local preview for a file type

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <outlook>
        <localPreview action="delete"/>
        <localPreview type="AllExcept" extensions=".docx" action="insert"/>
    </outlook>
</configuration>

Example:Set the threshold sizes and preview cache size

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <outlook>
        <localPreview action="delete"/>
        <localPreview maxCacheSizeInBytes="104857600" thresholdDownloadNoWarnings="100" thresholdDownloadNever="1000" action="insert"/>
    </outlook>
</configuration>