How to configure access to local and shared network directories for the TIBCO Spotfire Web Player

How to configure access to local and shared network directories for the TIBCO Spotfire Web Player

book

Article ID: KB0071832

calendar_today

Updated On:

Products Versions
Spotfire Web Player 7.5 and higher

Description

This article describes additional settings that must be performed if the TIBCO Spotfire Web Player is going to be used to open analysis files that reference files on local and shared network directories, like \\myserver\myfolder\mydata.csv

Note: When adding files to your analysis which will be accessed via the TIBCO Spotfire Web Player, it is recommended to only use UNC based paths like "\\myserver\myfolder\mydata.csv", and not local or mapped drives like "D:\myfolder\mydata.csv" or WebDAV-based UNC paths.

Issue/Introduction

This article describes additional settings that must be performed if the TIBCO Spotfire Web Player service configuration is going to be used to open analysis files that reference files on local and shared network directories, like \\myserver\myfolder\mydata.csv

Environment

All

Resolution

To define the allowed file paths, manually edit the service configuration files per the following documented steps:

Doc: Manually editing the service configuration files In Step 3 of the above referenced process ("3. Edit the exported configuration files in a text editor or XML editor"), edit the ‘Spotfire.Dxp.Worker.Host.exe.config’ with either of the following 2 options (OPTION A or OPTION B):

OPTION A) Explicitly define allowed paths with the AllowedFilePaths setting.
Locate the AllowedFilePaths setting:
<setting name="AllowedFilePaths" serializeAs="Xml">
        <value>
          <ArrayOfString>
            <string/>
          </ArrayOfString>
        </value>
      </setting>
Specify the individual paths in the 'AllowedFilePaths' parameter inside <string>. For example:
<setting name="AllowedFilePaths" serializeAs="Xml">
        <value>
          <ArrayOfString>
            <string>\\NetworkPath1\FolderName1\</string>
            <string>\\NetworkPath2\FolderName2\</string>
          </ArrayOfString>
        </value>
      </setting>

OR

OPTION B) Add the AllowAllFilePaths to allow all paths by default
The exact change will depend on which version of Spotfire you are running:

Version 7.9 and higher:

Locate the AllowedFilePaths setting:
<setting name="AllowedFilePaths" serializeAs="Xml">
        <value>
          <ArrayOfString>
            <string/>
          </ArrayOfString>
        </value>
      </setting>
And add in the following setting directly after the above setting:
<setting name="AllowAllFilePaths" serializeAs="String">
       <value>True</value>
           </setting>
Resulting in:
<setting name="AllowedFilePaths" serializeAs="Xml">
        <value>
          <ArrayOfString>
            <string/>
          </ArrayOfString>
        </value>
      </setting>
  <setting name="AllowAllFilePaths" serializeAs="String">
       <value>True</value>
           </setting>

Save the file.

Version 7.5 to 7.8:

Locate the AllowedFilePaths setting:

<setting name="AllowedFilePaths" serializeAs="Xml">
        <value>
          <ArrayOfString>
            <string/>
          </ArrayOfString>
        </value>
      </setting>
Comment out that section by adding <!-- before and --> after, resulting in:
<!--<setting name="AllowedFilePaths" serializeAs="Xml">
        <value>
          <ArrayOfString>
            <string/>
          </ArrayOfString>
        </value>
      </setting>-->

Also, add in the following setting directly after the above commented out setting:
<setting name="AllowAllFilePaths" serializeAs="String">
       <value>True</value>
           </setting>
Resulting in:
<!--<setting name="AllowedFilePaths" serializeAs="Xml">
        <value>
          <ArrayOfString>
            <string/>
          </ArrayOfString>
        </value>
      </setting>-->
  <setting name="AllowAllFilePaths" serializeAs="String">
       <value>True</value>
           </setting>

Save the file.

Additional Information

Doc: Manually editing the service configuration files
Doc: Spotfire.Dxp.Worker.Host.exe.config > allowedfilepaths