1. Extensions
  2. PowerPoint Add-in Series 1
  3. Install and set-up the PowerPoint Add-in
  4. Set up the PowerPoint Add-in proxy support

In the PowerPoint Add-in, configure the settings file for the add-in to enable connections via a proxy server.

You should have an intermediate to advanced knowledge of XML to adjust the settings file. If you're not familiar with XML, ask your Tenant Administrator to configure your proxy settings.

When you install the PowerPoint Add-in, a settings file is created in the following location:

  • %localappdata%\Anaplan\PowerPointAddIn\1.7\Settings.xml

To make changes to the proxy settings, open this file in a text editor, for example Notepad.

For proxy setting changes to take effect, ensure the DefaultProxy setting is set to true:

The settings file. The line where the DefaultProxy should be changed is highlighted.

Add proxy settings to the settings file

When you install version 1.7 of the PowerPoint Add-in, there's no section in the settings file for proxy settings. Previous versions had a section for proxy settings by default.

To adjust the proxy settings in the settings file, use the text in the image below as a template. Insert the ProxySettings tags after the Features tags and before the close of ApplicationSettings tags.

Code to configure proxy support.

If you've added this text to the default settings file for the PowerPoint Add-in version 1.7, your file displays as below:

The settings file. The areas where the DefaultProxy and ProxySettings settings should be changed are highlighted.

Available proxy settings

Once you've added the text above to your settings file, you can replace the value between the SelectedProxy tags to select different proxy behaviors. The valid values for proxy settings are:

  • None: Use if you do not need to use a proxy. This is the default behavior if proxy settings have not been configured in the settings file.
  • Legacy: Use to enable Series 4 versions of the Excel Add-in to support your system's proxy server. This setting attempts to connect you to your system's default URL for proxy servers. To change this URL, see Microsoft WebProxy.GetDefaultProxy Method(opens external page). The Excel Add-in reads Microsoft Internet Explorer (IE) proxy settings.
  • System: Use this as an alternative to the Legacy setting, to enable Series 4 versions of the Excel Add-in to support your system's proxy server. This setting attempts to connect you to the non-default URL defined for proxy servers in your system. To change this URL, see Microsoft WebProxy.GetProxy(Uri) Method(opens external page). The Excel Add-in reads Microsoft Internet Explorer (IE) proxy settings.
  • Override: Use enable the Excel Add-in to support a proxy server of your choice. This setting bypasses your system's proxy server and uses details you provide in the settings file.
    To use this setting, you must provide additional values for the SelectedOverrideProxyName and OverrideProxies tags. An example can be seen in the prior section on this page. Within OverrideProxies you must define one or more proxies. To define a proxy, you must provide a:
  • ProxySetting Name: This must be logical but can be whatever you want it to be.
  • Address: This must be the HTTP address of the proxy server.
  • Port: This must be the port for the proxy server.

Disclaimer

We may update our documentation occasionally, but will only do so in a way that does not negatively affect the features and functionality of the Anaplan service.