Device Configuration XML For Outlook Add-in

Outlook Add-in configuration settings can be configured remotely by specifying the configuration XML using policies.

For most clients, if the user changes the configuration locally, then the remote settings configured by the Administrator will override those settings the next time the client refreshes its settings.


To set a device configuration for a policy:

  1. Open a browser and log in the Admin Portal.
  2. From the left navigation pane, select Settings.
  3. To open the list of policies, select the Policies tab.
  4. Click the policy that you want to configure, and then click the edit icon ().
  5. Click on the Device Configuration tab.
  6. In Client Configuration, paste or type in the following remote device configuration XML. 

    <xml>
    	<outlookaddin>
                <settings>
            	<!-- XML for outlookaddin App -->
                </settings>
    	</outlookaddin>       
    </xml>
  7. Replace the <!-- XML for outlookaddin App --> line with the parameters that you need using the descriptions in Table 1. 


To set default values for auto upload:

In the Outlook addin Client Configuration, you can set the default values for Auto Upload Attachments and Auto Upload Attachments Greater than Size (MB) in the Upload Settings.
Follow the instructions above for setting the device configuration, and enter values: for <autoupload> and <autouploadsize>, for example:

<xml>
	<outlookaddin>
            <settings>
        		<autoupload>1</autoupload>
				<autouploadsize>3</autouploadsize>
            </settings>
	</outlookaddin>       
</xml>

When the Outlook Add-in is opened, and Settings > Upload is accessed the Auto Upload Attachments and Auto Upload Attachments Greater than Size (MB) settings appear as:


Table 1. The following XML tags are supported for Microsoft Outlook Addin device configuration.

The following XML tags are supported for the Outlook Add-in

XML Tag

Value

Example

autouploadSets default for auto upload to on or off. 0 => auto upload is off; 1=> auto upload is on.<autoupload>1</autoupload>
autouploadsizeSpecifies the default minimum size in MB of an attachment that is automatically uploaded.<autouploadsize>3</autouploadsize>
serverurlFileCloud server URL<serverurl>http://www.yourdomain.com</serverurl>
sharetype

Share Type 0 => Public Share, 1=> Password Protected Share

<sharetype>0</sharetype>
sharetextShare Text in HTML. Ensure to use CDATA to accomodate special characters in xml<sharetext><![CDATA[Attachment: #filename#<br/>Download link: <a href='#url_link#'>#filename#</a><br/>#password#]]></sharetext>
proxyserverProxy Server URL<proxyserver>http://proxyserverurl.com</proxyserver>
proxyusernameProxy Server Username<proxyusername>proxyserverusername</proxyusername>
proxypasswordProxy Server Password<proxypassword>proxyserverpassword</proxypassword>
proxyportProxy Server Port<proxyport>9000</proxyport>
ssllevelRequire strict SSL verification of VERIFY_STRICT or VERIFY_NONE<ssllevel>VERIFY_STRICT</ssllevel>
sslverifyConnect only TLS 1.2 server. Empty string or TLSV1_2_CLIENT_USE<sslverify><sslverify>


(lightbulb) Tips and Tricks

The easiest way to get the configuration XML for sync apps is by configuring an Outlook Add-in as needed and then exporting the configuration.