JavaScript Visualization Framework - JSViz and TIBCO Spotfire®
Last updated:
5:52pm Feb 06, 2018

Introduction

Within the TIBCO Spotfire® community, one area of discussion that crops up continually is that of new visualization types.  Customers often ask for a visualization type during a POC that Spotfire does not currently support.  Others ask for simple customizations of existing visualizations, such as moving labels around, that sound straightforward but are almost impossible to implement without extensive coding.

There are now a number of JavaScript libraries available for creating rich interactive graphics within a standard web browser.  One such is D3 which has a large library of example visualizations available on the D3 Website.  There are many others, including Highcharts and Google Charts.

Sample JSViz Visualizations

The JavaScript Visualization Framework, or JSViz, is a Custom Extension for TIBCO Spotfire that allows users to create their own visualizations using JavaScript libraries such as d3 but still allow them to seamlessly integrate with the Spotfire platform.  Note that although d3 was an initial driver for implementing the custom extension, it can actually work with any JavaScript based code.

Samples

Included with the framework are a number of sample charts including:

Download JSViz - Versions

JSViz can be downloaded from the TIBCO Exchange.  There are two packages to choose from depending on which version of Spotfire you are using:

  • For Spotfire 6.5 and 7.0 use V2.4
     
  • For Spotfire 7.5 or higher use V3.4

Both versions have the same capabilities.

For an overview of the different extension and customization options that the Spotfire platform provides, see Extending TIBCO Spotfire.


API

The documentation for the .NET API is now available online here.  This API can be used within Spotfire via IronPython or within a .NET Spotfire Custom Extension to configure JSViz visualizations.

The examples provided with JSViz also include a comprehensive scripting example showing how to use IronPython to create and configure JSViz charts.

 


    Automating Plot Setup

    It is possible to automate the creation of JSViz instances from the tool bar or the tools menu, by creating a custom extension that leverages the JSViz API:


    Licensing

    JSViz is shared with the TIBCO Community for free use by customers and partners under the  TIBCO Component Exchange License.  If you have suggestions for enhancements or run into issues, please post questions on TIBCO Community.
     


    Known Issues

    • Some users may encounter a problem when using JSViz with Spotfire 7.6.  This is resolved in the 3.4.0.3 release.  For detailed instructions see the following page: https://community.tibco.com/wiki/jsviz-problems-spotfire-76.  Spotfire 7.6 Hotfix 3 is also required.

    • JSViz visuals will work in Web Player and Automation Services as well as Spotfire Analyst (Professional).  Make sure to follow the installation instructions in the documentation.  Many people forget to update the Web Player after installing the plugin files.

    • There is an issue with the 3.4.0.8 build recently posted.  Please download and use a later version.

    • There is an issue with the resize logic in the doughnutchart.dxp sample which may cause the chart to occasionally appear empty when first opening the dxp file.  An updated version of the javascript file that resolves this issue can be downloaded from here.

    • JSViz is not supported on Spotfire Desktop (not to be confused with Spotfire Analyst).

     


    Simpler JS, Brunel

    Brunel is an open source Domain Specific Language designed specifically for interactive data visualisation. It allows coding complex Javascript D3 visualisations with as little as one line of code. Brunel can be integrated into Spotfire Javascript visualisations.

     


    Feedback (7)

    @olaf_schroeder

    Please make sure that you are using the lastest 3.x version for 7.5+ versions of spotfire. Also don't forget to update the deployement on your Spotfire web player instance.

    If you are not familiar with the Spotfire server-client topology after 7.5 please have a look at the server manua and/or perhaps here:
    https://community.tibco.com/wiki/introduction-spotfire-server-75

    Andreas Laestadius 12:16pm Dec. 20, 2017

    Has anyone had success enabling on Spotfire 7.8 or later once the Node Manager comes into play and Web Player is no longer a server but a service? We have a requirement that such reports render in both the web player and the analyst.

    olaf_schroeder 11:44am Dec. 20, 2017

    Please provide more specific information.  Which instructions did you follow and what "test file" are you referring to?

    Dave Leigh 6:01pm Nov. 15, 2017

    I have followed all the instructions but when I try to access the test file I keep seeing 404 file not found.  Any ideas as to why this might be occuring?

    luvigz 8:59am Nov. 15, 2017

    Hi jmgrosso,

    I have similar issue, after installation and followed steps, I was not able to start Spotfire desktop.

    I comment out the changes made in Spotfire.Dxp.exe.config and use the original content with its installation, I was able to start Spotfire desktop and JS was also available.

    Hui Cheng 12:50pm Sep. 14, 2017

    For jmgrosso and others having problems with installing JSViz under Spotfire Desktop, please make sure that when you downloaded the zip file, you "unblocked" it.  .NET is cautious about allowing dll's downloaded from the internet from running.

    So in the folder where you copied the dll's, right-click and select Properties.  Check the "unblock" option and click apply.  Repeat this for all dll's in the 3 JSViz folders.

    Dave Leigh 10:51am Dec. 06, 2016