LiveView Project Tutorial

Open StreamBase Studio.

In Studio's SB Authoring perspective, select File → New → StreamBase Project. The New StreamBase Project dialog opens.

In the New StreamBase Project dialog, enter a name for the project. This example uses my-first-liveview-project.

Clear the check box for Create empty EventFlow Application file.

Keep the default selections for the check boxes Use default location, Maintain project settings, and the Java Build Path Options settings (with those check boxes selected).

Click Finish. A folder for the my-first-liveview-project appears in the Package Explorer view.

Right-click the project folder and select New → TIBCO LiveView Configuration File.

Select my-first-liveview-project for the parent folder.

Enter Orders for the LiveView Configuration file name.

Select the Data Table radio button.

Click Finish. The new configuration file opens in the LiveView Configuration File Editor in Studio.

The Editor view's title bar shows errors because the table has not yet been configured.

Select the Use a Private Schema radio button.

In the field grid section, click the green plus sign to add the following fields to the grid:

The Description column for each field is optional.

Select the Indices tab at the bottom of the LiveView Configuration Editor view. Make the Symbol field the primary key for this table in either of two ways:

Use File → Save, Ctrl+S on Windows and Linux, or Command+S on Mac to save the Orders.lvconf file.

If the Configuration Editor reports errors, correct the affected fields and re-save the file.

Create a sub-folder for the EventFlow application that will populate the incoming data stream.

Add the new subfolder to this project's module search path. This is necessary to support a later step in the process.

Generate a data-source application with the correct schemas to match the Orders table. You can do this with the EventFlow application wizard, which will create a template EventFlow module as well as a StreamBase interface file with all the right schemas.

The EventFlow application wizard creates an interface file to store the schemas for the Orders table, and an interface file for the generated Order.sbapp module that imports the schemas interface. Both generated interface files are placed in the lv-interfaces folder, and that folder is added to the project's module search path. LiveView uses the schema interface to create a data stream with the correct schema for the Orders table.

On the canvas for Orders.sbapp, double-click the DataOut icon in the editor, select the General tab in Properties view, and make sure the check box for Always expose Stream for Dequeue is selected.

Select the Schema tab in the Properties view.

Notice that this output stream's schema name is OrdersDataInSchema. This is the required schema that matches the schema of the DataIn stream for sending data into the Orders table.

Now, you can create the data to populate the data stream. This example uses a StreamBase Input Feed Simulation Adapter with a custom feed simulation. To add the feed simulation adapter to your application, follow these steps:

The adapter appears red and the module does not yet pass typechecking. This is because the Feed Simulation adapter needs a feed simulation, defined next.

Use File → Save, Ctrl+S on Windows and Linux, or Command+S on OS X to save the Orders.sbapp file, despite it not yet passing typechecking.

Select File → New → Feed Simulation. This opens the New StreamBase Feed Simulation wizard.

Select my-first-liveview-project as the parent folder, specify the file name Orders, and click Finish. This creates a file named Orders.sbfs and opens it in the editor.

Enter a description in the Simulation Description field. This example uses Simple data feed.

In the Simulation Streams section, click Copy from Stream/Named Schema.

Select the schema OrdersDataInSchema from the interface file in my-first-liveview-project/lv-interfaces/OrdersSchemas.sbint.

Next, select the Custom generation method and click the Customize Field button to open the Customize Fields dialog. We will use this dialog to specify the range of values for the feed simulation to generate for each field. For each field, select from the Generation Method drop-down list as shown in the following table.

When done, click OK.

Use File → Save, Ctrl+S on Windows and Linux, or Command+S on Mac to save the Orders.sbfs feed simulation file.

Re-open OrdersDataSource/Orders.sbapp in the EventFlow Editor view.

Double-click the InputAdapter icon to open its Properties view.

In the Adapter Properties tab, use the Choose button to select Orders.sbfs for the Feed Simulation File field.

Use File → Save, Ctrl+S on Windows and Linux, or Command+S on Mac to save the Orders.sbapp EventFlow module file, which now passes typechecking.

Create a LiveView configuration for a data source table, OrdersDataSource, which will call the EventFlow data source configured above. This step creates an lvconf that accesses the subfolder where the applications are stored, so that successive project tables can reference this lvconf rather than having to reference individual EventFlow applications.

Add the reference from OrdersDataSource to Orders. The Orders table will use the OrdersDataSource table as an intermediary for communicating with the EventFlow data source application.

Run the application. Right-click in the editor canvas or on the orders.sbapp file in the Package Explorer view and select Run As → StreamBase Application.

Observe the Application Output tab. Look for the outgoing data stream to be automatically populated by the associated feed simulation.

Click on a row in the application output tab and examine the tuple contents. Each tuple shows a generated value for Symbol, Price, and Quantity fields, in addition to the required fields.

When done, press F9 or click the red Stop StreamBase Application button in Studio's top-level toolbar.

Select my-first-liveview-project in the Package Explorer view.

Right-click and select Run As → LiveView Project. The Console view shows several messages as the LiveView Server compiles the project and starts. This startup process can take several minutes, depending on the configuration of your computer.

When you see the message All tables have been loaded in the Console view, you are ready to start LiveView Desktop.

Start LiveView Desktop with one of the following methods:

Any of these methods opens the Connect to LiveView dialog.

In the dialog:

When LiveView Desktop connects to the server, you see only the Tables view by default. Double-click the Orders table to get a look at the incoming data flowing through the table.