TIBCO BusinessEvents and TIBCO ActiveSpaces 3.x Integration

You can integrate TIBCO BusinessEvents with TIBCO ActiveSpaces 3.x store using the CEP Store catalog functions.

TIBCO ActiveSpaces® 3.x software is a distributed in-memory data grid product. ActiveSpaces® features familiar database concepts (such as tables, rows, and columns), high I/O capacity, and network scalability. TIBCO ActiveSpaces 3.x uses TIBCO FTL messaging software for communication between an application program and data grid, for internal communication.

To communicate with ActiveSpaces 3.x store, TIBCO FTL should be installed in your system as a prerequisite for ActiveSpaces 3.x. In the be-engine.tra file, the AS3x_HOME must be set to TIBCO ActiveSpaces 3.x and FTL_HOME must be set to and TIBCO FTL installation location.

Key Concepts

Store
Store in BusinessEvents is synonymous with Data Grid in ActiveSpaces 3.x.
Container
A container in BusinessEvents is synonymous with Tables in ActiveSpaces 3.x.
Items
Items in BusinessEvents is synonymous to Rows in ActiveSpaces 3.x. TIBCO BusinessEvents applications can insert, delete, and retrieve individual rows. TIBCO BusinessEvents applications can query for rows that match a specified query filter.

To know about the key concepts and advanced configuration of ActiveSpaces 3.x, refer to the TIBCO ActiveSpaces documentation.

Data Type Mapping

As ActiveSpaces 3.x does not support TIBCO BusinessEvents primitive data types such as integer and boolean, they can be stored in long data type in ActiveSpaces 3.x. Also, TIBCO BusinessEvents arrays of primitive type can be mapped to opaque data type in ActiveSpaces 3.x. To know more about ActiveSpaces 3.x data types, refer to the TIBCO ActiveSpaces documentation.

Note: TIBCO ActiveSpaces is case insensitive, thus, for entities properties, do not use reserved words in either lowercase or uppercase. For complete list, see Keywords and Other Reserved Words.

The following table lists the data type mapping between TIBCO BusinessEvents and ActiveSpaces 3.x.

ActiveSpaces 3.x to TIBCO BusinessEvents Data Type Mapping
ActiveSpaces 3.x Data Type TIBCO BusinessEvents Data Type
Long Long/Integer/Boolean/Float
Double Double
String String
Opaque String[]/Integer[]/Long[]/Double[]/Boolean[]/DateTime[]
DateTime DateTime
BusinessEvents to ActiveSpaces 3.x Data Type Mapping
TIBCO BusinessEvents Data Type ActiveSpaces 3.x Data Type
String/String[] String/Opaque
Integer/Integer[] Long/Opaque
Long/Long[] Long/Opaque
Double/Double[] Double/Opaque
Boolean/Boolean[] Long/Opaque
DateTime/DateTime[] DateTime/Opaque
Float/Float[] Long/Opaque

Example Project

TIBCO BusinessEvents provides a working example project for ActiveSpaces 3.x connection present at BE_HOME/examples/standard/AS3x. Use the readme.html present at the same location to run the example. You can also import the example project in the TIBCO BusinessEvents Studio to understand more on how to integrate the project with ActiveSpace 3.x. For example, in the AS3x example, the StartUp.rulefunction uses Store.ConnectionInfo.create and Store.connect catalog functions to create a new connection to ActiveSpaces 3.x data store.

CEP Store Functions

You can use the CEP Store catalog functions to interact with TIBCO ActiveSpaces 3.x data store.

The basic CEP store functions are as follows:

  • connect or disconnect to data store
  • open or close a container
  • put, get, delete, or query items from the container
  • putAll, getAll, and deleteAll to work on items from all containers
  • closeQuery to exit a query explicitly

Apart from the basic functions, other functions are grouped into the following categories:

  • Metadata - Functions to get details of store, container, and fields.
  • ConnectionInfo - Functions to set up connection details for data store.
  • Item - Functions to set or get data from store items.
  • QueryOptions - Functions to cover prefetch size, snapshot consistencies, and so on.
  • Transactions - Functions to enable or disable the transactional behavior. Additionally, if the transactional behavior is enabled, commit or rollback transaction.
  • Util - Functions to check client version, edit log configurations, and set up a custom logger.

For more information on these catalog functions, see TIBCO BusinessEvents > CEP Store > Store in TIBCO BusinessEvents Functions Reference.