Jump to content
  • Customizing the Sample Files Shown on the Start Page in Spotfire Analyst


    This article describes how to customize the samples files displayed on the start page in Spotfire Analyst. By default, TIBCO Spotfire provides users with a number of sample files to introduce them to the application and to provide some example files for inspiration and/or guidance.

    This article describes how to customize the samples files displayed on the start page in Spotfire Analyst. By default, Spotfire provides users with a number of sample files to introduce them to the application and to provide some example files for inspiration and/or guidance. The image below displays the sample files included in Spotfire Analyst 7.6.

    default_sample_files_in_spotfire.png.2ac888aeb039f428ce2ca5d8cedf0149.png

    These sample files can be replaced with other sample files that may be more relevant to a specific market or user context. To replace the files requires access to the Spotfire SDK and the Spotfire Developer software.  

    These are the steps involved in customizing the sample files:

    1. Decide what new sample dxp files to use.
    2. Download the Spotfire SDK and run Package Builder.
    3. Create a new configuration in Package Builder and add a Spotfire distribution.
    4. Add a new project using the example folder ?SpotfireDeveloper.CustomSampleFilesExample? in the Examples\Extensions folder in the SDK.

      You might want to copy this folder to a new location.
    5. Add your new dxp files to the folder (and remove the ExampleN.dxp files).
    6. Edit the SampleFileConfiguration.xml file and decide where the sample files should be displayed.

      The path to the sample file is relative to the folder containing the module.xml file.  
    7. Validate and test the configuration using Package Builder.

      The image below shows a screenshot from Package Builder with the SpotfireDeveloper. CustomSampleFilesExample added as a new project.



      package_builder_with_custom_sample_files.png.432ef12674806a3344e2eae6529ef0ba.png
    8. Build a package and deploy it to the Spotfire Server for further distribution to the users (requires Administrator rights to the Spotfire Server).

    If you take the CustomSampleFilesExample and run it without any modifications the following is displayed on the start page:

    example_files_on_start_page.png.6b7c79394187d03bf3069d64bb342b4e.png

    Note that it is possible to have a maximum of six different sample files and they will be displayed in a 3x2 table like the image above.

    The preview image for the dxp file can be set manually when the dxp is opened in  Spotfire Analyst using the Document Properties dialog and then selecting the Library tab. The preview image is by default automatically a preview of the active page when the dxp file is saved.

    The possibility to customize the sample files was introduced in Spotfire Analyst version 7.0.

    Note:  If the sample dxp files contain IronPython or JavaScript scripts, the files must also be saved into the Spotfire Library in order for the dxp files not to prompt the user whether to trust those scripts.

    For more information about Spotfire Developer and how to use the SDK and the Package Builder tool, please visit the Spotfire Developer documentation.


    User Feedback

    Recommended Comments

    There are no comments to display.


×
×
  • Create New...