Using the Help System

This page describes the features of the Help and the documentation system for Spotfire Streaming and Spotfire LiveView.

Introduction

Spotfire® Streaming Help and documentation is provided in two formats:

  • Eclipse Help, also known as Infocenter format.

  • A website of HTML pages with a navigation bar.

For each Spotfire Streaming release, the content of the Help system is identical in all formats and locations. The two formats are distributed across four locations, local and online:

  • You can access the Eclipse Help format (which uses frames and provides a built-in Search function) as follows:

    • Locally, on systems with Spotfire Streaming installed, as the StreamBase Studio Help system. In StreamBase Studio, open Help>Help Contents. This opens a separate Eclipse Help window on Windows and Linux; on macOS, StreamBase Studio help opens in your system's default browser.

    • Online, at docs.streambase.com.

  • The website format (which does not use frames) is available online and locally:

    • Online at https://docs.tibco.com, where you can view and search the documentation for all active releases, and download it to your system. For details, see Website Format and Features.

    • Locally, on systems with Spotfire Streaming installed:

      • On Windows, invoked from the Start menu, as Spotfire>StreamBase 11.1 User Guide - HTML.

      • On Linux, invoked from the command line with

        /path/to/browser /opt/tibco/str/11.1/doc/index.html &
      • On macOS, invoked from a Terminal prompt with

        open ~/Applications/Spotfire\ Streaming\ 11.1.0/doc/index.html

        On macOS, your Spotfire Streaming installation might be in an alternate location, such as /Applications.

      The website format opens in your default browser, and does not include a built-in search feature, but does provide a general index and a site map.

Eclipse Help Features

Tips on using Eclipse Help versions of Spotfire Streaming:

  • The Help Contents in StreamBase Studio shows as a question mark in a circle:

  • In the Eclipse Help Search field, use quotes around an exact phrase to narrow your search results.

  • To search only within the current page, first sync the current page to the Contents panel using the Show in Table of Contents button (), then use the Search Topics button ( in the Contents pane's toolbar).

  • In StreamBase Studio's Authoring perspective you can review the schemas for streams, look up function definitions, and more in the Assistance Pane in the Properties View.

The features illustrated next are available in all Eclipse Help versions of Spotfire Streaming Help.

Eclipse Help Search

The following figure illustrates the search features of the Eclipse Help versions of Spotfire Streaming Help.

Properties View Help in StreamBase Studio

The Properties view in StreamBase Studio provides a built-in Assistance Pane on the right, with Streams, Functions, and Expression QuickRef tabs. Information in these tabs helps you write StreamBase expressions when setting the properties for the object currently selected on the Studio canvas.

The Properties view is keyed to the Help system. Click the Help button in the upper right of the view to open the StreamBase Studio Help page appropriate to the current context.

For example, when viewing the description of a function in the Assistance Pane (in the Details sub-tab of the Functions tab), click Show in Help to open that function's help page in Studio Help.

See the Properties View help page for further information on the developer assistance features of the Properties view, especially the Assistance Pane section of that page.

Limiting the Scope of Searches

To constrain search results, place quotes around search terms to return exact matches for phrases. For example, a search for "merge operator" in the 11.1.0 documentation yields results on 15 pages. Omitting the quotation marks returns results from 44 pages.

The Help system includes Eclipse documentation topics in addition to documentation specific to Spotfire Streaming. For this reason, some search results might be found in the Help for other Eclipse plug-ins. To restrict Help searches to results from the Spotfire Streaming documentation set, configure a search scope using the following steps:

Note

The following examples show Spotfire Streaming and apply to both Spotfire Streaming and Spotfire Data Streams.

  1. Click the Scope link next to the Search Go button.

  2. In the Select Scope dialog, click New.

  3. In the New Scope dialog list of topics, select Spotfire Streaming and enter a List name to identify this scope.

  4. Click OK.

  5. Thereafter, select the desired scope name in the list after clicking the Scope link:

  6. This results in a less cluttered list of Help books to search, and narrows any keyword searches to the selected scope:

You can set up as many search scopes as you need, giving each a unique name, down to the level of individual books in the documentation set. For example, You can create a search scope limited to LiveView reference pages by opening Spotfire Streaming, selecting LiveView References, and giving the scope a name such as LV-REF, as shown below.

Website Format and Features

The documentation that you install with StreamBase Studio is available at https://docs.tibco.com. You can browse and search Spotfire Streaming or any TIBCO product documentation there and download it for any currently available version of a product. The following image shows the TIBCO® Streaming documentation landing page and its features.

Spotfire Streaming documentation at https://docs.tibco.com uses the website format, which provides a navigation bar instead of frames with a table of contents, as illustrated below. You can read and download documentation in this format for all current releases, and specify product versions to search within. The default version is the one for the latest published release of Spotfire Streaming.

Note that downloaded documentation sets are in website format and thus do not provide a built-in search feature. Use the navigation bar, Site Map, and Topic Index to locate the information of interest (TIBCO® Streaming example shown).

Back to Top^